APIDIAN es el nombre con el que los desarrolladores de software en Colombia denominan al sistema de integración API que conecta cualquier programa con la plataforma de facturación electrónica de la DIAN. En términos simples: si quieres que tu software emita facturas electrónicas válidas sin que el usuario tenga que entrar a ningún portal externo, necesitas integrarte con APIDIAN.
¿Para qué sirve APIDIAN?
APIDIAN automatiza el proceso de emisión de documentos fiscales electrónicos: tu software envía los datos de la venta, APIDIAN genera el XML firmado, lo transmite a la DIAN y devuelve el CUFE (Código Único de Factura Electrónica) que le da validez fiscal al documento — todo en segundos, sin intervención manual.
Sin APIDIAN, cada factura requeriría que el usuario entrara al portal de la DIAN a registrarla manualmente. Para negocios con más de 5 facturas diarias eso es inviable.
¿Cómo funciona APIDIAN técnicamente?
La integración usa endpoints REST. Tu sistema envía una petición HTTP con los datos de la factura en JSON y recibe la respuesta con el resultado de la DIAN:
- Tu software envía: NIT emisor, NIT receptor, productos, valores, impuestos.
- APIDIAN 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 la validación.
- APIDIAN entrega al software el CUFE, el PDF de representación gráfica y los archivos para almacenamiento.
Funciona con cualquier lenguaje que soporte HTTP: PHP, Python, Node.js, Java, C#. No requiere librerías propietarias ni conocer el estándar UBL 2.1.
¿Qué documentos soporta APIDIAN?
El servicio cubre todos los documentos electrónicos que la DIAN exige o reconoce:
- Factura electrónica de venta (y modalidades: exportación, mandato, transporte, AIU, contingencia)
- Nota crédito y nota débito
- Documento soporte y nota de ajuste
- Nómina electrónica individual y nota de ajuste de nómina
- Documento equivalente electrónico (para sistemas POS)
- Eventos RADIAN (acuse de recibo, aceptación, rechazo)
La guía técnica completa está en el artículo sobre API de facturación electrónica DIAN.
¿Qué necesita una empresa para usar APIDIAN?
- Certificado digital vigente emitido por una entidad certificadora reconocida por la DIAN.
- Resolución de facturación activa con prefijo y rango de numeración vigentes.
- Empresa habilitada en el sistema de facturación electrónica de la DIAN.
Si la empresa aún no ha completado la habilitación, el artículo sobre facturación electrónica DIAN explica el proceso paso a paso.
¿Cuánto cuesta conectarse a APIDIAN con DonPedro?
$99.000 COP/mes por empresa, sin límite de documentos. Eso incluye todos los tipos de la lista anterior: facturas en sus modalidades, notas, nómina electrónica y eventos RADIAN. 10 facturas o 10.000 al mes — el precio es el mismo.
Conectar mi software a APIDIAN — WhatsApp
Preguntas frecuentes sobre APIDIAN
¿APIDIAN es un producto oficial de la DIAN?
APIDIAN es el nombre popular de la comunidad de desarrolladores para referirse al sistema de integración con la facturación electrónica de la DIAN. La DIAN define el estándar técnico (UBL 2.1, firma digital, URLs de transmisión); servicios como el de DonPedro implementan esa integración y la exponen como API simple.
¿En cuánto tiempo puedo tener APIDIAN integrado?
La integración técnica puede completarse en 1 a 3 días de desarrollo, dependiendo del sistema. La configuración del lado de DonPedro (certificado, resolución, credenciales) se hace el mismo día.
¿Puedo probar APIDIAN antes de producción?
Sí. El servicio soporta el ambiente de habilitación de la DIAN (pruebas), donde se emiten documentos sin valor fiscal real para validar la integración completa antes de ir a producción.
¿APIDIAN funciona para el documento equivalente electrónico de POS?
Sí. La API incluye soporte para el documento equivalente electrónico, que es el documento que la DIAN exige a los sistemas punto de venta que no emiten factura directa. Compatible con cualquier sistema POS.
Artículo generado con asistencia de IA a partir de fuentes verificadas.