Convenciones de la API
Reglas transversales que aplican a todos los endpoints. Conocerlas evita los errores más comunes al escribir un agente o un script.
Dinero
Los importes van en euros decimales, no en céntimos. Mil doscientos euros son 1200.00, no 120000. Usa punto decimal y dos decimales cuando corresponda.
{ "base": 1000.00, "iva": 210.00, "total": 1210.00 }
Fechas
Las fechas van en ISO-8601 (AAAA-MM-DD, por ejemplo 2026-07-08). Las marcas de tiempo siguen el mismo estándar. No uses formatos locales como 08/07/2026.
Identificadores
Los IDs de los recursos son UUID (por ejemplo 3f2a…). Esto vale para facturas, compras, tesorerías, movimientos, documentos y tipos de impuesto. En las líneas de factura/compra, el impuesto se referencia por su tax_type_id (un UUID que obtienes de /api/v1/taxes).
Paginación y filtros
Los endpoints de listado aceptan estos parámetros de consulta:
| Parámetro | Qué hace |
|---|---|
limit | Número máximo de elementos a devolver. |
offset | Desplazamiento (para paginar). |
from | Fecha inicial del rango (ISO-8601). |
to | Fecha final del rango (ISO-8601). |
Ejemplo:
curl "https://api.aikount.com/api/v1/bank-movements?treasury_id=<uuid>&from=2026-04-01&to=2026-06-30&limit=50" \
-H "Authorization: Bearer agl_tu_clave_aqui"
Errores
Un error llega como estado HTTP más un cuerpo JSON con la clave detail:
{ "detail": "..." }
Los más habituales de autenticación son 401 (token ausente, inválido o revocado) y 403 (token válido sin el alcance necesario). Ver Autenticación.
La fuente de la verdad
Esta documentación describe las convenciones estables, pero la especificación OpenAPI es la referencia autoritativa sobre parámetros exactos, tipos, campos y respuestas de cada endpoint:
https://api.aikount.com/openapi.json
También puedes explorarla en Swagger UI (/docs) o Redoc (/redoc). Si algo aquí discrepa del openapi.json, manda el openapi.json.