Documentación técnica
Referencia de la API, del sistema de eventos, de los webhooks y de los protocolos para agentes de XEN, para el equipo técnico que integra la plataforma con sus propios sistemas.
La referencia se publica apartado por apartado, en el orden de este índice.
Cada apartado sale con sus ejemplos de petición y respuesta revisados contra el servidor en producción. Un equipo que necesite integrar hoy recibe la referencia de los endpoints que usa y una persona de Xeneural durante la integración.
Solicitar la referencia para una integraciónOcho apartados
Autenticación
Cada petición lleva el token de sesión del usuario en la cabecera de autorización; el servidor lo valida, resuelve al usuario y rechaza cualquier petición sin token antes de tocar un solo dato.
Ámbito de organización
La organización activa la resuelve el servidor a partir de la sesión; el cliente nunca la declara en la petición, así que un identificador enviado desde fuera no puede abrir los datos de otra empresa.
Endpoints de ventas
Emisión de documentos, borradores y programación; consulta del estado; notas de crédito y débito enlazadas al original; series por punto de emisión.
Endpoints de inventario
Movimientos de ingreso y salida, transferencias entre almacenes, ajustes con motivo y consulta de saldo físico y disponible por ítem y almacén.
Sistema de eventos
Todo resultado del servidor lleva un código de evento pequeño y secuencial de un registro único; los códigos se leen del mismo catálogo en la aplicación, en las integraciones y en los agentes.
Webhooks
Registro de un destino por organización, formato del envío, firma para verificar el origen y política de reintentos cuando el destino no responde.
Protocolos para agentes
Cómo un agente externo se autoriza con MCP, AP2 y UCP, opera con los permisos del usuario que lo autorizó y deja cada acción en el mismo historial que una persona.
Errores y códigos
Forma de la respuesta de error, catálogo de códigos por familia (validación, permisos, fiscal, integración) y qué corregir en cada caso antes de reintentar.