Introducción
La API de facturación permite a los sistemas de una empresa (tienda en línea, ERP, sistema de reservas) registrar ventas en Tezora y emitir su documento tributario electrónico (DTE) ante el Ministerio de Hacienda. Tezora arma, firma y transmite cada documento y devuelve el resultado.
Alcance de la API
La API registra clientes, mantiene el catálogo de productos y servicios, crea ventas con su DTE, entrega el JSON y el PDF de cada documento, los envía por correo, emite notas de crédito y de débito, invalida documentos y notifica los cambios de estado por webhook.
Todo documento nace de una venta, igual que en el punto de venta y en la oficina. Una venta creada por la API aparece en los libros de IVA, el F-07, las cuentas por cobrar y los reportes como cualquier otra. La API no emite documentos sueltos.
La superficie /api/integrations/v2 tiene un contrato estable, independiente de los endpoints internos de la aplicación. La versión v2 no quita campos ni rutas. Puede agregar campos y rutas, y una ruta existente puede responder errores nuevos, como 422 document_too_long y 429 rate_limited en las rutas del PDF. Quitar un campo o una ruta sería v3. Un cliente de la API debe ignorar los campos que no conoce.
Convenciones
| Tema | Regla |
|---|---|
| Formato | JSON en la petición y en la respuesta. |
| Montos | Cadenas decimales con punto: "amount": "5.00", nunca "amount": 5 ni "5,00". Un monto enviado como número (unit_price, discount_amount, payments[].amount, charges[].amount, discounts[].amount) responde 422 validation_failed en ese campo, antes de que un serializador lo redondee. Uno escrito con coma decimal responde 422 en ese campo, pidiendo el punto. |
| Cantidades | Cadenas decimales con punto, igual que los montos: "quantity": "2" o "1.5". Una cantidad enviada como número (lines[].quantity de una venta y de una nota) responde 422 validation_failed en ese campo. |
| Identificadores | uuid. |
| Fechas | ISO 8601. Las respuestas llevan el desfase de El Salvador (2026-10-23T08:14:34-06:00). |
| Filtros de fecha | created_from, created_to y updated_since aceptan ISO 8601. Con desfase (Z o -06:00) se toma ese instante; sin desfase (2026-10-01T00:00:00) se lee en hora de El Salvador. 2026-10-01T06:00:00Z y 2026-10-01T00:00:00-06:00 son el mismo instante. Una fecha sin hora no es un instante válido. |
| Paginación | page y per_page (25 por omisión, máximo 100), con meta y links. links.next, prev, first y last conservan per_page y los filtros de la petición: recorrer links.next hasta que sea nulo trae todas las filas del filtro. |
| Idioma | Los mensajes siguen Accept-Language (es o en). El code de un error no cambia con el idioma. |
| Soporte | Toda respuesta lleva X-Request-Id, que identifica la petición ante soporte. |
Fuera de alcance por ahora
- Llaves de prueba sobre una empresa espejo en el ambiente de pruebas mientras la empresa real emite en producción.
- Escritura de movimientos de inventario (entradas, ajustes, traslados); la API solo los lee.
- Facturación para varias empresas con una sola llave.
- Comprobante de retención, de donación, nota de remisión y documento de exportación, salvo los que la venta de oficina ya emite.
- SDK; los ejemplos se publican en JSON y en
curl.