Colombia / Guía

XML de la nómina electrónica de la DIAN: verlo

Suelta el XML de la nómina electrónica o de su nota de ajuste. Verás el empleador, el trabajador, el periodo, cada devengado y cada deducción, el total pagado y el CUNE.

Suelta aquí el XML de la nómina

Puedes soltar varios a la vez, por ejemplo los de todo un año, y pasarlos a Excel.

Tus archivos no salen de tu equipo

Qué es

Es el documento soporte de pago de nómina electrónica que creó la Resolución 000013 de 2021. Lo generan los contribuyentes del impuesto sobre la renta que pagan salarios o pensiones y quieren soportar ese costo (artículo 4). Se genera uno por trabajador y por mes, con lo pagado en el mes anterior (artículo 3), y se transmite a la DIAN dentro de los diez primeros días del mes siguiente (artículo 8).

Cómo está armado el XML

No es UBL como la factura. La raíz es NominaIndividual (código 102) y casi todos los datos van en atributos, no en el texto de las etiquetas: por ejemplo <Basico DiasTrabajados="30" SueldoTrabajado="..."/>. La estructura es la del anexo técnico versión 1.0, que es la que la DIAN publica en su documentación técnica junto con la caja de herramientas (XSD 1.0.6 y XML de ejemplo). Los bloques que importan:

InformacionGeneral: fecha y hora de generación, PeriodoNomina (1 semanal a 5 mensual), moneda, ambiente y el CUNE.
Periodo: fecha de ingreso, de retiro si la hay, y las fechas de inicio y fin de la liquidación. FechasPagos trae cada fecha de pago.
Empleador y Trabajador: NIT y razón social del empleador; tipo y número de documento, nombres, tipo de contrato, sueldo y tipo de trabajador del empleado. Pago trae la forma, el medio y el banco.
Devengados: salario básico, auxilio de transporte, horas extra y recargos, vacaciones, primas, cesantías, incapacidades, licencias, bonificaciones y otros conceptos.
Deducciones: salud, pensión, fondo de solidaridad pensional, sindicatos, libranzas, retención en la fuente y otras.
DevengadosTotal, DeduccionesTotal y ComprobanteTotal, que debe ser la diferencia entre los dos primeros.

La nota de ajuste tiene raíz NominaIndividualDeAjuste (código 103) y un TipoNota: con 1 trae un bloque Reemplazar con la nómina corregida completa; con 2 trae un bloque Eliminar solo con el empleador. Las dos dicen el número, el CUNE y la fecha de la nómina que ajustan.

Cómo la muestra el visor

Arriba van el empleador con su NIT y, como receptor, el trabajador con su documento.
Cada devengado es una línea en positivo y cada deducción una línea en negativo, con los días o las horas y el porcentaje cuando el XML los trae. Los conceptos en cero no se muestran.
En los totales, «Subtotal» es el total devengado, «Descuentos» el total deducido y «Total» el valor pagado. Si las líneas no cuadran con el total, sale una advertencia.
En los datos del documento aparecen el periodo liquidado, la fecha de pago, el periodo de nómina, el sueldo, el tipo de contrato y el medio de pago con el banco.
Pulsa «Guardar PDF» o, con varias nóminas, «Descargar Excel», que trae una hoja de documentos y otra con cada concepto.

Errores comunes

Buscar el CUFE. La nómina no tiene CUFE: su código es el CUNE.
Buscar los valores en el texto de las etiquetas. Casi todos van en atributos; un lector de XML pensado para la factura los pasa por alto.
Esperar una nómina por cada pago quincenal. El documento es mensual y junta los pagos del mes.

Preguntas frecuentes

¿Qué es el CUNE?

El código único del documento soporte de pago de nómina electrónica. Es un SHA-384 de 96 caracteres que va en el atributo CUNE de InformacionGeneral. El visor lo muestra al final del documento.

¿Por qué hay una sola nómina electrónica al mes si me pagan cada quincena?

Porque el artículo 3 de la Resolución 000013 de 2021 pide generarla de forma mensual, acumulando los pagos del mes anterior, aunque se paguen por periodos más cortos. Se transmite a la DIAN dentro de los diez primeros días del mes siguiente (artículo 8).

¿El PDF que guarda el visor es la representación gráfica de la nómina?

No. La representación gráfica la expide el empleador si quiere, con la información mínima de la resolución y un código QR para consultar el documento (artículo 24). El PDF del visor es una vista de los datos del XML y no lleva ese código.

¿Abre también la nota de ajuste?

Sí. En la nota de tipo 1 (Reemplazar) muestra los valores nuevos y el número de la nómina reemplazada; en la de tipo 2 (Eliminar), qué nómina anula.

¿Mis archivos se suben a algún servidor?

No. Se leen dentro de tu navegador y no se envían a ningún lado, lo que importa aquí porque el XML trae el documento, el salario y a veces la cuenta bancaria del trabajador. Puedes comprobarlo en la pestaña Red de las herramientas del navegador mientras cargas un archivo.

Fuentes oficiales

Fuentes consultadas el 21 de octubre de 2026.

Más guías de Colombia: estructura del XML y CUFE, AttachedDocument, ZIP de la factura, nota crédito, descargar el XML, documento soporte. Para el recibo de nómina de México, mira el CFDI de nómina. O vuelve al visor de Colombia.