Documentación del Proveedor Tecnológico
Todo lo que necesitas para integrar tu software con la plataforma de facturación electrónica, nómina electrónica y eventos DIAN. La documentación es pública: se lee sin ingresar. Las 17 funciones ejecutables se prueban desde aquí mismo contra el ambiente de habilitación de la DIAN.
Lee la documentación
Cada función trae su endpoint, sus datos, sus respuestas y los errores frecuentes con su causa. No hace falta ingresar.
Regístrate una vez
Ingresa con Google o Microsoft y completa tu perfil de desarrollador. El sandbox solo acepta registros completos.
Ajusta los datos y ejecuta
Empieza por una consulta o por la generación del XML, que no gastan consecutivos. La respuesta de la DIAN se muestra tal como llega.
Cómo funciona el sandbox
El desarrollador registra su perfil y pasa por la autorización. Desde ahí se abren tres caminos: consultas, generación del XML sin reportarlo y emisión de documentos.
El desarrollador entra al portal y lo primero que hace es registrar su perfil, porque sin él todo lo demás responde 401. Con el perfil registrado pasa la compuerta de autorización, y desde ahí se abren tres caminos: las consultas a la DIAN, la generación del XML sin reportarlo y la emisión de documentos. Las consultas y la emisión terminan en la DIAN, en el ambiente de habilitación; la generación del XML termina en un documento firmado que no se reporta y que por tanto no gasta consecutivos.
Desliza el diagrama para verlo completo.
Ver la fuente Mermaid del diagrama
flowchart TD
D(["Desarrollador en el portal ISW"]) --> A["1 · Registro del perfil<br/>POST /desarrollador"]
A --> G["2 · Compuerta de autorización<br/>credencial y perfil"]
G --> C["3 · Consultas a la DIAN<br/>NIT · resoluciones<br/>eventos · XML"]
G --> X["4 · Generación de XML<br/>sin reportar<br/>PATCH xmlFE · xmlNE · xmlDE"]
G --> E["5 · Emisión a la DIAN<br/>POST DocumentoFE · NE · DE"]
C --> DIAN(["DIAN<br/>ambiente de habilitación"])
X --> XML(["XML firmado que no se reporta<br/>no gasta consecutivos"])
E --> DIAN Llévate las funciones a Postman
Descarga la colección completa con sus variables y tu credencial vigente: al importarla en Postman la primera petición responde sin configurar nada. El paso a paso, con imágenes, está en Probar desde Postman.
Consultas generales
Lecturas contra la DIAN: terceros, eventos de un documento y su XML. Se ejecutan sin gastar consecutivos.
Leer primero el concepto del grupoConsulta en la DIAN la razón social y el correo registrados para una identificación.
/nit/{nit}/{tddocumento?}Historial de eventos DIAN reportados sobre una factura, a partir de su CUFE.
/documento/{uuid}/eventosDescarga el XML que la DIAN tiene almacenado para un CUFE, CUDE, CUDS o CUNE.
/xml/DIAN/{uuid} Facturación electrónica
Emisión de facturas de venta, documento soporte, notas crédito y débito, y notas de ajuste.
Leer primero el concepto del grupoReporta a la DIAN una factura electrónica de venta y devuelve su CUFE.
/DocumentoFEAumenta el valor de una factura ya reportada. Devuelve su CUDE.
/DocumentoFEDisminuye o anula una factura ya reportada. Devuelve su CUDE.
/DocumentoFEReporta el documento soporte en adquisiciones a no obligados a facturar y devuelve su CUDS.
/DocumentoFECorrige o anula un documento soporte ya emitido.
/DocumentoFELista todas las resoluciones de numeración que la DIAN tiene autorizadas para un emisor.
/resoluciones/{nit}/{tdambiente?}/Detalle de una resolución de numeración puntual, incluida su clave técnica.
/resolucion/{nit}/{numeroresolucion}/Construye y firma el documento sin enviarlo a la DIAN. No gasta consecutivos.
/xmlFE Nómina electrónica
Emisión del documento soporte de pago de nómina y sus notas de ajuste y de eliminación.
Leer primero el concepto del grupoReporta a la DIAN el documento soporte de pago de nómina y devuelve su CUNE.
/DocumentoNECorrige un documento de nómina ya reportado, reemplazando su liquidación.
/DocumentoNEAnula un documento de nómina ya reportado, sin reemplazarlo.
/DocumentoNEConstruye y firma el XML de un documento de nómina o de su nota de ajuste, sin enviarlo a la DIAN.
/xmlNE Eventos de la DIAN
Reporte de los eventos del ciclo de vida de la factura: acuse, reclamo, recibo y aceptación.
Leer primero el concepto del grupo¿No sabes por dónde empezar?
Por facturación electrónica: es el grupo con más documentos, más validaciones y más ejemplos, y el que explica el ciclo completo JSON → validación → XML UBL firmado → DIAN → CUFE. Su página de concepto arma el recorrido: primero entender el documento, después generar el XML sin reportarlo —que no gasta consecutivos— y solo al final enviar a la DIAN.