Endpoints principales
Estos son los endpoints de negocio con los que un agente lleva la contabilidad. Todos cuelgan de la base https://api.aikount.com bajo el prefijo /api/v1, y todos requieren Authorization: Bearer <token> (ver Autenticación).
Usa solo los endpoints listados aquí. Para la lista completa y exacta de parámetros y respuestas, consulta el OpenAPI en
https://api.aikount.com/openapi.json, que es la fuente de la verdad.
Núcleo
| Endpoint | Para qué |
|---|---|
GET /api/v1/tenants/me | Verificar el token y ver la empresa (tenant) activa. Es el que debes usar con claves agl_. |
GET/POST /api/v1/invoices | Facturas de venta. |
GET/POST /api/v1/purchases | Facturas de compra / gastos. |
POST /api/v1/ai/ingest-purchase | Ingestar un PDF de compra: el agente lo lee por OCR y lo contabiliza (con deduplicación). |
GET /api/v1/treasuries | Tesorerías (cuentas bancarias, Stripe, PayPal) con su saldo. |
GET /api/v1/bank-movements | Movimientos bancarios. Filtra por cuenta con ?treasury_id=. |
POST /api/v1/reconciliation/manual-match | Conciliar a mano: enlaza {movement_id, document_id}. |
GET /api/v1/reconciliation/board | El tablero de sugerencias de conciliación. |
GET /api/v1/taxes | Tipos de impuesto (con sus UUID). Las líneas referencian un impuesto por tax_type_id. |
GET /api/v1/ledger | Libro mayor / asientos contables (PGC). |
GET /api/v1/aeat/303 | Modelo 303 (IVA) en CSV, con ?year=&quarter=. |
Sobre el 303
GET /api/v1/aeat/303?year=2026&quarter=2devuelve el CSV del modelo para ese periodo.GET /api/v1/aeat/303/summarydevuelve el histórico en JSON.
Recuerda: Aikount prepara los modelos a partir de tu contabilidad real; la presentación ante la AEAT la hacéis tú o tu gestor.
/auth/me no vale para claves de API
/auth/me es solo de sesión (login) y rechaza las claves de API. Si tu agente usa una clave agl_, verifica el token con /api/v1/tenants/me, no con /auth/me.
Convenciones que aplican a todos
- Dinero en euros decimales (
1200.00), no en céntimos. - Fechas en ISO-8601; IDs en UUID.
- Los endpoints de listado aceptan
limit,offset,from,to. - Errores: estado HTTP más
{"detail": "..."}.
Los detalles están en Convenciones de la API. Para la lista completa de endpoints por recurso, consulta la Referencia de la API.