Objeto de nómina

Ejemplo:

Estructura

Nómina

Es el objeto base de la nómina

Campo	Tipo	¿Es opcional?	Descripción
novedad	Objeto	Sí	Ver Novedad
periodo	Objeto	No	Ver Periodo
numeroSecuenciaXml	Objeto	No	Ver NúmeroSecuenciaXML
codigoQr	String	No	Debe poseer información detallada del documento electrónico, debe corresponder a la siguiente URL: “https://catalogovpfe.dian.gov.co/document/searchqr?documentkey=CUNE” donde la palabra CUNE debe ser reemplazada por el CUNE del documento electrónico
informacionGeneral	Objeto	Sí	Ver InformacionGeneral
notas	String	Sí	Notas adicionales a la nómina, utilizado para atributos del empleador o emisor del documento
trabajador	Objeto	No	Ver Trabajador
pago	Objeto	No	Ver Pago
fechasPago	Objeto	No	Ver FechasPago
devengados	Objeto	No	Ver Devengados
deducciones	Objeto	No	Ver Deducciones
redondeo	Entero	Sí	Valor del redondeo.
devengadosTotal	Entero	Sí	Valor total de la suma de todas los devengados del trabajador
deduccionesTotal	Entero	Sí	Valor total de la suma de todas las deducciones del trabajador
comprobanteTotal	Entero	Sí	Debe ir el total de Devengados - Deducciones, es decir, la diferencia entre devengadosTotal y deduccionesTotal

Novedad

Indica si existe alguna novedad contractual en el documento soporte de pago de nómina electrónica.

Campo	Tipo	¿Es opcional?	Descripción
cuneNov	String	Sí	Indica el cune del documento al cual se le realizará la novedad contractual
value	Booleano	No	Se debe colocar `true` o `false` dependiendo si hay novedad o no, respectivamente

Periodo

Indica información sobre el periodo de generación del documento de nómina.

Campo	Tipo	¿Es opcional?	Descripción
fechaIngreso	DateTime	Sí	Este dato se debe diligenciar solamente en el registro del mes en que el trabajador o aprendiz presenta ingreso o vinculación a la nómina del reportante. En caso de tener más de un ingreso en el mes, se debe reportar la primera fecha en la que se presenta esta novedad. En el mes en que se está reportando se debe indicar la fecha de ingreso del trabajador a la empresa.
fechaRetiro	DateTime	Sí	Este dato se debe diligenciar solamente en el registro del mes en que el trabajador o aprendiz presenta retiro de la nómina del reportante. En caso de tener más de un retiro en el mes, se debe reportar la última fecha en la que se presenta esta novedad en el mismo mes que está siendo reportado.
fechaLiquidacionInicio	DateTime	No	Fecha de inicio de liquidación de nómina.
fechaLiquidacionFin	DateTime	No	Fecha fin de liquidación de nómina.
tiempoLaborado	Entero	No	Número de horas laboradas

NumeroSecuenciaXML

Inidca los atributos del número de secuencia del documento xml.

Campo	Tipo	¿Es opcional?	Descripción
prefijo	String	Sí	Código del trabajador, es interno al empleador
consecutivo	Entero	No	Consecutivo de la secuencua

InformacionGeneral

Indica atributos de información general documento

Campo	Tipo	¿Es opcional?	Descripción
trm	Entero	Sí	Tasa Representativa del mercado. Corresponde a la tasa de cambio de la moneda utilizada en el documento en el campo “tipoMoneda” a pesos colombianos.

Trabajador

Indica atributos del trabajador o receptor del documento.

