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 de InSoft. 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, ajustando a tu caso de prueba los datos de la consulta o el JSON del documento.
1 · 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.
2 · Regístrate una vez
Ingresa con Google o Microsoft y completa tu perfil de desarrollador. El sandbox solo acepta registros completos.
3 · 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 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 /api/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.
/api/nit/{nit}/{tddocumento?}Historial de eventos DIAN reportados sobre una factura, a partir de su CUFE.
/api/documento/{uuid}/eventosDescarga el XML que la DIAN tiene almacenado para un CUFE, CUDE, CUDS o CUNE.
/api/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.
/api/DocumentoFEAumenta el valor de una factura ya reportada. Devuelve su CUDE.
/api/DocumentoFEDisminuye o anula una factura ya reportada. Devuelve su CUDE.
/api/DocumentoFEReporta el documento soporte en adquisiciones a no obligados a facturar y devuelve su CUDS.
/api/DocumentoFECorrige o anula un documento soporte ya emitido.
/api/DocumentoFELista todas las resoluciones de numeración que la DIAN tiene autorizadas para un emisor.
/api/resoluciones/{nit}/{tdambiente?}/Detalle de una resolución de numeración puntual, incluida su clave técnica.
/api/resolucion/{nit}/{numeroresolucion}/Construye y firma el documento sin enviarlo a la DIAN. No gasta consecutivos.
/api/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.
/api/DocumentoNECorrige un documento de nómina ya reportado, reemplazando su liquidación.
/api/DocumentoNEAnula un documento de nómina ya reportado, sin reemplazarlo.
/api/DocumentoNEConstruye y firma el XML de un documento de nómina o de su nota de ajuste, sin enviarlo a la DIAN.
/api/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.