BotBlaze

Facturación BotBlaze

v1.0

Documentación para desarrolladores · DTE El Salvador

API REST · Compatible con Hacienda El Salvador

Emite Documentos Tributarios Electrónicos

Factura, crédito fiscal, notas de crédito y débito, retenciones, exportaciones y más con una API REST. Firma digital incluida, envío a Recepción DTE y descarga de PDF, JSON y ticket en un solo request.

Bearer token
Respuesta en segundos
8 tipos de DTE
Endpoints
26 endpoints
Secciones
6 secciones
Base URL
https://api-pruebas.botblaze.tech
Autenticación
Authorization: Bearer <token>
Entorno
Pruebas Producción
Paso 1

Obtén tu token

Autentícate con tu email y contraseña. El access_token es válido por 1 hora.

Paso 2

Emite tu primer DTE

Envía el JSON del documento. La API lo firma y lo manda a Recepción DTE por ti.

Paso 3

Consulta el resultado

Revisa el estado del documento y descarga el PDF, el JSON y el ticket.

Elige un endpoint para empezar

Cada endpoint incluye el JSON de ejemplo, la tabla de campos con sus tipos y requerimientos, catálogos de Hacienda y ejemplos listos para copiar en PHP, Laravel y Python.

Usa el buscador para saltar a cualquier endpoint

Control total sobre los datos

El request sigue el esquema oficial del Ministerio de Hacienda —emisor, receptor, cuerpoDocumento, resumen-, para que tu integración sea predecible y cada observación de Hacienda apunte a un campo que tú enviaste.

Lo que esa estructura no cubre, lo pone la API: generamos la sección identificación completa, firmamos, enviamos a Recepción DTE y retornamos el PDF, el JSON y el ticket.

Responde con los mismos nombres de campo que usa Hacienda. Puedes tomar un ejemplo de la API y mandarlo tal cual a otro proveedor.
  • Control total

    Defines cada campo del documento, incluidos los opcionales que Hacienda exige cuando aplican: documentoRelacionado, otrosDocumentos, ventaTercero o extension.

  • Errores claros

    Cuando Hacienda devuelve una observación, corresponde a un campo que tú enviaste y no a una capa interna de la que no tienes visibilidad.

  • Portabilidad

    La estructura que produces es la de Hacienda, así que puedes llevarla a cualquier proveedor que hable el mismo esquema.

BotBlaze

Campos propios de BotBlaze

Estos campos no existen en el esquema del Ministerio de Hacienda: los agrega la API para que puedas emitir con fecha anterior, personalizar el PDF y distinguir los documentos que salen desde la app móvil.

Extensión BotBlaze
Cargas diferidas
fechaEmision

Emite con fecha anterior. Útil para cargas diferidas y correcciones de documentos del mismo periodo.

Plantillas de PDF
diseno

Elige el diseño del PDF (diseno-base, diseno-1 … diseno-5) que se imprime.

Tu marca
colorPrimario

Personaliza el PDF con tu color de marca en hexadecimal.

pos
App móvil de BotBlaze

Marca el DTE como generado desde la app móvil de BotBlaze. Los documentos que se emiten desde el punto de venta viajan con el flag pos, y así puedes separarlos en tus reportes, en tu contabilidad y en el seguimiento de cada venta.

Conocer la app
Autenticarse
Pega el access_token que devuelve POST /auth/login.
El token se guarda solo en tu sesión (30 minutos) y se envía como Authorization: Bearer <token>.