API de gestión escolar para desarrolladores Todo lo que hace Edena, desde tu código

Más de 800 operaciones, un evento por cada cambio, una CLI para ti y tu agente de IA, y un conector para Claude y ChatGPT. Cada clave actúa con un rol del centro y llega exactamente a lo mismo que una persona con ese rol.

Instala la CLI
$ npm install -g @edena-solutions/cli

30 días de prueba, sin tarjeta de crédito.

¿Tu centro ya usa Edena? La consola está en Desarrolladores, en el menú de la app.

edena login · Autorizar la CLI de Edena · Sandbox · edena students list · edena skill install

Cuatro formas de construir sobre Edena

Debajo de todo está la misma API. Llámala desde tu servidor, recibe cada cambio al momento, trabaja desde la terminal o deja que tu app hable como cada familia.

API REST

Alumnos, facturas, asistencia, CRM, horarios: cada pantalla de Edena tiene su operación. Envía la clave en la cabecera Authorization y recibe JSON, con sus tipos en la referencia OpenAPI.

Lista para producción desde la primera petición

Lo que esperas de una API seria, con su comportamiento escrito en la referencia.

Reintentos sin duplicados

Envía cada escritura con Idempotency-Key y repítela durante 24 horas: responde lo mismo que la primera vez y no la hace dos veces.

› Idempotency-Key: 5f0c2e9a-…

Errores con una clave estable

Todos los errores responden con el mismo cuerpo. Decide con key, que no cambia, y guarda el requestId. Hay más de 400 claves documentadas.

› "key": "auth.api_key_in_browser"

Límites que se leen

300 peticiones por minuto por clave y 1.200 entre todas las de la organización. Cada respuesta dice cuánto margen queda; por encima, 429 con Retry-After.

› X-RateLimit-Remaining: 287

Referencia OpenAPI pública

Cada operación con lo que recibe, lo que devuelve y sus errores, en español, catalán e inglés. La CLI y los agentes la leen para no inventar nada.

› GET /openapi.json?lang=es

Un sandbox de verdad

Una copia vacía de tu centro con sus propias claves. De ella no sale nada: ni correos, ni avisos, ni VeriFactu en producción, ni cobros con tarjeta.

› edn_test_…

Tú decides quién escribe a las familias

Si tu app habla con las familias, apaga los correos y avisos de Edena para ellas. El personal y el equipo de desarrollo siguen recibiendo los suyos.

› 409 organization.family_messaging_off

Cada petición, con su rastro

La consola guarda 30 días de peticiones con su requestId, la latencia p95 y cada entrega de webhook con lo que respondió tu sistema.

› X-Request-Id: 0190f4d2-…

Un prompt por categoría

Copia el prompt de una categoría desde la documentación o ejecuta edena prompt: tu agente implementa la integración con los tipos exactos.

› edena prompt invoices

Conector MCP Edena en Claude y ChatGPT

Cada persona del equipo conecta su asistente con su propia cuenta y pregunta por el centro en su idioma. El asistente ve y hace lo mismo que esa persona en Edena, nunca más.

Funciona en
  • Claude
  • ChatGPT
  • Claude Code
  • Codex
  • Gemini CLI
  • GitHub Copilot
  • Cursor
  • Cualquier cliente MCP remoto
  1. ¿Cuántos alumnos de 3.º B faltaron ayer?
  2. Ayer faltaron 2 de los 24 alumnos de 3.º B. Una de las ausencias ya la justificó la familia desde la app.
  3. Convoca a sus familias a una reunión el jueves a las 17:00.
  4. Hecho. La reunión ya está en el calendario de 3.º B.

Se conecta en un minuto

  1. 1

    Añade la dirección

    En tu asistente, como conector personalizado. En Claude está en Ajustes, Conectores.

  2. 2

    Aprueba el acceso en Edena

    Eliges el centro y si el asistente solo consulta o también puede hacer cambios.

  3. 3

    Pregunta en tu idioma

    Busca la operación, la ejecuta como tú y te resume la respuesta. Antes de cada cambio te pide confirmación.

Seis herramientas

Las de cambio solo aparecen si la persona lo permitió al conectarlo.

  • whoami Consulta Como quién actúa: persona, centro, roles y si puede cambiar datos.
  • search_operations Consulta Busca operaciones de la API en palabras sencillas.
  • describe_operation Consulta Describe una operación con sus parámetros y tipos.
  • read_operation Consulta Hace una consulta como la persona.
  • prepare_change Cambio Prepara un cambio sin hacerlo y enseña qué hará.
  • apply_change Cambio Hace el cambio confirmado, una sola vez.

Lo que un asistente nunca hace