Campo	Tipo	¿Es opcional?	Descripción
tipoTrabajador	String	No	Código del tipo de trabajador del ministerio de salud. aportes a seguridad social de activos. Corresponde a la clasificación de PILA para conocer en que calidad se realizan las cotizaciones a la seguridad social. Ver códigos
subTipoTrabajador	String	No	Código del sub tipo de trabajador del ministerio de salud. Ver códigos
altoRiesgoPension	Booleano	No	Es `true` si el trabajador desarrolló durante el presente periodo alguna de las actividades descritas en el decreto 2090 de 2003.
tipoDocumento	String	No	Tipo de documento de identificación del empleado. Ver códigos
numeroDocumento	String	No	Número de documento del trabajador.
primerApellido	String	No	Primer apellido del trabajador.
segundoApellido	String	No	Segundo apellido del trabajador.
primerNombre	String	No	Primer nombre del trabajador.
otrosNombres	String	Sí	Otros nombres del trabajador.
lugarTrabajoPais	String	No	Código del país donde se encuentra el trabajador. Ver códigos
lugarTrabajoDepartamentoEstado	String	No	Código del departamento donde se encuentra el trabajador. Ver códigos
lugarTrabajoMunicipioCiudad	String	No	Código del municipio o ciudad donde se encuentra el trabajador. Ver códigos
lugarTrabajoDireccion	String	No	Dirección del lugar físico donde se encuentra el trabajador.
salarioIntegral	Booleano	No	Indica si el trabajador tiene un salario integral, el cual es el tipo de remuneración que incluye todos los conceptos que puedan constituir salario en un solo monto o pago (prestaciones sociales y recargos nocturno, dominical y festivo, y el trabajo extra) y que sea superior a 10 smlmv mas un 30% correspondiente a factor prestacional.
tipoContrato	String	No	Tipo de contrato que posee el empleado. Ver códigos
sueldo	Entero	No	Sueldo base del trabajador.
codigoTrabajador	String	Sí	Código interno de la empresa.
fechaIngreso	DateTime	Sí	Fecha en la cual el empleado ingresa a trabajar, si esta dentro del periodo informado se envía en periodo.
fechaRetiro	DateTime	Sí	Fecha en la cual el empleado se retire de trabajar, si esta dentro del periodo informado se envía en periodo.
genero	String	Sí	Género del trabajador
email	String	Sí	Email del trabajador

Pago

Indica atributos de pago de la nómina

Campo	Tipo	¿Es opcional?	Descripción
metodo	String	No	Código de forma de pago. Ver códigos
banco	String	Sí	Nombre de entidad bancaria del empleado donde se realiza la consignación
tipoCuenta	String	Sí	Se debe colocar el tipo de cuenta que el trabajador tiene para pago de nómina. Si el metodo de pago se realiza de forma bancaria, este campo es obligatorio.
numeroCuenta	String	Sí	Se debe colocar el número de la cuenta que el trabajador tiene para pago de nomina. Si el metodo de pago se realiza de forma bancaria, este campo es obligatorio.

FechasPagos

Indica la fecha de pago de la nómina

Campo	Tipo	¿Es opcional?	Descripción
fechaPago	Date	No	Fecha de pago de la nómina.

Devengados

Indica todos los devengados de la nómina

Campo	Tipo	¿Es opcional?	Descripción
basico	Objeto	No	Ver Basico
transporte	Objeto	Sí	Ver Transporte
heds	Array	Sí	Ver Heds
hens	Array	Sí	Ver Hens
hrns	Array	Sí	Ver Hrns
heddfs	Array	Sí	Ver Heddfs
hrddfs	Array	Sí	Ver Hrddfs
hendfs	Array	Sí	Ver Hendfs
hrndfs	Array	Sí	Ver Hrndfs
vacaciones	Objeto	Sí	Ver Vacaciones
primas	Objeto	Sí	Ver Primas
cesantias	Objeto	Sí	Ver Cesantias
incapacidades	Array	Sí	Ver Incapacidades
licencias	Array	Sí	Ver Licencias
bonificaciones	Array	Sí	Ver Bonificaciones
auxilios	Array	Sí	Ver Auxilios
huelgasLegales	Array	Sí	Ver HuelgasLegales
otrosConceptos	Array	Sí	Ver OtrosConcpetos
compensaciones	Array	Sí	Ver Compensaciones
bonoEpctvs	Array	Sí	Ver BonoEpctvs
comisiones	Array	Sí	Arreglo de valores de comisiones
pagosTerceros	Array	Sí	Arreglo de valores de pagos a terceros
anticipos	Array	Sí	Arreglo de valores de anticipos
dotacion	Entero	Sí	Valor relacionado con la dotación requerida por el empleado
apoyoSost	Entero	Sí	Valor pagado por apoyo a sostenimiento
teletrabajo	Entero	Sí	Valor Pagado por trabajo en Teletrabajo
bonifRetiro	Entero	Sí	Valor pagado por retiro de la empresa
indemnizacion	Entero	Sí	Valor pagado por indemnización

