API Reference
Base URL
https://api.timbrify.com/api/v1Autenticacion
Todas las requests de integracion POS/ERP requieren el header X-API-Key.
Ver Autenticacion para mas detalles.
Formato
- Request bodies: JSON (
Content-Type: application/json) - Responses: JSON con envelope
{ data: T }o{ error, message } - Fechas: ISO 8601 (
2026-04-03T12:00:00Z) - Montos: Numeros decimales (no centavos)
- IDs: UUIDs v4
Endpoints principales
| Grupo | Endpoints | Descripcion |
|---|---|---|
| Tickets | POST/GET /api/v1/tickets | Creacion y consulta de tickets POS |
| Invoices | GET /api/v1/invoices | Consulta de facturas |
| Merchant | GET/PUT /api/v1/merchant/* | Dashboard, settings, branches |
| Consumer Suite | POST /api/v1/consumer/* | Facturacion B2C |
| Admin | GET/POST /api/v1/admin/* | Backoffice de administracion |
| Catalogs | GET /api/v1/catalogs/* | Catalogos del SAT |
| System | GET /health | Health check |
Esquemas de seguridad
| Esquema | Header/Cookie | Uso |
|---|---|---|
| API Key | X-API-Key | Integraciones POS/ERP |
| Cookie Session | tmb_session | Portal merchant |
| Bearer JWT | Authorization: Bearer ... | Admin backoffice |
Especificacion OpenAPI
Esta documentacion se genera automaticamente desde la especificacion OpenAPI del servidor Fastify. La spec contiene 238 endpoints organizados en 8 tags.