T5.4 Resolución 000013 de 11-02-2021.pdf

Anexo T5.4 Documento Soporte de Pago de Nómina Electrónica – Versión 1.0

Dirección de Gestión de Ingresos Carrera 8 Nº 6C-38 piso 6º PBX 607 9999 – 382 4500 Ext. 905101 Código postal 111711 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN

Página 1 de 324

Dirección de Impuestos y Aduanas Nacionales

Anexo Técnico Documento Soporte de Pago de Nómina Electrónica

Versión 1.0Anexo T5.4 Documento Soporte de Pago de Nómina Electrónica – Versión 1.0

Dirección de Gestión de Ingresos Carrera 8 Nº 6C-38 piso 6º PBX 607 9999 – 382 4500 Ext. 905101 Código postal 111711 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN

Página 2 de 324

Contenido

1. Introducción. ................................ ................................ ................................ ............................ 6 1.1. Calidad de la información: las Validaciones. ................................ ................................ ..... 7 1.1.1. Redondeos. ................................ ................................ ................................ ................ 7 1.1.2. Identificador de los documentos electrónicos. ................................ ............................ 8 1.1.3. Valores Negativos. ................................ ................................ ................................ ..... 9

2. Convenciones utilizadas en las tablas. ................................ ................................ .................... 9 2.1. Columnas de las tablas de definición. ................................ ................................ ............... 9

1.1.3. Valores Negativos. ................................ ................................ ................................ ..... 9

2. Convenciones utilizadas en las tablas. ................................ ................................ .................... 9 2.1. Columnas de las tablas de definición. ................................ ................................ ............... 9 2.2. Tipos de campos de los archivos XML. ................................ ................................ ........... 10 2.3. Tamaños de los elementos. ................................ ................................ ............................ 11 2.4. Convenciones utilizadas en las Tablas de Reglas de Validación. ................................ ... 13

3. Formato para la generación de los Documentos Electrónicos. ................................ .............. 14 3.1. Documento Soporte de Pago de Nómina Electrónica: NominaIndividual. ....................... 14 3.2. Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica: NominaIndividualDeAjuste. ................................ ................................ ................................ .... 62 3.3. Estándar del nombre del documento electrónico Documento Soporte de Pago de Nómina Electrónica XML. ................................ ................................ ................................ .................. 125 3.4. Estándar del nombre del documento electrónico Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica XML. ................................ ................................ ................. 125 3.5. Guía del nombre del archivo que contiene uno o más documentos electrónicos y que será entregado a la DIAN mediante un web service de recepción. ................................ ...... 126 3.6. firma digital del documento: ds:Signature................................. ................................ ..... 128 3.7. Respuesta DIAN con validaciones de documentos Nomina: ApplicationResponse. ...... 140 3.7.1. Garantía de que el evento será registrado en el documento correcto. .................... 140 3.7.2. Relacionamientos mutuos entre los eventos. ................................ .......................... 141 3.7.3. Detalles de cada evento. ................................ ................................ ........................ 141

4. Inconvenientes tecnológicos. ................................ ................................ ............................... 153

3.7.2. Relacionamientos mutuos entre los eventos. ................................ .......................... 141 3.7.3. Detalles de cada evento. ................................ ................................ ........................ 141

4. Inconvenientes tecnológicos. ................................ ................................ ............................... 153 4.1. Por parte del Sujeto Obligado. ................................ ................................ ...................... 153 4.2. Por parte de la DIAN. ................................ ................................ ................................ .... 153

5. Tablas de Contenidos de Elementos y de Atributos................................. ............................ 153 5.1. Códigos Relacionados con Documentos. ................................ ................................ ...... 154 5.1.1. Ambiente de Destino del Documento: Ambiente. ................................ .................... 154 5.1.2. Algoritmo: EncripCUNE. ................................ ................................ ......................... 154 5.2. Códigos para identificación fiscal. ................................ ................................ ................. 154 5.2.1. Documento de identificación (Tipo de Identificador Fiscal): TipoDocumento. ......... 154 5.3. Códigos Diversos. ................................ ................................ ................................ ......... 155 5.3.1. Lenguaje (ISO 639): Idioma. ................................ ................................ ................... 155 5.3.2. Moneda (ISO 4217): TipoMoneda. ................................ ................................ ......... 158 5.3.3. Pagos. ................................ ................................ ................................ .................... 163Anexo T5.4

