Indica si existe alguna Novedad Contractual en el Documento Soporte de Pago de Nómina Electrónica o Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica del Trabajador en dicho Mes.
Se debe colocar true = 1, false = 0.
PATH: /root/Novedad
novedadCUNE
String
N|96
C/C
Debe corresponder al CUNE del Documento Soporte de Pago de Nómina Electrónica o Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica a realizar la Novedad
PATH: /root/Novedad/@CUNENov
lugarGeneracionXML
Class
-
SI
Utilizado para Atributos del Lugar de Generación del Documento XML
Pagos por el reconocimiento del logro o cumplimiento por parte del trabajador en el desarrollo de sus labores, de condiciones definidas expresamente entre las partes.
Consecutivo desde el que comienza la serie para el documento a emitir, siempre debe colocarse el prefijo (con guión) independientemente de la modalidad de secuencial. Ejemplo: ‘PREF-1123456’
PATH: /root/NumeroSecuencialXML/@Prefijo
redondeo
String
N|..
NO
Se utiliza para cuando se realice el Redondeo en el Documento
Las cuotas o aportes que los empleados hagan a las cooperativas legalmente constituidas
PATH: …/root.Deducciones/cooperativa
deuda
String
N|..
NO
Valor que se deba pagar por las obligaciones que el empleado tenga con su empresa, como puede ser un crédito que ésta le haya otorgado, o como compensación por algún perjuicio o detrimento económico que el empleado le haya causado a la empresa.
PATH: …/root.Deducciones/deuda
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
educación
String
N|..
NO
Valor Pagado correspondiente a Conceptos Educativos por parte del trabajador
PATH: …/root.Deducciones/educación
embargoFiscal
String
N|..
NO
Valor Pagado correspondiente a Embargos Fiscales por parte del trabajador
PATH: …/root.Deducciones/embargoFiscal
fondosPensiones
Array<FondoPension>
-
SI
Clase relacionada a las deducciones realizadas por motivos de fondos de pensión
Valor correspondiente al ahorro que hace el trabajador para complementar su pensión obligatoria o cumplir metas especificas.
PATH: …/root.Deducciones/pensionVoluntaria
planComplementarios
String
N|..
NO
Valor de planes complementarios de salud al que el trabajador se encuentran afiliado, siempre que medie autorización del empleado.
PATH: …/root.Deducciones/planComplementarios
retencionFuente
String
N|..
NO
Si hubiere lugar, la empresa deberá calcular y retener al empleado el valor correspondiente a retención en la fuente por ingresos laborales. Este valor será declarado y consignado en la respectiva declaración mensual de retención en la fuente.
Valor que le regresa el trabajador a la empresa por un devengo mal realizado en otro pago de nómina
PATH: …/root.Deducciones/reintegro
Class.AnticiposNom
Atributo
Tipo Dato
Formato
Requerido
Descripción
montoanticipo
String
N|..
NO
Anticipos de Nómina.
PATH: /root./@anticiposNom
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
Class.FondoPension
Atributo
Tipo Dato
Formato
Requerido
Descripción
deducción
String
N|..
SI
Valor Pagado correspondiente a Pensión por parte del trabajador.
PATH: /root./@deduccion
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
porcentaje
String
N|4-6
SI
Debe corresponder al porcentaje de deducción de fondo de pensión que paga el trabajador.
PATH: /root/@porcentaje
Class.FondoSP
Atributo
Tipo Dato
Formato
Requerido
Descripción
deduccionSP
String
N|..
NO
Valor Pagado correspondiente a Fondo de Solidaridad Pensional por parte del trabajador.
PATH: /root./@deduccionSP
deduccionSub
String
N|..
NO
Valor Pagado correspondiente a Fondo de Subsistencia por parte del trabajador.
PATH: /root./@deduccionSub
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
porcentaje
String
N|4-6
NO
Debe corresponder al porcentaje de deducción de fondo de seguridad pensional que paga el trabajador.
PATH: /root/@porcentaje
porcentajeSub
String
N|4-6
NO
Se debe colocar el Porcentaje que correspondiente al Fondo de Subsistencia correspondiente.
PATH: /root/@porcentajeSub
Class.Libranza
Atributo
Tipo Dato
Formato
Requerido
Descripción
descripción
String
AN|..
SI
Nombre de la Libranza que corresponda a las cuotas que el empleado deba pagar a una entidad financiera, para la amortización de un crédito que le haya sido otorgado por libranza.
PATH: /root./@descripcion
deduccion
String
N|..
SI
Las cuotas que el empleado deba pagar a una entidad financiera, para la amortización de un crédito que le haya sido otorgado por libranza.
PATH: /root./@deduccion
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
Class.OtraDeduccion
Atributo
Tipo Dato
Formato
Requerido
Descripción
montootraDeduccion
String
N|..
NO
Otro tipo de deducción dentro de la Nomina..
PATH: /root./@otraDeduccion
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
Class.PagoTercero
Atributo
Tipo Dato
Formato
Requerido
Descripción
pagoTercero
String
N|...
NO
Beneficios en cabeza del Trabjador que se pagan a un proveedor o tercero
PATH: /root./@pagoTercero
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
Class.Salud
Atributo
Tipo Dato
Formato
Requerido
Descripción
porcentaje
String
N|..
SI
Debe corresponder al porcentaje de deducción de salud que paga el trabajador
PATH: /root./@porcentaje
deduccion
String
N|..
SI
Valor Pagado correspondiente a Salud por parte del trabajador
PATH: /root./@deduccion
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
Class.Sancion
Atributo
Tipo Dato
Formato
Requerido
Descripción
sancionPublic
String
N|..
SI
Valor por el del incumplimiento de una regla o norma de conducta obligatoria (Publica)
PATH: /root./@sancionPublic
sancionPriv
String
N|..
SI
Valor por el del incumplimiento de una regla o norma de conducta obligatoria (Privada o Ordinaria)
PATH: /root./@sancionPriv
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
Class.Sindicato
Atributo
Tipo Dato
Formato
Requerido
Descripción
porcentaje
String
N|..
SI
Porcentaje establecido en la ley o por estatutos del sindicato.
PATH: /root./@porcentaje
deduccion
String
N|..
SI
Las cuotas que los trabajadores sindicalizados deben aportar al sindicato al que estén afiliados, y siempre que medie autorización del empleado
PATH: /root./@deduccion
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
Class.Devengados
Atributo
Tipo Dato
Formato
Requerido
Descripción
anticiposNom
Array<AnticiposNom>
-
NO
Clase relacionada a los devengos correspondientes a anticipos.
Corresponde al valor no salarial que el patrocinador paga de forma mensual como ayuda o apoyo economía al aprendiz o practicante universitario durante su etapa lectiva y fase practica.
PATH: /root.Devengados/apoyoSost
basico
Array<Basico>
-
SI
Utilizado para Atributos Básicos de Devengos del Documento
De conformidad con lo previsto en el artículo 230 del Código Sustantivo del Trabajo, o la norma que lo modifique, adicione o sustituya, corresponde al valor que el empleador dispone para suministrar la dotación de sus trabajadores.
PATH: ../root.Devengados/dotación
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No Aplica
horasExtras
Array<HoraExtra>
-
NO
Utilizado para Todos los Elementos de Horas Extras Diarias de Devengos del Documento
Beneficios, ayudas o apoyos económicos, pagados al trabajador de forma ocasional.
PATH: /root./@auxilioNS
auxilioS
String
N|..
NO
Beneficios, ayudas o apoyos económicos, pagados al trabajador de forma habitual
PATH: /root./@./@auxilioS
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
Class.Basico
Atributo
Tipo Dato
Formato
Requerido
Descripción
diasTrabajados
String
N|1-2
SI
Número de días que el trabajador o aprendiz efectivamente estuvo ejecutando sus labores en la empresa.
PATH: /root/@diasTrabajados
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
sueldoTrabajado
String
N|..
SI
Corresponde al valor que el empleador paga de forma periódica al trabajador como contraprestación por el trabajo realizado.
PATH: /root/@sueldoTrabajado
Class.Bonificación
Atributo
Tipo Dato
Formato
Requerido
Descripción
bonificacionNS
String
N|..
NO
Son valores de incentivos pagados al trabajador de forma ocasional y por mera liberalidad o los pactados entre las partes de forma expresa como pago no salarial..
PATH: /root/@bonificacionNS
bonificacionS
String
N|..
NO
Corresponde al valor que el empleador paga de forma periódica al trabajador como contraprestación por el trabajo realizado.
PATH: /root/@bonificacionNS
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
Class.BonoEPCTV
Atributo
Tipo Dato
Formato
Requerido
Descripción
pagoAlimentacionNS
String
N|..
NO
Valor que el trabajador recibe como concepto no salarial, por medio de bonos electrónicos, recargas, cheques, vales. es decir, todo pago realizado en un medio diferente a dinero en efectivo o consignación de cuenta bancaria (Para Alimentación No Salarial).
PATH: /root/@pagoAlimentacionNS
pagoAlimentacionS
String
N|..
NO
Valor que el trabajador recibe como contraprestación por el trabajo realizado, por medio de bonos electrónicos, recargas, cheques, vales. es decir, todo pago realizado en un medio diferente a dinero en efectivo o consignación de cuenta bancaria (Salarial).
PATH: /root/@pagoAlimentacionS
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
pagoNS
String
N|..
NO
Valor que el trabajador recibe como contraprestación por el trabajo realizado, por medio de bonos electrónicos, recargas, cheques, vales de forma no salarial.
PATH: /root/@pagoNS
pagoS
String
N|..
NO
Valor que el trabajador recibe como contraprestación por el trabajo realizado, por medio de bonos electrónicos, recargas, cheques, vales de forma salarial.
PATH: /root/@pagoS
Class.Cesantia
Atributo
Tipo Dato
Formato
Requerido
Descripción
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
pago
String
N|..
SI
Pago de la Cesantias otorgada por Ley.
PATH: root/.Cesantias/@pago
pagoIntereses
String
N|..
SI
Pago de los Intereses de Cesantias otorgada por Ley.
PATH: root/.Cesantias/@pagoIntereses
porcentaje
String
N|..
SI
Porcentaje que corresponde al Interés de Cesantias de Ley.
PATH: /root/Cesantias/@pagoIntereses
Class.Comisión
Atributo
Tipo Dato
Formato
Requerido
Descripción
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
montocomision
String
N|..
NO
Valor pagado al trabajador usualmente del área comercial, y de forma regular se liquida con un porcentaje sobre el importe de una operación, también se presenta como incentivo por el logro de objetivos..
PATH: root./@comision
Class.Compensación
Atributo
Tipo Dato
Formato
Requerido
Descripción
compensacionE
String
N|..
SI
Valor Pagado por Compensaciones Extraordinarias.
PATH: root./@compensacionE
compensacionO
String
N|..
SI
Valor Pagado por Compensaciones Ordinarias.
PATH: root./@compensacionO
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
Class.HoraExtra
Atributo
Tipo Dato
Formato
Requerido
Descripción
cantidad
String
N|..
SI
Cantidad de Horas Extra según el tipo.
PATH: /root/HorasExtras(Tipo)/@cantidad
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
horaInicio
String
AN|19
NO
Hora de inicio de Hora Extra Según el tipo.
PATH: /root/HorasExtras(Tipo)/@horaInicio. En formato YYYY-MM-DDTHH:MM:SS
horaFin
String
AN|19
NO
Hora de fin de Hora Extra según el tipo.
PATH: /root/HorasExtras(Tipo)/@horaFin. En formato YYYY-MM-DDTHH:MM:SS
pago
String
N|..
SI
Es el valor pagado por el tiempo que se trabaja adicional a la jornada legal o pactada contractualmente.
PATH: /root/HorasExtras(Tipo)/@pago
porcentaje
String
N|4-6
SI
Porcentaje al cual corresponde el calculo de 1 hora Extra según el tipo.
Número de días que el trabajador o aprendiz efectivamente estuvo inactivo por permiso o licencia.
PATH: /root/@cantidad
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
fechaInicio
String
AN|10
NO
Fecha donde da inicio la Licencia.
PATH: /Incapacidad/@fechaInicio
fechaFin
String
AN|10
NO
Fecha donde termina la Licencia.
PATH: /root/@fechaFin
pago
String
N|..
SI
Valor pagado al trabajador del descanso remunerado que la ley confiere por el nacimiento de un hijo, y que es reconocido y pagado por la EPS a la que está afiliado el padre o la madre, o en su defecto por el empleador
PATH: /root/@pago
Class.LicenciaNR
Atributo
Tipo Dato
Formato
Requerido
Descripción
cantidad
String
N|..
SI
Número de días que el trabajador o aprendiz efectivamente estuvo inactivo por permiso o licencia.
PATH: /root/Licencias/licenciaNR/cantidad
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
fechaInicio
String
AN|10
NO
Fecha donde da inicio la Licencia.
PATH: /root/Licencias/licenciaNR/fechaInicio
fechaFin
String
AN|10
NO
Fecha donde termina la Licencia.
PATH: /root/Licencias/licenciaNR/fechaFin
Class.LicenciaR
Atributo
Tipo Dato
Formato
Requerido
Descripción
cantidad
String
N|..
SI
Número de días que el trabajador o aprendiz efectivamente estuvo inactivo por permiso o licencia.
PATH: /root/Licencias/licenciaR/cantidad
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
fechaInicio
String
AN|10
NO
Fecha donde da inicio la Licencia.
PATH: /root/Licencias/licenciaR/fechaInicio
fechaFin
String
AN|10
NO
Fecha donde termina la Licencia.
PATH: /root/Licencias/licenciaR/fechaFin
pago
String
N|..
SI
Valor pagado al trabajador corresponde a tiempo no laborado, que por ley o por acuerdo con el empleador se le concede
PATH: /root/Licencias/licenciaR/pago
Class.OtroConcepto
Atributo
Tipo Dato
Formato
Requerido
Descripción
conceptoNS
String
N|..
NO
Valor Pagado por Conceptos No Salariales.
PATH: /root/@conceptoNS
conceptoS
String
N|..
NO
Valor Pagado por Conceptos Salariales.
PATH: /root/@conceptoS
descripcionConcepto
String
AN|..
SI
Nombre del Concepto que corresponde a los demás pagos fijos o variables realizados al trabajador que remuneren en dinero o en especie como contraprestación directa del servicio.
@IMPORTANTE: Este campo solo admite 100 caracteres según el anexo técnico.
PATH: /root/@descripcionConcepto
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
Class.PagoTercero
Atributo
Tipo Dato
Formato
Requerido
Descripción
montopagoTercero
String
N|..
NO
Beneficios en cabeza del Trabjador que se pagan a un proveedor o tercero.
PATH: /root/@pagoTercero
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
Class.Prima
Atributo
Tipo Dato
Formato
Requerido
Descripción
cantidad
String
N|..
SI
Cantidad de dias trabajados para calculo de Pago de Corte de Prima.
PATH: /root/@cantidad
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
pago
String
N|..
SI
Pagos por el reconocimiento del logro o cumplimiento por parte del trabajador en el desarrollo de sus labores.
PATH: /root/@pago
pagoNS
String
N|..
NO
Son valores pagados al trabajador de forma ocasional y por mera liberalidad o los pactados entre las partes de forma expresa como pago no salarial.
PATH: /root/@pagoNS
Class.Transporte
Atributo
Tipo Dato
Formato
Requerido
Descripción
auxilioTransporte
String
N|..
NO
Parte de los viáticos pagado al trabajador correspondientes a medios de transporte y/o los gastos de representación.
PATH: /root/@auxilioTransporte
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
ViaticoManuAlojS
String
N|..
NO
Parte de los viáticos pagado al trabajador correspondientes a manutención y/o alojamiento.
PATH: /root/@sueldoTrabajado
viaticoManuAlojNS
String
N|..
NO
Parte de los viáticos pagado al trabajador correspondientes a manutención y/o alojamiento No Salariales.
PATH: /root/@viaticoManuAlojNS
Class.Vacaciónes
Atributo
Tipo Dato
Formato
Requerido
Descripción
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
vacaciónesComunes
Array<VacaciónesComunes>
-
NO
Utilizado para Atributos de Vacaciones Comunes del Documento
Número de días que el trabajador estuvo inactivo durante el mes por vacaciones
- Número de días que el trabajador estuvo activo durante el mes sin disfrutar sus vacaciones. (Vacaciones NO disfrutadas).
PATH: /root/@cantidad
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
fechaInicio
String
AN|10
NO
Este dato se debe diligenciar solamente en el registro del mes en que el trabajador presenta el inicio del disfrute de sus vacaciones en tiempo.
PATH: /root/@fechaInicio
fechaFin
String
AN|10
NO
Este dato se debe diligenciar solamente en el registro del mes en que el trabajador regresa o termina el disfrute de sus vacaciones.
PATH: /root/@fechaFin
pago
String
N|..
SI
Corresponde al valor pagado al trabajador, por el descanso remunerado que tiene derecho por haber trabajado un
determinado tiempo. (Vacaciones disfrutadas)
Corresponde al valor pagado al trabajador, por el descanso remunerado que no disfrutó y que tiene derecho por haber trabajado un determinado tiempo. (Vacaciones NO disfrutadas).
PATH: /root/@pago
Class.VacaciónesCompensadas
Atributo
Tipo Dato
Formato
Requerido
Descripción
cantidad
String
N|..
SI
Número de días que el trabajador estuvo inactivo durante el mes por vacaciones
- Número de días que el trabajador estuvo activo durante el mes sin disfrutar sus vacaciones. (Vacaciones NO disfrutadas).
PATH: /root/@cantidad
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
fechaInicio
String
AN|10
NO
Este dato se debe diligenciar solamente en el registro del mes en que el trabajador presenta el inicio del disfrute de sus vacaciones en tiempo.
PATH: /root/@fechaInicio
fechaFin
String
AN|10
NO
Este dato se debe diligenciar solamente en el registro del mes en que el trabajador regresa o termina el disfrute de sus vacaciones.
PATH: /root/@fechaFin
pago
String
N|..
SI
Corresponde al valor pagado al trabajador, por el descanso remunerado que tiene derecho por haber trabajado un
determinado tiempo. (Vacaciones disfrutadas)
Corresponde al valor pagado al trabajador, por el descanso remunerado que no disfrutó y que tiene derecho por haber trabajado un determinado tiempo. (Vacaciones NO disfrutadas).
PATH: /root/@pago
Class.DocumentosReferenciadosNom
Atributo
Tipo Dato
Formato
Requerido
Descripción
cunePred
String
AN..20
SI
Debe corresponder al CUNE del Documento Soporte de Pago de Nómina Electrónica o Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica a Reemplazar
Debe corresponder a la Fecha de Emisión del Documento Soporte de Pago de Nómina Electrónica o Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica a Reemplazar o Eliminar AA-MM-DD
Debe corresponder al Numero de Documento Soporte de Pago de Nómina Electrónica o Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica a Reemplazar
Se debe colocar el nombre de la entidad bancaria donde el trabajador tiene su cuenta para pago de nómina. Si el Método de Pago se realiza de forma Bancaria, este campo es obligatorio.
PATH: .. /root.Pago/@Banco
tipoCuenta
String
AN|..50
NC
Se debe colocar el tipo de cuenta que el trabajador tiene para pago de nómina. Si el Método de Pago se realiza de forma Bancaria, este campo es obligatorio.
PATH: .. /root.Pago/@tipoCuenta
numeroCuenta
String
AN|..50
NC
Se debe colocar el número de la cuenta que el trabajador tiene para pago de nómina. Si el Método de Pago se realiza de forma Bancaria, este campo es obligatorio.
PATH: .. /root.Pago/@numeroCuenta
Class.FechasPagos
Atributo
Tipo Dato
Formato
Requerido
Descripción
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
fechapagonomina
String
AN|10
SI
Fecha de Pago de la Nómina
PATH: root/Fechaspagos/@FechaPago
Class.Periodo
Atributo
Tipo Dato
Formato
Requerido
Descripción
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
fechaIngreso
String
AN|10
SI
Se debe indicar la Fecha de Ingreso del trabajador a la empresa, en formato AAAA-MM-DD
PATH: /root.Periodo/@fechaIngreso
fechaLiquidacionInicio
String
AN|10
SI
Se debe indicar la Fecha de Inicio del Periodo de Liquidación del documento, en formato AAAA-MM-DD
PATH: /root.Periodo/@fechaLiquidacionInicio
fechaLiquidacionFin
String
AN|10
SI
Se debe indicar la Fecha de Fin del Periodo de Liquidación del documento, en formato AAAA-MM-DD
PATH: /root.Periodo/@fechaLiquidacionFin
fechaRetiro
String
AN|10
NO
Se debe indicar la Fecha de Retiro del trabajador a la empresa, en formato AAAA-MM-DD
PATH: /root.Periodo/@fechaRetiro
tiempoLaborado
String
5 caracteres enteros n decimales (días)
NO
Cantidad de Tiempo que lleva laborando el Trabajador en la empresa
Si el trabajador desarrollo durante el presente periodo alguna de las actividades descritas en el Decreto 2090 de 2003, o la norma que lo modifique, adicione o sustituya.
Se debe colocar "0" o "1"
PATH: /root.Trabajador/@altoRiesgoPension
codigoTrabajador
String
N|2
SI
Codigo del trabajador. Campo queda a manejo Interno del Empleador.
PATH: /root.Trabajador/@tipoTrabajador
email
String
-
SI
Email del trabajador para entregarle el Desprendible de Nómina.
PATH: /No.Aplica
extrasNom
Array<ExtensibleNom>
-
NO
Habilitado como campo opcional
PATH: /No definido
lugarTrabajoDepartamentoEstado
String
N|2
SI
Código del departamento actual donde se encontraba ubicado el trabajador o aprendiz en el mes reportado.
PATH: /root.Trabajador/@lugarTrabajoDepartamentoEstado Tabla 4
lugarTrabajoDireccion
String
AN|...100
SI
Debe corresponder a la dirección del lugar físico donde vive el empleado.
PATH: /root.Trabajador/@lugarTrabajoDireccion
lugarTrabajoMunicipioCiudad
String
N|5
SI
Código del municipio o ciudad actual donde se encontraba ubicado el trabajador o aprendiz en el mes reportado.
PATH: /root.Trabajador/@lugarTrabajoMunicipioCiudad Tabla 5
lugarTrabajoPais
String
AN|2
SI
Código del país actual donde se encontraba ubicado el trabajador o aprendiz en el mes reportado.
PATH: /root.Trabajador/@lugarTrabajoPais
numeroDocumento
String
AN|...60
SI
Numero de identificación que actualmente el trabajador o aprendiz
PATH: /Class.Trabajador/@numeroDocumento
primerApellido
String
AN|...60
SI
Primer Apellido del trabajador o aprendiz.
PATH: /root4.Trabajador/@primerApellido
primerNombre
String
AN|...60
SI
Primer Nombre del trabajador o aprendiz.
PATH: /root.Trabajador/@primerNombre
otrosNombres
String
AN|...60
NO
Otros Nombres del trabajador o aprendiz
PATH: /root.Trabajador/@otrosNombres
salarioIntegral
String
N|1
SI
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. True = 1 False = 0
PATH: /root.Trabajador/@salarioIntegral
segundoApellido
String
AN|...60
SI
Segundo Apellido del trabajador o aprendiz.
PATH: /root.Trabajador/@segundoApellido
subTipoTrabajador
String
N|2
SI
Código del Sub tipo de trabajador del Ministerio de salud. Aportes a Seguridad Social de Activos.
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.
PATH: /root.Trabajador/@sueldo
tipoContrato
String
N|1
SI
Tipo de Contrato que posee el empleado con el Empleador.
Etiqueta asignada para la Representación Impresa PDF.
PATH: /Variable
controlInterno2
String
AN|..
C/C
Permite asociar dos o más campos mediante un índice (si los campos son asociables).
PATH: /Variable
nombre
String
AN|..
SI
Código del campo extensible a referenciar.
PATH: /Variable
valor
String
AN|..
SI
Valor del campo a agregar.
PATH: /Variable
RESPONSE
Parámetros a Recibir
Tipo
Identificación
Descripción
int
código
Indica el Estado de la operación retornado por el servicio, (Por definir catálogo)
String
mensaje
Este mensaje está asociado al código de respuesta, útil para identificación de errores
String
resultado
Resultado del consumo del método:" Procesado” ó “Error”.
String
consecutivoDocumento
Prefijo y Consecutivo del Documento concatenado sin separadores. Para el ejemplo anterior corresponde a: “PRUE980338337”
String
cune
Código Único de Nómina Electrónica” correspondiente al documento consultado.
String
trackId
Número de seguimiento, es un UUID, para consultar posteriormente el proceso asíncrono
Array<String>
reglasNotificacionesTFHKA
Reglas de validación en caso de notificación TFHKA
Array<String>
reglasNotificacionesDIAN
Reglas de validación en caso de notificación DIAN
Array<String>
reglasRechazoTFHKA
Reglas de validación en caso de rechazo TFHKA
Array<String>
reglasRechazoDIAN
Reglas de validación en caso de rechazo DIAN
Método ConsultarDocumento
Permite consultar el estado de un documento Soporte de Pago de Nómina Electrónica y Nómina de Ajuste, ante la DIAN, el tipo de entrega y si la misma fue exitosa,además otros parámetros de interés que puedes ser útil en los procesos de control del software de Nómina (ERP) o para el modelo de negocio del empleador emisor.
REQUEST
Parámetros a Enviar
Tipo
Identificador
Descripción
String
tokenEmpresa
Suministrado por The Factory HKA Colombia
tokenPassword
consecutivoDocumentoNom
Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
RESPONSE
Parámetros a Recibir
Tipo
Identificador
Descripción
String
ambiente
Tipo de ambiente de generación del documento:
“ambienteDePruebas”
“ambienteDeProducción”
String
cadenaCodigoQR
Concatenación cadena del código QR (elemento de control)
String
cadenaCune
Concatenación cadena del código CUNE previo al cálculo por el algoritmo correspondiente del servicio
Int
código
Indica el estado de la operación retornado por el servicio
String
cune
“Código Único de Nómina Electrónica” correspondiente al documento consultado, calculado por el algoritmo correspondiente del servicio.
String
descripcionDocumento
Identificador del tipo de documento de referencia,
Ejemplo: “Nómina Individual o Nómina Ajuste”
String
descripcionEstatusDocumento
Descripción correspondiente al estatusDocumento ante la DIAN: “La Nomina Individual, ha sido autorizada”
String
estatusDocumento
Código obtenido en la respuesta correspondiente al estado del documento ante la DIAN ("200","109")
String
esValidoDIAN
“true” Si es válido
“false” Si no es válido
String
fechaAceptacionDIAN
Día y Hora en la que la DIAN aceptó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
String
fechaDocumento
Fecha en la que se generó el documento, en formato: AAAA-MM-DD
String
mensaje
Este mensaje está asociado al código, útil para identificación de errores
String
mensajeDocumento
Entrega una descripción del error de cada una de las validaciones iniciales. Si no hay errores no entrega descripción
String
reglasValidacionDIAN
Mensajes de validación por parte de la DIAN
String
resultado
Resultado del consumo del método:
“Procesado” ó “Error”
String
trackID
Este elemento corresponde al TrackId del documento procesado