Aunque la persona pueda hacerlo en Edena.

  • Facturas y dinero, solo en Edena

    Emitir o anular facturas, cobros, devoluciones, monederos y remesas se hacen siempre desde Edena.

  • Permisos y ajustes, tampoco

    Quién puede hacer qué, el equipo y la configuración del centro no se cambian desde un asistente.

  • Datos sensibles, ocultos

    Datos bancarios, documentos de identidad, datos de salud y credenciales le llegan ocultos.

  • El centro decide

    Un administrador elige qué roles pueden conectar un asistente y puede desconectarlos todos al momento.

Hasta 120 llamadas por minuto por persona y 1.200 por centro. Lo que el asistente lee lo procesa su proveedor, con la cuenta de la persona.

¿Y Ena? Ena es la IA que ya vive dentro de Edena, en la web y en la app. El conector es para quien prefiere trabajar desde su propio asistente. Conoce a Ena

Así entra tu equipo de desarrollo

Quien desarrolla con vosotros tiene su propia cuenta y su consola, sin ver los datos del centro. En cuatro pasos hace su primera petición.

Invita a quien desarrolla

En Desarrolladores, Equipo. Un administrador de desarrollo crea claves e invita; un desarrollador consulta la documentación, las peticiones y el consumo. Los administradores del centro ya forman parte del equipo.

¿Solo necesitas la API?

Crea una organización de desarrollo

Todos los módulos por API para tu propio software, con la consola, el sandbox y las claves, sin la suite de gestión. 30 días de prueba, sin tarjeta.

Crear cuenta de desarrollador

Preguntas frecuentes de desarrolladores

Lo que suele preguntar quien integra Edena por primera vez.

¿Qué puede hacer una clave de API?
Actúa con el rol con el que se creó, administrador o gestor (con su subrol, si lo tiene), y llega exactamente a lo mismo que una persona con ese rol. Si le falta un permiso, la API responde 403. Una organización puede tener hasta 25 claves activas, y cada una se revoca en segundos desde la consola.
¿Necesito usar Edena en mi centro para usar la API?
No. Si tu centro ya usa Edena, la consola está en Desarrolladores, en el menú de la app. Si solo quieres la API para tu propio software, crea una organización de desarrollo: tiene todos los módulos por API, la consola y el sandbox, con 30 días de prueba sin tarjeta.
¿Puedo probar sin tocar datos reales?
Sí. Desde Entorno creas un sandbox: una copia vacía de tu centro con sus propias claves (edn_test_). De ella no salen correos ni avisos a familias, no se envía nada a VeriFactu en producción y no se cobra con tarjeta. Lo puedes restablecer cuando quieras.
¿Cómo se entera mi sistema de los cambios?
Con webhooks: cada cambio en Edena (un alta, una factura cobrada, una asistencia) llega a tu endpoint como un POST firmado con HMAC-SHA256, y se reintenta durante unos tres días si no responde. GET /webhook-events lista los eventos de los últimos 30 días, y en local edena listen te los reenvía sin dirección pública.
¿Mi app puede actuar como cada familia?
Sí, con tokens de usuario final. Tu servidor los pide con una clave de administrador y los entrega a la app, que llega a lo mismo que esa familia en las apps de Edena: sus hijos, sus facturas, sus comunicados y su calendario. Si la familia no tiene cuenta en Edena, se crea una solo para tu app. Una clave enviada desde un navegador responde 403.
¿Qué hace el conector para Claude y ChatGPT?
Deja que cada persona del equipo use Edena desde su asistente de IA, con su cuenta y sus permisos. Consulta lo que la persona puede ver y, si ella lo permite, prepara cambios que solo se hacen cuando los confirma. Nunca emite facturas, mueve dinero ni cambia permisos o ajustes, y no recibe datos bancarios, de identidad ni de salud.
¿Qué diferencia hay entre Ena y el conector?
Ena es la IA de Edena: vive dentro de la web y de la app, con el contexto del centro. El conector lleva Edena al asistente que ya usa cada persona, como Claude o ChatGPT. En los dos casos se respetan los permisos de cada persona y los cambios se confirman antes de hacerse.
¿Quién puede entrar en la consola de desarrolladores?
Los administradores del centro y las personas que invitéis al equipo de desarrollo, como administrador de desarrollo o como desarrollador. Quien solo es desarrollador entra en la consola, nunca en los datos del centro.
¿Qué límites tiene la API?
300 peticiones por minuto por clave y 1.200 entre todas las claves de la organización. Con tokens de usuario final, 300 por persona y 6.000 entre todas las de la app. Cada respuesta indica cuánto margen queda, y por encima la API responde 429 con Retry-After.

Secretaría cierra el mes sin ir detrás de las familias

Las facturas salen con Verifactu, la asistencia queda registrada y cada familia lo ve en la app. Verlo con un centro como el tuyo lleva 15 minutos.

Hablemos