Documento Soporte de Pago de Nómina Electrónica – Versión 1.0

Dirección de Gestión de Ingresos Carrera 8 Nº 6C-38 piso 6º PBX 607 9999 – 382 4500 Ext. 905101 Código postal 111711 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN

Página 3 de 324

5.4. Códigos Geográficos. ................................ ................................ ................................ ... 165

Código postal 111711 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN

Página 3 de 324

5.4. Códigos Geográficos. ................................ ................................ ................................ ... 165 5.4.1. Países (ISO 3166-1): Pais. ................................ ................................ ..................... 165 5.4.2. Departamentos (ISO 3166-2:CO): Departamento. ................................ .................. 177 5.4.3. Municipios: Municipio. ................................ ................................ ............................ 178 5.5. Campos Nómina. ................................ ................................ ................................ .......... 211 5.5.1. Periodo de Nómina: PeriodoNomina. ................................ ................................ ..... 211 5.5.2. Tipo de Contrato: TipoContrato. ................................ ................................ ............. 211 5.5.3. Tipo de Trabajador: TipoTrabajador. ................................ ................................ ...... 211 5.5.4. Subtipo de Trabajador: SubTipoTrabajador. ................................ ........................... 212 5.5.5. Tipo de Hora Extra o Recargo: Porcentaje. ................................ ............................ 212 5.5.6. Tipo de Incapacidad: Tipo. ................................ ................................ ..................... 212 5.5.7. Tipo de XML: TipoXML. ................................ ................................ .......................... 212 5.5.8. Tipo de Nota de Ajuste: TipoNota. ................................ ................................ .......... 212

6. Reglas y Mensajes de Validación. ................................ ................................ ....................... 214 6.1. Documentos Electrónicos. ................................ ................................ ............................ 214 6.1.1. Documento Soporte de Pago de Nómina Electrónica: NominaIndividual. ............... 214 6.1.2. Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica: NominaIndividualDeAjuste. ................................ ................................ ............... 240

6.1.2. Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica: NominaIndividualDeAjuste. ................................ ................................ ............... 240 6.1.3. Firma Digital del Documento: ds:Signature. ................................ ............................ 273 6.2. Reglas Relativas al Establecimiento de la Conexión. ................................ .................... 287 6.2.1. Mensaje del Web Service. ................................ ................................ ...................... 287 6.2.2. Schema XML. ................................ ................................ ................................ ......... 288 6.2.3. Certificado Digital de Transmisión (conexión). ................................ ........................ 288 6.2.4. Certificado Digital de Firma (Firma XML). ................................ ............................... 289 6.2.5. Firma. ................................ ................................ ................................ ..................... 289 Abreviaturas Utilizadas. ................................ ................................ ................................ ........... 289

7. Política de firma. ................................ ................................ ................................ .................. 291 7.1. Observaciones. ................................ ................................ ................................ ............. 291 7.2. Consideraciones Generales. ................................ ................................ ......................... 291 7.3. Especificaciones técnicas sobre la firma digital Avanzada. ................................ ........... 291 7.4. Alcance de la Política de Firma. ................................ ................................ .................... 292 7.5. Política de Firma. ................................ ................................ ................................ .......... 292 7.5.1. Actores de la Firma. ................................ ................................ ............................... 292 7.5.2. Formato de Firma. ................................ ................................ ................................ .. 292 7.6. Algoritmo de Firma. ................................ ................................ ................................ ....... 293 7.7. Algoritmo de Organización de Datos según el Canon. ................................ .................. 293 7.8. Ubicación de la Firma. ................................ ................................ ................................ .. 293 7.9. Condiciones de la Firma. ................................ ................................ .............................. 293 7.10. Identificador de la Política. ................................ ................................ .......................... 295

