Servicio principal · DIAN Colombia

API-REST para
Facturación Electrónica

Nuestra API REST es el puente entre tu software y la DIAN. Con una sola integración, tu sistema puede emitir, firmar y entregar documentos electrónicos válidos en producción, cumpliendo con toda la normativa vigente.

Documentos soportados

  • Factura electrónica de venta
  • Nota crédito electrónica
  • Nota débito electrónica
  • Documento soporte para no obligados a facturar
  • Nómina electrónica individual y de ajuste
  • Documento equivalente electrónico (servicios públicos)
  • AttachDocument para envío de RIPS (sector salud)

Todo lo que tu integración necesita

Una sola API que cubre todos los tipos de documentos, sectores económicos y requisitos normativos vigentes.

Servicios Públicos Domiciliarios

Soporte para documentos equivalentes electrónicos de agua, electricidad, gas y telecomunicaciones. Cumplimos con las resoluciones específicas de la SPD y la DIAN sin que tu equipo tenga que conocer cada detalle normativo.

Sector Salud

Integración completa con los requisitos del Ministerio de Salud y la DIAN, incluyendo la generación y descarga de AttachDocument para el envío de RIPS. Una sola API cubre todo el ciclo de facturación para clínicas, hospitales y entidades de salud.

Fácil Implementación a Clientes

No te dejamos solo después de la integración. Te apoyamos en la habilitación ante la DIAN de cada uno de tus clientes y en la definición del proceso de implementación para que puedas escalar de forma ordenada.

Fácil Integración con tu Software

Nuestra API REST está completamente documentada con ejemplos reales por cada tipo de documento. Ambiente de pruebas disponible desde el primer día. La mayoría de equipos de desarrollo completan la integración en 1 a 3 semanas.

Tecnología Cloud

Operamos sobre Microsoft Azure y MongoDB Atlas, lo que nos permite garantizar alta disponibilidad, auto-escalabilidad y rendimiento consistente sin importar el volumen de documentos que proceses.

Integración y Despliegues Continuos

Contamos con procesos de CI/CD que nos permiten adaptar la API a cada cambio de la DIAN sin interrupciones de servicio. Cuando la normativa cambia, tu software no necesita hacer nada — nosotros ya lo resolvimos.

Proceso de envío de documentos

Tu sistema envía los datos del documento; nosotros nos encargamos de generar el XML, aplicar la firma electrónica, enviarlo a la DIAN y entregar el resultado.

Envío individual

1

Tu software

Llama POST /api/v1/Document con los datos del documento

2

Majim-e procesa

Genera XML UBL, aplica firma electrónica y transmite a la DIAN

3

DIAN valida

La DIAN retorna el acuse de recibo y el CUFE del documento

Resultado disponible

Consulta vía GET /api/v1/Trace/{TrackId} y el PDF se envía por email

Envío masivo (Batch)

1

Tu software sube archivos

Carga los JSON de documentos al storage del contenedor asignado

2

Dispara el lote

Llama POST /api/v1/Batch con el ID del lote y la cantidad de archivos

3

Procesamiento asíncrono

Majim-e procesa todos los documentos en paralelo y los envía a la DIAN

Estado del lote disponible

Consulta con GET /api/v1/Batch/{BatchId} y los PDFs se envían por email

Dos APIs, una integración completa

El servicio se compone de dos APIs independientes que trabajan en conjunto para cubrir todo el flujo de documentos electrónicos.

EB.Api.Security

API de Seguridad

Permite obtener los tokens de seguridad necesarios para cualquier operación con documentos electrónicos.

Endpoint principal

POST /api/v1/Authentication/Authenticate
  • Autenticación JWT Bearer
  • Roles: Admin, User, Sudo, Broker, Seller
  • Tenant extraído automáticamente del JWT

EB.Api.Adapter

API de Adaptación y Envío

Permite el envío (individual y masivo) de los documentos electrónicos para su transmisión a la DIAN. Además permite la consulta del estado actual de los documentos y asociarles sus representaciones gráficas para su envío por email.

  • Envío individual: POST /api/v1/Document
  • Envío masivo: POST /api/v1/Batch
  • Consulta de estado: GET /api/v1/Trace/{id}
  • Nómina electrónica: POST /api/v1/Payroll
  • Eventos DIAN: POST /api/v1/Event

Eventos sobre Factura Electrónica

Los eventos RADIAN gestionan el ciclo de vida de cada factura electrónica y son requisito para habilitarla como título valor negociable en operaciones de factoring y financiamiento.

030

Acuse de Recibo

El comprador confirma haber recibido la factura electrónica. Es el primer paso obligatorio del ciclo y debe registrarse dentro de los 3 días hábiles siguientes a la recepción.

032

Recibo del Bien o Servicio

El comprador informa que recibió los bienes o que el servicio fue efectivamente prestado. Necesario junto al Acuse de Recibo para habilitar la factura como título valor.

033

Aceptación Expresa

El comprador declara formalmente que acepta la factura. Junto a los eventos 030 y 032, completa el proceso de circulación del título valor.

Auto

Aceptación Tácita

Se genera automáticamente si el comprador no presenta un reclamo dentro de los 3 días hábiles siguientes al Acuse de Recibo. No requiere ninguna acción adicional.

031

Reclamo / Rechazo

El comprador manifiesta que no está de acuerdo con la operación registrada en la factura. Debe realizarse dentro de los 3 días hábiles siguientes al Acuse de Recibo.

Endpoint

POST /api/v1/Event

Con una sola llamada registras cualquiera de los 5 eventos ante la DIAN a través del sistema RADIAN.

Ver documentación técnica

¿Por qué importan los eventos?

Para que una factura electrónica pueda ser negociada como título valor (factoring, confirming, financiamiento de cartera), el comprador debe haber emitido los eventos 030 y 032. Sin estos eventos registrados en RADIAN, la factura no puede cederse ni usarse como garantía ante entidades financieras.

Empieza hoy

¿Listo para integrar tu software con la DIAN?

Contáctanos y en menos de 24 horas un experto te guía por el proceso de integración. Ambiente de pruebas disponible desde el primer día.

1–3

Semanas de integración

10M+

Documentos procesados

60+

Empresas activas

6

Años en el mercado