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	Corresponde al NIT del Empleador emisor
String	tokenEmpresa	Utilice los Suministrado por el proveedor tecnológico en ambiente Demo.
	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
consecutivoDocumentoNom	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 No se permiten caracteres numéricos en el prefijo.
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)
documentosReferenciadosNom	Array<DocumentosReferenciadosNom>	-	SI	Clase destinada a la referencia de la nomina individual o nomina de ajuste a reemplazar / eliminar PATH: /root/(tipoNota) (ver detalle en Class.DocumentosReferenciadosNom)
extrasNom	Array<ExtensibleNom>	-	NO	Campo Opcional PATH:/NoAplica
fechaEmisionNom	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 = 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 PATH: /root/LugarGeneracionXML ( Ver detalle en Class.Class.LugarGeneracionXML)
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)
rangoNumeracionNom	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
tipoDocumentoNom	String	N|3	SI	Tipo de XML del Documento PATH: /root/InformacionGeneral/@TipoXML Tabla 9
tipoMonedaNom	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
anticiposNom	Array<AnticiposNom>		NO	Utilizado para Todos los Elementos de Anticipos de Deducciones del Documento PATH: …/root.Deducciones/anticipos (ver detalle en Class.AnticiposNom)
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
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 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)
reintegro	String	N|..	NO	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. PATH: ../root.Devengados/anticiposNom (ver detalle en Class.AnticiposNom)
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.Bonificación)
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.Comisión)
compensaciones	Array<Compensación>	-	NO	Utilizado para Todos los Elementos de Compensaciones de Devengos del Documento PATH: ../root.Devengados/compensaciones (ver detalle en Class.Compensación)
dotación	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
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 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.Vacaciónes)

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.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
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. 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
extrasNom	Array<ExtensibleNom>	-	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
extrasNom	Array<ExtensibleNom>	-	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
extrasNom	Array<ExtensibleNom>	-	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
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 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
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 PATH: /root.documentosReferenciadosNom/@CUNEPred Tabla 17
extrasNom	Array<ExtensibleNom>	-	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.documentosReferenciadosNom/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.documentosReferenciadosNom/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
extrasNom	Array<ExtensibleNom>	-	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
extrasNom	Array<ExtensibleNom>	-	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
extrasNom	Array<ExtensibleNom>	-	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	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 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	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. 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.ExtrasNom

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<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
String	tipoDocumento	Identificador del tipo de documento de referencia Ver Tabla 9

Método ConsultarFolios

Permite consultar la cantidad de folios para procesar el Soporte de Pago de Nómina Electrónica y Nómina de Ajuste.

REQUEST

Parámetros a Enviar

Tipo	Identificador	Descripción
String	tokenEmpresa	Suministrado por The Factory HKA Colombia
	tokenPassword

RESPONSE

Parámetros a Recibir

Tipo	Identificador	Descripción
Int	código	Indica el estado de la operación retornado por el servicio
String	mensaje	Este mensaje está asociado al código, útil para identificación de errores
String	resultado	Resultado del consumo del método: “Procesado” ó “Error”
Int	foliosRestantes	Cantidad de folios disponibles

Método EnviarCorreo

Permite reenviar a una direccion de correo electrónico el Soporte de Pago de Nómina Electrónica y Nómina de Ajuste.

REQUEST

Parámetros a Enviar

Tipo	Identificador	Descripción
String	tokenEmpresa	Suministrado por The Factory HKA Colombia
	tokenPassword
	email	Direccion de correo electrónico del empleado
	consecutivoDocumentoNom	Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212

RESPONSE

Parámetros a Recibir

Tipo	Identificador	Descripción
Int	código	Indica el estado de la operación retornado por el servicio
String	mensaje	Este mensaje está asociado al código, útil para identificación de errores
String	resultado	Resultado del consumo del método: “Procesado” ó “Error”

Método DescargarXML

Permite descargar documento Soporte de Pago de Nómina Electrónica, Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica en formato XML.

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
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	documento	Documento XML codificado en Base64
String	hash	Código de detección de errores
String	mensaje	Este mensaje está asociado al código, útil para identificación de errores
String	nombre	Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”
String	resultado	Resultado del consumo del método: “Procesado” ó “Error”

Método DescargarPDF

Permite descargar la representación gráfica de un documento Soporte de Pago de Nómina Electrónica y Nómina de Ajuste.

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
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	documento	Documento PDF codificado en Base64
String	hash	Código de detección de errores
String	mensaje	Este mensaje está asociado al código, útil para identificación de errores
String	nombre	Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”
String	resultado	Resultado del consumo del método: “Procesado” ó “Error”