7.8. Ubicación de la Firma. ................................ ................................ ................................ .. 293 7.9. Condiciones de la Firma. ................................ ................................ .............................. 293 7.10. Identificador de la Política. ................................ ................................ .......................... 295 7.11. Hora de Firma. ................................ ................................ ................................ ............ 296 7.12. Firmante................................. ................................ ................................ ..................... 296Anexo T5.4 Documento Soporte de Pago de Nómina Electrónica – Versión 1.0

Dirección de Gestión de Ingresos Carrera 8 Nº 6C-38 piso 6º PBX 607 9999 – 382 4500 Ext. 905101 Código postal 111711 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN

Página 4 de 324

7.13. Mecanismo de firma digital................................. ................................ ......................... 296 7.14. Certificado digital desde la vigencia de la circular 03-2016 de la ONAC. .................... 296

8. Mecanismos de Control del Documento Soporte de Pago de Nómina Electrónica y Nota de Ajuste del Documento Soporte de Pago de Nómina Electrónica. ................................ ............ 301 8.1. Especificación Técnica de Generación Del CUNE. ................................ ....................... 301 8.1.1. Consideraciones Generales del CUNE. ................................ ................................ .. 301 8.2. Especificacón Técnica Del Código De Seguridad Del Software. ................................ ... 304 8.3. Métodos de Calculo. ................................ ................................ ................................ ..... 305 8.3.1. Cálculo de Tiempo Laborado ................................ ................................ .................. 305

9. Descripciónes Tecnológicas del Web Services de Método Síncrono. ................................ .. 305 9.1. Modelo conceptual de comunicación. ................................ ................................ ........... 305

8.3.1. Cálculo de Tiempo Laborado ................................ ................................ .................. 305

9. Descripciónes Tecnológicas del Web Services de Método Síncrono. ................................ .. 305 9.1. Modelo conceptual de comunicación. ................................ ................................ ........... 305 9.2. Servicio síncrono. ................................ ................................ ................................ ......... 306 9.2.1. Secuencia del servicio síncrono. ................................ ................................ ............ 306 9.3. Aspectos tecnológicos de las operaciones del web service. ................................ ......... 306 9.4. Estándar de comunicación. ................................ ................................ ........................... 307 9.5. Estándar de mensajes de los servicios de La DIAN. ................................ ..................... 307 9.6. Descripción de los servicios web de La DIAN. ................................ .............................. 308 9.7. WS recepción documento electrónico – SendNominaSync. ................................ .......... 308 9.7.1. Descripción de procesamiento................................. ................................ ............... 308 9.7.2. Mensaje de petición. ................................ ................................ ............................... 308 9.8. WS Consulta del estado de DE – GetStatus. ................................ ................................ 310 9.8.1. Descrición de procesamiento. ................................ ................................ ................ 310 9.8.2. Mensaje de petición. ................................ ................................ ............................... 310

10. Campos definidos en las extensiones................................. ................................ ............... 313 10.1. Estructura para reporte de información adicional específica de cada sector. .............. 313

11. Elemento Novedad. ................................ ................................ ................................ ........... 313

12. Preguntas Frecuentes. ................................ ................................ ................................ ...... 314

13. Servicio de Consulta. ................................ ................................ ................................ ......... 314 13.1. Servicio de consulta a través de Código Bidimensional QR. ................................ ....... 314

14. Anexo: Herramienta para el consumo de Web Services. ................................ ................... 317 14.1. Introducción ................................ ................................ ................................ ................ 317

13.1. Servicio de consulta a través de Código Bidimensional QR. ................................ ....... 314

