Diferencia entre revisiones de «Métodos Servicio Emisión Nómina Electrónica - Indice Manual Integración Nómina Electrónica»
(→Método Enviar) |
|||
(No se muestran 40 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" | ||
Línea 431: | Línea 445: | ||
: '''PATH''': /root./@deduccion | : '''PATH''': /root./@deduccion | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
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> | + | |<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 600: | Línea 584: | ||
: '''PATH''': /root./@pagoTercero | : '''PATH''': /root./@pagoTercero | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
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" | ||
Línea 664: | Línea 649: | ||
: '''PATH''': /root./@sancionPriv | : '''PATH''': /root./@sancionPriv | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
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. | + | =====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 929: | Línea 915: | ||
! 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 935: | Línea 921: | ||
| | | | ||
:Anticipos de Nómina. | :Anticipos de Nómina. | ||
− | : '''PATH''': /root./@ | + | : '''PATH''': /root./@anticiposNom |
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 945: | Línea 931: | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
|} | |} | ||
+ | |||
=====Class.Auxilio===== | =====Class.Auxilio===== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
Línea 969: | Línea 956: | ||
: '''PATH''': /root./@./@auxilioS | : '''PATH''': /root./@./@auxilioS | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 993: | Línea 980: | ||
: '''PATH''': /root/@diasTrabajados | : '''PATH''': /root/@diasTrabajados | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1028: | Línea 1015: | ||
|String | |String | ||
|<nowiki>N|..</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. | :Corresponde al valor que el empleador paga de forma periódica al trabajador como contraprestación por el trabajo realizado. | ||
: '''PATH''': /root/@bonificacionNS | : '''PATH''': /root/@bonificacionNS | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1041: | Línea 1028: | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
|} | |} | ||
+ | |||
=====Class.BonoEPCTV===== | =====Class.BonoEPCTV===== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
Línea 1062: | Línea 1050: | ||
|NO | |NO | ||
| | | | ||
− | :Valor que el trabajador recibe como | + | :Valor que el trabajador recibe como contraprestación por el trabajo realizado, por medio de bonos electrónicos, recargas, cheques, vales. es decir, todo pago realizado en un medio diferente a dinero en efectivo o consignación de cuenta bancaria (Salarial). |
: '''PATH''': /root/@pagoAlimentacionS | : '''PATH''': /root/@pagoAlimentacionS | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1089: | Línea 1077: | ||
: '''PATH''': /root/@pagoS | : '''PATH''': /root/@pagoS | ||
|} | |} | ||
− | =====Class. | + | =====Class.Cesantia===== |
{| 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 1097: | 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 1129: | Línea 1117: | ||
: '''PATH''': /root/Cesantias/@pagoIntereses | : '''PATH''': /root/Cesantias/@pagoIntereses | ||
|} | |} | ||
− | =====Class. | + | |
+ | =====Class.Comisió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 1137: | Línea 1126: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1153: | Línea 1142: | ||
: '''PATH''': root./@comision | : '''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 1174: | Línea 1164: | ||
|SI | |SI | ||
| | | | ||
− | :Valor Pagado por Compensaciones | + | :Valor Pagado por Compensaciones Ordinarias. |
− | : '''PATH''': root./@ | + | : '''PATH''': root./@compensacionO |
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1185: | Línea 1175: | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
|} | |} | ||
− | =====Class. | + | |
+ | =====Class.HoraExtra===== | ||
{| 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 1201: | Línea 1192: | ||
: '''PATH''': /root/HorasExtras(Tipo)/@cantidad | : '''PATH''': /root/HorasExtras(Tipo)/@cantidad | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1215: | Línea 1206: | ||
| | | | ||
:Hora de inicio de Hora Extra Según el tipo. | :Hora de inicio de Hora Extra Según el tipo. | ||
− | : '''PATH''': /root/HorasExtras(Tipo)/@horaInicio | + | : '''PATH''': /root/HorasExtras(Tipo)/@horaInicio. En formato YYYY-MM-DDTHH:MM:SS |
|- | |- | ||
|horaFin | |horaFin | ||
Línea 1223: | Línea 1214: | ||
| | | | ||
:Hora de fin de Hora Extra según el tipo. | :Hora de fin de Hora Extra según el tipo. | ||
− | : '''PATH''': /root/HorasExtras(Tipo)/@horaFin | + | : '''PATH''': /root/HorasExtras(Tipo)/@horaFin. En formato YYYY-MM-DDTHH:MM:SS |
|- | |- | ||
|pago | |pago | ||
Línea 1243: | Línea 1234: | ||
|tipoHorasExtra | |tipoHorasExtra | ||
|String | |String | ||
− | |<nowiki>N|1/nowiki> | + | |<nowiki>N|1</nowiki> |
|C/C | |C/C | ||
| | | | ||
:Tipo de Hora Extra. | :Tipo de Hora Extra. | ||
: '''PATH''': /root/HorasExtras(Tipo) | : '''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. | + | |
+ | =====Class.HuelgaLegal===== | ||
{| 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 1265: | Línea 1258: | ||
: '''PATH''': /root/@cantidad | : '''PATH''': /root/@cantidad | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1289: | Línea 1282: | ||
: '''PATH''': /root/@fechaFin | : '''PATH''': /root/@fechaFin | ||
|} | |} | ||
− | =====Class. | + | =====Class.Incapacidad===== |
{| 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 1305: | Línea 1298: | ||
: '''PATH''': /root/Incapacidad/@cantidad | : '''PATH''': /root/Incapacidad/@cantidad | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1331: | Línea 1324: | ||
|pago | |pago | ||
|String | |String | ||
− | |<nowiki>N|../nowiki> | + | |<nowiki>N|..</nowiki> |
|SI | |SI | ||
| | | | ||
Línea 1344: | Línea 1337: | ||
:Se debe indicar el código al cual corresponda el tipo de incapacidad del Empleado. | :Se debe indicar el código al cual corresponda el tipo de incapacidad del Empleado. | ||
: '''PATH''': /root/.Incapacidad/@fechaFin | : '''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. | + | |
+ | =====Class.Licencia===== | ||
{| 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 1353: | Línea 1348: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
| | | | ||
− | |||
: '''PATH''': /No definido | : '''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.LicenciaMP====== |
{| 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 1377: | Línea 1398: | ||
: '''PATH''': /root/@cantidad | : '''PATH''': /root/@cantidad | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1406: | Línea 1427: | ||
|SI | |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 | : '''PATH''': /root/@pago | ||
|} | |} | ||
− | =====Class.LicenciaNR===== | + | ======Class.LicenciaNR====== |
{| 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 1426: | Línea 1446: | ||
: '''PATH''': /root/Licencias/licenciaNR/cantidad | : '''PATH''': /root/Licencias/licenciaNR/cantidad | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1449: | Línea 1469: | ||
:Fecha donde termina la Licencia. | :Fecha donde termina la Licencia. | ||
: '''PATH''': /root/Licencias/licenciaNR/fechaFin | : '''PATH''': /root/Licencias/licenciaNR/fechaFin | ||
− | | | + | |} |
− | + | ||
− | + | ======Class.LicenciaR====== | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | =====Class.LicenciaR===== | ||
{| 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 1475: | Línea 1487: | ||
: '''PATH''': /root/Licencias/licenciaR/cantidad | : '''PATH''': /root/Licencias/licenciaR/cantidad | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1504: | Línea 1516: | ||
|SI | |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 | : '''PATH''': /root/Licencias/licenciaR/pago | ||
|} | |} | ||
+ | |||
=====Class.OtroConcepto===== | =====Class.OtroConcepto===== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
Línea 1538: | Línea 1550: | ||
| | | | ||
: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. | :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 | : '''PATH''': /root/@descripcionConcepto | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1548: | Línea 1561: | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
|} | |} | ||
+ | |||
=====Class.PagoTercero===== | =====Class.PagoTercero===== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
Línea 1564: | Línea 1578: | ||
: '''PATH''': /root/@pagoTercero | : '''PATH''': /root/@pagoTercero | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1588: | Línea 1602: | ||
: '''PATH''': /root/@cantidad | : '''PATH''': /root/@cantidad | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1628: | Línea 1642: | ||
: '''PATH''': /root/@auxilioTransporte | : '''PATH''': /root/@auxilioTransporte | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1636: | Línea 1650: | ||
: '''PATH''': /No definido | : '''PATH''': /No definido | ||
|- | |- | ||
− | | | + | |ViaticoManuAlojS |
|String | |String | ||
|<nowiki>N|..</nowiki> | |<nowiki>N|..</nowiki> | ||
Línea 1652: | Línea 1666: | ||
: '''PATH''': /root/@viaticoManuAlojNS | : '''PATH''': /root/@viaticoManuAlojNS | ||
|} | |} | ||
− | =====Class. | + | |
+ | =====Class.Vacaciónes===== | ||
{| 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 1660: | Línea 1675: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1667: | Línea 1682: | ||
:Habilitado como campo opcional | :Habilitado como campo opcional | ||
: '''PATH''': /No definido | : '''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. | + | ======Class.VacaciónesComunes====== |
{| 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 1685: | Línea 1718: | ||
: '''PATH''': /root/@cantidad | : '''PATH''': /root/@cantidad | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1719: | Línea 1752: | ||
: '''PATH''': /root/@pago | : '''PATH''': /root/@pago | ||
|} | |} | ||
− | =====Class. | + | ======Class.VacaciónesCompensadas====== |
{| 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 1736: | Línea 1769: | ||
: '''PATH''': /root/@cantidad | : '''PATH''': /root/@cantidad | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1770: | Línea 1803: | ||
: '''PATH''': /root/@pago | : '''PATH''': /root/@pago | ||
|} | |} | ||
− | ====Class. | + | |
+ | ====Class.DocumentosReferenciadosNom==== | ||
{| 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 1784: | Línea 1818: | ||
| | | | ||
: Debe corresponder al CUNE del Documento Soporte de Pago de Nómina Electrónica o Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica a Reemplazar | : Debe corresponder 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. | + | : '''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< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1800: | Línea 1835: | ||
| | | | ||
: 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 | : 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. | + | : '''PATH''': /root.documentosReferenciadosNom/fechaGenPred |
|- | |- | ||
|numeroPred | |numeroPred | ||
Línea 1808: | Línea 1843: | ||
| | | | ||
: 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 | : 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. | + | : '''PATH''': …/root.documentosReferenciadosNom/numeroPred |
|} | |} | ||
Línea 1827: | Línea 1862: | ||
: '''PATH''': .. /root.notas/descripción | : '''PATH''': .. /root.notas/descripción | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1850: | Línea 1885: | ||
: Código del departamento donde se genera el documento | : Código del departamento donde se genera el documento | ||
: '''PATH''': ../root.LugarGeneracionXML/departamentoEstado | : '''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< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1875: | Línea 1911: | ||
: Código del municipio o ciudad donde se genera el documento | : Código del municipio o ciudad donde se genera el documento | ||
: '''PATH''': ../root.LugarGeneracionXML/municipioCiudad | : '''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 | |pais | ||
Línea 1883: | Línea 1919: | ||
| | | | ||
: '''PATH''': ../root.LugarGeneracionXML/municipioCiudad | : '''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.Pago==== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
Línea 1892: | Línea 1930: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 1907: | Línea 1945: | ||
: Utilizado para Todos los Elementos de Fechas de Pagos del Documento | : Utilizado para Todos los Elementos de Fechas de Pagos del Documento | ||
: '''PATH''': .. /root/FechasPagos | : '''PATH''': .. /root/FechasPagos | ||
− | | | + | : (ver detalle en [[#Class.FechasPagos|Class.FechasPagos]]) |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
|fechapagonomina | |fechapagonomina | ||
Línea 1931: | Línea 1962: | ||
: Metodos de Pago del Documento | : Metodos de Pago del Documento | ||
: '''PATH''': ../root.Pago/@Forma | : '''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 | |medioPago | ||
Línea 1938: | Línea 1969: | ||
|SI | |SI | ||
| | | | ||
− | : | + | : Medios de Pago del Documento |
: '''PATH''': .. /root.Pago/@Metodo | : '''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 | |nombreBanco | ||
Línea 1946: | Línea 1978: | ||
|NC | |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 | : '''PATH''': .. /root.Pago/@Banco | ||
|- | |- | ||
Línea 1954: | Línea 1986: | ||
|NC | |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 | : '''PATH''': .. /root.Pago/@tipoCuenta | ||
|- | |- | ||
Línea 1962: | Línea 1994: | ||
|NC | |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 | : '''PATH''': .. /root.Pago/@numeroCuenta | ||
|} | |} | ||
− | ====Class. | + | =====Class.FechasPagos===== |
{| 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 1973: | Línea 2005: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |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 | |NO | ||
Línea 2020: | Línea 2077: | ||
:Cantidad de Tiempo que lleva laborando el Trabajador en la empresa | :Cantidad de Tiempo que lleva laborando el Trabajador en la empresa | ||
: '''PATH''': /root.Periodo/@tiempoLaborado | : '''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.Trabajador==== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
Línea 2035: | Línea 2094: | ||
| | | | ||
: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. | :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 | : '''PATH''': /root.Trabajador/@altoRiesgoPension | ||
|- | |- | ||
Línea 2042: | Línea 2102: | ||
|SI | |SI | ||
| | | | ||
− | : | + | :Codigo del trabajador. Campo queda a manejo Interno del Empleador. |
: '''PATH''': /root.Trabajador/@tipoTrabajador | : '''PATH''': /root.Trabajador/@tipoTrabajador | ||
|- | |- | ||
Línea 2053: | Línea 2113: | ||
: '''PATH''': /No.Aplica | : '''PATH''': /No.Aplica | ||
|- | |- | ||
− | | | + | |extrasNom |
− | |Array< | + | |Array<ExtensibleNom> |
| - | | - | ||
|NO | |NO | ||
Línea 2067: | Línea 2127: | ||
| | | | ||
:Código del departamento actual donde se encontraba ubicado el trabajador o aprendiz en el mes reportado. | :Código del departamento actual donde se encontraba ubicado el trabajador o aprendiz en el mes reportado. | ||
− | : '''PATH''': /root.Trabajador/@lugarTrabajoDepartamentoEstado | + | : '''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 | |lugarTrabajoDireccion | ||
Línea 2083: | Línea 2143: | ||
| | | | ||
:Código del municipio o ciudad actual donde se encontraba ubicado el trabajador o aprendiz en el mes reportado. | :Código del municipio o ciudad actual donde se encontraba ubicado el trabajador o aprendiz en el mes reportado. | ||
− | : '''PATH''': /root.Trabajador/@lugarTrabajoMunicipioCiudad | + | : '''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 | |lugarTrabajoPais | ||
Línea 2104: | Línea 2156: | ||
|String | |String | ||
|<nowiki>AN|...60</nowiki> | |<nowiki>AN|...60</nowiki> | ||
− | | | + | |SI |
| | | | ||
− | : | + | :Numero de identificación que actualmente el trabajador o aprendiz |
− | : '''PATH''': / | + | : '''PATH''': /Class.Trabajador/@numeroDocumento |
|- | |- | ||
|primerApellido | |primerApellido | ||
Línea 2124: | Línea 2176: | ||
:Primer Nombre del trabajador o aprendiz. | :Primer Nombre del trabajador o aprendiz. | ||
: '''PATH''': /root.Trabajador/@primerNombre | : '''PATH''': /root.Trabajador/@primerNombre | ||
+ | |- | ||
+ | |otrosNombres | ||
+ | |String | ||
+ | |<nowiki>AN|...60</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Otros Nombres del trabajador o aprendiz | ||
+ | : '''PATH''': /root.Trabajador/@otrosNombres | ||
+ | |- | ||
|- | |- | ||
|salarioIntegral | |salarioIntegral | ||
Línea 2130: | Línea 2191: | ||
|SI | |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. | + | :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 | : '''PATH''': /root.Trabajador/@salarioIntegral | ||
|- | |- | ||
Línea 2148: | Línea 2209: | ||
:Código del Sub tipo de trabajador del Ministerio de salud. Aportes a Seguridad Social de Activos. | :Código del Sub tipo de trabajador del Ministerio de salud. Aportes a Seguridad Social de Activos. | ||
: '''PATH''': /root.Trabajador/@subTipoTrabajador | : '''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 | |sueldo | ||
Línea 2164: | Línea 2226: | ||
:Tipo de Contrato que posee el empleado con el Empleador. | :Tipo de Contrato que posee el empleado con el Empleador. | ||
: '''PATH''': /root.Trabajador/@tipoContrato | : '''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 | |tipoIdentificacion | ||
Línea 2180: | Línea 2243: | ||
:Código del tipo de trabajador del Ministerio de salud. Aportes a Seguridad Social de Activos.. | :Código del tipo de trabajador del Ministerio de salud. Aportes a Seguridad Social de Activos.. | ||
: '''PATH''': /root.Trabajador/@tipoTrabajador | : '''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="mw-collapsible mw-collapsed wikitable" | + | ====Class.ExtrasNom==== |
− | ! style="background:#f2f2f2; text-align:center;"|Tipo | + | {| class="mw-collapsible mw-collapsed wikitable" |
− | ! style="background:#f2f2f2; text-align:center;"| | + | ! 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 | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |controlInterno1 |
− | |||
− | |||
− | |||
|String | |String | ||
− | | | + | |<nowiki>AN|..</nowiki> |
− | | | + | |C/C |
+ | | | ||
+ | :Etiqueta asignada para la Representación Impresa PDF. | ||
+ | : '''PATH''': /Variable | ||
|- | |- | ||
+ | |controlInterno2 | ||
|String | |String | ||
− | |resultado | + | |<nowiki>AN|..</nowiki> |
− | |Resultado del consumo del método:" Procesado” ó “Error”. | + | |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 | |String | ||
Línea 2211: | Línea 2316: | ||
|Número de seguimiento, es un UUID, para consultar posteriormente el proceso asíncrono | |Número de seguimiento, es un UUID, para consultar posteriormente el proceso asíncrono | ||
|- | |- | ||
− | |Array | + | |Array<String> |
− | | | + | |reglasNotificacionesTFHKA |
|Reglas de validación en caso de notificación TFHKA | |Reglas de validación en caso de notificación TFHKA | ||
|- | |- | ||
− | |Array | + | |Array<String> |
− | | | + | |reglasNotificacionesDIAN |
|Reglas de validación en caso de notificación DIAN | |Reglas de validación en caso de notificación DIAN | ||
|- | |- | ||
− | |Array | + | |Array<String> |
− | | | + | |reglasRechazoTFHKA |
|Reglas de validación en caso de rechazo TFHKA | |Reglas de validación en caso de rechazo TFHKA | ||
|- | |- | ||
− | |Array | + | |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 | |String | ||
− | | | + | |cadenaCune |
− | |Indica el | + | |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 | |String | ||
− | | | + | |descripcionDocumento |
− | | | + | |Identificador del tipo de documento de referencia, |
+ | : Ejemplo: “Nómina Individual o Nómina Ajuste” | ||
|- | |- | ||
|String | |String | ||
− | | | + | |descripcionEstatusDocumento |
− | | | + | |Descripción correspondiente al estatusDocumento ante la DIAN: “La Nomina Individual, ha sido autorizada” |
|- | |- | ||
|String | |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 | + | | |
+ | : “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 | ||
+ | |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:
|