Métodos Servicio Emisión Nómina Electrónica - Indice Manual Integración Nómina Electrónica

Método Enviar

La función encargada de construir y enviar los documentos de soporte de pago de Nómina Electrónica a la DIAN.

REQUEST

Parámetros a Enviar

Tipo	Identificador	Descripción
String	idSoftware	Identificador Software: Identificador del software habilitado para la emisión de nóminas
String	tokenEmpresa	Suministrado por el proveedor tecnológico
	tokenPassword
String	nitEmpleador	Debe corresponder al NIT del Empleador que realiza el DE
Objeto	Nomina	Ver el detalle del Objeto Nomina más abajo

Class.Nómina Electrónica

Atributo	Tipo Dato	Formato	Requerido	Descripción
consecutivoDocumento	String	AN..20	Si	Correlativo/consecutivo del documento electrónico. Concatenación del prefijo + el consecutivo PATH: /root/NumeroSecuencialXML/(@Numero + Consecutivo) Rechazo No se permiten caracteres adicionales como espacios o guiones Rechazo Número de consecutivo debe ser igual o superior al valor inicial del rango de numeración otorgado por la DIAN Rechazo Número de consecutivo debe ser igual o inferior al valor final del rango de numeración otorgado por la DIAN
deducciones	Class	-	SI	Clase relacionada al las deducciones reportadas en el documento PATH: /root/deducciones (ver detalle en Class.Deducciones)
devengados	Class		SI	Hace referencia al concepto de valor devengado de nómina señalado en el numeral 18, articulo 1 de la presente resolución. PATH: root/devengados (ver detalle en Class.Devengados)
documentosReferenciados	Array<DocumentoReferenciado>	-	SI	Clase destinada a la referencia de la nomina individual o nomina de ajuste a reemplazar / eliminar PATH: /root/(tipoNota) (ver detalle en Class.DocumentosReferenciados)
extras	Array<Extras>	-	NO	Campo Opcional PATH:/NoAplica
fechaEmision	String	AN|19	SI	Debe ir la fecha de emisión del documento. Considerando zona horaria de Colombia (-5), en formato AAAA-MM-DD HH:MM:SS PATH: /root/InformacionGeneral/@(FechaGen + HoraGen)
notas	Array<Nota>	-	NO	Información adicional Texto libre, relativo al documento. PATH: /root/Nota. ( Ver detalle en Class.Nota)
novedad	String	N|1	SI	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" o "false" 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 PATH: /root/LugarGeneracionXML ( Ver detalle en Class.LugarGeneracionXM)
pagos	Array<Pago>	-	SI	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. PATH: /root/Pago (ver detalle en Class.Pago)
periodoNomina	String	N|1	SI	Corresponde al Codigo de Periodo de Nómina PATH: /root/InformacionGeneral/@periodoNomina Tabla 10
periodos	Array<Periodo>	AN|19	SI	Corresponde al periodo de generación del documento (periodo laborable del trabajador) PATH: /root/periodo (ver detalle en Class.Periodo)
rangoNumeracion	String	AN..20	SI	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 PATH: /root/redondeo
tipoDocumento	String	N|3	SI	Tipo de documento de identificación que actualmente tiene el trabajador o aprendiz PATH: /root/InformacionGeneral/@TipoXML Tabla 9
tipoMoneda	String	AN|3	SI	Tipo de Moneda utilizada en el documento PATH: /root/InformacionGeneral/@tipoMoneda Tabla 2
tipoNota	String	N|1	SI	Corresponde al tipo de Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica que se desee implementar PATH: /root/tipoNota Tabla 3
totalComprobante	String	N|..	SI	Debe ir el total de: Devengados - Deducciones PATH: /root/comprobanteTotal
totalDeducciones	String	N|..	SI	Valor total de la Suma de todas las Deducciones del Documento PATH: /root/deduccionesTotal
totalDevengados	String	N|..	SI	Valor total de la Suma de todos los Devengados del Documento PATH: /root/devengadosTotal
trm	String	N|..	NO	Tasa Representativa del mercado. Corresponde a la tasa de cambio de la moneda utilizada en el documento en el Campo “TipoMoneda” a Pesos Colombianos. PATH:/root/InformacionGeneral/@trm
trabajador	Class	-	SI	Utilizado para Atributos del Trabajador o Receptor del Documento PATH: /root/Trabajador

Class.Deducciones