14. Anexo: Herramienta para el consumo de Web Services. ................................ ................... 317 14.1. Introducción ................................ ................................ ................................ ................ 317 14.2. Descargar SOAP UI. ................................ ................................ ................................ ... 317 14.3. Ejecutar SOAP UI. ................................ ................................ ................................ ...... 317 14.4. Crear un nuevo proyecto tipo SOAP. ................................ ................................ .......... 317 14.5. Configuración inicial. ................................ ................................ ................................ ... 318 14.6. Configurar Keystore. ................................ ................................ ................................ ... 318 14.7. Configurar WS-Security Signature. ................................ ................................ ............. 319 14.8. Configurar TimeStamp. ................................ ................................ ............................... 319Anexo T5.4

Documento Soporte de Pago de Nómina Electrónica – Versión 1.0

Dirección de Gestión de Ingresos Carrera 8 Nº 6C-38 piso 6º PBX 607 9999 – 382 4500 Ext. 905101 Código postal 111711 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN

Página 5 de 324

14.9. Configurar GetStatus Request, Authentication y WS-A addressing. ............................ 320 14.10. Configurar y ejecutar GetStatus Request. ................................ ................................ . 321 14.11. Configurar y ejecutar SendBillAsync Request. ................................ .......................... 322 14.12. SendBillAsync Response. ................................ ................................ ......................... 323 14.13. Recomendaciones. ................................ ................................ ................................ ... 324

15. Control de cambios. ................................ ................................ ................................ ........... 324Anexo T5.4

Documento Soporte de Pago de Nómina Electrónica – Versión 1.0

Dirección de Gestión de Ingresos

14.13. Recomendaciones. ................................ ................................ ................................ ... 324

15. Control de cambios. ................................ ................................ ................................ ........... 324Anexo T5.4

Documento Soporte de Pago de Nómina Electrónica – Versión 1.0

Dirección de Gestión de Ingresos Carrera 8 Nº 6C-38 piso 6º PBX 607 9999 – 382 4500 Ext. 905101 Código postal 111711 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN

Página 6 de 324

1. Introducción.

El presente anexo técnico describe el Documento Soporte de Pago de Nómina Electrónica y la Nota de Ajuste del Documento Soporte de Pago de Nómina Electrónica , para que sean documentos soporte de costos y deducciones en el impuesto sobre la renta y complementarios, de conformidad con lo dispuesto en el parágrafo 6 del artículo 616-1. El formato No pertenece al Estandar Universal Business Language – UBL. La generación del Documento Soporte de Pago de la Nómina Electrónica y la Nota de Ajuste del Documento Soporte de Pago de Nómina Electrónica poseen las siguientes características:

• Documento Soporte de Pago de Nómina Electrónica (NominaIndividual): Debe existir al menos 1 documento de este tipo por cada empleado que tenga la empresa por mes, el cual corresponde al Comprobante de Nómina de dicho trabajador.

• Nota de Ajuste del Documento Soporte de Pago de Nómina Electrónica

(NominaIndividualDeAjuste): Debe existir 1 documento de este tipo por cada Documento Soporte de Pago de Nómina Electrónica de cada empleado que tenga la empresa el cual

• Nota de Ajuste del Documento Soporte de Pago de Nómina Electrónica

(NominaIndividualDeAjuste): Debe existir 1 documento de este tipo por cada Documento Soporte de Pago de Nómina Electrónica de cada empleado que tenga la empresa el cual se deba ajustar o reemplazar por errores aritméticos contables o de contenido y que el sujeto obligado deberá ajustar o corregir. Este documento electrónico podrá hacerse tantas veces como correcciones se requieran realizar sobre un mismo Documento Soporte de Pago de Nómina Electrónica, siendo la úlima nota de ajuste del documento soporte de pago de nómina electrónica validada, la que sirva como soporte. Este documento también permite eliminar un Documento Soporte de Pago de Nómina Electrónica o una Nota de Ajuste del Documento Soporte de Pago de Nómina Electrónica que el sujeto obligado deba eliminar por errores contables o de procedimiento.

El objetivo de la presente descripción es buscar, una estandarización del Documento Soporte de Pago de Nómina Electrónica y Nota de Ajuste del Documento Soporte de Pago de Nómina Electrónica, permitiendo que la información pueda ser utilizada de la manera más eficaz, eficiente y efectiva posible.