Basico

Utilizado para atributos básicos de devengos del documento.

Campo	Tipo	¿Es opcional?	Descripción
diasTrabajados	Entero	No	Cantidad de días en que el trabajador se desempeñó en la empresa.
sueldoTrabajado	Entero	No	Corresponde al valor que el empleador paga de forma periódica al trabajador como contraprestación por el trabajo realizado, este puede ser fijo o variable de acuerdo a la unidad de tiempo en que las partes hayan acordado el pago, teniendo como base el día o la hora trabajada.

Transporte

Utilizado para atributos de transporte de devengados del documento.

Campo	Tipo	¿Es opcional?	Descripción
auxilioTransporte	Entero	Sí	Parte de los viáticos pagado al trabajador correspondientes a medios de transporte y/o los gastos de representación.
viaticoManutAlojS	Entero	Sí	Parte de los viáticos pagado al trabajador correspondientes a manutención y/o alojamiento.
viaticoManutAlojNs	Entero	Sí	Parte de los viáticos pagado al trabajador correspondientes a manutención y/o alojamiento no salariales.

Heds, Hens, Hrns, Heddfs, Hrddfs, Hendfs, Hrndfs

Arreglo de horas, se aplica la misma estructura para todas, hay que tener en cuenta el código del porcentaje según el tipo de hora.

Abreviación	Significado
heds	Horas extra diurnas
hens	Horas extra nocturnas
hrns	Horas de recargo nocturno
heddfs	Horas extras diurnas dominicales y festivas
hrddfs	Horas recargo diurnas dominicales y festivas
hendfs	Horas extras nocturnas dominicales y festivas
hrndfs	Horas recargo nocturno dominicales y festivas

Campo	Tipo	¿Es opcional?	Descripción
horaInicio	DateTime	Sí	Hora de inicio
horaFin	DateTime	Sí	Hora de finalización
cantidad	Entero	No	Cantidad de horas
porcentaje	Entero	No	Porcentaje al cual corresponde el calculo de 1 hora según la ley. Ver códigos
pago	Entero	No	Valor Pagado por las Horas correspondiente a: (Sueldo /240) x Porcentaje x Cantidad

Vacaciones

Utilizado para todos los elementos de vacaciones de devengos del documento.

Campo	Tipo	¿Es opcional?	Descripción
vacacionesComunes	Array	Sí	Ver VacacionesComunes
vacacionesCompensadas	Array	Sí	Ver VacacionesCompensadas

Vacaciones Comunes

Arreglo de vacaciones comunes incluídas en el periodo

Campo	Tipo	¿Es opcional?	Descripción
fechaInicio	DateTime	Sí	Este dato se debe diligenciar solamente en el registro del mes en que el trabajador presenta el inicio de sus vacaciones.
fechaFin	DateTime	Sí	Este dato se debe diligenciar solamente en el registro del mes en que el trabajador regresa o termina sus vacaciones.
cantidad	Entero	Sí	Número de días que el trabajador estuvo inactivo durante el mes por vacaciones.
pago	Entero	Sí	Corresponde al valor pagado al trabajador, por el descanso remunerado que tiene derecho por haber trabajado un determinado tiempo.

Vacaciones Compensadas

Arreglo de vacaciones compensadas incluidas en el periodo

Campo	Tipo	¿Es opcional?	Descripción
cantidad	Entero	Sí	Número de días que el trabajador estuvo inactivo durante el mes por vacaciones.
pago	Entero	Sí	Corresponde al valor pagado al trabajador, por el descanso remunerado que tiene derecho por haber trabajado un determinado tiempo.

Primas

Primas aplicadas en la nómina

Campo	Tipo	¿Es opcional?	Descripción
cantidad	Entero	No	Cantidad de días a los cuales corresponde el pago de la prima legal.
pago	Entero	No	Valor pagado por prima legal con respecto a cantidad de días.
pagoNs	Entero	Sí	Valor pagado por prima no salarial.

Cesantias

Cesantías aplicadas en la nómina

