Lumen Docs

Guía de inicio rápido

Emite tu primer documento tributario electrónico con Lumen API en cuatro pasos. Configura el emisor, emite factura electrónica en El Salvador y descarga el PDF o JSON del DTE generado.

Esta guía te lleva de cero a emitir documentos tributarios electrónicos con la API REST de Lumen en El Salvador. En cuatro pasos configurás el emisor, emitís tu primer documento y descargás el PDF o JSON de manera rápida y sencilla.

Antes de comenzar

Cada empresa emisora debe estar inscrita ante Hacienda en modalidad Sistema de Transmisión y contar con las credenciales y el certificado de firma electrónica correspondientes.

En una plataforma multiempresa, este requisito aplica a cada empresa emisora.

1. Obtén tus credenciales

Para autenticarte con Lumen API necesitas:

  • client_id
  • client_secret

Si aún no tienes credenciales, contactanos para obtener acceso al sandbox y probar la emisión sin impacto fiscal.

Con ellas podrás obtener un token de acceso para realizar solicitudes a la API.

→ Conoce el flujo de autenticación

2. Configura tu entorno

Antes de emitir, configura el emisor que utilizará Lumen API:

  1. Crea la empresa emisora.
  2. Crea sus establecimientos.
  3. Crea sus puntos de venta.
  4. Configura las credenciales de facturación (opcional en sandbox).
  5. Carga el certificado de firma electrónica (opcional en sandbox).

En sandbox, los pasos 4 y 5 son opcionales. Puedes probar y simular la transmisión sin credenciales de facturación otorgadas por MH: los DTE se crearán en modo borrador, sin validez fiscal y no se transmitirán a Hacienda.

3. Envía un JSON simple

Con el entorno configurado, ya puedes emitir tu primer DTE.

Elige el endpoint según el documento que necesitas:

Envía el JSON requerido y Lumen se encargará del proceso de emisión ante Hacienda.

4. Recibe tu DTE

Una vez procesada la emisión, Lumen devuelve la información del DTE generado.

Utiliza el código de generación de la respuesta para consultar sus archivos:


¿Listo para comenzar?

Obtén tu token de acceso, crea tu primera factura o vuelve a la introducción de la API.

On this page