Diferencia entre revisiones de «Métodos Servicio Emisión Nómina Electrónica - Indice Manual Integración Nómina Electrónica»
Ir a la navegación
Ir a la búsqueda
Línea 51: | Línea 51: | ||
: Clase relacionada al las deducciones reportadas en el documento | : Clase relacionada al las deducciones reportadas en el documento | ||
: '''PATH''': /root/deducciones | : '''PATH''': /root/deducciones | ||
− | : (ver detalle en [[#Class.Deducciones|Class. | + | : (ver detalle en [[#Class.Deducciones|Class.Deducciones]]) |
|- | |- | ||
|devengados | |devengados | ||
Línea 1116: | Línea 1116: | ||
: '''PATH''': /root/@porcentaje | : '''PATH''': /root/@porcentaje | ||
|} | |} | ||
+ | ====Class.FondoSP==== | ||
+ | {| 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 | ||
+ | |- | ||
+ | |deduccionSP | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Valor Pagado correspondiente a Fondo de Solidaridad Pensional por parte del trabajador. | ||
+ | : '''PATH''': /root./@deduccionSP | ||
+ | |- | ||
+ | |deduccionSub | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Valor Pagado correspondiente a Fondo de Subsistencia por parte del trabajador. | ||
+ | : '''PATH''': /root./@deduccionSub | ||
+ | |- | ||
+ | |extras | ||
+ | |Array<Extra> | ||
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | :Habilitado como campo opcional | ||
+ | : '''PATH''': /No definido | ||
+ | |- | ||
+ | |porcentaje | ||
+ | |String | ||
+ | |<nowiki>N|4-6</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Debe corresponder al porcentaje de deducción de fondo de seguridad pensional que paga el trabajador. | ||
+ | : '''PATH''': /root/@porcentaje | ||
+ | |} | ||
+ | ====Class.Libranza==== | ||
+ | {| 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 | ||
+ | |<nowiki>AN|..</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Nombre de la Libranza que corresponda a las cuotas que el empleado deba pagar a una entidad financiera, para la amortización de un crédito que le haya sido otorgado por libranza. | ||
+ | : '''PATH''': /root./@descripcion | ||
+ | |- | ||
+ | |deduccion | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Las cuotas que el empleado deba pagar a una entidad financiera, para la amortización de un crédito que le haya sido otorgado por libranza. | ||
+ | : '''PATH''': /root./@deduccion | ||
+ | |} | ||
+ | ====Class.OtraDeduccion==== | ||
+ | {| 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 | ||
+ | |- | ||
+ | |otraDeduccion | ||
+ | |String | ||
+ | |<nowiki>N|../nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Otro tipo de deducción dentro de la Nomina.. | ||
+ | : '''PATH''': /root./@otraDeduccion | ||
+ | |- | ||
+ | |extras | ||
+ | |Array<Extras> | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Las cuotas que el empleado deba pagar a una entidad financiera, para la amortización de un crédito que le haya sido otorgado por libranza. | ||
+ | : '''PATH''': /root./@deduccion | ||
+ | |} | ||
+ | |||
; RESPONSE: Parámetros a Recibir | ; RESPONSE: Parámetros a Recibir | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" |
Revisión del 20:49 26 mar 2021
Sumario
- 1 Método Enviar
- 1.1 Class.Nómina Electrónica
- 1.2 Class.Deducciones
- 1.3 Class.Devengados
- 1.4 Class.DocumentoReferenciado
- 1.5 Class.Nota
- 1.6 Class.LugarGeneracionXML
- 1.7 Class.Pago
- 1.8 Class.Periodo
- 1.9 Class.Trabajador
- 1.10 Class.Anticipo
- 1.11 Class.FondoPension
- 1.12 Class.FondoSP
- 1.13 Class.FondoSP
- 1.14 Class.Libranza
- 1.15 Class.OtraDeduccion
Método Enviar
La función encargada de construir y enviar los documentos de soporte de pago de Nómina Electrónica a la DIAN.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción |
---|---|---|
String | idSoftware | Identificador Software: Identificador del software habilitado para la emisión de nóminas |
String | tokenEmpresa | Suministrado por el proveedor tecnológico |
tokenPassword | ||
String | nitEmpleador | Debe corresponder al NIT del Empleador que realiza el DE |
Objeto | Nomina | Ver el detalle del Objeto Nomina más abajo |
Class.Nómina Electrónica
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
consecutivoDocumento | String | AN..20 | Si |
|
deducciones | Class | - | SI |
|
devengados | Class | SI |
| |
documentosReferenciados | Array<DocumentoReferenciado> | - | SI |
|
extras | Array<Extras> | - | NO |
|
fechaEmision | 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 |
|
rangoNumeracion | String | AN..20 | SI |
|
redondeo | String | N|.. | NO |
|
tipoDocumento | String | N|3 | SI |
|
tipoMoneda | 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 |
|
anticipos | Array<Anticipo> | NO |
| |
cooperativa | String | N|.. | NO |
|
deuda | String | N|.. | 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 |
|
Class.Devengados
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
anticipos | Array<Anticipo> | - | 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 |
|
dotacion | String | N|.. | NO |
|
extras | Array<Extra> | - | 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.DocumentoReferenciado
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
cunePred | String | AN..20 | SI |
|
extras | Array<Extra> | - | NO |
|
fechaGenPred | String | AN|10 | SI |
|
numeroPred | String | AN..20 | SI |
|
Class.Nota
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
descripción | String | - | NO |
|
extras | Array<Extra> | - | NO |
|
Class.LugarGeneracionXML
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
departamentoEstado | String | N|2 | SI |
|
extras | Array<Extra> | - | 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 |
---|---|---|---|---|
extras | Array<Extra> | - | NO |
|
fechasPagos | Array<FechasPago> | - | SI |
|
extras | Array<Extra> | - | NO |
|
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.Periodo
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
extras | Array<Extra> | - | 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 |
| ||||||
extras | Array<Extra> | - | NO |
| |||||
lugarTrabajoDepartamentoEstado | String | N|2 | SI |
| |||||
lugarTrabajoDireccion | String | AN|...100 | SI |
| |||||
lugarTrabajoMunicipioCiudad | String | N|5 | SI |
| |||||
codigoTrabajador | String | N|2 | SI |
| |||||
lugarTrabajoPais | String | AN|2 | SI |
| |||||
numeroDocumento | String | AN|...60 | NO |
| |||||
primerApellido | String | AN|...60 | SI |
| |||||
primerNombre | String | AN|...60 | SI |
| |||||
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.Anticipo
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
anticipo | String | N|.. | NO |
|
extras | Array<Extra> | - | NO |
|
Class.FondoPension
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
deducción | String | N|.. | SI |
|
extras | Array<Extra> | - | NO |
|
porcentaje | String | N|4-6 | SI |
|
Class.FondoSP
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
deduccionSP | String | N|.. | SI |
|
deduccionSub | String | N|.. | NO |
|
extras | Array<Extra> | - | NO |
|
porcentaje | String | N|4-6 | NO |
|
Class.FondoSP
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
deduccionSP | String | N|.. | SI |
|
deduccionSub | String | N|.. | NO |
|
extras | Array<Extra> | - | NO |
|
porcentaje | String | N|4-6 | NO |
|
Class.Libranza
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
descripción | String | AN|.. | SI |
|
deduccion | String | N|.. | NO |
|
Class.OtraDeduccion
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
otraDeduccion | String | N|../nowiki> |NO | :Otro tipo de deducción dentro de la Nomina.. : '''PATH''': /root./@otraDeduccion |- |extras |Array<Extras> |<nowiki>N|.. | NO |
|
- RESPONSE
- Parámetros a Recibir
Tipo | Identificación | Descripción |
---|---|---|
int | código | Indica el Estado de la operación retornado por el servicio, (Por definir catálogo) |
String | mensaje | Este mensaje está asociado al código de respuesta, útil para identificación de errores |
String | resultado | Resultado del consumo del método:" Procesado” ó “Error”. |
String | consecutivoDocumento | Prefijo y Consecutivo del Documento concatenado sin separadores. Para el ejemplo anterior corresponde a: “PRUE980338337” |
String | cune | Código Único de Nómina Electrónica” correspondiente al documento consultado. |
String | trackId | Número de seguimiento, es un UUID, para consultar posteriormente el proceso asíncrono |
Array | notificacionesTFHKA | Reglas de validación en caso de notificación TFHKA |
Array | notificacionesDIAN | Reglas de validación en caso de notificación DIAN |
Array | rechazoTFHKA | Reglas de validación en caso de rechazo TFHKA |
Array | rechazoDIAN | Nombre definido por la DIAN |
String | nitEmpleador | Indica el nit del empleador |
String | nitEmpleado | Indica el nit del empleado |
String | idSoftware | Identificador de Casa de Software |
String | qr | Concatenación cadena del código QR (elemento de control) |
Bolean | esvalidoDIAN | “true” Si es válido |
Una vez realizado el envío exitoso de la Nómina electrónica (código ‘200’ o ‘201’ en la respuesta), se procede a enviar los archivos adjuntos (a través del método CargarAdjuntos) consumiendo el Servicio Adjuntos Web SOAP, en el escenario de que el parámetro adjuntos se haya asignado en “1” u “11”, en caso contrario el Servicio Adjuntos Web SOAP retornará un error indicando que el documento NO admite adjuntos.