Atributo	Tipo Dato	Formato	Requerido	Descripción
afc	String	N|..	NO	Corresponde a (Ahorro Fomento a la construcción) PATH: /root.Deducciones/afc
anticipos	Array<Anticipo>		NO	Utilizado para Todos los Elementos de Anticipos de Deducciones del Documento PATH: …/root.Deducciones/anticipos (ver detalle en Class.Anticipo)
cooperativa	String	N|..	NO	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
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 PATH: …/root.Deducciones/FondoPension (ver detalle en Class.FondoPension)
fondosSP	Array<FondosSP>	-	NO	Clase relacionada a las deducciones realizadas por motivos de fondos de seguridad pensional PATH: …/root.Deducciones/FondoSP (ver detalle en Class.FondoSP)
libranzas	Array<Libranza>	N|..	NO	Utilizado para Todos los Elementos de Libranzas de Deducciones del Documento PATH: …/root.Deducciones/libranzas (ver detalle en Class.Libranza)
otrasDeducciones	Array<OtrasDeducciones>	-	NO	Utilizado para Todos los Elementos de Otras Deducciones del Documento PATH: …/root.Deducciones/otrasDeducciones (ver detalle en Class.OtraDeduccion)
pagosTerceros	Array<PagoTerceros>	-	NO	Utilizado para Todos los Elementos de Pagos a Tercero de Devengos del Documento PATH: …/root.Deducciones/pagosTerceros (ver detalle en Class.PagoTercero)
pensionVoluntaria	String	N|..	NO	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. PATH: …/root.Deducciones/retencionFuente
salud	Array<Salud>	-	SI	Utilizado para Atributos de Salud del Documento. PATH: …/root.Deducciones/Salud (ver detalle en Class.Salud)
sanciones	Array<Sanción>	-	NO	Utilizado para Todos los Elementos de Sanciones de Deducciones del Documento PATH: …/root.Deducciones/sanciones (ver detalle en Class.Sancion)
sindicatos	Array<Sindicato>	-	NO	Utilizado para Todos los Elementos de Sindicatos de Deducciones del Documento. PATH: …/root.Deducciones/sindicatos (ver detalle en Class.Sindicato)

Class.Anticipo

Atributo	Tipo Dato	Formato	Requerido	Descripción
anticipo	String	N|..	NO	Anticipos de Nómina. PATH: /root./@anticipo
extras	Array<Extra>	-	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
extras	Array<Extra>	-	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|..	SI	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
extras	Array<Extra>	-	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

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|..	NO	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
extras	Array<Extra>	-	NO	Habilitado como campo opcional PATH: /No definido

Class.OtraDeduccion

Atributo	Tipo Dato	Formato	Requerido	Descripción
otraDeduccion	String	N|..	NO	Otro tipo de deducción dentro de la Nomina.. PATH: /root./@otraDeduccion
extras	Array<Extra>	-	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
extras	Array<Extra>	-	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
deducciones	String	N|..	SI	Valor Pagado correspondiente a Salud por parte del trabajador PATH: /root./@deduccion
extras	Array<Extra>	-	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
extras	Array<Extra>	-	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
deducciones	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
extras	Array<Extra>	-	NO	Habilitado como campo opcional PATH: /No definido

Class.Devengados

