Errores de nómina electrónica DIAN: códigos NIE y qué revisar
Consulta doce códigos del anexo oficial: mensaje, rechazo o notificación y comprobación sugerida. Incluye NIE017, NIE033 y CUNE. Revisa la respuesta DIAN completa antes de reenviar (art. 1.5.3.5.1.7).
Revisado el 21 de septiembre de 2026.
Primero distingue rechazo, notificación y ausencia de respuesta
La Resolución 227/2025, art.1.5.3.5.1.7, distingue Documento validado por la DIAN y Documento Rechazado por la DIAN. En la tabla de reglas del anexo, R significa rechazo: impide el procesamiento. N significa notificación: advierte un posible problema sin impedirlo (anexo v1.0, apartado 2.4, p.13).
Un error de conexión o la palabra enviado del proveedor no es una respuesta de validación. Consulta el resultado del envío antes de generar duplicados. Si hay rechazo, corrige las causas y repite el procedimiento hasta obtener validación; una notificación aislada no permite afirmar rechazo.
Cómo leer este catálogo de códigos
El artículo 1.5.3.7.1 de la Resolución 227/2025 incorpora el anexo v1.0. Contrastamos estos doce códigos con sus tablas oficiales el 21 de septiembre de 2026. Son una selección de reglas de NominaIndividual; no un catálogo completo ni códigos de factura electrónica o de notas de ajuste.
La columna Mensaje se reproduce por separado de nuestras indicaciones de revisión. Se normalizan saltos de línea y el guion tipográfico del PDF. Si tu respuesta trae otra versión, otro código o texto adicional, conserva el mensaje íntegro y confirma con el proveedor la regla aplicable.
La DIAN publica Memorias de casos recurrentes de habilitación, NIE017/NIE033 y formato XML. Esa fuente orienta la selección; no tenemos una estadística actual que ordene estos doce códigos por frecuencia.
| Código | Efecto en el anexo | Campo |
|---|---|---|
| NIE017 | R · rechazo | ProveedorXML/@NIT |
| NIE018 | R · rechazo | ProveedorXML/@DV |
| NIE019 | R · rechazo | ProveedorXML/@SoftwareID |
| NIE020 | R · rechazo | ProveedorXML/@SoftwareSC |
| NIE023 | R · rechazo | InformacionGeneral/@Ambiente |
| NIE024 | R · rechazo | InformacionGeneral/@CUNE |
| NIE025 | R · rechazo | InformacionGeneral/@EncripCUNE |
| NIE033 | R · rechazo | Empleador/@NIT |
| NIE034 | R · rechazo | Empleador/@DV |
| NIE045 | R · rechazo | Trabajador/@NumeroDocumento |
| NIE012 | R · rechazo | NumeroSecuenciaXML/@Numero |
| NIE009 | N · notificación | NumeroSecuenciaXML/@CodigoTrabajador |
NIE017: NIT del proveedor de software · rechazo
Mensaje del anexo: «Se debe colocar el NIT sin guiones ni DV de la empresa dueña del Software que genera el Documento, debe estar registrado en la DIAN» (v1.0, p.185; página 215 del PDF).
Qué revisar: Pide al proveedor revisar su identificación y registro en el ambiente usado. Este campo identifica a la empresa dueña del software; no lo sustituyas automáticamente por el NIT de tu empresa.
NIE018: DV del proveedor de software · rechazo
Mensaje del anexo: «Se debe colocar el DV de la empresa dueña del Software que genera el Documento, debe estar registrado en la DIAN» (v1.0, p.185; página 215 del PDF).
Qué revisar: Comprueba el dígito de verificación asociado al NIT del proveedor. NIT y DV son campos separados; no pegues el identificador completo en ambos.
NIE019: identificador del software · rechazo
Mensaje del anexo: «Identificador del software asignado cuando el software se activa en el Sistema de Documento Soporte de Pago de Nómina Electrónica, debe corresponder a un software autorizado para este Emisor» (v1.0, p.185; página 215 del PDF).
Qué revisar: Comprueba que el software esté autorizado para este emisor y ambiente. El proveedor debe revisar la configuración de habilitación; no cambies el identificador al azar.
NIE020: código de seguridad del software · rechazo
Mensaje del anexo: «Se debe indicar el Software Security Code según la definición establecida.» (v1.0, p.185; página 215 del PDF).
Qué revisar: Solicita al proveedor revisar el cálculo de SoftwareSC según el numeral 8.3. No publiques el PIN ni credenciales en capturas, foros o solicitudes abiertas.
NIE023: ambiente de envío · rechazo
Mensaje del anexo: «Se debe colocar el Codigo correspondiente» (v1.0, p.186; página 216 del PDF).
Qué revisar: Contrasta el ambiente del XML con la tabla 5.1.1 del anexo y con el servicio al que lo envías. Una prueba de habilitación no es un envío en producción.
NIE024: CUNE · rechazo
Mensaje del anexo: «Se debe indicar el CUNE según la definición establecida.» (v1.0, p.186; página 216 del PDF).
Qué revisar: Pide recalcular el CUNE con los datos y formato del numeral 8.1. Si se cambió un valor del documento, no conserves un CUNE calculado con datos anteriores.
NIE025: algoritmo del CUNE · rechazo
Mensaje del anexo: «Debe ir la palabra "CUNE-SHA384"» (v1.0, p.186; página 216 del PDF).
Qué revisar: Comprueba el literal CUNE-SHA384 del atributo. Revisar este campo no reemplaza la comprobación del valor CUNE del documento.
NIE033: NIT del empleador · rechazo
Mensaje del anexo: «Debe ir el NIT del Empleador sin guiones ni DV» (v1.0, p.187; página 217 del PDF).
Qué revisar: Usa el NIT del empleador real sin guiones ni dígito de verificación en este campo. No lo confundas con ProveedorXML/@NIT.
NIE034: DV del empleador · rechazo
Mensaje del anexo: «Debe ir el DV del Empleador» (v1.0, p.187; página 217 del PDF).
Qué revisar: Comprueba el dígito del NIT del empleador contra su identificación tributaria; debe ir separado del NIT.
NIE045: documento del trabajador · rechazo
Mensaje del anexo: «Debe ir el Numero de documento del trabajador, sin puntos ni comas ni espacios» (v1.0, p.187; página 217 del PDF).
Qué revisar: Contrasta el documento del trabajador con su soporte y elimina separadores de presentación. No cambies la identidad para conseguir que el envío valide.
NIE012: número del documento · rechazo
Mensaje del anexo: «No se permiten caracteres adicionales como espacios o guiones. Debe corresponder a Prefijo + Número consecutivo del documento» (v1.0, p.184; página 214 del PDF).
Qué revisar: Verifica que Numero corresponda al prefijo y consecutivo del documento, sin espacios o guiones adicionales. Revisa el estado del envío anterior antes de crear otro consecutivo.
NIE009: código interno del trabajador · notificación
Mensaje del anexo: «Se debe indicar el Codigo del Trabajador.» (v1.0, p.184; página 214 del PDF).
Qué revisar: El anexo clasifica esta regla como notificación y describe el campo como opcional, de manejo interno del empleador. Revisa la advertencia y el estado final de la respuesta: este código por sí solo no prueba rechazo.
Regla 92: revisa la habilitación y el método de consulta
Las Memorias DIAN tratan conjuntamente Regla 92, NIE017 y NIE033 en el contexto de pruebas. No son tres nombres para una misma regla ni toda aparición de NIE017/NIE033 demuestra la misma causa.
Para el set de habilitación, la DIAN describe SendTestSetAsync, que entrega ZipKey, y su consulta mediante GetStatusZip. GetStatus consulta con el CUNE, no con ZipKey. Después de superar el set y verificar que el software aparece habilitado en pruebas, las Memorias describen SendNominaSync y su AppResponse. Pide al proveedor confirmar el estado y método utilizados; no cambies a producción para eludir una prueba pendiente.
No copiamos aquí una cuota de pruebas histórica como si fuera garantía de la configuración vigente. Confirma el set asignado en tu ambiente y conserva el resultado real de habilitación.
Formato XML y soporte: qué entregar al proveedor
La DIAN recomienda revisar tamaño y formato de campos, orden de elementos según XSD y no inventar elementos XML. Entrega por el canal privado acordado el código, mensaje íntegro, fecha, ambiente, versión del software y referencia del envío. El proveedor puede necesitar el XML y AppResponse o ZipKey para diagnosticar; no publiques datos de trabajadores, PIN ni credenciales en un foro abierto.
Un XML rechazado no se arregla automáticamente con una nota de ajuste. Primero identifica si el documento anterior fue validado y cuál es la causa; la nota para reemplazar o eliminar se rige por el art.1.5.3.5.1.9. Guarda la respuesta final y revisa aparte importes y tratamiento tributario: la validación no certifica exactitud salarial ni deducibilidad (art.1.5.3.5.1.8).
Paso a paso
- Obtén la respuesta DIAN. Distingue validado, rechazado o ausencia de respuesta. Consulta el envío anterior antes de crear otro.
- Localiza código, campo y efecto. Contrasta código y mensaje completos con la versión del anexo. N y R no significan lo mismo.
- Corrige la causa con el proveedor. Revisa identidad, ambiente, software o formato señalado. No inventes datos para forzar una validación.
- Verifica y conserva el resultado. Tras corregir un rechazo, vuelve a validar y guarda documento y respuesta DIAN. Revisa aparte el cálculo de nómina.
Preguntas frecuentes
¿NIE017 y NIE033 identifican el mismo NIT?
No. NIE017 corresponde a ProveedorXML/@NIT y NIE033 a Empleador/@NIT. Confundirlos puede sustituir la identidad correcta por la del otro participante.
¿NIE009 significa rechazo?
El anexo v1.0 lo marca N: notificación. Revisa la respuesta final y las demás reglas; ese código por sí solo no demuestra rechazo.
¿Qué revisar en NIE024?
El CUNE de InformacionGeneral, calculado según el numeral 8.1. Debe corresponder a los datos del documento; el proveedor debe revisar su generación.
¿Son los doce errores más frecuentes?
No afirmamos un ranking. Son doce reglas verificadas en el anexo; las Memorias DIAN describen algunos casos como recurrentes, sin una distribución actual de frecuencias.
¿Validado significa que el cálculo salarial es correcto?
No. El art.1.5.3.5.1.8 mantiene la responsabilidad sobre exactitud y requisitos en el sujeto obligado.
Fuentes consultadas
- DIAN, Resolución Única 000227/2025, capítulo de nómina electrónica (leída el 21 de septiembre de 2026)
- DIAN, anexo técnico nómina v1.0: mensajes y efecto, pp.184–187 (PDF pp.214–217) (leída el 21 de septiembre de 2026)
- DIAN, convenciones R/N del anexo, p.13 (PDF p.43) (leída el 21 de septiembre de 2026)
- DIAN, Memorias de casos recurrentes: habilitación, regla 92, NIE017 y NIE033 (leída el 21 de septiembre de 2026)
Aviso legal y de uso
NominaCheck CO es una herramienta informativa de comparación de costos y opciones de contratación en Colombia. No constituye asesoría laboral, contable, fiscal, ni jurídica.
Los cálculos se basan en tasas y regulaciones oficiales colombianas vigentes a la fecha indicada en cada resultado, e incorporan supuestos simplificados para fines comparativos. Las cifras son estimaciones aproximadas; el costo real depende de la convención colectiva aplicable, la caja de compensación, la clase de riesgo ARL exacta, el municipio, las exoneraciones tributarias aplicables (Ley 1607 art 25), y el contrato específico.
Consulte siempre con un contador público o abogado laboral colombiano antes de tomar decisiones de contratación, terminación, reclasificación, o estructuración societaria.
Esta herramienta puede contener enlaces de afiliado a plataformas de EOR (Deel, Remote, Multiplier, Oyster u otras). Cuando contrata a través de uno de estos enlaces, recibimos una comisión sin costo adicional para usted. El orden de los proveedores se basa en el ajuste a sus inputs, no en el monto de la comisión.
Última actualización del modelo: 2026-09-07.