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
(→Método Enviar) |
|||
Línea 60: | Línea 60: | ||
: 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.Devengado|Class.Devengado]]) |
|- | |- | ||
|documentosReferenciados | |documentosReferenciados | ||
Línea 69: | Línea 69: | ||
: 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.DocumentoReferenciado|Class.DocumentoReferenciado]]) |
|- | |- | ||
|extras | |extras | ||
Línea 94: | Línea 94: | ||
: Información adicional Texto libre, relativo al documento. | : Información adicional Texto libre, relativo al documento. | ||
: '''PATH''': /root/Nota. | : '''PATH''': /root/Nota. | ||
− | : ( Ver detalle en [[#Class. | + | : ( Ver detalle en [[#Class.Nota|Class.Nota]]) |
|- | |- | ||
|novedad | |novedad | ||
Línea 261: | Línea 261: | ||
: 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.Anticipo|Class.Anticipo]]) |
|- | |- | ||
|cooperativa | |cooperativa | ||
Línea 302: | Línea 302: | ||
: Utilizado para Atributos de Fondos de Pension del Documento | : Utilizado para Atributos de Fondos de Pension del Documento | ||
: '''PATH''': …/root.Deducciones/FondoPension | : '''PATH''': …/root.Deducciones/FondoPension | ||
− | : (ver detalle en [[#Class. | + | : (ver detalle en [[#Class.FondoPension|Class.FondoPension]]) |
|- | |- | ||
|fondosSP | |fondosSP | ||
Línea 609: | Línea 609: | ||
|} | |} | ||
− | ====Class. | + | ====Class.DocumentoReferenciado==== |
{| 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 649: | Línea 649: | ||
: '''PATH''': …/root.documentosReferenciados/numeroPred | : '''PATH''': …/root.documentosReferenciados/numeroPred | ||
|} | |} | ||
− | ====Class. | + | ====Class.Nota==== |
{| 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 973: | Línea 973: | ||
: '''PATH''': /root.Trabajador/@salarioIntegral | : '''PATH''': /root.Trabajador/@salarioIntegral | ||
|- | |- | ||
− | | | + | |segundoApellido |
+ | |String | ||
+ | |<nowiki>AN|...60</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Segundo Apellido del trabajador o aprendiz. | ||
+ | : '''PATH''': /root.Trabajador/@segundoApellido | ||
+ | |- | ||
+ | |subTipoTrabajador | ||
+ | |String | ||
+ | |<nowiki>N|2</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Código del Sub tipo de trabajador del Ministerio de salud. Aportes a Seguridad Social de Activos. | ||
+ | : '''PATH''': /root.Trabajador/@subTipoTrabajador | ||
+ | |sueldo | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Corresponde al valor que el empleador paga de forma periódica al trabajador como contraprestación por el trabajo realizado,este puede ser fijo o variable de acuerdo a la unidad de tiempo en que las partes hayan acordado el pago, teniendo como base el día o la hora trabajada.. | ||
+ | : '''PATH''': /root.Trabajador/@sueldo | ||
+ | |- | ||
+ | |tipoContrato | ||
+ | |String | ||
+ | |<nowiki>N|1</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Tipo de Contrato que posee el empleado con el Empleador. | ||
+ | : '''PATH''': /root.Trabajador/@tipoContrato | ||
+ | |- | ||
+ | |tipoIdentificacion | ||
+ | |String | ||
+ | |<nowiki>N|2</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | :Tipo de documento de identificación que actualmente tiene el trabajador, aprendiz, o pasante. | ||
+ | : '''PATH''': /root.Trabajador/@TipoDocumento | ||
+ | |- | ||
+ | |tipoTrabajador | ||
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|2</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | :Código del tipo de trabajador del Ministerio de salud. Aportes a Seguridad Social de Activos.. |
− | : '''PATH''': /root.Trabajador/@ | + | : '''PATH''': /root.Trabajador/@tipoTrabajador |
− | | | + | |} |
+ | ====Class.Anticipo==== | ||
+ | {| 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 | ||
+ | |- | ||
+ | |anticipo | ||
+ | |String | ||
+ | |<nowiki>N|..</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | :Anticipos de Nómina. | ||
+ | : '''PATH''': /root./@anticipo | ||
+ | |- | ||
+ | |extras | ||
+ | |Array<Extra> | ||
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | :Habilitado como campo opcional | ||
+ | : '''PATH''': /No definido | ||
+ | |} | ||
+ | ====Class.FondoPension==== | ||
+ | {| 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 | ||
+ | |- | ||
+ | |deducción | ||
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|..</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | :Valor Pagado correspondiente a Pensión por parte del trabajador. |
− | : '''PATH''': /root. | + | : '''PATH''': /root./@deduccion |
− | | | + | |- |
+ | |extras | ||
+ | |Array<Extra> | ||
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | :Habilitado como campo opcional | ||
+ | : '''PATH''': /No definido | ||
+ | |- | ||
+ | |porcentaje | ||
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|4-6</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | :Debe corresponder al porcentaje de deducción de fondo de pensión que paga el trabajador. |
− | : '''PATH''': /root | + | : '''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 | |String | ||
− | |<nowiki> | + | |<nowiki>N|..</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | :Valor Pagado correspondiente a Fondo de Solidaridad Pensional por parte del trabajador. |
− | : '''PATH''': /root | + | : '''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 | ||
+ | |} | ||
; 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 05:19 26 mar 2021
Sumario
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<Sancion> | - | 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 |
|
cesantias | Array<Cesantia> | - | NO |
|
comisiones | Array<Comision> | - | NO |
|
compensaciones | Array<Compensacion> | - | NO |
|
dotacion | String | N|.. | NO |
|
extras | Array<Extra> | - | NO |
|
horasExtras | Array<HoraExtra> | - | NO |
|
huelgasLegales | Array<HuelgaLegal> | - | NO |
|
indemnizacion | 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 |
---|---|---|---|---|
descripcion | 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 (dias) | 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 |
|
- RESPONSE
- Parámetros a Recibir
Tipo | Identificación | Descripción |
---|---|---|
int | codigo | Indica el Estado de la operación retornado por el servicio, (Por definir catálogo) |
String | consecutivoDocumento | Prefijo y Consecutivo del Documento concatenado sin separadores. Para el ejemplo anterior corresponde a: “PRUE980338337” |
String | cufe | “Código Único de Factura Electrónica” correspondiente al documento consultado. |
Bool | esValidoDian | “true” Si 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 | fechaRespuesta | Día y Hora en la que se generó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS |
String | hash | Código de detección de errores |
String | mensaje | Este mensaje está asociado al código de respuesta, útil para identificación de errores |
Array | mensajesValidacion | Mensajes de validación en caso de notificación o rechazo |
String | nombre | Nombre definido por la DIAN |
String | qr | Concatenación cadena del código QR (elemento de control) |
Array | reglasNotificacionDIAN | Reglas de validación en caso de notificación |
Array | reglasValidacionDIAN | Reglas de validación en caso de rechazo |
String | resultado | Resultado del consumo del método: Procesado” ó “Error” |
String | tipoCufe | Algoritmo del tipo de CUFE. “CUFE-SHA384” ó “CUDE-SHA384” |
String | xml | Archivo XML (tipo AttachedDocument) codificado en Base64 |
Una vez realizado el envío exitoso de la factura 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.