Atributo	Tipo Dato	Formato	Requerido	Descripción
anticipos	Array<Anticipo>	-	NO	Clase relacionada a los devengos correspondientes a anticipos. PATH: ../root.Devengados/anticipos (ver detalle en Class.Anticipo)
auxilios	Array<Auxilios>	-	NO	Utilizado para Todos los Elementos de Auxilios de Devengos del Documento PATH: ../root.Devengados/auxilios (ver detalle en Class.Auxilio)
apoyoSost	String	N|..	NO	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 PATH: ../root.Basico (ver detalle en Class.Basico)
bonificaciones	Array<Bonificaciones>	-	NO	Utilizado para Todos los Elementos de Bonificaciones de Devengos del Documento PATH: ../root.Devengados/bonificaciones (ver detalle en Class.Bonificacion)
bonifRetiro	String	N|..	NO	Valor establecido por mutuo acuerdo por retiro del Trabajador. PATH: ../root.Devengados/bonifRetiro
bonoEPCTVs	Array<BonoEPCTVs>	-	NO	Utilizado para Todos los Elementos de Bonos Electrónicos o de Papel de Servicio, Cheques, Tarjetas, Vales, etc de Devengos del Documento PATH: ../root.Devengados/bonoEPCTVs (ver detalle en Class.BonoEPCTV)
cesantías	Array<Cesantía>	-	NO	Utilizado para Atributos de Cesantías de Devengos del Documento PATH: ../root.Devengados/cesantias (ver detalle en Class.Cesantia)
comisiones	Array<Comisión>	-	NO	Utilizado para Todos los Elementos de Comisiones de Devengos del Documento PATH: ../root.Devengados/comisiones (ver detalle en Class.Comision)
compensaciones	Array<Compensación>	-	NO	Utilizado para Todos los Elementos de Compensaciones de Devengos del Documento PATH: ../root.Devengados/compensaciones (ver detalle en Class.compensacion)
dotacion	String	N|..	NO	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
extras	Array<Extra>	-	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 PATH: /root.Devengado/horasExtras (ver detalle en Class.HoraExtra)
huelgasLegales	Array<HuelgaLegal>	-	NO	Utilizado para Todos los Elementos de Huelgas Legales de Devengos del Documento PATH: /root.Devengados/huelgasLegales (ver detalle en Class.HuelgasLegal)
indemnización	String	N|..	NO	Valor de Indemnización establecido por ley PATH: /root.Devengados/indemnización
incapacidades	Array<Incapacidad>	-	NO	Utilizado para Todos los Elementos de Incapacidades de Devengos del Documento PATH: /root.Devengados/incapacidades (ver detalle en Class.incapacidad)
licencias	Class	-	NO	Utilizado para Todos los Elementos de Licencias de Devengos del Documento PATH: /root.Devengados/licencias (ver detalle en Class.Licencia)
otrosConceptos	Array<OtroConcepto>	-	NO	Utilizado para Todos los Elementos de Otros Conceptos de Devengos del Documento PATH: /root.Devengados/otrosConceptos (ver detalle en Class.OtroConcepto)
pagosTerceros	Array<PagoTercero>	-	NO	Utilizado para Todos los Elementos de Pagos a Tercero de Devengos del Documento PATH: /root.Devengados/pagosTerceros (ver detalle en Class.PagoTercero)
primas	Array<Prima>	-	NO	Utilizado para Atributos de Primas de Devengos del Documento PATH: /root.Devengados/primas (ver detalle en Class.Prima)
reintegro	String	N|..	NO	Valor que le regresa la empresa al trabajador por una deducción mal realizada en otro pago de nomina PATH: /root.Devengados/reintegro
teletrabajo	String	N|..	NO	Valor que debe ser pagado al trabajador cuyo contrato indica expresamente que puede laborar mediante teletrabajo PATH: /No Aplica
transporte	Array<Transporte>	-	NO	Utilizado para Atributos de Transporte de Devengos del Documento PATH: /root.Transporte (ver detalle en Class.Transporte)
vacaciones	Class	-	NO	Utilizado para Todos los Elementos de Vacaciones de Devengos del Documento PATH: /root.Devengados/vacaciones (ver detalle en Class.Vacacion)

Class.Anticipo

Atributo	Tipo Dato	Formato	Requerido	Descripción
anticipo	String	N|..	NO	Anticipos de Nómina. PATH: /root./@anticipo
extras	Array<Extra>	-	NO	Habilitado como campo opcional PATH: /No definido

Class.Auxilio

Atributo	Tipo Dato	Formato	Requerido	Descripción
auxilioNS	String	N|..	NO	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
extras	Array<Extra>	-	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
extras	Array<Extra>	-	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|..	SI	Corresponde al valor que el empleador paga de forma periódica al trabajador como contraprestación por el trabajo realizado. PATH: /root/@bonificacionNS
extras	Array<Extra>	-	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
extras	Array<Extra>	-	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
extras	Array<Extra>	-	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
extras	Array<Extra>	-	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 Extraordinarias. PATH: root./@compensacionE
extras	Array<Extra>	-	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
extras	Array<Extra>	-	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
horaFin	String	AN|19	NO	Hora de fin de Hora Extra según el tipo. PATH: /root/HorasExtras(Tipo)/@horaFin
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. PATH: /root/HorasExtras(Tipo)/@porcentaje
tipoHorasExtra	String	N|1	C/C	Tipo de Hora Extra. PATH: /root/HorasExtras(Tipo) Tabla 15

Class.HuelgaLegal

