Skip to main content
La API de Sintropix es una interfaz JSON sobre HTTPS al sistema que gestiona tu contabilidad, tus facturas, tus movimientos bancarios y tus informes. Cada ruta de negocio está acotada a una sola Entidad (una empresa legal con sus propios libros) y se autentica con una clave de API. Las solicitudes y respuestas se validan de extremo a extremo, por lo que los nombres de campo, tipos y enumeraciones son consistentes en todos los endpoints.
Las páginas de referencia de cada endpoint están disponibles solo en inglés por ahora.

​
URL base

Todas las rutas se montan bajo el prefijo /api:
La API no lleva versión en la ruta de la URL.

​
Forma de las rutas

La mayoría de los recursos de negocio viven bajo una sola Entidad:
Por ejemplo:
Unas pocas rutas son independientes de la Entidad: /api/entities (listar y crear), /api/fx-rates, /api/countries y /api/currencies, /api/onboarding/* (solo para el equipo de Sintropix) y /api/health. {entityId} es siempre un UUID. Una solicitud sobre una Entidad a la que quien llama no tiene acceso devuelve 404, nunca 403, de modo que sondear rutas no revela si una Entidad desconocida existe.

​
Autenticación

Los clientes programáticos se autentican con una clave de API en el encabezado x-api-key. Las claves se crean en la aplicación de Sintropix; consulta Obtener una clave de API. Toda solicitud que modifica datos (POST, PUT, PATCH, DELETE) debe enviar además un Actor Declarado:
x-audit-actor es una etiqueta de software autodeclarada (por ejemplo claude-opus-4.8) que se guarda tal cual en el registro de auditoría. Omitirla en una mutación devuelve 400.

​
Formato de las solicitudes

Las solicitudes son JSON plano. Incluye Content-Type: application/json en cualquier solicitud con cuerpo.
Los parámetros de ruta que son identificadores deben ser UUID válidos; un identificador mal formado devuelve 400.

​
Formato de las respuestas

Las respuestas son el recurso en sí como JSON. No hay un envoltorio data de nivel superior, ni un bloque meta, ni un bloque pagination en los endpoints no paginados. Cada página de referencia lista los campos que devuelve cada endpoint. Un recurso individual se devuelve como un objeto:
Un endpoint de listado devuelve un arreglo JSON sin envoltorio:
Un endpoint paginado (aquellos cuya ruta termina en /pages, más algunos informes) devuelve un objeto { rows, nextCursor }. nextCursor es null en la última página.
La paginación se habilita endpoint por endpoint, no en todo el sitio. Los endpoints sin /pages en su ruta devuelven todas las filas y no aceptan el argumento cursor. Revisa la página de referencia del endpoint que estés llamando.

​
Errores

Las respuestas distintas de 2xx son JSON. Toda respuesta, exitosa o fallida, lleva un encabezado x-request-id; cítalo cuando contactes a soporte. Los errores de dominio llevan en el cuerpo un code de tipo string estable, por ejemplo API_KEY_READ_ONLY_ERROR. Compara contra code, no contra el mensaje legible por humanos.

​
Límites de solicitudes

Cada clave de API está limitada a 25.000 solicitudes por hora en una ventana deslizante. Superar el límite devuelve 429; no existe un contrato de encabezados X-RateLimit-* en la respuesta.

​
Llamadas desde el navegador

La API está diseñada para uso servidor a servidor con una clave de API. Llamarla directamente desde un navegador requiere que Sintropix incluya tu origen en una lista de permitidos; contacta a soporte si lo necesitas.

​
Qué no forma parte de la API

No hay sistema de webhooks. Sintropix no envía notificaciones de eventos a URL externas. Consulta periódicamente los endpoints que te interesen, o el registro de auditoría como feed de cambios.
No hay paginación por cursor en la mayoría de los endpoints. Solo los endpoints cuya ruta termina en /pages (más los paginadores de libro mayor, partidas abiertas, diario y asientos contables) devuelven { rows, nextCursor }. El resto devuelve la lista completa.
No hay esquema Authorization: Bearer. Las claves de API van en el encabezado x-api-key.
No hay prefijo /v1. La ruta base es /api.