Campo	Tipo	¿Es opcional?	Descripción
pago	Entero	No	Pago de la cesantía otorgada por ley.
porcentaje	Entero	No	Porcentaje de interés de cesantías.
pagoIntereses	Entero	No	Valor pagado por intereses de cesantías.

Incapacidades

Incapacidades del empleado en el periodo reportado.

Campo	Tipo	¿Es opcional?	Descripción
tipo	String	No	Se debe indicar el código al cual corresponda el tipo de incapacidad. Ver códigos
pago	Entero	No	Valor del pago al empleado a pesar de su incapacidad.
fechaInicio	DateTime	Sí	Fecha de inicio de la incapacidad.
fechaFin	DateTime	Sí	Fecha de finalización de la incapacidad.
cantidad	Entero	No	Número de días en que el trabajador estuvo inactivo por incapacidad.

Licencias

Se refiere a todas la licencias concedidas al empleado

Campo	Tipo	¿Es opcional?	Descripción
licenciaMp	Array	Sí	Ver LicenciaMp
licenciaR	Array	Sí	Ver LicenciaR
licenciaNr	Array	Sí	Ver LicenciaNr

LicenciaMp, LicenciaR

LicenciaMp: Licencia de materinidad o paternidad

LicenciaR: Licencia remunerada

Campo	Tipo	¿Es opcional?	Descripción
pago	Entero	No	Valor pagado con relación a la licencia
fechaInicio	DateTime	Sí	Fecha de inicio de la licencia
fechaFin	DateTime	Sí	Fecha de finalización de la licencia
cantidad	Entero	No	Cantidad de días de la licencia

LicenciaNr

Se refiere a las licencias no remuneradas

Campo	Tipo	¿Es opcional?	Descripción
fechaInicio	DateTime	Sí	Fecha de inicio de la licencia
fechaFin	DateTime	Sí	Fecha de finalización de la licencia
cantidad	Entero	No	Cantidad de días de la licencia

Bonificaciones

Indica las bonificaciones concedidas al empelado

Campo	Tipo	¿Es opcional?	Descripción
bonificacionS	Entero	Sí	Valor pagado por bonificación salarial
bonificacionNs	Entero	Sí	Valor Pagado por bonificación no salarial

Auxilios

Indica los auxilios concedidos al empleado

Campo	Tipo	¿Es opcional?	Descripción
auxilioS	Entero	Sí	Valor pagado por auxilio salarial
auxilioNs	Entero	Sí	Valor Pagado por auxilio no salarial

HuelgasLegales

Indica los atributos de las huelgas legales

Campo	Tipo	¿Es opcional?	Descripción
fechaInicio	DateTime	No	Fecha de inicio de la huelga
fechaFin	Entero	Sí	Fecha de finalización de la huelga
cantidad	Entero	Sí	Cantidad de días de duración de la huelga

OtrosConceptos

Indica conceptos adicionales a los ya documentados previamente

Campo	Tipo	¿Es opcional?	Descripción
descripcionConcepto	String	No	Descripción del concepto
conceptoS	Entero	No	Valor pagado por conceptos salariales.
conceptoNs	Entero	No	Valor pagado por conceptos no salariales.

Compensaciones

Utilizado para atributos de compensaciones del documento.

Campo	Tipo	¿Es opcional?	Descripción
compensacionO	Entero	Sí	Valor pagado por compensaciones ordinarias
compensacionE	Entero	Sí	Valor pagado por compensaciones extraordinarias

BonoEpctvs

Utilizado para atributos de bono electrónico o de papel de servicio, cheque, tarjeta, vale, etc.

Campo	Tipo	¿Es opcional?	Descripción
pagoS	Entero	Sí	Valor del bono si es salarial.
pagoNs	Entero	Sí	Valor del bono si es no salarial.
pagoAlimentacionS	Entero	Sí	Valor del bono para alimentación salarial.
pagoAlimentacionNs	Entero	Sí	Valor del bono para alimentación no salarial.

Deducciones

Hace referencia a las deducciones aplicadas a la nómina

