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 1179: | Línea 1179: | ||
: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. | :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 | : '''PATH''': /root./@deduccion | ||
+ | |- | ||
+ | |extras | ||
+ | |Array<Extra> | ||
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | :Habilitado como campo opcional | ||
+ | : '''PATH''': /No definido | ||
|} | |} | ||
====Class.OtraDeduccion==== | ====Class.OtraDeduccion==== | ||
Línea 1197: | Línea 1205: | ||
|- | |- | ||
|extras | |extras | ||
− | |Array< | + | |Array<Extra> |
− | |<nowiki>N|.. | + | | - |
+ | |NO | ||
+ | | | ||
+ | :Habilitado como campo opcional | ||
+ | : '''PATH''': /No definido | ||
+ | |} | ||
+ | ====Class.PagoTercero==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |pagoTercero | ||
+ | |String | ||
+ | |<nowiki>N|.../nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Beneficios en cabeza del Trabjador que se pagan a un proveedor o tercero | ||
+ | : '''PATH''': /root./@pagoTercero | ||
+ | |- | ||
+ | |extras | ||
+ | |Array<Extra> | ||
+ | | - | ||
|NO | |NO | ||
| | | | ||
− | : | + | :Habilitado como campo opcional |
+ | : '''PATH''': /No definido | ||
+ | |} | ||
+ | ====Class.Salud==== | ||
+ | {| 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 | ||
+ | |- | ||
+ | |porcentaje | ||
+ | |String | ||
+ | |<nowiki>N|../nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Debe corresponder al porcentaje de deducción de salud que paga el trabajador | ||
+ | : '''PATH''': /root./@porcentaje | ||
+ | |- | ||
+ | |deducciones | ||
+ | |String | ||
+ | |<nowiki>N|../nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Valor Pagado correspondiente a Salud por parte del trabajador | ||
: '''PATH''': /root./@deduccion | : '''PATH''': /root./@deduccion | ||
+ | |- | ||
+ | |extras | ||
+ | |Array<Extra> | ||
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | :Habilitado como campo opcional | ||
+ | : '''PATH''': /No definido | ||
+ | |} | ||
+ | ====Class.Sancion==== | ||
+ | {| 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 | ||
+ | |- | ||
+ | |sancionPublic | ||
+ | |String | ||
+ | |<nowiki>N|../nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Valor por el del incumplimiento de una regla o norma de conducta obligatoria (Publica) | ||
+ | : '''PATH''': /root./@sancionPublic | ||
+ | |- | ||
+ | |sancionPriv | ||
+ | |String | ||
+ | |<nowiki>N|../nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Valor por el del incumplimiento de una regla o norma de conducta obligatoria (Privada o Ordinaria) | ||
+ | : '''PATH''': /root./@sancionPriv | ||
+ | |- | ||
+ | |extras | ||
+ | |Array<Extra> | ||
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | :Habilitado como campo opcional | ||
+ | : '''PATH''': /No definido | ||
+ | |} | ||
+ | ====Class.Sindicato==== | ||
+ | {| 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 | ||
+ | |- | ||
+ | |porcentaje | ||
+ | |String | ||
+ | |<nowiki>N|../nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Porcentaje establecido en la ley o por estatutos del sindicato. | ||
+ | : '''PATH''': /root./@porcentaje | ||
+ | |- | ||
+ | |deducciones | ||
+ | |String | ||
+ | |<nowiki>N|../nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Las cuotas que los trabajadores sindicalizados deben aportar al sindicato al que estén afiliados, y siempre que medie autorización del empleado | ||
+ | : '''PATH''': /root./@deduccion | ||
+ | |- | ||
+ | |extras | ||
+ | |Array<Extra> | ||
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | :Habilitado como campo opcional | ||
+ | : '''PATH''': /No definido | ||
|} | |} | ||
− | |||
; RESPONSE: Parámetros a Recibir | ; RESPONSE: Parámetros a Recibir | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
Línea 1271: | Línea 1398: | ||
|“true” Si es válido | |“true” Si es válido | ||
|} | |} | ||
− | |||
{{clear}} | {{clear}} |
Revisión del 21:38 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
- 1.16 Class.PagoTercero
- 1.17 Class.Salud
- 1.18 Class.Sancion
- 1.19 Class.Sindicato
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 |
|
extras | Array<Extra> | - | NO |
|
Class.OtraDeduccion
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
otraDeduccion | String | ../nowiki> | NO |
|
extras | Array<Extra> | - | NO |
|
Class.PagoTercero
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
pagoTercero | String | .../nowiki> | NO |
|
extras | Array<Extra> | - | NO |
|
Class.Salud
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
porcentaje | String | ../nowiki> | SI |
|
deducciones | String | ../nowiki> | SI |
|
extras | Array<Extra> | - | NO |
|
Class.Sancion
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
sancionPublic | String | ../nowiki> | SI |
|
sancionPriv | String | ../nowiki> | SI |
|
extras | Array<Extra> | - | NO |
|
Class.Sindicato
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
porcentaje | String | ../nowiki> | SI |
|
deducciones | String | ../nowiki> | SI |
|
extras | Array<Extra> | - | 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 |