De igual forma se deberá tener en cuenta lo referente al tratamiento de datos personales relacionado con la seguridad de la información que contienen los documentos que por medio de este anexo se implementan, de conformidad con lo previsto en los artículos 17 y 18 de la Ley 1581 de 2012 y la Circular 000001 del 25 de enero de 2019 de la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales -DIAN, las cuales señalan los aspectos relacionados con el tratamiento de datos personales y la se guridad de la

Especial Dirección de Impuestos y Aduanas Nacionales -DIAN, las cuales señalan los aspectos relacionados con el tratamiento de datos personales y la se guridad de la información, los cuales se desarrollan en el CAPÍTULO 9 del TÍTULO 7 de la PARTE 1 de la presente resolución.

Se imponen por lo tanto dos (2) requisitos: confiabilidad y calidad en las informaciones tal como se describe a continuación.Anexo T5.4 Documento Soporte de Pago de Nómina Electrónica – Versión 1.0

Dirección de Gestión de Ingresos Carrera 8 Nº 6C-38 piso 6º PBX 607 9999 – 382 4500 Ext. 905101 Código postal 111711 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN

Página 7 de 324

1.1. Calidad de la información: las Validaciones. En el presente anexo técnico se aclara las limitaciones que se pueden presentar al brindar información en un determinado elemento, tanto de manera lógica, como de manera aritmética.

La aplicación de las reglas de validación puede terminar en uno (1) de los siguientes tres (3) resultados: • Rechazo, si la aplicación de la regla apunta a una discrepancia grave, que indica que las informaciones del archivo no pueden ser utilizadas de manera confiable o de manera legal; • Notificación, si la aplicación de la regla apunta a una discrepancia menos importante, pero que asimismo merece que se advierta al emisor de un posible problema con las informaciones del archivo; • Aprobación, si la aplicación de la regla no apunta a ningún tipo de problema.

Las reglas de validación serán aplicadas en los siguientes momentos:

pero que asimismo merece que se advierta al emisor de un posible problema con las informaciones del archivo; • Aprobación, si la aplicación de la regla no apunta a ningún tipo de problema.

Las reglas de validación serán aplicadas en los siguientes momentos: • Por la DIAN al recibir, del Sujeto Obligado directamente a través de Modalidad Software Propio o a través de un tercero.

1.1.1. Redondeos. Las reglas de validación que contengan operaciones aritméticas relacionadas con valores monetarios deberán cumplir con los siguientes parámetros para su aproximación, dependiendo de la cantidad de decimales definidos para el campo respectivo en las reglas de validación que apliquen:

Dígito siguiente al dígito menos significativo es Redondeo Entre 0 y 4. Mantener el dígito menos significativo. Entre 6 y 9. Incrementar el dígito menos significativo. 5, y el segundo dígito siguiente al dígito menos significativo es cero o par. Mantener el dígito menos significativo. 5, y el segundo dígito siguiente al dígito menos significativo es impar. Incrementar el dígito menos significativo.

Esta definición se hace para que se reduzca el riesgo de problemas de suma de los valores redondeados, para valores originales con décimas conteniendo el número “5”. En caso que con la adopción de este procedimiento haya diferencia entre los totales calculados y la suma de los parciales para el valor total de un documento, se deberá utilizarAnexo T5.4 Documento Soporte de Pago de Nómina Electrónica – Versión 1.0

Dirección de Gestión de Ingresos

calculados y la suma de los parciales para el valor total de un documento, se deberá utilizarAnexo T5.4 Documento Soporte de Pago de Nómina Electrónica – Versión 1.0

Dirección de Gestión de Ingresos Carrera 8 Nº 6C-38 piso 6º PBX 607 9999 – 382 4500 Ext. 905101 Código postal 111711 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN

Página 8 de 324

el elemento /NominaIndividual/Redondeo y /NominaIndividualDeAjuste/Reempolazar/Redondeo para informar la diferencia.

1.1.1.1. Redondeos valores monetarios. Redondeos para los elementos, que contienen valores monetarios.