Atributo	Tipo Dato	Formato	Requerido	Descripción
cantidad	String	N|..	SI	Número de días que el trabajador estuvo inactivo por huelga legalmente declarada. PATH: /root/@cantidad
extras	Array<Extra>	-	NO	Habilitado como campo opcional PATH: /No definido
fechaInicio	String	AN|10	NO	Fecha donde da inicio la huelga legalmente declarada. PATH: /root/@fechaInicio
fechaFin	String	AN|10	NO	Fecha donde termina la huelga legalmente declarada. PATH: /root/@fechaFin

Class.Incapacidad

Atributo	Tipo Dato	Formato	Requerido	Descripción
cantidad	String	N|..	SI	Número de días que el trabajador estuvo inactivo por incapacidad. PATH: /root/Incapacidad/@cantidad
extras	Array<Extra>	-	NO	Habilitado como campo opcional PATH: /No definido
fechaInicio	String	AN|10	NO	Fecha donde da inicio la huelga legalmente declarada. PATH: /root/Incapacidad/@fechaInicio
fechaFin	String	AN|10	NO	Fecha fin de incapacidad del trabajador. PATH: /root/.Incapacidad/@fechaFin
pago	String	N|..	SI	Valor de la prestación económica pagada al trabajador por consecuencia de la falta de capacidad laboral. PATH: /root/Incapacidad/@pago
tipo	String	N|1	SI	Se debe indicar el código al cual corresponda el tipo de incapacidad del Empleado. PATH: /root/.Incapacidad/@fechaFin Tabla 16

Class.Licencia

Atributo	Tipo Dato	Formato	Requerido	Descripción
extras	Array<Extra>	-	NO	PATH: /No definido
licenciaMP	Array<LicenciaMP>	-	SI	Clase relacionada a los devengos correspondientes con Licencias de Maternidad o Paternidad PATH: /root/Licencias/licenciaMP (ver detalle en Class.LicenciaMP)
licenciaNR	Array<LicenciaNR>	-	SI	Utilizado para Atributos de Licencia No Remunerada del Documento PATH: /root/Licencias/licenciaNR (ver detalle en Class.LicenciaNP)
licenciaR	Array<LicenciaR>	-	SI	Utilizado para Atributos de Licencia Remunerada del Documento PATH: /root/Licencias/licenciaR (ver detalle en Class.LicenciaR)

Class.LicenciaMP

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/@cantidad
extras	Array<Extra>	-	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 corresponde a tiempo de descanso o no laborado Nota: Este campo no es valido para Licencias No Remuneradas". 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
extras	Array<Extra>	-	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
pago	String	N|..	SI	"Valor pagado al trabajador corresponde a tiempo de descanso o no laborado Nota: Este campo no es valido para Licencias No Remuneradas". PATH: /root/Licencias/licenciaNR/pago

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
extras	Array<Extra>	-	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 de descanso o no laborado Nota: Este campo no es valido para Licencias No Remuneradas". 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. PATH: /root/@descripcionConcepto
extras	Array<Extra>	-	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
extras	Array<Extra>	-	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
extras	Array<Extra>	-	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
extras	Array<Extra>	-	NO	Habilitado como campo opcional PATH: /No definido
sueldoTrabajado	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
extras	Array<Extra>	-	NO	Habilitado como campo opcional PATH: /No definido
vacaciónesComunes	Array<VacaciónesComunes>	-	NO	Utilizado para Atributos de Vacaciones Comunes del Documento PATH: root/Vacaciones/VacaciónesComunes (ver detalle en Class.VacaciónesComunes)
vacaciónesCompensadas	Array<VacaciónesCompensadas>	-	NO	Utilizado para Atributos de Vacaciones Compensadas del Documento PATH: root/Vacaciones/VacaciónesCompensadas (ver detalle en Class.VacaciónesCompensadas)

Class.VacaciónesComunes

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
extras	Array<Extra>	-	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
extras	Array<Extra>	-	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.DocumentosReferenciados

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 PATH: /root.documentosReferenciadoS/@CUNEPred Tabla 17
extras	Array<Extra>	-	NO	Habilitado como campo opcional PATH: /No definido
fechaGenPred	String	AN|10	SI	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 PATH: /root.documentosReferenciados/fechaGenPred
numeroPred	String	AN..20	SI	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 PATH: …/root.documentosReferenciados/numeroPred

Class.Nota

Atributo	Tipo Dato	Formato	Requerido	Descripción
descripción	String	-	NO	Campo de libre uso para Observaciones en el documento PATH: .. /root.notas/descripción
extras	Array<Extra>	-	NO	Habilitado como campo opcional PATH: /No definido