Campo	Tipo	¿Es opcional?	Descripción
salud	Objeto	No	Ver Salud
fondoPension	Objeto	No	Ver FondoPension
fondoSp	Objeto	Sí	Ver FondoSp
sindicatos	Objeto	Sí	Ver Sindicatos
sanciones	Objeto	Sí	Ver Sanciones
libranzas	Objeto	Sí	Ver Libranzas
pagosTerceros	Array	Sí	Arreglo de valores de pagos a terceros
anticipos	Array	Sí	Arreglo de valores de anticipos
otrasDeducciones	Array	Sí	Otras deducciones distintas a las ya contempladas
pensionVoluntaria	Entero	Sí	Valor pagado correspondiente al ahorro que hace el trabajador para complementar su pensión obligatoria o cumplir metas especificas.
retencionFuente	Entero	Sí	Valor pagado correspondiente a Retención en la Fuente por parte del trabajador.
afc	Entero	Sí	Valor pagado correspondiente a AFC (Ahorro Fomento a la construcción) por parte del trabajador
cooperativa	Entero	Sí	Valor pagado correspondiente a cooperativas por parte del trabajador.
embargoFiscal	Entero	Sí	Valor pagado correspondiente a embargos fiscales por parte del trabajador.
planComplementarios	Entero	Sí	Valor pagado correspondiente a planes complementarios por parte del trabajador.
educacion	Entero	Sí	Valor pagado correspondiente a conceptos educativos por parte del trabajador.
reintegro	Entero	Sí	Valor Pagado correspondiente a reintegro por parte del trabajador.
deuda	Entero	Sí	Valor pagado correspondiente a deuda con la empresa por parte del trabajador.

Salud

Indica atributos de salud de la nómina

Campo	Tipo	¿Es opcional?	Descripción
porcentaje	Entero	No	Valor del porcentaje de salud
deduccion	Entero	No	Valor pagado correspondiente a salud por parte del trabajador.

FondoPension

Indica atributos del fondo de pensión del empleado

Campo	Tipo	¿Es opcional?	Descripción
porcentaje	Entero	No	Valor del porcentaje para el fondo de pensión.
deduccion	Entero	No	Valor pagado correspondiente a el fondo de pensión por parte del trabajador.

FondoSp

Utilizado para atributos de fondo de seguridad pensional

Campo	Tipo	¿Es opcional?	Descripción
porcentaje	Entero	Sí	Valor del porcentaje para el fondo de seguridad pensional.
deduccionSp	Entero	Sí	Valor pagado correspondiente a fondo de solidaridad pensional por parte del trabajador.
porcentajeSub	Entero	Sí	Se debe colocar el porcentaje correspondiente al fondo de subsistencia.
deduccionSub	Entero	Sí	Valor pagado correspondiente a fondo de subsistencia por parte del trabajador.

Sindicatos

Arreglo de Sindicatos

Campo	Tipo	¿Es opcional?	Descripción
porcentaje	Entero	Sí	Porcentaje que correspondiente a aportes del sindicato
deduccion	Entero	Sí	Aportes al sindicato por parte del trabajador

Sanciones

Arreglo de sanciones

Campo	Tipo	¿Es opcional?	Descripción
sancionPublic	Entero	Sí	Valor Pagado correspondiente a Sanción Pública por parte del trabajador
sancionPriv	Entero	Sí	Valor Pagado correspondiente a Sanción Privada por parte del trabajador

Libranzas

Arreglo de librazas

Campo	Tipo	¿Es opcional?	Descripción
descripcion	String	Sí	Descripción de la libranza
deduccion	Entero	Sí	Valor pagado correspondiente a aportes a entidades financieras por parte del trabajador.

Documento sin título

Objeto de nómina#

Ejemplo:#

Estructura#

Nómina#

Novedad#

Periodo#

NumeroSecuenciaXML#

InformacionGeneral#

Trabajador#

Pago#

FechasPagos#

Devengados#

Basico#

Transporte#

Heds, Hens, Hrns, Heddfs, Hrddfs, Hendfs, Hrndfs#

Vacaciones#

Vacaciones Comunes#

Vacaciones Compensadas#

Primas#

Cesantias#

Incapacidades#

Licencias#

LicenciaMp, LicenciaR#

LicenciaNr#

Bonificaciones#

Auxilios#

HuelgasLegales#

OtrosConceptos#

Compensaciones#

BonoEpctvs#

Deducciones#

Salud#

FondoPension#

FondoSp#

Sindicatos#

Sanciones#

Libranzas#