Objeto de nómina
Estructura del objeto de nómina
Ejemplo:
{
"novedad": {
"cuneNov": "string",
"value": true
},
"periodo": {
"fechaIngreso": "2021-07-14T14:30:23.527Z",
"fechaRetiro": "2021-07-14T14:30:23.527Z",
"fechaLiquidacionInicio": "2021-07-14T14:30:23.527Z",
"fechaLiquidacionFin": "2021-07-14T14:30:23.527Z",
"tiempoLaborado": 0
},
"numeroSecuenciaXml": {
"prefijo": "string",
"consecutivo": 0
},
"codigoQr": "string",
"informacionGeneral": {
"trm": 0
},
"notas": "string",
"trabajador": {
"tipoTrabajador": "string",
"subTipoTrabajador": "string",
"altoRiesgoPension": true,
"tipoDocumento": "string",
"numeroDocumento": "string",
"primerApellido": "string",
"segundoApellido": "string",
"primerNombre": "string",
"otrosNombres": "string",
"lugarTrabajoPais": "string",
"lugarTrabajoDepartamentoEstado": "string",
"lugarTrabajoMunicipioCiudad": "string",
"lugarTrabajoDireccion": "string",
"salarioIntegral": true,
"tipoContrato": "string",
"sueldo": 0,
"codigoTrabajador": "string",
"fechaIngreso": "2021-07-14T14:30:23.527Z",
"fechaRetiro": "2021-07-14T14:30:23.527Z",
"genero": "string",
"email": "string"
},
"pago": {
"metodo": "string",
"banco": "string",
"tipoCuenta": "string",
"numeroCuenta": "string"
},
"fechasPagos": {
"fechaPago": "2021-07-14T14:30:23.527Z"
},
"devengados": {
"basico": {
"diasTrabajados": 0,
"sueldoTrabajado": 0
},
"transporte": {
"auxilioTransporte": 0,
"viaticoManutAlojS": 0,
"viaticoManutAlojNs": 0
},
"heds": [
{
"horaInicio": "2021-07-14T14:30:23.527Z",
"horaFin": "2021-07-14T14:30:23.527Z",
"cantidad": 0,
"porcentaje": 0,
"pago": 0
}
],
"hens": [
{
"horaInicio": "2021-07-14T14:30:23.527Z",
"horaFin": "2021-07-14T14:30:23.527Z",
"cantidad": 0,
"porcentaje": 0,
"pago": 0
}
],
"hrns": [
{
"horaInicio": "2021-07-14T14:30:23.527Z",
"horaFin": "2021-07-14T14:30:23.527Z",
"cantidad": 0,
"porcentaje": 0,
"pago": 0
}
],
"heddfs": [
{
"horaInicio": "2021-07-14T14:30:23.527Z",
"horaFin": "2021-07-14T14:30:23.527Z",
"cantidad": 0,
"porcentaje": 0,
"pago": 0
}
],
"hrddfs": [
{
"horaInicio": "2021-07-14T14:30:23.527Z",
"horaFin": "2021-07-14T14:30:23.527Z",
"cantidad": 0,
"porcentaje": 0,
"pago": 0
}
],
"hendfs": [
{
"horaInicio": "2021-07-14T14:30:23.527Z",
"horaFin": "2021-07-14T14:30:23.527Z",
"cantidad": 0,
"porcentaje": 0,
"pago": 0
}
],
"hrndfs": [
{
"horaInicio": "2021-07-14T14:30:23.527Z",
"horaFin": "2021-07-14T14:30:23.527Z",
"cantidad": 0,
"porcentaje": 0,
"pago": 0
}
],
"vacaciones": {
"vacacionesComunes": [
{
"fechaInicio": "2021-07-14T14:30:23.527Z",
"fechaFin": "2021-07-14T14:30:23.527Z",
"cantidad": 0,
"pago": 0
}
],
"vacacionesCompensadas": [
{
"cantidad": 0,
"pago": 0
}
]
},
"primas": {
"cantidad": 0,
"pago": 0,
"pagoNs": 0
},
"cesantias": {
"pago": 0,
"porcentaje": 0,
"pagoIntereses": 0
},
"incapacidades": [
{
"tipo": "string",
"pago": 0,
"fechaInicio": "2021-07-14T14:30:23.527Z",
"fechaFin": "2021-07-14T14:30:23.528Z",
"cantidad": 0
}
],
"licencias": {
"licenciaMp": [
{
"pago": 0,
"fechaInicio": "2021-07-14T14:30:23.528Z",
"fechaFin": "2021-07-14T14:30:23.528Z",
"cantidad": 0
}
],
"licenciaR": [
{
"pago": 0,
"fechaInicio": "2021-07-14T14:30:23.528Z",
"fechaFin": "2021-07-14T14:30:23.528Z",
"cantidad": 0
}
],
"licenciaNr": [
{
"fechaInicio": "2021-07-14T14:30:23.528Z",
"fechaFin": "2021-07-14T14:30:23.528Z",
"cantidad": 0
}
]
},
"bonificaciones": [
{
"bonificacionS": 0,
"bonificacionNs": 0
}
],
"auxilios": [
{
"auxilioS": 0,
"auxilioNs": 0
}
],
"huelgasLegales": [
{
"fechaInicio": "2021-07-14T14:30:23.528Z",
"fechaFin": "2021-07-14T14:30:23.528Z",
"cantidad": 0
}
],
"otrosConceptos": [
{
"descripcionConcepto": "string",
"conceptoS": 0,
"conceptoNs": 0
}
],
"compensaciones": [
{
"compensacionO": 0,
"compensacionE": 0
}
],
"bonoEpctvs": [
{
"pagoS": 0,
"pagoNs": 0,
"pagoAlimentacionS": 0,
"pagoAlimentacionNs": 0
}
],
"comisiones": [
0
],
"pagosTerceros": [
0
],
"anticipos": [
0
],
"dotacion": 0,
"apoyoSost": 0,
"teletrabajo": 0,
"bonifRetiro": 0,
"indemnizacion": 0
},
"deducciones": {
"salud": {
"porcentaje": 0,
"deduccion": 0
},
"fondoPension": {
"porcentaje": 0,
"deduccion": 0
},
"fondoSp": {
"porcentaje": 0,
"deduccionSp": 0,
"porcentajeSub": 0,
"deduccionSub": 0
},
"sindicatos": [
{
"porcentaje": 0,
"deduccion": 0
}
],
"sanciones": [
{
"sancionPublic": 0,
"sancionPriv": 0
}
],
"libranzas": [
{
"descripcion": "string",
"deduccion": 0
}
],
"pagosTerceros": [
0
],
"anticipos": [
0
],
"otrasDeducciones": [
0
],
"pensionVoluntaria": 0,
"retencionFuente": 0,
"afc": 0,
"cooperativa": 0,
"embargoFiscal": 0,
"planComplementarios": 0,
"educacion": 0,
"reintegro": 0,
"deuda": 0
},
"redondeo": 0,
"devengadosTotal": 0,
"deduccionesTotal": 0,
"comprobanteTotal": 0
}Estructura
Nómina
Es el objeto base de la nómina
Campo
Tipo
¿Es opcional?
Descripción
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
notas
String
Sí
Notas adicionales a la nómina, utilizado para atributos del empleador o emisor del documento
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
altoRiesgoPension
Booleano
No
Es true si el trabajador desarrolló durante el presente periodo alguna de las actividades descritas en el decreto 2090 de 2003.
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.
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.
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
String
Sí
Email del trabajador
Pago
Indica atributos de pago de la nómina
Campo
Tipo
¿Es opcional?
Descripción
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
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
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
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
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, 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
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.
Última actualización
¿Te fue útil?