Class.LugarGeneracionXML

Atributo	Tipo Dato	Formato	Requerido	Descripción
departamentoEstado	String	N|2	SI	Código del departamento donde se genera el documento PATH: ../root.LugarGeneracionXML/departamentoEstado Tabla 4
extras	Array<Extra>	-	NO	Habilitado como campo opcional PATH: /No definido
idioma	String	N|2	SI	Codigo del país donde se genera el documento PATH: ../root.LugarGeneracionXML/idioma
municipioCiudad	String	N|5	SI	Código del municipio o ciudad donde se genera el documento PATH: ../root.LugarGeneracionXML/municipioCiudad Tabla 5
pais	String	AN|2	SI	PATH: ../root.LugarGeneracionXML/municipioCiudad Tabla 11

Class.Pago

Atributo	Tipo Dato	Formato	Requerido	Descripción
extras	Array<Extra>	-	NO	Habilitado como campo opcional PATH: /No definido
fechasPagos	Array<FechasPago>	-	SI	Utilizado para Todos los Elementos de Fechas de Pagos del Documento PATH: .. /root/FechasPagos (ver detalle en Class.FechasPagos)
fechapagonomina	String	AN|10	SI	Fecha de Pago de la Nómina PATH: .. /root.Fechaspagos/@FechaPago
metodoDePago	String	N|1	SI	Metodos de Pago del Documento PATH: ../root.Pago/@Forma Tabla 7
medioPago	String	AN|3	SI	Medios de Pago del Documento PATH: .. /root.Pago/@Metodo Tabla 6
nombreBanco	String	AN|..50	NC	Nombre de Entidad Bancaria del Empleado donde se realiza la consignación PATH: .. /root.Pago/@Banco
tipoCuenta	String	AN|..50	NC	Tipo de Cuenta Bancaria del Empleado donde se realiza la consignación PATH: .. /root.Pago/@tipoCuenta
numeroCuenta	String	AN|..50	NC	Numero de Cuenta Bancaria del Empleado donde se realiza la consignación PATH: .. /root.Pago/@numeroCuenta

Class.FechasPagos

Atributo	Tipo Dato	Formato	Requerido	Descripción
extras	Array<Extra>	-	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
extras	Array<Extra>	-	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 PATH: /root.Periodo/@tiempoLaborado Tabla 8

Class.Trabajador

Atributo	Tipo Dato	Formato	Requerido	Descripción
altoRiesgoPension	String	N|1	SI	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	Código del tipo de trabajador del Ministerio de salud. Aportes a Seguridad Social de Activos. PATH: /root.Trabajador/@tipoTrabajador
email	String	-	SI	Email del trabajador para entregarle el Desprendible de Nómina. PATH: /No.Aplica
extras	Array<Extra>	-	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
codigoTrabajador	String	N|2	SI	Campo Opcional queda a manejo Interno del Empleador. PATH: /root.Trabajador/@tipoTrabajador
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	NO	Otros Nombres del trabajador o aprendiz. PATH: /root.Trabajador/@otrosNombres
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
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. 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. PATH: /root.Trabajador/@subTipoTrabajador Tabla 13
sueldo	String	N|..	SI	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. PATH: /root.Trabajador/@tipoContrato Tabla 14
tipoIdentificacion	String	N|2	SI	Tipo de documento de identificación que actualmente tiene el trabajador, aprendiz, o pasante. PATH: /root.Trabajador/@TipoDocumento
tipoTrabajador	String	N|2	SI	Código del tipo de trabajador del Ministerio de salud. Aportes a Seguridad Social de Activos.. PATH: /root.Trabajador/@tipoTrabajador Tabla 12

Class.Extras

Atributo	Tipo Dato	Formato	Requerido	Descripción
controlInterno1	String	AN|..	C/C	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	notificacionesTFHKA	Reglas de validación en caso de notificación TFHKA
Array	notificacionesDIAN	Reglas de validación en caso de notificación DIAN
Array	rechazoTFHKA	Reglas de validación en caso de rechazo TFHKA
Array	rechazoDIAN	Nombre definido por la DIAN
String	nitEmpleador	Indica el nit del empleador
String	nitEmpleado	Indica el nit del empleado
String	idSoftware	Identificador de Casa de Software
String	qr	Concatenación cadena del código QR (elemento de control)
Bolean	esvalidoDIAN	“true” Si es válido