Diferencia entre revisiones de «Métodos Servicio Emisión Nómina Electrónica - Indice Manual Integración Nómina Electrónica»
(→Class.DocumentoReferenciado) |
(→Método Enviar) |
||
(No se muestran 41 ediciones intermedias de 2 usuarios) | |||
Línea 12: | Línea 12: | ||
|String | |String | ||
|idSoftware | |idSoftware | ||
− | | | + | |Corresponde al NIT del Empleador emisor |
|- | |- | ||
|rowspan="2"|String | |rowspan="2"|String | ||
|tokenEmpresa | |tokenEmpresa | ||
− | |rowspan="2"|Suministrado por el proveedor tecnológico | + | |rowspan="2"|Utilice los Suministrado por el proveedor tecnológico en ambiente Demo. |
|- | |- | ||
|tokenPassword | |tokenPassword | ||
Línea 36: | Línea 36: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |consecutivoDocumentoNom |
|String | |String | ||
|<nowiki>AN..20</nowiki> | |<nowiki>AN..20</nowiki> | ||
|Si | |Si | ||
| | | | ||
− | : Correlativo/consecutivo del documento electrónico. Concatenación del prefijo + el | + | : Correlativo/consecutivo del documento electrónico. Concatenación del prefijo + el consecutivo |
: '''PATH''': /root/NumeroSecuencialXML/(@Numero + Consecutivo) | : '''PATH''': /root/NumeroSecuencialXML/(@Numero + Consecutivo) | ||
+ | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> No se permiten caracteres adicionales como espacios o guiones | ||
+ | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> No se permiten caracteres numéricos en el prefijo. | ||
|- | |- | ||
|deducciones | |deducciones | ||
Línea 60: | Línea 62: | ||
: Hace referencia al concepto de valor devengado de nómina señalado en el numeral 18, articulo 1 de la presente resolución. | : 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 | : '''PATH''': root/devengados | ||
− | : (ver detalle en [[#Class. | + | : (ver detalle en [[#Class.Devengados|Class.Devengados]]) |
|- | |- | ||
− | | | + | |documentosReferenciadosNom |
− | |Array< | + | |Array<DocumentosReferenciadosNom> |
| - | | - | ||
|SI | |SI | ||
Línea 69: | Línea 71: | ||
: Clase destinada a la referencia de la nomina individual o nomina de ajuste a reemplazar / eliminar | : Clase destinada a la referencia de la nomina individual o nomina de ajuste a reemplazar / eliminar | ||
: '''PATH''': /root/(tipoNota) | : '''PATH''': /root/(tipoNota) | ||
− | : (ver detalle en [[#Class. | + | : (ver detalle en [[#Class.DocumentosReferenciadosNom|Class.DocumentosReferenciadosNom]]) |
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 79: | Línea 81: | ||
: '''PATH''':/NoAplica | : '''PATH''':/NoAplica | ||
|- | |- | ||
− | | | + | |fechaEmisionNom |
|String | |String | ||
|<nowiki>AN|19</nowiki> | |<nowiki>AN|19</nowiki> | ||
Línea 102: | Línea 104: | ||
| | | | ||
: 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. | : 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 | + | :Se debe colocar true = 1, false = 0. |
: '''PATH''': /root/Novedad | : '''PATH''': /root/Novedad | ||
|- | |- | ||
Línea 120: | Línea 122: | ||
: Utilizado para Atributos del Lugar de Generación del Documento XML | : Utilizado para Atributos del Lugar de Generación del Documento XML | ||
: '''PATH''': /root/LugarGeneracionXML | : '''PATH''': /root/LugarGeneracionXML | ||
− | : ( Ver detalle en [[#Class. | + | : ( Ver detalle en [[#Class.Class.LugarGeneracionXML|Class.Class.LugarGeneracionXML]]) |
|- | |- | ||
|pagos | |pagos | ||
Línea 138: | Línea 140: | ||
: Corresponde al Codigo de Periodo de Nómina | : Corresponde al Codigo de Periodo de Nómina | ||
: '''PATH''': /root/InformacionGeneral/@periodoNomina | : '''PATH''': /root/InformacionGeneral/@periodoNomina | ||
+ | : [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 10|Tabla 10]] | ||
|- | |- | ||
|periodos | |periodos | ||
Línea 148: | Línea 151: | ||
: (ver detalle en [[#Class.Periodo|Class.Periodo]]) | : (ver detalle en [[#Class.Periodo|Class.Periodo]]) | ||
|- | |- | ||
− | | | + | |rangoNumeracionNom |
|String | |String | ||
|<nowiki>AN..20</nowiki> | |<nowiki>AN..20</nowiki> | ||
|SI | |SI | ||
| | | | ||
− | : Consecutivo desde el que comienza la serie para el documento a emitir, siempre debe colocarse el prefijo (con guión) | + | : 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 | : '''PATH''': /root/NumeroSecuencialXML/@Prefijo | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
|redondeo | |redondeo | ||
Línea 171: | Línea 167: | ||
: '''PATH''': /root/redondeo | : '''PATH''': /root/redondeo | ||
|- | |- | ||
− | | | + | |tipoDocumentoNom |
|String | |String | ||
|<nowiki>N|3</nowiki> | |<nowiki>N|3</nowiki> | ||
|SI | |SI | ||
| | | | ||
− | : Tipo de | + | : Tipo de XML del Documento |
: '''PATH''': /root/InformacionGeneral/@TipoXML | : '''PATH''': /root/InformacionGeneral/@TipoXML | ||
− | : [[ | + | : [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 9|Tabla 9]] |
|- | |- | ||
− | | | + | |tipoMonedaNom |
|String | |String | ||
|<nowiki>AN|3</nowiki> | |<nowiki>AN|3</nowiki> | ||
Línea 187: | Línea 183: | ||
: Tipo de Moneda utilizada en el documento | : Tipo de Moneda utilizada en el documento | ||
: '''PATH''': /root/InformacionGeneral/@tipoMoneda | : '''PATH''': /root/InformacionGeneral/@tipoMoneda | ||
− | : [[ | + | : [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 2|Tabla 2]] |
|- | |- | ||
|tipoNota | |tipoNota | ||
Línea 196: | Línea 192: | ||
: Corresponde al tipo de Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica que se desee implementar | : Corresponde al tipo de Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica que se desee implementar | ||
: '''PATH''': /root/tipoNota | : '''PATH''': /root/tipoNota | ||
− | : [[ | + | : [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 3|Tabla 3]] |
|- | |- | ||
|totalComprobante | |totalComprobante | ||
Línea 238: | Línea 234: | ||
: '''PATH''': /root/Trabajador | : '''PATH''': /root/Trabajador | ||
|} | |} | ||
+ | |||
====Class.Deducciones==== | ====Class.Deducciones==== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
Línea 254: | Línea 251: | ||
: '''PATH''': /root.Deducciones/afc | : '''PATH''': /root.Deducciones/afc | ||
|- | |- | ||
− | | | + | |anticiposNom |
− | |Array< | + | |Array<AnticiposNom> |
| | | | ||
|NO | |NO | ||
Línea 261: | Línea 258: | ||
: Utilizado para Todos los Elementos de Anticipos de Deducciones del Documento | : Utilizado para Todos los Elementos de Anticipos de Deducciones del Documento | ||
: PATH: …/root.Deducciones/anticipos | : PATH: …/root.Deducciones/anticipos | ||
− | : (ver detalle en [[#Class. | + | : (ver detalle en [[#Class.AnticiposNom|Class.AnticiposNom]]) |
|- | |- | ||
|cooperativa | |cooperativa | ||
Línea 278: | Línea 275: | ||
: 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. | : 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 | : '''PATH''': …/root.Deducciones/deuda | ||
+ | |- | ||
+ | |extrasNom | ||
+ | |Array<ExtensibleNom> | ||
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | :Habilitado como campo opcional | ||
+ | : '''PATH''': /No definido | ||
|- | |- | ||
|educación | |educación | ||
Línea 300: | Línea 305: | ||
|SI | |SI | ||
| | | | ||
− | : | + | : Clase relacionada a las deducciones realizadas por motivos de fondos de pensión |
: '''PATH''': …/root.Deducciones/FondoPension | : '''PATH''': …/root.Deducciones/FondoPension | ||
: (ver detalle en [[#Class.FondoPension|Class.FondoPension]]) | : (ver detalle en [[#Class.FondoPension|Class.FondoPension]]) | ||
Línea 309: | Línea 314: | ||
|NO | |NO | ||
| | | | ||
− | : | + | : Clase relacionada a las deducciones realizadas por motivos de fondos de seguridad pensional |
: '''PATH''': …/root.Deducciones/FondoSP | : '''PATH''': …/root.Deducciones/FondoSP | ||
: (ver detalle en [[#Class.FondoSP|Class.FondoSP]]) | : (ver detalle en [[#Class.FondoSP|Class.FondoSP]]) | ||
Línea 390: | Línea 395: | ||
: '''PATH''': …/root.Deducciones/sindicatos | : '''PATH''': …/root.Deducciones/sindicatos | ||
: (ver detalle en [[#Class.Sindicato|Class.Sindicato]]) | : (ver detalle en [[#Class.Sindicato|Class.Sindicato]]) | ||
+ | |- | ||
+ | |reintegro | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |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. | + | =====Class.AnticiposNom===== |
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 399: | Línea 412: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |montoanticipo |
|String | |String | ||
|<nowiki>N|..</nowiki> | |<nowiki>N|..</nowiki> | ||
Línea 405: | Línea 418: | ||
| | | | ||
:Anticipos de Nómina. | :Anticipos de Nómina. | ||
− | : '''PATH''': /root./@ | + | : '''PATH''': /root./@anticiposNom |
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 415: | Línea 428: | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
|} | |} | ||
− | ====Class.FondoPension==== | + | |
+ | =====Class.FondoPension===== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 431: | Línea 445: | ||
: '''PATH''': /root./@deduccion | : '''PATH''': /root./@deduccion | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 447: | Línea 461: | ||
: '''PATH''': /root/@porcentaje | : '''PATH''': /root/@porcentaje | ||
|} | |} | ||
− | ====Class.FondoSP==== | + | =====Class.FondoSP===== |
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 458: | Línea 472: | ||
|String | |String | ||
|<nowiki>N|..</nowiki> | |<nowiki>N|..</nowiki> | ||
− | | | + | |NO |
| | | | ||
:Valor Pagado correspondiente a Fondo de Solidaridad Pensional por parte del trabajador. | :Valor Pagado correspondiente a Fondo de Solidaridad Pensional por parte del trabajador. | ||
Línea 471: | Línea 485: | ||
: '''PATH''': /root./@deduccionSub | : '''PATH''': /root./@deduccionSub | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 486: | Línea 500: | ||
:Debe corresponder al porcentaje de deducción de fondo de seguridad pensional que paga el trabajador. | :Debe corresponder al porcentaje de deducción de fondo de seguridad pensional que paga el trabajador. | ||
: '''PATH''': /root/@porcentaje | : '''PATH''': /root/@porcentaje | ||
+ | |- | ||
+ | |porcentajeSub | ||
+ | |String | ||
+ | |<nowiki>N|4-6</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Se debe colocar el Porcentaje que correspondiente al Fondo de Subsistencia correspondiente. | ||
+ | : '''PATH''': /root/@porcentajeSub | ||
|} | |} | ||
− | ====Class. | + | |
+ | =====Class.Libranza===== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 495: | Línea 518: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |descripción |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>AN|..</nowiki> |
|SI | |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./@ | + | : '''PATH''': /root./@descripcion |
|- | |- | ||
− | | | + | |deduccion |
|String | |String | ||
|<nowiki>N|..</nowiki> | |<nowiki>N|..</nowiki> | ||
− | | | + | |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./@ | + | : '''PATH''': /root./@deduccion |
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 518: | Línea 541: | ||
:Habilitado como campo opcional | :Habilitado como campo opcional | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
− | ====Class. | + | |
+ | =====Class.OtraDeduccion===== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 535: | Línea 551: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |montootraDeduccion |
|String | |String | ||
− | + | |<nowiki>N|..</nowiki> | |
− | + | |NO | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |<nowiki>N|..</nowiki> | ||
− | |NO | ||
| | | | ||
:Otro tipo de deducción dentro de la Nomina.. | :Otro tipo de deducción dentro de la Nomina.. | ||
: '''PATH''': /root./@otraDeduccion | : '''PATH''': /root./@otraDeduccion | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 584: | Línea 568: | ||
|} | |} | ||
− | ====Class.PagoTercero==== | + | =====Class.PagoTercero===== |
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 600: | Línea 584: | ||
: '''PATH''': /root./@pagoTercero | : '''PATH''': /root./@pagoTercero | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 608: | Línea 592: | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
|} | |} | ||
− | ====Class.Salud==== | + | =====Class.Salud===== |
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 624: | Línea 608: | ||
: '''PATH''': /root./@porcentaje | : '''PATH''': /root./@porcentaje | ||
|- | |- | ||
− | | | + | |deduccion |
|String | |String | ||
|<nowiki>N|..</nowiki> | |<nowiki>N|..</nowiki> | ||
Línea 632: | Línea 616: | ||
: '''PATH''': /root./@deduccion | : '''PATH''': /root./@deduccion | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 640: | Línea 624: | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
|} | |} | ||
− | ====Class.Sancion==== | + | |
+ | =====Class.Sancion===== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 664: | Línea 649: | ||
: '''PATH''': /root./@sancionPriv | : '''PATH''': /root./@sancionPriv | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 672: | Línea 657: | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
|} | |} | ||
− | ====Class.Sindicato==== | + | =====Class.Sindicato===== |
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 688: | Línea 673: | ||
: '''PATH''': /root./@porcentaje | : '''PATH''': /root./@porcentaje | ||
|- | |- | ||
− | | | + | |deduccion |
|String | |String | ||
|<nowiki>N|..</nowiki> | |<nowiki>N|..</nowiki> | ||
Línea 696: | Línea 681: | ||
: '''PATH''': /root./@deduccion | : '''PATH''': /root./@deduccion | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 704: | Línea 689: | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
|} | |} | ||
+ | |||
====Class.Devengados==== | ====Class.Devengados==== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
Línea 712: | Línea 698: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |anticiposNom |
− | |Array< | + | |Array<AnticiposNom> |
| - | | - | ||
|NO | |NO | ||
| | | | ||
:Clase relacionada a los devengos correspondientes a anticipos. | :Clase relacionada a los devengos correspondientes a anticipos. | ||
− | : '''PATH''': ../root.Devengados/ | + | : '''PATH''': ../root.Devengados/anticiposNom |
− | : (ver detalle en [[#Class. | + | : (ver detalle en [[#Class.AnticiposNom|Class.AnticiposNom]]) |
|- | |- | ||
|auxilios | |auxilios | ||
Línea 754: | Línea 740: | ||
: Utilizado para Todos los Elementos de Bonificaciones de Devengos del Documento | : Utilizado para Todos los Elementos de Bonificaciones de Devengos del Documento | ||
: '''PATH''': ../root.Devengados/bonificaciones | : '''PATH''': ../root.Devengados/bonificaciones | ||
− | : (ver detalle en [[#Class.Bonificacion|Class. | + | : (ver detalle en [[#Class.Bonificacion|Class.Bonificación]]) |
|- | |- | ||
|bonifRetiro | |bonifRetiro | ||
Línea 789: | Línea 775: | ||
: Utilizado para Todos los Elementos de Comisiones de Devengos del Documento | : Utilizado para Todos los Elementos de Comisiones de Devengos del Documento | ||
: '''PATH''': ../root.Devengados/comisiones | : '''PATH''': ../root.Devengados/comisiones | ||
− | : (ver detalle en [[#Class. | + | : (ver detalle en [[#Class.Comisión|Class.Comisión]]) |
|- | |- | ||
|compensaciones | |compensaciones | ||
Línea 798: | Línea 784: | ||
: Utilizado para Todos los Elementos de Compensaciones de Devengos del Documento | : Utilizado para Todos los Elementos de Compensaciones de Devengos del Documento | ||
: '''PATH''': ../root.Devengados/compensaciones | : '''PATH''': ../root.Devengados/compensaciones | ||
− | : (ver detalle en [[#Class. | + | : (ver detalle en [[#Class.Compensación|Class.Compensación]]) |
|- | |- | ||
− | | | + | |dotación |
|String | |String | ||
|<nowiki>N|..</nowiki> | |<nowiki>N|..</nowiki> | ||
Línea 808: | Línea 794: | ||
: '''PATH''': ../root.Devengados/dotación | : '''PATH''': ../root.Devengados/dotación | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 849: | Línea 835: | ||
:Utilizado para Todos los Elementos de Incapacidades de Devengos del Documento | :Utilizado para Todos los Elementos de Incapacidades de Devengos del Documento | ||
: '''PATH''': /root.Devengados/incapacidades | : '''PATH''': /root.Devengados/incapacidades | ||
− | : (ver detalle en [[#Class. | + | : (ver detalle en [[#Class.Incapacidad|Class.Incapacidad]]) |
|- | |- | ||
|licencias | |licencias | ||
Línea 919: | Línea 905: | ||
:Utilizado para Todos los Elementos de Vacaciones de Devengos del Documento | :Utilizado para Todos los Elementos de Vacaciones de Devengos del Documento | ||
: '''PATH''': /root.Devengados/vacaciones | : '''PATH''': /root.Devengados/vacaciones | ||
− | : (ver detalle en [[#Class. | + | : (ver detalle en [[#Class.Vacaciónes|Class.Vacaciónes]]) |
|} | |} | ||
− | + | =====Class.AnticiposNom===== | |
− | ====Class. | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 930: | Línea 915: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |montoanticipo |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|..</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | :Anticipos de Nómina. |
− | : '''PATH''': /root. | + | : '''PATH''': /root./@anticiposNom |
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 945: | Línea 930: | ||
:Habilitado como campo opcional | :Habilitado como campo opcional | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
− | ====Class. | + | =====Class.Auxilio===== |
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 971: | Línea 940: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |auxilioNS |
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Beneficios, ayudas o apoyos económicos, pagados al trabajador de forma ocasional. | ||
+ | : '''PATH''': /root./@auxilioNS | ||
+ | |- | ||
+ | |auxilioS | ||
|String | |String | ||
− | | | + | |<nowiki>N|..</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | :Beneficios, ayudas o apoyos económicos, pagados al trabajador de forma habitual |
− | : '''PATH''': | + | : '''PATH''': /root./@./@auxilioS |
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 987: | Línea 964: | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
|} | |} | ||
− | ====Class. | + | =====Class.Basico===== |
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 995: | Línea 972: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |diasTrabajados |
|String | |String | ||
− | |<nowiki>N|2</nowiki> | + | |<nowiki>N|1-2</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | :Número de días que el trabajador o aprendiz efectivamente estuvo ejecutando sus labores en la empresa. |
− | : '''PATH''': | + | : '''PATH''': /root/@diasTrabajados |
− | |||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1012: | Línea 988: | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
|- | |- | ||
− | | | + | |sueldoTrabajado |
|String | |String | ||
− | |<nowiki>N| | + | |<nowiki>N|..</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | :Corresponde al valor que el empleador paga de forma periódica al trabajador como contraprestación por el trabajo realizado. |
− | : '''PATH''': | + | : '''PATH''': /root/@sueldoTrabajado |
− | : | + | |} |
+ | =====Class.Bonificación===== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |bonificacionNS |
|String | |String | ||
− | |<nowiki>N| | + | |<nowiki>N|..</nowiki> |
− | | | + | |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''': | + | : '''PATH''': /root/@bonificacionNS |
− | |||
|- | |- | ||
− | | | + | |bonificacionS |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|..</nowiki> |
− | | | + | |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 | ||
| | | | ||
− | : '''PATH''': | + | :Habilitado como campo opcional |
− | + | : '''PATH''': /No definido | |
|} | |} | ||
− | ====Class. | + | |
+ | =====Class.BonoEPCTV===== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 1046: | Línea 1037: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |pagoAlimentacionNS |
− | | | + | |String |
− | | | + | |<nowiki>N|..</nowiki> |
|NO | |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''': / | + | : '''PATH''': /root/@pagoAlimentacionNS |
|- | |- | ||
− | | | + | |pagoAlimentacionS |
− | | | + | |String |
− | | | + | |<nowiki>N|..</nowiki> |
− | | | + | |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''': | + | : '''PATH''': /root/@pagoAlimentacionS |
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1070: | Línea 1061: | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
|- | |- | ||
− | | | + | |pagoNS |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|..</nowiki> |
− | + | |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''': | + | : '''PATH''': /root/@pagoNS |
− | |||
|- | |- | ||
− | | | + | |pagoS |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|..</nowiki> |
− | | | + | |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===== | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | : '''PATH''': | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |} | ||
− | ====Class. | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 1127: | Línea 1085: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1135: | Línea 1093: | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
|- | |- | ||
− | | | + | |pago |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|..</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | :Pago de la Cesantias otorgada por Ley. |
− | : '''PATH''': / | + | : '''PATH''': root/.Cesantias/@pago |
− | |- | + | |- |
− | | | + | |pagoIntereses |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|..</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | :Pago de los Intereses de Cesantias otorgada por Ley. |
− | : '''PATH''': / | + | : '''PATH''': root/.Cesantias/@pagoIntereses |
|- | |- | ||
− | | | + | |porcentaje |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|..</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | :Porcentaje que corresponde al Interés de Cesantias de Ley. |
− | : '''PATH''': /root | + | : '''PATH''': /root/Cesantias/@pagoIntereses |
+ | |} | ||
+ | |||
+ | =====Class.Comisión===== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |extrasNom |
− | + | |Array<ExtensibleNom> | |
− | |< | + | | - |
|NO | |NO | ||
| | | | ||
− | : | + | :Habilitado como campo opcional |
− | : '''PATH''': / | + | : '''PATH''': /No definido |
|- | |- | ||
− | | | + | |montocomision |
|String | |String | ||
− | | | + | |<nowiki>N|..</nowiki> |
|NO | |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''': | + | : '''PATH''': root./@comision |
|} | |} | ||
− | ====Class. | + | |
+ | =====Class.Compensación===== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 1183: | Línea 1151: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |compensacionE |
|String | |String | ||
− | |<nowiki>N| | + | |<nowiki>N|..</nowiki> |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|SI | |SI | ||
| | | | ||
− | : | + | :Valor Pagado por Compensaciones Extraordinarias. |
− | : '''PATH''': | + | : '''PATH''': root./@compensacionE |
|- | |- | ||
− | | | + | |compensacionO |
|String | |String | ||
− | | | + | |<nowiki>N|..</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | :Valor Pagado por Compensaciones Ordinarias. |
− | : '''PATH''': / | + | : '''PATH''': root./@compensacionO |
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1214: | Línea 1174: | ||
:Habilitado como campo opcional | :Habilitado como campo opcional | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
− | |- | + | |} |
− | | | + | |
+ | =====Class.HoraExtra===== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |cantidad | ||
|String | |String | ||
− | |<nowiki>N| | + | |<nowiki>N|..</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | :Cantidad de Horas Extra según el tipo. |
− | : '''PATH''': /root | + | : '''PATH''': /root/HorasExtras(Tipo)/@cantidad |
|- | |- | ||
− | | | + | |extrasNom |
− | + | |Array<ExtensibleNom> | |
− | |< | + | | - |
− | | | + | |NO |
| | | | ||
− | : | + | :Habilitado como campo opcional |
− | : '''PATH''': / | + | : '''PATH''': /No definido |
|- | |- | ||
− | | | + | |horaInicio |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>AN|19</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | :Hora de inicio de Hora Extra Según el tipo. |
− | : '''PATH''': /root | + | : '''PATH''': /root/HorasExtras(Tipo)/@horaInicio. En formato YYYY-MM-DDTHH:MM:SS |
|- | |- | ||
− | | | + | |horaFin |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>AN|19</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | :Hora de fin de Hora Extra según el tipo. |
− | : '''PATH''': /root | + | : '''PATH''': /root/HorasExtras(Tipo)/@horaFin. En formato YYYY-MM-DDTHH:MM:SS |
|- | |- | ||
− | | | + | |pago |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|..</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | :Es el valor pagado por el tiempo que se trabaja adicional a la jornada legal o pactada contractualmente. |
− | : '''PATH''': /root | + | : '''PATH''': /root/HorasExtras(Tipo)/@pago |
|- | |- | ||
− | | | + | |porcentaje |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|4-6</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | :Porcentaje al cual corresponde el calculo de 1 hora Extra según el tipo. |
− | : '''PATH''': /root | + | : '''PATH''': /root/HorasExtras(Tipo)/@porcentaje |
|- | |- | ||
− | | | + | |tipoHorasExtra |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|1</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | :Tipo de Hora Extra. |
− | : '''PATH''': / | + | : '''PATH''': /root/HorasExtras(Tipo) |
− | |- | + | : [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 15|Tabla 15]] |
− | | | + | |} |
+ | |||
+ | =====Class.HuelgaLegal===== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |cantidad | ||
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|..</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | :Número de días que el trabajador estuvo inactivo por huelga legalmente declarada. |
− | : '''PATH''': /root | + | : '''PATH''': /root/@cantidad |
|- | |- | ||
− | | | + | |extrasNom |
− | + | |Array<ExtensibleNom> | |
− | |< | + | | - |
− | | | + | |NO |
| | | | ||
− | : | + | :Habilitado como campo opcional |
− | : '''PATH''': / | + | : '''PATH''': /No definido |
|- | |- | ||
− | | | + | |fechaInicio |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|10</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | :Fecha donde da inicio la huelga legalmente declarada. |
− | : '''PATH''': /root | + | : '''PATH''': /root/@fechaInicio |
|- | |- | ||
− | | | + | |fechaFin |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>AN|10</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | :Fecha donde termina la huelga legalmente declarada. |
− | : '''PATH''': /root | + | : '''PATH''': /root/@fechaFin |
+ | |} | ||
+ | =====Class.Incapacidad===== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |cantidad |
|String | |String | ||
|<nowiki>N|..</nowiki> | |<nowiki>N|..</nowiki> | ||
|SI | |SI | ||
| | | | ||
− | : | + | :Número de días que el trabajador estuvo inactivo por incapacidad. |
− | : '''PATH''': /root | + | : '''PATH''': /root/Incapacidad/@cantidad |
|- | |- | ||
− | | | + | |extrasNom |
− | + | |Array<ExtensibleNom> | |
− | |< | + | | - |
− | | | + | |NO |
| | | | ||
− | : | + | :Habilitado como campo opcional |
− | : '''PATH''': / | + | : '''PATH''': /No definido |
|- | |- | ||
− | | | + | |fechaInicio |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>AN|10</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | :Fecha donde da inicio la huelga legalmente declarada. |
− | : '''PATH''': /root | + | : '''PATH''': /root/Incapacidad/@fechaInicio |
|- | |- | ||
− | | | + | |fechaFin |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>AN|10</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | :Fecha fin de incapacidad del trabajador. |
− | : '''PATH''': /root. | + | : '''PATH''': /root/.Incapacidad/@fechaFin |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
+ | |pago | ||
|String | |String | ||
− | | | + | |<nowiki>N|..</nowiki> |
− | | | + | |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 | |String | ||
− | |resultado | + | |<nowiki>N|1</nowiki> |
− | |Resultado del consumo del método:" Procesado” ó “Error”. | + | |SI |
+ | | | ||
+ | :Se debe indicar el código al cual corresponda el tipo de incapacidad del Empleado. | ||
+ | : '''PATH''': /root/.Incapacidad/@fechaFin | ||
+ | : [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 16|Tabla 16]] | ||
+ | |} | ||
+ | |||
+ | =====Class.Licencia===== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|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|Class.LicenciaMP]]) | ||
+ | |- | ||
+ | |licenciaNR | ||
+ | |Array<LicenciaNR> | ||
+ | | - | ||
+ | |SI | ||
+ | | | ||
+ | :Utilizado para Atributos de Licencia No Remunerada del Documento | ||
+ | : '''PATH''': /root/Licencias/licenciaNR | ||
+ | : (ver detalle en [[#Class.LicenciaNR|Class.LicenciaNP]]) | ||
+ | |- | ||
+ | |licenciaR | ||
+ | |Array<LicenciaR> | ||
+ | | - | ||
+ | |SI | ||
+ | | | ||
+ | :Utilizado para Atributos de Licencia Remunerada del Documento | ||
+ | : '''PATH''': /root/Licencias/licenciaR | ||
+ | : (ver detalle en [[#Class.LicenciaR|Class.LicenciaR]]) | ||
+ | |} | ||
+ | ======Class.LicenciaMP====== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |cantidad | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Fecha donde da inicio la Licencia. | ||
+ | : '''PATH''': /Incapacidad/@fechaInicio | ||
+ | |- | ||
+ | |fechaFin | ||
+ | |String | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Fecha donde termina la Licencia. | ||
+ | : '''PATH''': /root/@fechaFin | ||
+ | |- | ||
+ | |pago | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |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====== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |cantidad | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Fecha donde da inicio la Licencia. | ||
+ | : '''PATH''': /root/Licencias/licenciaNR/fechaInicio | ||
+ | |- | ||
+ | |fechaFin | ||
+ | |String | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Fecha donde termina la Licencia. | ||
+ | : '''PATH''': /root/Licencias/licenciaNR/fechaFin | ||
+ | |} | ||
+ | |||
+ | ======Class.LicenciaR====== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |cantidad | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Fecha donde da inicio la Licencia. | ||
+ | : '''PATH''': /root/Licencias/licenciaR/fechaInicio | ||
+ | |- | ||
+ | |fechaFin | ||
+ | |String | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Fecha donde termina la Licencia. | ||
+ | : '''PATH''': /root/Licencias/licenciaR/fechaFin | ||
+ | |- | ||
+ | |pago | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |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===== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |conceptoNS | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Valor Pagado por Conceptos No Salariales. | ||
+ | : '''PATH''': /root/@conceptoNS | ||
+ | |- | ||
+ | |conceptoS | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Valor Pagado por Conceptos Salariales. | ||
+ | : '''PATH''': /root/@conceptoS | ||
+ | |- | ||
+ | |descripcionConcepto | ||
+ | |String | ||
+ | |<nowiki>AN|..</nowiki> | ||
+ | |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===== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |montopagoTercero | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |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===== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |cantidad | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Pagos por el reconocimiento del logro o cumplimiento por parte del trabajador en el desarrollo de sus labores. | ||
+ | : '''PATH''': /root/@pago | ||
+ | |- | ||
+ | |pagoNS | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |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===== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |auxilioTransporte | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Parte de los viáticos pagado al trabajador correspondientes a manutención y/o alojamiento. | ||
+ | : '''PATH''': /root/@sueldoTrabajado | ||
+ | |- | ||
+ | |viaticoManuAlojNS | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Parte de los viáticos pagado al trabajador correspondientes a manutención y/o alojamiento No Salariales. | ||
+ | : '''PATH''': /root/@viaticoManuAlojNS | ||
+ | |} | ||
+ | |||
+ | =====Class.Vacaciónes===== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|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|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ónesCompensadas]]) | ||
+ | |} | ||
+ | ======Class.VacaciónesComunes====== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |cantidad | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |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====== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |cantidad | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |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==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |cunePred | ||
+ | |String | ||
+ | |<nowiki>AN..20</nowiki> | ||
+ | |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 | ||
+ | : [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 17|Tabla 17]] | ||
+ | |- | ||
+ | |extrasNom | ||
+ | |Array<ExtensibleNom> | ||
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | :Habilitado como campo opcional | ||
+ | : '''PATH''': /No definido | ||
+ | |- | ||
+ | |fechaGenPred | ||
+ | |String | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>AN..20</nowiki> | ||
+ | |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==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|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==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |departamentoEstado | ||
+ | |String | ||
+ | |<nowiki>N|2</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | : Código del departamento donde se genera el documento | ||
+ | : '''PATH''': ../root.LugarGeneracionXML/departamentoEstado | ||
+ | : [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 4|Tabla 4]] | ||
+ | |||
+ | |- | ||
+ | |extrasNom | ||
+ | |Array<ExtensibleNom> | ||
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | :Habilitado como campo opcional | ||
+ | : '''PATH''': /No definido | ||
+ | |- | ||
+ | |idioma | ||
+ | |String | ||
+ | |<nowiki>N|2</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | : Codigo del país donde se genera el documento | ||
+ | : '''PATH''': ../root.LugarGeneracionXML/idioma | ||
+ | |- | ||
+ | |municipioCiudad | ||
+ | |String | ||
+ | |<nowiki>N|5</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | : Código del municipio o ciudad donde se genera el documento | ||
+ | : '''PATH''': ../root.LugarGeneracionXML/municipioCiudad | ||
+ | : [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 5|Tabla 5]] | ||
+ | |- | ||
+ | |pais | ||
+ | |String | ||
+ | |<nowiki>AN|2</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | : '''PATH''': ../root.LugarGeneracionXML/municipioCiudad | ||
+ | : [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 11|Tabla 11]] | ||
+ | |} | ||
+ | |||
+ | ====Class.Pago==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|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|Class.FechasPagos]]) | ||
+ | |- | ||
+ | |fechapagonomina | ||
+ | |String | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | : Fecha de Pago de la Nómina | ||
+ | : '''PATH''': .. /root.Fechaspagos/@FechaPago | ||
+ | |- | ||
+ | |metodoDePago | ||
+ | |String | ||
+ | |<nowiki>N|1</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | : Metodos de Pago del Documento | ||
+ | : '''PATH''': ../root.Pago/@Forma | ||
+ | : [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 7|Tabla 7]] | ||
+ | |- | ||
+ | |medioPago | ||
+ | |String | ||
+ | |<nowiki>AN|3</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | : Medios de Pago del Documento | ||
+ | : '''PATH''': .. /root.Pago/@Metodo | ||
+ | : [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 6|Tabla 6]] | ||
+ | |- | ||
+ | |nombreBanco | ||
+ | |String | ||
+ | |<nowiki>AN|..50</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>AN|..50</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>AN|..50</nowiki> | ||
+ | |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===== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |extrasNom | ||
+ | |Array<ExtensibleNom> | ||
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | :Habilitado como campo opcional | ||
+ | : '''PATH''': /No definido | ||
+ | |- | ||
+ | |fechapagonomina | ||
+ | |String | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Fecha de Pago de la Nómina | ||
+ | : '''PATH''': root/Fechaspagos/@FechaPago | ||
+ | |} | ||
+ | |||
+ | ====Class.Periodo==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |extrasNom | ||
+ | |Array<ExtensibleNom> | ||
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | :Habilitado como campo opcional | ||
+ | : '''PATH''': /No definido | ||
+ | |- | ||
+ | |fechaIngreso | ||
+ | |String | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Se debe indicar la Fecha de Ingreso del trabajador a la empresa, en formato AAAA-MM-DD | ||
+ | : '''PATH''': /root.Periodo/@fechaIngreso | ||
+ | |- | ||
+ | |fechaLiquidacionInicio | ||
+ | |String | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>AN|10</nowiki> | ||
+ | |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 | ||
+ | : [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 8|Tabla 8]] | ||
+ | |} | ||
+ | |||
+ | ====Class.Trabajador==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |altoRiesgoPension | ||
+ | |String | ||
+ | |<nowiki>N|1</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>N|2</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>N|2</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Código del departamento actual donde se encontraba ubicado el trabajador o aprendiz en el mes reportado. | ||
+ | : '''PATH''': /root.Trabajador/@lugarTrabajoDepartamentoEstado [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 4|Tabla 4]] | ||
+ | |- | ||
+ | |lugarTrabajoDireccion | ||
+ | |String | ||
+ | |<nowiki>AN|...100</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Debe corresponder a la dirección del lugar físico donde vive el empleado. | ||
+ | : '''PATH''': /root.Trabajador/@lugarTrabajoDireccion | ||
+ | |- | ||
+ | |lugarTrabajoMunicipioCiudad | ||
+ | |String | ||
+ | |<nowiki>N|5</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Código del municipio o ciudad actual donde se encontraba ubicado el trabajador o aprendiz en el mes reportado. | ||
+ | : '''PATH''': /root.Trabajador/@lugarTrabajoMunicipioCiudad [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 5|Tabla 5]] | ||
+ | |- | ||
+ | |lugarTrabajoPais | ||
+ | |String | ||
+ | |<nowiki>AN|2</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>AN|...60</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Numero de identificación que actualmente el trabajador o aprendiz | ||
+ | : '''PATH''': /Class.Trabajador/@numeroDocumento | ||
+ | |- | ||
+ | |primerApellido | ||
+ | |String | ||
+ | |<nowiki>AN|...60</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Primer Apellido del trabajador o aprendiz. | ||
+ | : '''PATH''': /root4.Trabajador/@primerApellido | ||
+ | |- | ||
+ | |primerNombre | ||
+ | |String | ||
+ | |<nowiki>AN|...60</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Primer Nombre del trabajador o aprendiz. | ||
+ | : '''PATH''': /root.Trabajador/@primerNombre | ||
+ | |- | ||
+ | |otrosNombres | ||
+ | |String | ||
+ | |<nowiki>AN|...60</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Otros Nombres del trabajador o aprendiz | ||
+ | : '''PATH''': /root.Trabajador/@otrosNombres | ||
+ | |- | ||
+ | |- | ||
+ | |salarioIntegral | ||
+ | |String | ||
+ | |<nowiki>N|1</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>AN|...60</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Segundo Apellido del trabajador o aprendiz. | ||
+ | : '''PATH''': /root.Trabajador/@segundoApellido | ||
+ | |- | ||
+ | |subTipoTrabajador | ||
+ | |String | ||
+ | |<nowiki>N|2</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Código del Sub tipo de trabajador del Ministerio de salud. Aportes a Seguridad Social de Activos. | ||
+ | : '''PATH''': /root.Trabajador/@subTipoTrabajador | ||
+ | : [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 13|Tabla 13]] | ||
+ | |- | ||
+ | |sueldo | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |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 | ||
+ | |<nowiki>N|1</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Tipo de Contrato que posee el empleado con el Empleador. | ||
+ | : '''PATH''': /root.Trabajador/@tipoContrato | ||
+ | : [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 14|Tabla 14]] | ||
+ | |- | ||
+ | |tipoIdentificacion | ||
+ | |String | ||
+ | |<nowiki>N|2</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Tipo de documento de identificación que actualmente tiene el trabajador, aprendiz, o pasante. | ||
+ | : '''PATH''': /root.Trabajador/@TipoDocumento | ||
+ | |- | ||
+ | |tipoTrabajador | ||
+ | |String | ||
+ | |<nowiki>N|2</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Código del tipo de trabajador del Ministerio de salud. Aportes a Seguridad Social de Activos.. | ||
+ | : '''PATH''': /root.Trabajador/@tipoTrabajador | ||
+ | : [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 12|Tabla 12]] | ||
+ | |} | ||
+ | |||
+ | ====Class.ExtrasNom==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |controlInterno1 | ||
+ | |String | ||
+ | |<nowiki>AN|..</nowiki> | ||
+ | |C/C | ||
+ | | | ||
+ | :Etiqueta asignada para la Representación Impresa PDF. | ||
+ | : '''PATH''': /Variable | ||
+ | |- | ||
+ | |controlInterno2 | ||
+ | |String | ||
+ | |<nowiki>AN|..</nowiki> | ||
+ | |C/C | ||
+ | | | ||
+ | :Permite asociar dos o más campos mediante un índice (si los campos son asociables). | ||
+ | : '''PATH''': /Variable | ||
+ | |- | ||
+ | |nombre | ||
+ | |String | ||
+ | |<nowiki>AN|..</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Código del campo extensible a referenciar. | ||
+ | : '''PATH''': /Variable | ||
+ | |- | ||
+ | |valor | ||
+ | |String | ||
+ | |<nowiki>AN|..</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Valor del campo a agregar. | ||
+ | : '''PATH''': /Variable | ||
+ | |} | ||
+ | ; RESPONSE: Parámetros a Recibir | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificación | ||
+ | ! style="background:#f2f2f2; text-align:center;"|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 | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |rowspan="3"|String | ||
+ | |tokenEmpresa | ||
+ | |rowspan="2"|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 | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |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 [[Catálogos de códigos para generación de Nómina Electrónica - Indice Manual Integración Nómina Electrónica #Tabla 9|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 | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |rowspan="3"|String | ||
+ | |tokenEmpresa | ||
+ | |rowspan="2"|Suministrado por The Factory HKA Colombia | ||
+ | |- | ||
+ | |tokenPassword | ||
+ | |} | ||
+ | |||
+ | ; RESPONSE: Parámetros a Recibir | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |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 | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |rowspan="4"|String | ||
+ | |tokenEmpresa | ||
+ | |rowspan="2"|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 | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |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 | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |rowspan="3"|String | ||
+ | |tokenEmpresa | ||
+ | |rowspan="2"|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 | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |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 | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |rowspan="3"|String | ||
+ | |tokenEmpresa | ||
+ | |rowspan="2"|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 | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |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 | |String | ||
− | | | + | |resultado |
− | | | + | |Resultado del consumo del método: |
− | + | : “Procesado” ó “Error” | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
+ | |||
{{clear}} | {{clear}} |
Revisión actual del 03:16 16 jun 2023
Sumario
- 1 Método Enviar
- 1.1 Class.Nómina Electrónica
- 1.2 Class.Deducciones
- 1.3 Class.Devengados
- 1.3.1 Class.AnticiposNom
- 1.3.2 Class.Auxilio
- 1.3.3 Class.Basico
- 1.3.4 Class.Bonificación
- 1.3.5 Class.BonoEPCTV
- 1.3.6 Class.Cesantia
- 1.3.7 Class.Comisión
- 1.3.8 Class.Compensación
- 1.3.9 Class.HoraExtra
- 1.3.10 Class.HuelgaLegal
- 1.3.11 Class.Incapacidad
- 1.3.12 Class.Licencia
- 1.3.13 Class.OtroConcepto
- 1.3.14 Class.PagoTercero
- 1.3.15 Class.Prima
- 1.3.16 Class.Transporte
- 1.3.17 Class.Vacaciónes
- 1.4 Class.DocumentosReferenciadosNom
- 1.5 Class.Nota
- 1.6 Class.LugarGeneracionXML
- 1.7 Class.Pago
- 1.8 Class.Periodo
- 1.9 Class.Trabajador
- 1.10 Class.ExtrasNom
- 2 Método ConsultarDocumento
- 3 Método ConsultarFolios
- 4 Método EnviarCorreo
- 5 Método DescargarXML
- 6 Método DescargarPDF
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 |
|
deducciones | Class | - | SI |
|
devengados | Class | SI |
| |
documentosReferenciadosNom | Array<DocumentosReferenciadosNom> | - | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
fechaEmisionNom | String | AN|19 | SI |
|
notas | Array<Nota> | - | NO |
|
novedad | String | N|1 | SI |
|
novedadCUNE | String | N|96 | C/C |
|
lugarGeneracionXML | Class | - | SI |
|
pagos | Array<Pago> | - | SI |
|
periodoNomina | String | N|1 | SI |
|
periodos | Array<Periodo> | AN|19 | SI |
|
rangoNumeracionNom | String | AN..20 | SI |
|
redondeo | String | N|.. | NO |
|
tipoDocumentoNom | String | N|3 | SI |
|
tipoMonedaNom | String | AN|3 | SI |
|
tipoNota | String | N|1 | SI |
|
totalComprobante | String | N|.. | SI |
|
totalDeducciones | String | N|.. | SI |
|
totalDevengados | String | N|.. | SI |
|
trm | String | N|.. | NO |
|
trabajador | Class | - | SI |
|
Class.Deducciones
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
afc | String | N|.. | NO |
|
anticiposNom | Array<AnticiposNom> | NO |
| |
cooperativa | String | N|.. | NO |
|
deuda | String | N|.. | NO |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
educación | String | N|.. | NO |
|
embargoFiscal | String | N|.. | NO |
|
fondosPensiones | Array<FondoPension> | - | SI |
|
fondosSP | Array<FondosSP> | - | NO |
|
libranzas | Array<Libranza> | N|.. | NO |
|
otrasDeducciones | Array<OtrasDeducciones> | - | NO |
|
pagosTerceros | Array<PagoTerceros> | - | NO |
|
pensionVoluntaria | String | N|.. | NO |
|
planComplementarios | String | N|.. | NO |
|
retencionFuente | String | N|.. | NO |
|
salud | Array<Salud> | - | SI |
|
sanciones | Array<Sanción> | - | NO |
|
sindicatos | Array<Sindicato> | - | NO |
|
reintegro | String | N|.. | NO |
|
Class.AnticiposNom
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
montoanticipo | String | N|.. | NO |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
Class.FondoPension
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
deducción | String | N|.. | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
porcentaje | String | N|4-6 | SI |
|
Class.FondoSP
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
deduccionSP | String | N|.. | NO |
|
deduccionSub | String | N|.. | NO |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
porcentaje | String | N|4-6 | NO |
|
porcentajeSub | String | N|4-6 | NO |
|
Class.Libranza
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
descripción | String | AN|.. | SI |
|
deduccion | String | N|.. | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
Class.OtraDeduccion
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
montootraDeduccion | String | N|.. | NO |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
Class.PagoTercero
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
pagoTercero | String | N|... | NO |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
Class.Salud
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
porcentaje | String | N|.. | SI |
|
deduccion | String | N|.. | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
Class.Sancion
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
sancionPublic | String | N|.. | SI |
|
sancionPriv | String | N|.. | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
Class.Sindicato
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
porcentaje | String | N|.. | SI |
|
deduccion | String | N|.. | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
Class.Devengados
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
anticiposNom | Array<AnticiposNom> | - | NO |
|
auxilios | Array<Auxilios> | - | NO |
|
apoyoSost | String | N|.. | NO |
|
basico | Array<Basico> | - | SI |
|
bonificaciones | Array<Bonificaciones> | - | NO |
|
bonifRetiro | String | N|.. | NO |
|
bonoEPCTVs | Array<BonoEPCTVs> | - | NO |
|
cesantías | Array<Cesantía> | - | NO |
|
comisiones | Array<Comisión> | - | NO |
|
compensaciones | Array<Compensación> | - | NO |
|
dotación | String | N|.. | NO |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
horasExtras | Array<HoraExtra> | - | NO |
|
huelgasLegales | Array<HuelgaLegal> | - | NO |
|
indemnización | String | N|.. | NO |
|
incapacidades | Array<Incapacidad> | - | NO |
|
licencias | Class | - | NO |
|
otrosConceptos | Array<OtroConcepto> | - | NO |
|
pagosTerceros | Array<PagoTercero> | - | NO |
|
primas | Array<Prima> | - | NO |
|
reintegro | String | N|.. | NO |
|
teletrabajo | String | N|.. | NO |
|
transporte | Array<Transporte> | - | NO |
|
vacaciones | Class | - | NO |
|
Class.AnticiposNom
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
montoanticipo | String | N|.. | NO |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
Class.Auxilio
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
auxilioNS | String | N|.. | NO |
|
auxilioS | String | N|.. | NO |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
Class.Basico
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
diasTrabajados | String | N|1-2 | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
sueldoTrabajado | String | N|.. | SI |
|
Class.Bonificación
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
bonificacionNS | String | N|.. | NO |
|
bonificacionS | String | N|.. | NO |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
Class.BonoEPCTV
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
pagoAlimentacionNS | String | N|.. | NO |
|
pagoAlimentacionS | String | N|.. | NO |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
pagoNS | String | N|.. | NO |
|
pagoS | String | N|.. | NO |
|
Class.Cesantia
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
extrasNom | Array<ExtensibleNom> | - | NO |
|
pago | String | N|.. | SI |
|
pagoIntereses | String | N|.. | SI |
|
porcentaje | String | N|.. | SI |
|
Class.Comisión
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
extrasNom | Array<ExtensibleNom> | - | NO |
|
montocomision | String | N|.. | NO |
|
Class.Compensación
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
compensacionE | String | N|.. | SI |
|
compensacionO | String | N|.. | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
Class.HoraExtra
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
cantidad | String | N|.. | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
horaInicio | String | AN|19 | NO |
|
horaFin | String | AN|19 | NO |
|
pago | String | N|.. | SI |
|
porcentaje | String | N|4-6 | SI |
|
tipoHorasExtra | String | N|1 | C/C |
|
Class.HuelgaLegal
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
cantidad | String | N|.. | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
fechaInicio | String | AN|10 | NO |
|
fechaFin | String | AN|10 | NO |
|
Class.Incapacidad
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
cantidad | String | N|.. | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
fechaInicio | String | AN|10 | NO |
|
fechaFin | String | AN|10 | NO |
|
pago | String | N|.. | SI |
|
tipo | String | N|1 | SI |
|
Class.Licencia
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
extrasNom | Array<ExtensibleNom> | - | NO |
|
licenciaMP | Array<LicenciaMP> | - | SI |
|
licenciaNR | Array<LicenciaNR> | - | SI |
|
licenciaR | Array<LicenciaR> | - | SI |
|
Class.LicenciaMP
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
cantidad | String | N|.. | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
fechaInicio | String | AN|10 | NO |
|
fechaFin | String | AN|10 | NO |
|
pago | String | N|.. | SI |
|
Class.LicenciaNR
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
cantidad | String | N|.. | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
fechaInicio | String | AN|10 | NO |
|
fechaFin | String | AN|10 | NO |
|
Class.LicenciaR
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
cantidad | String | N|.. | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
fechaInicio | String | AN|10 | NO |
|
fechaFin | String | AN|10 | NO |
|
pago | String | N|.. | SI |
|
Class.OtroConcepto
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
conceptoNS | String | N|.. | NO |
|
conceptoS | String | N|.. | NO |
|
descripcionConcepto | String | AN|.. | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
Class.PagoTercero
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
montopagoTercero | String | N|.. | NO |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
Class.Prima
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
cantidad | String | N|.. | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
pago | String | N|.. | SI |
|
pagoNS | String | N|.. | NO |
|
Class.Transporte
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
auxilioTransporte | String | N|.. | NO |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
ViaticoManuAlojS | String | N|.. | NO |
|
viaticoManuAlojNS | String | N|.. | NO |
|
Class.Vacaciónes
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
extrasNom | Array<ExtensibleNom> | - | NO |
|
vacaciónesComunes | Array<VacaciónesComunes> | - | NO |
|
vacaciónesCompensadas | Array<VacaciónesCompensadas> | - | NO |
|
Class.VacaciónesComunes
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
cantidad | String | N|.. | SI |
- Número de días que el trabajador estuvo activo durante el mes sin disfrutar sus vacaciones. (Vacaciones NO disfrutadas).
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
fechaInicio | String | AN|10 | NO |
|
fechaFin | String | AN|10 | NO |
|
pago | String | N|.. | SI |
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).
|
Class.VacaciónesCompensadas
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
cantidad | String | N|.. | SI |
- Número de días que el trabajador estuvo activo durante el mes sin disfrutar sus vacaciones. (Vacaciones NO disfrutadas).
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
fechaInicio | String | AN|10 | NO |
|
fechaFin | String | AN|10 | NO |
|
pago | String | N|.. | SI |
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).
|
Class.DocumentosReferenciadosNom
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
cunePred | String | AN..20 | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
fechaGenPred | String | AN|10 | SI |
|
numeroPred | String | AN..20 | SI |
|
Class.Nota
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
descripción | String | - | NO |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
Class.LugarGeneracionXML
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
departamentoEstado | String | N|2 | SI |
|
extrasNom | Array<ExtensibleNom> | - | NO |
|
idioma | String | N|2 | SI |
|
municipioCiudad | String | N|5 | SI |
|
pais | String | AN|2 | SI |
|
Class.Pago
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
extrasNom | Array<ExtensibleNom> | - | NO |
|
fechasPagos | Array<FechasPago> | - | SI |
|
fechapagonomina | String | AN|10 | SI |
|
metodoDePago | String | N|1 | SI |
|
medioPago | String | AN|3 | SI |
|
nombreBanco | String | AN|..50 | NC |
|
tipoCuenta | String | AN|..50 | NC |
|
numeroCuenta | String | AN|..50 | NC |
|
Class.FechasPagos
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
extrasNom | Array<ExtensibleNom> | - | NO |
|
fechapagonomina | String | AN|10 | SI |
|
Class.Periodo
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
extrasNom | Array<ExtensibleNom> | - | NO |
|
fechaIngreso | String | AN|10 | SI |
|
fechaLiquidacionInicio | String | AN|10 | SI |
|
fechaLiquidacionFin | String | AN|10 | SI |
|
fechaRetiro | String | AN|10 | NO |
|
tiempoLaborado | String | 5 caracteres enteros n decimales (días) | NO |
|
Class.Trabajador
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
altoRiesgoPension | String | N|1 | SI |
|
codigoTrabajador | String | N|2 | SI |
|
String | - | SI |
| |
extrasNom | Array<ExtensibleNom> | - | NO |
|
lugarTrabajoDepartamentoEstado | String | N|2 | SI |
|
lugarTrabajoDireccion | String | AN|...100 | SI |
|
lugarTrabajoMunicipioCiudad | String | N|5 | SI |
|
lugarTrabajoPais | String | AN|2 | SI |
|
numeroDocumento | String | AN|...60 | SI |
|
primerApellido | String | AN|...60 | SI |
|
primerNombre | String | AN|...60 | SI |
|
otrosNombres | String | AN|...60 | NO |
|
salarioIntegral | String | N|1 | SI |
|
segundoApellido | String | AN|...60 | SI |
|
subTipoTrabajador | String | N|2 | SI |
|
sueldo | String | N|.. | SI |
|
tipoContrato | String | N|1 | SI |
|
tipoIdentificacion | String | N|2 | SI |
|
tipoTrabajador | String | N|2 | SI |
|
Class.ExtrasNom
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
controlInterno1 | String | AN|.. | C/C |
|
controlInterno2 | String | AN|.. | C/C |
|
nombre | String | AN|.. | SI |
|
valor | String | AN|.. | SI |
|
- 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:
|
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,
|
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 |
|
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:
|
String | trackID | Este elemento corresponde al TrackId del documento procesado |
String | tipoDocumento | Identificador del tipo de documento de referencia
|
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:
|
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 | ||
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:
|
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:
|
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:
|