Nota: Los valores monetarios permitirán una tolerancia de error + - 2.00.

Nota: La fórmula de redondeo utilizada en estos momentos es la round-half-to-even cuya definición se puede encontrar en la siguiente dirección https://www.w3.org/TR/xpathfunctions-31/#func-round-half-to-even, y, corresponde a la norma técnica colombiana NTC 3711 (Norma técnica internacional JIS Z 8401).

1.1.2. Identificador de los documentos electrónicos. El Código Único de Documento Soporte de Pago de Nómina Electrónica – CUNE utilizado para l os Documentos Soporte de Pago de Nómina Electrónica , es el identificador de los diferentes documentos electrónicos. Para su cálculo debe remitirse al numeral 8.1 del presente documento. Para posibilitar la referencia cruzada entre los diferentes documentos electrónicos, se incluye la etiqueta /Generales/@CUNE, la cual contendrá un identif icador universal denominado

presente documento. Para posibilitar la referencia cruzada entre los diferentes documentos electrónicos, se incluye la etiqueta /Generales/@CUNE, la cual contendrá un identif icador universal denominado “CUNE” y su Tipo de encriptado denominado “EncripCUNE” . Este identificador y el Tipo de Encriptado están localizados en la siguiente ruta de ambos documentos: Documento Soporte de Pago de Nómina Electrónica: • /NominaIndividual/InformacionGeneral/@CUNE • /NominaIndividual/InformacionGeneral/@EncripCUNE Nota de Ajuste del Documento Soporte de Pago de Nómina Electrónica: • /NominaIndividualDeAjuste/Reemplazar/InformacionGeneral/@CUNE • /NominaIndividualDeAjuste/Eliminar/InformacionGeneral/@CUNE • /NominaIndividualDeAjuste/Reemplazar/InformacionGeneral/@EncripCUNE • /NominaIndividualDeAjuste/Eliminar/InformacionGeneral/@EncripCUNE

La etiqueta CUNE contendrá: • Como se mencionó anteriormente, el lector debe remitirse al numeral 8.1, con el objeto de revisar cómo se calcula o genera el CUN E para los diferentes documentos electrónicos.

Los elementos utilizados en los cálculos se encuentran especificados en el presente documento.Anexo T5.4 Documento Soporte de Pago de Nómina Electrónica – Versión 1.0

Dirección de Gestión de Ingresos Carrera 8 Nº 6C-38 piso 6º PBX 607 9999 – 382 4500 Ext. 905101 Código postal 111711 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN

Página 9 de 324

1.1.3. Valores Negativos.

Código postal 111711 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN

Página 9 de 324

1.1.3. Valores Negativos. 1.1.3.1. Monetarios. Todos los valores monetarios deberán ser expresados en valores positivos. La naturaleza del signo negativo o positivo la otorga el concepto de campo, mas no está incluido en el valor. Se informa la generación de la regla VLR01. 1.1.3.2. Tarifas. Las tarifas tributarias deben corresponder a valores iguales o superiores a 0.00, en este caso no se permiten valores negativos.

2. Convenciones utilizadas en las tablas.

Este capítulo presenta la definición de las estructuras de las tablas de definición del formato XML tanto de los Documentos Electrónicos, como de las reglas de validación.

2.1. Columnas de las tablas de definición. Las columnas de las Tablas de Definición siguen las descripciones que se encuentran en la Tabla 1.

Tabla 1 – Convenciones Utilizadas en la Tablas de Definición de los Formatos XML. Columna Descripción ID Identificador único del elemento atributo y que servirá de base para la codificación de notificaciones o errores de cada uno de ellos. NS Identifica el NameSpace al cual pertenece el campo: • xmlns="dian:gov:co:facturaelectronica:NominaIndividual" • xmlns="dian:gov:co:facturaelectronica:NominaIndividualDeAjuste" • xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" • ds - http://www.w3.org/2000/09/xmldsig#

• xmlns="dian:gov:co:facturaelectronica:NominaIndividual