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 ejemplo 1)
• limit: cantidad de registros por página (por ejemplo 20)

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).

Los webhooks salientes también se configuran en la app (pestaña Webhooks). Ver Webhooks para firma HMAC, eventos y payload.