Colombia: documentación del ambiente de pruebas (habilitación DIAN). No hay ambiente de producción.

📅 Versión

V1.0 · desde 04/09/2026 · DIAN Anexo Técnico v1.9

🏛️ Autoridad

DIAN
8
Secciones
88
Campos documentados
6
Tipos de documento
4
Ejemplos XML/JSON
🟧
Formato XML
Documentación interactiva de cada elemento del NUC en formato XML. Validaciones, ejemplos y referencias cruzadas.
Explorar XML →
🟦
Formato JSON
Misma estructura del NUC pero en JSON. Equivalencias campo por campo con XML.
Explorar JSON →
📐
Esquemas
NUCSchema.xsd y NUCSchema.json descargables. Para validación local.
Descargar esquemas →
📦
Ejemplos
4 ejemplos reales en XML y JSON. Listos para copiar y descargar.
Ver ejemplos →

El NUC V1.0 se organiza en 8 secciones. Cada una lleva a su tabla de campos:

4.2Elemento raíz del NUC5 campos4.3Información general del documento (Header)11 campos4.4Información del emisor (Seller)17 campos4.5Información del adquirente (Buyer)10 campos4.6Ítems del documento (Items)17 campos4.7Totales (Totals)11 campos4.8Pagos (Payments)6 campos4.9Información adicional y referencia de notas (AdditionalDocumentInfo)11 campos

Cada documento en Colombia se identifica por su DocType en el header del NUC. Estos son los 6 tipos soportados:

Facturas

01Factura electrónica de Venta

Tipo de documento 01 según Header.DocType (alias NUC aceptados: FE o 01). El API lo transforma a UBL 2.1 con raíz Invoice, cbc:InvoiceTypeCode 01, cbc:CustomizationID 10 (Estándar), ProfileID "DIAN 2.1: Factura Electrónica de Venta" y UUID CUFE-SHA384.

02Factura electrónica de venta - exportación

Tipo de documento 02 según Header.DocType (alias NUC: FX o 02). NO SOPORTADO AÚN de punta a punta: el API lo acepta y emite cbc:InvoiceTypeCode 02, pero con CustomizationID fijo 10 (no 04 Exportación) y sin la extensión de Interoperabilidad para exportación (Suplemento K).

03Documento electrónico de transmisión - tipo 03

Tipo de documento 03 según Header.DocType. NO SOPORTADO AÚN: el API lo acepta y lo emite como Invoice, pero el procedimiento de contingencia del facturador (§12.1) no está implementado.

04Factura electrónica de Venta - tipo 04

Tipo de documento 04 según Header.DocType. NO SOPORTADO AÚN: el flujo de contingencia DIAN (§12.2: reintentos, re-firma, AttachedDocument, retransmisión en 48 h) no está implementado en el backend.

Notas

91Nota Crédito

Tipo de documento 91 según Header.DocType (alias NUC: NC o 91). El API emite UBL 2.1 con raíz CreditNote, cbc:CreditNoteTypeCode 91, cbc:CustomizationID 20, ProfileID "DIAN 2.1: Nota Crédito de Factura Electrónica de Venta" y UUID CUDE-SHA384, más cac:DiscrepancyResponse y cac:BillingReference.

92Nota Débito

Tipo de documento 92 según Header.DocType (alias NUC: ND o 92). El API emite UBL 2.1 con raíz DebitNote (sin type code: UBL 2.1 DebitNote-2 no lo define), cbc:CustomizationID 30, ProfileID "DIAN 2.1: Nota Débito de Factura Electrónica de Venta", UUID CUDE-SHA384 y totales en cac:RequestedMonetaryTotal.


Información adicional que se anexa al NUC dentro deAdditionalDocumentInfosegún el tipo de operación.