Referencias
Las fuentes oficiales de todo lo que la documentación da por sabido: la norma que define qué se emite, el estándar del que sale cada código y la especificación de los formatos con los que viaja el documento. Todos los enlaces son de quien publica el dato —la DIAN, ISO, OASIS, el IETF—, no de un resumen de tercero: un resumen envejece sin avisar y no sirve para defender una decisión.
Lo que no encontrarás aquí es la dirección del servicio productivo: esa se entrega junto con las credenciales — ver Credenciales y JWT.
La DIAN: norma y anexos técnicos
La autoridad del proceso. Aquí está lo que define qué se emite, con qué estructura y bajo qué reglas; es lo que se cita cuando hay que defender por qué un documento se armó de una manera y no de otra.
- Sistema de facturación electrónica El punto de entrada. Desde aquí cuelgan los documentos electrónicos, su normativa y sus anexos. micrositios.dian.gov.co
- Documentación técnica Los anexos técnicos vigentes, con la estructura del XML, los catálogos de códigos y las reglas de validación. Es la fuente del
codigodianque devuelve una regla incumplida. micrositios.dian.gov.co - Documento soporte en adquisiciones a no obligados a facturar El documento que emite el comprador. Su anexo técnico y su normativa propia, que no son los de la factura de venta. micrositios.dian.gov.co
- Documento soporte de pago de nómina electrónica Nómina electrónica: su anexo técnico, sus catálogos de conceptos y las condiciones de la nota de ajuste. micrositios.dian.gov.co
- RADIAN — el ciclo de vida de la factura Los eventos que se reportan sobre una factura ya emitida y las condiciones con las que se convierte en título valor. micrositios.dian.gov.co
- Normograma de la DIAN El texto de las resoluciones, con su vigencia y sus modificaciones. Es donde se comprueba si la resolución que citas sigue viva. normograma.dian.gov.co
- Portal de la DIAN Los servicios en línea del contribuyente: RUT, habilitación y trámites del emisor. Es lo que necesita tu cliente, no tu integración. dian.gov.co
Verificar un documento emitido
El documento que la DIAN recibió y almacenó, buscado por su identificador. Es la prueba de que la emisión llegó: lo que muestra el catálogo es lo que la DIAN tiene, no la copia local del emisor.
- Catálogo de documentos electrónicos — habilitación Donde se comprueba lo que se emite desde el sandbox. Pide el identificador del documento y el NIT del emisor, que en el sandbox es el de la empresa de pruebas. catalogo-vpfe-hab.dian.gov.co
- Catálogo de documentos electrónicos — producción El mismo catálogo para lo emitido de verdad. Un documento de habilitación no aparece aquí, ni al revés. catalogo-vpfe.dian.gov.co
El formato del documento electrónico
El estándar sobre el que está construido el XML que se firma y se reporta. Se viene aquí cuando hay que comparar nodo por nodo el XML que genera el Proveedor Tecnológico con el que espera tu integración.
- UBL 2.1 — Universal Business Language (OASIS) La especificación de la que salen
Invoice,CreditNote,DebitNoteyApplicationResponse, con el significado de cada nodo. docs.oasis-open.org - XAdES — firma electrónica avanzada sobre XML El perfil de firma del documento electrónico. Explica qué sella la firma y por qué cualquier cambio posterior la invalida. w3.org
- RFC 3629 — UTF-8 La codificación de caracteres con la que se genera todo XML del Proveedor Tecnológico: lo declara el propio documento en
<?xml version="1.0" encoding="UTF-8"?>. Es lo que hay que usar al leerlo y al guardarlo, y lo que explica que una tilde o unañse vean como dos caracteres raros cuando algo lo interpreta con otra codificación. datatracker.ietf.org - RFC 4648 — Base64 La codificación con la que viaja el documento adjunto en las respuestas. Es lo que hay que decodificar para recuperar el XML. datatracker.ietf.org
Códigos y catálogos internacionales
Los códigos que el documento no inventa: los toma de un estándar internacional. El anexo técnico de la DIAN dice cuál de ellos aplica en cada campo, y estas son las listas de origen.
- ISO 8601 — fechas y horas El formato de toda fecha del JSON:
2026-08-06T10:30:00-05:00. La zona no es opcional, y sin ella la fecha se interpreta contra otro huso. iso.org - RFC 3339 — el perfil de ISO 8601 que usa internet La versión estricta y con ejemplos. Es más corto de leer que ISO 8601 y basta para escribir una fecha correcta. datatracker.ietf.org
- ISO 3166 — códigos de país El código de dos letras del país en las ubicaciones:
COColombia. Aparece en el emisor, en el receptor y en la factura de exportación. iso.org - ISO 639 — códigos de idioma El código del idioma del documento:
esespañol. Se pide en los documentos con contraparte del exterior. iso.org - ISO 4217 — códigos de moneda El código de tres letras de la moneda:
COP,USD,EUR. Es el que decide en qué moneda están los totales, y en moneda extranjera obliga a informar la tasa. iso.org - UN/CEFACT — recomendaciones de codificación La Recomendación 20 es la lista de unidades de medida del campo
unidadde cada ítem:94unidad,KGMkilogramo,HURhora. unece.org
Autorización, HTTP y herramientas
Lo que rodea a la petición: cómo se compone la credencial, qué significa cada código de respuesta y con qué se prueba antes de escribir código.
- JWT — sitio de referencia Decodifica un token y muestra lo que lleva dentro. Es la forma rápida de comprobar qué datos de origen quedaron en la credencial y cuándo vence. jwt.io
- RFC 7519 — JSON Web Token La especificación del formato: cómo se compone, cómo se firma y qué garantiza la firma. datatracker.ietf.org
- Códigos de respuesta HTTP El significado general de cada código. Lo que cada uno quiere decir en este servicio está en la sección de respuestas de cada ficha. developer.mozilla.org
- Documentación de Postman Variables, entornos y ejecución de colecciones, para sacarle partido a la colección que exporta el portal. learning.postman.com
Un enlace roto es un enlace que cambió de sitio
Las direcciones de la DIAN se reorganizan de vez en cuando, y un anexo técnico se reemplaza por su versión siguiente sin que la anterior desaparezca. Si una de estas páginas no responde, búscala desde el Sistema de facturación electrónica, que es la entrada estable, y avísanos para corregirla aquí.