Una API de facturación electrónica DIAN permite que tu software genere, firme y transmita documentos fiscales ante la DIAN directamente desde tu propio flujo, sin redirigir al usuario a un portal externo. La facturación electrónica en Colombia exige cumplir el estándar UBL 2.1 con firma digital y transmisión en tiempo real — eso es exactamente lo que resuelve la API DIAN de posdonpedro.com. El servicio soporta todos los tipos de documentos electrónicos vigentes y está disponible a $99.000/mes por empresa, con documentos ilimitados y sin costos adicionales por volumen.
¿Qué es APIDIAN?
APIDIAN es el término con el que los desarrolladores de software en Colombia denominan al sistema de conexión con la plataforma de facturación electrónica de la DIAN mediante API REST. Cuando un software necesita emitir facturas electrónicas válidas ante la DIAN sin que el usuario salga del sistema, la solución es integrarse con APIDIAN.
En la práctica, conectarse a APIDIAN significa que tu software envía los datos de la factura (cliente, productos, valores e impuestos) a un servicio intermediario habilitado. Ese servicio genera el XML en formato UBL 2.1, lo firma con el certificado digital y lo transmite a la DIAN. La DIAN valida el documento y devuelve el CUFE (Código Único de Factura Electrónica), que le da validez fiscal real al documento.
DonPedro ofrece este servicio de APIDIAN como API gestionada: tu sistema envía los datos en JSON y el servicio resuelve la firma, la transmisión, el almacenamiento y el PDF. Sin librerías propietarias, sin conocer el estándar UBL 2.1. Precio: $99.000 COP/mes por empresa, documentos ilimitados.
Conectar mi software a APIDIAN — WhatsApp
Qué tipos de documentos fiscales puede emitir la API
La API cubre el catálogo completo de documentos electrónicos que la DIAN exige o reconoce en Colombia:
| Documento | Descripción |
|---|---|
| Factura electrónica de venta | Documento fiscal principal para personas jurídicas y naturales obligadas |
| Factura de exportación | Para operaciones de comercio exterior |
| Factura por mandato | Emitida en nombre de un tercero mandante |
| Factura de transporte | Específica para el sector de carga y logística |
| Factura AIU | Para contratos de administración, imprevistos y utilidad (construcción y servicios) |
| Factura en contingencia | Para emisión cuando hay fallas de conectividad con la DIAN |
| Nota crédito | Corrección, anulación parcial o total de una factura |
| Nota débito | Cargos adicionales sobre una factura ya emitida |
| Documento soporte | Para adquisiciones a proveedores no obligados a facturar electrónicamente |
| Nota de ajuste al documento soporte | Correcciones sobre el documento soporte emitido |
| Nómina electrónica individual | Reporte de pago de nómina a la DIAN por empleado |
| Nota de ajuste de nómina | Correcciones sobre nóminas ya transmitidas |
| Documento equivalente electrónico (POS) | Para sistemas de punto de venta no integrados a factura directa |
| Eventos RADIAN | Acuse de recibo, recibo del bien/servicio, aceptación expresa y rechazo |
| RIPS / Servicios de salud | Documentos electrónicos para prestadores de servicios de salud |
Cada documento genera automáticamente el XML firmado en UBL 2.1, la representación gráfica en PDF con código QR y el archivo ZIP de transmisión a la DIAN.
Cómo funciona la integración con tu software
La API expone endpoints REST estándar. Tu sistema envía los datos del documento en formato JSON — sin necesidad de conocer la estructura XML ni el estándar UBL 2.1 — y recibe de vuelta el resultado de la validación DIAN con el CUFE (o CUNE para nómina), los archivos generados y el estado del documento.
El flujo básico para una factura:
- Tu software envía los datos del cliente, productos, valores e impuestos en JSON al endpoint de factura.
- La API genera el XML en formato UBL 2.1 y lo firma con el certificado digital de la empresa.
- El XML firmado se transmite a la DIAN, que devuelve el ApplicationResponse con el resultado de validación.
- La API entrega al software el CUFE, el estado, el PDF y los archivos para almacenamiento o reenvío al cliente.
La API funciona con cualquier lenguaje que soporte peticiones HTTP: PHP, Python, Node.js, Java, C#, Ruby u otros. La integración no requiere librerías propietarias.
Funciones avanzadas que incluye el servicio
Modo de envío diferido
Si tu sistema genera documentos en lote o en condiciones de baja conectividad, el parámetro dont_send_yet: true permite crear el documento sin transmitirlo inmediatamente. Los documentos quedan en estado pendiente y se pueden transmitir después con un solo llamado al endpoint de envíos pendientes, de forma masiva o selectiva por prefijo y número de documento.
Descarga y regeneración de archivos
La API incluye endpoints para descargar el XML firmado, el PDF, el ZIP de transmisión y el ApplicationResponse de la DIAN. También es posible regenerar el PDF de representación gráfica sin retransmitir el documento.
Envío por correo electrónico
Un endpoint dedicado permite enviar la factura directamente al correo electrónico del cliente con el XML y el PDF adjuntos, sin que tu sistema deba manejar el envío de correos.
Consulta de estado en tiempo real
Consulta el estado de cualquier documento ante la DIAN por CUFE, por prefijo y número, o por rango de fechas. La API también permite consultar el estado de los ZIPs de transmisión.
Gestión de rangos de numeración DIAN
La API gestiona los rangos de resolución DIAN activos para cada empresa, incluyendo la verificación de prefijos y números disponibles antes de emitir.
Almacenamiento de los documentos generados
Cada documento que pasa por la API genera archivos (XML, PDF, ZIP, ApplicationResponse, QR). El servicio ofrece dos opciones de almacenamiento, configurables sin modificar código:
- Almacenamiento local: los archivos quedan en el servidor donde corre la API.
- AWS S3: los archivos se guardan en un bucket de Amazon S3, recomendado para volúmenes altos o cuando se necesita acceso desde múltiples servidores.
Ambientes: pruebas y producción
La API trabaja tanto en el ambiente de habilitación de la DIAN (pruebas) como en producción. Esto permite que tu equipo de desarrollo valide la integración completa — incluyendo tipos de documentos, campos requeridos y respuestas de error — antes de transmitir documentos con valor fiscal real.
Cuánto cuesta el servicio y qué incluye
El servicio de API de facturación electrónica tiene un precio de $99.000 COP/mes por empresa, sin límite de documentos emitidos. Eso incluye todos los tipos de documentos de la tabla anterior: facturas en sus distintas modalidades, notas, documentos soporte, nómina electrónica y eventos RADIAN.
No hay costo adicional por volumen ni por tipo de documento. Si tu empresa emite 10 facturas al mes o 10.000, el precio es el mismo.
Para casas de software que ofrecen la integración a sus clientes finales, el precio aplica por empresa habilitada en el sistema. El equipo de DonPedro gestiona la configuración inicial, la carga del certificado digital y entrega las credenciales listas para conectar.
Lo que necesita la empresa para empezar:
- Certificado digital vigente emitido por una entidad certificadora reconocida por la DIAN.
- Resolución de facturación activa con prefijo y rango vigentes.
- La empresa ya habilitada en el sistema de facturación electrónica de la DIAN.
Si la empresa aún no ha completado el proceso de habilitación ante la DIAN, el artículo sobre facturación electrónica DIAN explica los requisitos y el proceso paso a paso.
Preguntas frecuentes sobre la API de facturación DIAN
¿La API funciona en el ambiente de pruebas de habilitación de la DIAN?
Sí. La API soporta tanto el ambiente de habilitación (pruebas) como el de producción. Puedes validar toda la integración antes de emitir documentos con valor fiscal.
¿Cuántos documentos puedo emitir por mes?
Sin límite. El plan de $99.000/mes no tiene restricciones por número de documentos ni por tipo de documento emitido.
¿La API genera el PDF de representación gráfica automáticamente?
Sí. Cada documento emitido genera su representación gráfica en PDF con código QR y los datos de validación DIAN, disponible para descarga o envío directo al correo del cliente.
¿Desde qué lenguajes de programación puedo integrar la API?
Desde cualquiera que soporte peticiones HTTP: PHP, Python, Node.js, Java, C#, Ruby, entre otros. La API expone endpoints REST estándar sin librerías propietarias.
¿Qué pasa si necesito la API para varias empresas?
Cada empresa requiere su propia configuración con su certificado digital y su resolución DIAN. El precio de $99.000/mes aplica por empresa registrada en el sistema.
¿La API cubre también la nómina electrónica?
Sí. La API emite documentos de nómina electrónica individual y notas de ajuste de nómina, los dos documentos que exige la DIAN para el reporte de pagos laborales.
Fuentes y referencias técnicas:
- DIAN — Sistema de facturación electrónica (portal oficial)
- MytechSolutions — Cómo integrar la DIAN en tu software: paso a paso 2026
Artículo generado con asistencia de IA a partir de las fuentes citadas.