Tezora

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