Colombia / Guía
Estructura del XML de la factura electrónica de la DIAN
Suelta un XML y mira cada parte ya armada; abajo está qué elemento del XML corresponde a cada dato.
Suelta aquí tus archivos XML o ZIP
Puedes soltar varios a la vez. Si recibiste un ZIP, suéltalo sin abrirlo.
Tus archivos no salen de tu equipo
Las partes del XML
La factura electrónica de venta es un XML en UBL 2.1 cuya estructura define el anexo técnico 1.9 de la DIAN. Estas son las partes que más se buscan, con el elemento donde están:
- Extensiones y firma:
ext:UBLExtensions, con los datos de la DIAN (resolución de numeración, proveedor del software, código QR) y la firma digital. - Número:
cbc:ID, el prefijo y el consecutivo. - CUFE:
cbc:UUID, con el atributoschemeName="CUFE-SHA384". - Fecha y hora:
cbc:IssueDateycbc:IssueTime. - Tipo de factura:
cbc:InvoiceTypeCode(01 factura de venta, 02 exportación, 03 y 04 contingencia). - Emisor y adquirente:
cac:AccountingSupplierPartyycac:AccountingCustomerParty, con NIT, razón social y dirección. - Impuestos: cada
cac:TaxTotaltrae un impuesto (IVA, INC, ICA y otros) con su base, tarifa y valor. - Totales:
cac:LegalMonetaryTotal, con el valor antes de impuestos y el total a pagar. - Líneas: un
cac:InvoiceLinepor producto o servicio.
Las tablas de códigos (tipos de documento, impuestos, conceptos de corrección) están en la caja de herramientas 1.9 de la DIAN.
Qué es el CUFE y cómo consultar una factura
El CUFE (código único de factura electrónica) identifica cada factura; las notas y demás documentos usan el CUDE (anexo 1.9, sección 5.2.2). Se calcula con SHA-384 y por eso es una cadena larga de letras y números. La DIAN permite buscar un documento en catalogo-vpfe.dian.gov.co con el CUFE y el NIT del emisor o del receptor. El código QR de la representación gráfica apunta a esa misma consulta.
Cómo verlo con el visor
- Suelta el XML o el ZIP arriba.
- La factura aparece armada: emisor, adquirente, líneas, impuestos con su tarifa, total y, al final, el CUFE.
- Copia el CUFE desde ahí si quieres consultarlo en la DIAN.
Errores comunes
- Buscar el CUFE en el contenedor. En un AttachedDocument, el CUFE está en la factura de adentro y también en la parte de la validación. El visor lo toma de la factura.
- Leer el XML de pruebas como si fuera real. Los documentos generados en el ambiente de habilitación usan una consulta distinta (catalogo-vpfe-hab).
- Totales que no cuadran. Si la suma de las líneas e impuestos no coincide con el total, el visor muestra una advertencia con las dos cifras.
Preguntas frecuentes
¿En qué formato está la factura electrónica de la DIAN?
En XML con el estándar UBL 2.1, según el anexo técnico de factura electrónica de venta versión 1.9.
¿Dónde está el CUFE en el XML?
En el elemento cbc:UUID de la factura, con el atributo schemeName «CUFE-SHA384». El visor lo muestra al final de la factura abierta.
¿Qué diferencia hay entre CUFE y CUDE?
El CUFE identifica facturas de venta. El CUDE identifica los demás documentos electrónicos, como las notas crédito y débito.
¿Cómo consulto una factura con su CUFE?
En la búsqueda de documentos de catalogo-vpfe.dian.gov.co, escribiendo el CUFE y el NIT del emisor o del receptor.
¿Mis archivos se suben a algún servidor?
No. Se leen dentro de tu navegador y no se envían a ningún lado. Puedes comprobarlo en la pestaña Red de las herramientas del navegador mientras cargas un archivo.
Fuentes oficiales
- Anexo técnico de factura electrónica de venta, versión 1.9 (DIAN)
- Caja de herramientas 1.9 (DIAN)
- Buscar documento por CUFE (DIAN)
- Documentación técnica vigente (DIAN)
Más guías de Colombia: AttachedDocument, ZIP de la factura, nota crédito. O vuelve al visor de Colombia.