Referencia de API
Recursos principales de la API REST de abaco. Todas las rutas requieren autenticación (sesión web o API key) y se aplican al ámbito de la compañía del usuario o de la llave.
Con API key: el ámbito de la empresa lo define solo la llave; todas las peticiones quedan asociadas a esa empresa. No hace falta (ni corresponde) indicar en la petición el contexto de otra compañía.
Convenciones
URL base
Todas las peticiones usan la misma URL base (endpoint). En producción suele ser https://api.abaco.hn (sin puerto). Obténgala en Configuración > Integraciones.
Paginación
Muchos listados aceptan query params de paginación:
page: número de página (por ejemplo1)limit: cantidad de registros por página (por ejemplo20)
Ejemplo: GET /documents?page=1&limit=20
Códigos HTTP
| Código | Significado |
|---|---|
| 200 | OK (éxito en GET/PUT) |
| 201 | Creado (éxito en POST) |
| 400 | Error de validación (body o query inválido) |
| 401 | No autenticado (falta o invalidez de token/API key) |
| 403 | Sin permiso para el recurso |
| 404 | Recurso no encontrado |
| 429 | Demasiadas peticiones (rate limit); ver Límites y cuotas |
| 500 | Error interno del servidor |
Autenticación
Todas las peticiones deben incluir autenticación: cookie de sesión (app web) o header API key. Formato: Authorization: Bearer <keyId:secret> o X-API-Key: <keyId:secret>.
Recursos por categoría
| Recurso | Descripción | Detalle |
|---|---|---|
| Documentos | Facturas, cotizaciones, notas de crédito | CRUD, confirmar, cancelar |
| Productos | Catálogo, precios y stock | CRUD, búsqueda |
| Socios de negocio | Clientes y proveedores | CRUD, listas por tipo |
| Inventario | Bodegas y stock | Warehouses, stocks, por producto/bodega |
| Empresa y pagos | Compañía, métodos de pago, CAI, sucursales | Configuración |
Las llaves de API no forman parte de la API documentada para integraciones: se crean y administran únicamente desde la aplicación web en Configuración > Integraciones (ver Endpoint y llaves).