{"id":174,"date":"2026-09-23T09:00:00","date_gmt":"2026-09-23T09:00:00","guid":{"rendered":"https:\/\/posdonpedro.com\/negociosnubeIA\/api-de-facturacion-electronica-dian-en-colombia-que-documentos-soporta-y-como-integrarla\/"},"modified":"2026-09-26T01:14:17","modified_gmt":"2026-09-26T01:14:17","slug":"api-dian-factura-electronica-colombia","status":"publish","type":"post","link":"https:\/\/posdonpedro.com\/negociosnubeIA\/api-dian-factura-electronica-colombia\/","title":{"rendered":"API de facturaci\u00f3n electr\u00f3nica DIAN en Colombia: qu\u00e9 documentos soporta y c\u00f3mo integrarla"},"content":{"rendered":"

Una API de facturaci\u00f3n electr\u00f3nica DIAN<\/a> 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\u00f3n electr\u00f3nica en Colombia<\/a> exige cumplir el est\u00e1ndar UBL 2.1 con firma digital y transmisi\u00f3n en tiempo real \u2014 eso es exactamente lo que resuelve la API DIAN de posdonpedro.com. El servicio soporta todos los tipos de documentos electr\u00f3nicos vigentes y est\u00e1 disponible a $99.000\/mes por empresa, con documentos ilimitados y sin costos adicionales por volumen.<\/p>\n

\u00bfQu\u00e9 es APIDIAN?<\/h2>\n

APIDIAN<\/strong> es el t\u00e9rmino con el que los desarrolladores de software en Colombia denominan al sistema de conexi\u00f3n con la plataforma de facturaci\u00f3n electr\u00f3nica de la DIAN mediante API REST. Cuando un software necesita emitir facturas electr\u00f3nicas v\u00e1lidas ante la DIAN sin que el usuario salga del sistema, la soluci\u00f3n es integrarse con APIDIAN.<\/p>\n

En la pr\u00e1ctica, conectarse a APIDIAN significa que tu software env\u00eda 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<\/strong> (C\u00f3digo \u00danico de Factura Electr\u00f3nica), que le da validez fiscal real al documento.<\/p>\n

DonPedro ofrece este servicio de APIDIAN como API gestionada: tu sistema env\u00eda los datos en JSON y el servicio resuelve la firma, la transmisi\u00f3n, el almacenamiento y el PDF. Sin librer\u00edas propietarias, sin conocer el est\u00e1ndar UBL 2.1. Precio: $99.000 COP\/mes por empresa<\/strong>, documentos ilimitados.<\/p>\n

Conectar mi software a APIDIAN \u2014 WhatsApp<\/a><\/p>\n

Qu\u00e9 tipos de documentos fiscales puede emitir la API<\/h2>\n

La API cubre el cat\u00e1logo completo de documentos electr\u00f3nicos que la DIAN exige o reconoce en Colombia:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Documento<\/th>\nDescripci\u00f3n<\/th>\n<\/tr>\n<\/thead>\n
Factura electr\u00f3nica de venta<\/td>\nDocumento fiscal principal para personas jur\u00eddicas y naturales obligadas<\/td>\n<\/tr>\n
Factura de exportaci\u00f3n<\/td>\nPara operaciones de comercio exterior<\/td>\n<\/tr>\n
Factura por mandato<\/td>\nEmitida en nombre de un tercero mandante<\/td>\n<\/tr>\n
Factura de transporte<\/td>\nEspec\u00edfica para el sector de carga y log\u00edstica<\/td>\n<\/tr>\n
Factura AIU<\/td>\nPara contratos de administraci\u00f3n, imprevistos y utilidad (construcci\u00f3n y servicios)<\/td>\n<\/tr>\n
Factura en contingencia<\/td>\nPara emisi\u00f3n cuando hay fallas de conectividad con la DIAN<\/td>\n<\/tr>\n
Nota cr\u00e9dito<\/td>\nCorrecci\u00f3n, anulaci\u00f3n parcial o total de una factura<\/td>\n<\/tr>\n
Nota d\u00e9bito<\/td>\nCargos adicionales sobre una factura ya emitida<\/td>\n<\/tr>\n
Documento soporte<\/td>\nPara adquisiciones a proveedores no obligados a facturar electr\u00f3nicamente<\/td>\n<\/tr>\n
Nota de ajuste al documento soporte<\/td>\nCorrecciones sobre el documento soporte emitido<\/td>\n<\/tr>\n
N\u00f3mina electr\u00f3nica individual<\/td>\nReporte de pago de n\u00f3mina a la DIAN por empleado<\/td>\n<\/tr>\n
Nota de ajuste de n\u00f3mina<\/td>\nCorrecciones sobre n\u00f3minas ya transmitidas<\/td>\n<\/tr>\n
Documento equivalente electr\u00f3nico (POS)<\/td>\nPara sistemas de punto de venta no integrados a factura directa<\/td>\n<\/tr>\n
Eventos RADIAN<\/td>\nAcuse de recibo, recibo del bien\/servicio, aceptaci\u00f3n expresa y rechazo<\/td>\n<\/tr>\n
RIPS \/ Servicios de salud<\/td>\nDocumentos electr\u00f3nicos para prestadores de servicios de salud<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Cada documento genera autom\u00e1ticamente el XML firmado en UBL 2.1, la representaci\u00f3n gr\u00e1fica en PDF con c\u00f3digo QR y el archivo ZIP de transmisi\u00f3n a la DIAN.<\/p>\n

C\u00f3mo funciona la integraci\u00f3n con tu software<\/h2>\n

La API expone endpoints REST est\u00e1ndar. Tu sistema env\u00eda los datos del documento en formato JSON \u2014 sin necesidad de conocer la estructura XML ni el est\u00e1ndar UBL 2.1 \u2014 y recibe de vuelta el resultado de la validaci\u00f3n DIAN con el CUFE (o CUNE para n\u00f3mina), los archivos generados y el estado del documento.<\/p>\n

El flujo b\u00e1sico para una factura:<\/p>\n

    \n
  1. Tu software env\u00eda los datos del cliente, productos, valores e impuestos en JSON al endpoint de factura.<\/li>\n
  2. La API genera el XML en formato UBL 2.1 y lo firma con el certificado digital de la empresa.<\/li>\n
  3. El XML firmado se transmite a la DIAN, que devuelve el ApplicationResponse con el resultado de validaci\u00f3n.<\/li>\n
  4. La API entrega al software el CUFE, el estado, el PDF y los archivos para almacenamiento o reenv\u00edo al cliente.<\/li>\n<\/ol>\n

    La API funciona con cualquier lenguaje que soporte peticiones HTTP: PHP, Python, Node.js, Java, C#, Ruby u otros. La integraci\u00f3n no requiere librer\u00edas propietarias.<\/p>\n

    Funciones avanzadas que incluye el servicio<\/h2>\n

    Modo de env\u00edo diferido<\/h3>\n

    Si tu sistema genera documentos en lote o en condiciones de baja conectividad, el par\u00e1metro dont_send_yet: true<\/code> permite crear el documento sin transmitirlo inmediatamente. Los documentos quedan en estado pendiente y se pueden transmitir despu\u00e9s con un solo llamado al endpoint de env\u00edos pendientes, de forma masiva o selectiva por prefijo y n\u00famero de documento.<\/p>\n

    Descarga y regeneraci\u00f3n de archivos<\/h3>\n

    La API incluye endpoints para descargar el XML firmado, el PDF, el ZIP de transmisi\u00f3n y el ApplicationResponse de la DIAN. Tambi\u00e9n es posible regenerar el PDF de representaci\u00f3n gr\u00e1fica sin retransmitir el documento.<\/p>\n

    Env\u00edo por correo electr\u00f3nico<\/h3>\n

    Un endpoint dedicado permite enviar la factura directamente al correo electr\u00f3nico del cliente con el XML y el PDF adjuntos, sin que tu sistema deba manejar el env\u00edo de correos.<\/p>\n

    Consulta de estado en tiempo real<\/h3>\n

    Consulta el estado de cualquier documento ante la DIAN por CUFE, por prefijo y n\u00famero, o por rango de fechas. La API tambi\u00e9n permite consultar el estado de los ZIPs de transmisi\u00f3n.<\/p>\n

    Gesti\u00f3n de rangos de numeraci\u00f3n DIAN<\/h3>\n

    La API gestiona los rangos de resoluci\u00f3n DIAN activos para cada empresa, incluyendo la verificaci\u00f3n de prefijos y n\u00fameros disponibles antes de emitir.<\/p>\n

    Almacenamiento de los documentos generados<\/h2>\n

    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\u00f3digo:<\/p>\n