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-… 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.
$ 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
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.
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.
Lo que esperas de una API seria, con su comportamiento escrito en la referencia.
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-… 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" 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 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 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_… 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 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-… 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 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.
En tu asistente, como conector personalizado. En Claude está en Ajustes, Conectores.
Eliges el centro y si el asistente solo consulta o también puede hacer cambios.
Busca la operación, la ejecuta como tú y te resume la respuesta. Antes de cada cambio te pide confirmación.
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. Aunque la persona pueda hacerlo en Edena.
Emitir o anular facturas, cobros, devoluciones, monederos y remesas se hacen siempre desde Edena.
Quién puede hacer qué, el equipo y la configuración del centro no se cambian desde un asistente.
Datos bancarios, documentos de identidad, datos de salud y credenciales le llegan ocultos.
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
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.
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?
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.
Lo que suele preguntar quien integra Edena por primera vez.
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.