Diferencia entre revisiones de «API LaFactura.co:NominaIndividual»
Ir a la navegación
Ir a la búsqueda
(→Campos) |
|||
(No se muestran 21 ediciones intermedias del mismo usuario) | |||
Línea 1: | Línea 1: | ||
==Objeto:nominaIndividual== | ==Objeto:nominaIndividual== | ||
Es el objeto raiz, del sistema de envio de <b>nómina</b> de nuestra '''API''', es importante respetar todos los elementos aquí contemplados.<br/> | Es el objeto raiz, del sistema de envio de <b>nómina</b> de nuestra '''API''', es importante respetar todos los elementos aquí contemplados.<br/> | ||
− | + | <br><br> | |
+ | Ingreso: | ||
+ | <nowiki>https://***.tas-la.com/nomina.v10/nomina/</nowiki> | ||
+ | |||
+ | <b>Solicita tu usuario y contraseña +57-601-7466664</b> | ||
+ | No cobramos por el proceso de pruebas o desarrollo | ||
+ | Y puedes empezar inmediatamente (sin certificados o papeleos) | ||
+ | <br> | ||
=====Ejemplo===== | =====Ejemplo===== | ||
Línea 29: | Línea 36: | ||
"tipoContrato":"2", | "tipoContrato":"2", | ||
"sueldo":"4000000.00", | "sueldo":"4000000.00", | ||
− | "tiempoLaborado":"360.00" | + | "tiempoLaborado":"360.00", |
+ | "correo":"[email protected]", | ||
+ | "fechaIngreso":"20200101" | ||
}, | }, | ||
"lugarTrabajo":{ | "lugarTrabajo":{ | ||
Línea 43: | Línea 52: | ||
"devengado":{ | "devengado":{ | ||
"diasTrabajados":"30", | "diasTrabajados":"30", | ||
− | "sueldoTrabajado":"4000000.00" | + | "sueldoTrabajado":"4000000.00" |
}, | }, | ||
"deducido":{ | "deducido":{ | ||
Línea 72: | Línea 81: | ||
! Parámetro !! Descripción !! Tipo !! Obligatorio !! Notas | ! Parámetro !! Descripción !! Tipo !! Obligatorio !! Notas | ||
|- | |- | ||
− | | llaveRango || Identificador único, del rango de Nomina a ser utilizado<br><small>Esta valor es el resultado del servicio: [[API_LaFactura.co:traerRangos|traerRangos]]</small>|| cadena || SI || || | + | | llaveRango || Identificador único, del rango de Nomina a ser utilizado<br><small>Esta valor es el resultado del servicio: [[API_LaFactura.co:traerRangos|traerRangos]]</small>|| cadena || SI || |
+ | |- | ||
+ | | intID || Código del documento generado en tu base de datos (Debe ser único para cada documento)<br/><small>Esta valor se utiliza como control para evitar repetir documentos en el sistema</small> || cadena || SI || | ||
+ | |- | ||
+ | | fechaInicio || Fecha de liquidación inicial<br/><small>(YYYYMMDD) Ejemplo: 20200321</small>|| cadena || SI || | ||
+ | |- | ||
+ | | fechaFin || Fecha de liquidacion final<br/><small>(YYYYMMDD) Ejemplo: 20200321</small>|| cadena || SI || | ||
+ | |- | ||
+ | | fechaGen || Fecha de generacion del documento<br/><small>(YYYYMMDD) Ejemplo: 20200321</small> || cadena || SI || | ||
+ | |- | ||
+ | | horaGen || Hora de generacion del documento<br><small>(HHMMSS) Ejemplo: 175430</small>|| cadena || SI || | ||
+ | |- | ||
+ | | periodoNomina || Codigo del período de nómina según tabla DIAN<br/><small>[[API_LaFactura.co:Tabla_Tipos_Perido_Nomina|consultar tabla]]</small> || cadena || SI || | ||
+ | |- | ||
+ | | notas1 || Nota para ser agregada al documento<br/><small>Aparece en el PDF</small> || cadena || NO || | ||
+ | |- | ||
+ | | notas2 || Nota para ser agregada al documento<br/><small>Aparece en el PDF</small> || cadena || NO || | ||
+ | |- | ||
+ | | notas3 || Nota para ser agregada al documento<br/><small>Aparece en el PDF</small> || cadena || NO || | ||
+ | |- | ||
+ | | notas4 || Nota para ser agregada al documento<br/><small>Aparece en el PDF</small>|| cadena || NO || | ||
+ | |- | ||
+ | | notas5 || Nota para ser agregada al documento<br/><small>Aparece en el PDF</small>|| cadena || NO || | ||
+ | |- | ||
+ | | trabajador || Datos básicos del trabajador<br/><small>Ir a: [[API_laFactura.co:trabajador|trabajador]]</small> || objeto || SI || | ||
+ | |- | ||
+ | | lugarTrabajo || Datos de la localización del sitio de trabajo<br/><small>Ir a: [[API_laFactura.co:lugarTrabajo|lugarTrabajo]]</small> || objeto || SI || | ||
+ | |- | ||
+ | | pago || Medios y métodos de pago de la nómina<br/><small>Ir a: [[API_laFactura.co:pago|pago]]</small>|| objeto || SI || | ||
+ | |- | ||
+ | | devengado || Todos los valores a favor del empleado<br/><small>Ir a: [[API_laFactura.co:devengado|devengado]]</small> || objeto || SI || | ||
+ | |- | ||
+ | | deducido || Todos los valores en contra del empleado<br/><small>Ir a: [[API_laFactura.co:deducido|deducido]]</small>|| objeto || SI || | ||
+ | |- | ||
+ | | totales || Valores totales del documento<br/><small>Ir a: [[API_laFactura.co:totales|totales]] || objeto || SI || | ||
|} | |} | ||
Línea 86: | Línea 129: | ||
"code":200, | "code":200, | ||
"text":"Operación realizada con exito" | "text":"Operación realizada con exito" | ||
− | + | }, | |
− | + | "documento":{ | |
− | "type":" | + | "type":"nominaIndividual", |
"mode":"Creation", | "mode":"Creation", | ||
− | "tascode":"ni- | + | "tascode":"ni-969527772dbe01117b63a3ef6aec715a-v300", |
"intID":"2122", | "intID":"2122", | ||
− | "document":" | + | "document":"NOM156", |
− | "CUNE":" | + | "CUNE":"b84b1889239498d4b1f34a63bec5290589a3aa880a9eaa5ab36a6837ae66bf649325130500dec0cbacc0b4c513f00df6", |
"process":"0", | "process":"0", | ||
− | "retries":"0" | + | "retries":"0", |
− | + | "customer":"0" | |
− | + | } | |
− | + | } | |
+ | } | ||
=====A tener presente===== | =====A tener presente===== |
Revisión actual del 17:21 23 sep 2021
Sumario
Objeto:nominaIndividual
Es el objeto raiz, del sistema de envio de nómina de nuestra API, es importante respetar todos los elementos aquí contemplados.
Ingreso: https://***.tas-la.com/nomina.v10/nomina/ Solicita tu usuario y contraseña +57-601-7466664 No cobramos por el proceso de pruebas o desarrollo Y puedes empezar inmediatamente (sin certificados o papeleos)
Ejemplo
{ "nominaIndividual": { "llaveRango":"rk-7b8842f7d525e2a3dc7eb2bae5641665-v200", "intID":"2122", "fechaInicio":"20210301", "fechaFin":"20210331", "fechaGen":"20210331", "horaGen":"100000", "periodoNomina":"5", "notas1":"Esta es una prueba", "trabajador":{ "codigo":"TR79506693", "tipo":"01", "subTipo":"00", "altoRiesgoPension":"falso", "tipoDocumento":"13", "numeroDocumento":"79506693", "primerApellido":"Perez", "segundoApellido":"Perez", "primerNombre":"Pepito", "otrosNombres":"Alberto", "salarioIntegral":"falso", "tipoContrato":"2", "sueldo":"4000000.00", "tiempoLaborado":"360.00", "correo":"[email protected]", "fechaIngreso":"20200101" }, "lugarTrabajo":{ "pais":"CO", "departamento":"11", "municipio":"11001", "direccion":"xxxx" }, "pago":{ "fecha":"20210330", "metodo":"1" }, "devengado":{ "diasTrabajados":"30", "sueldoTrabajado":"4000000.00" }, "deducido":{ "salud":{ "porcentaje":"4.00", "deduccion":"160000.00" }, "pension":{ "porcentaje":"4.00", "deduccion":"160000.00" } }, "totales":{ "devengados":"4000000.00", "deducidos":"320000.00", "comprobante":"3680000.00" } } }
Explicacion
Campos
Parámetro | Descripción | Tipo | Obligatorio | Notas |
---|---|---|---|---|
llaveRango | Identificador único, del rango de Nomina a ser utilizado Esta valor es el resultado del servicio: traerRangos |
cadena | SI | |
intID | Código del documento generado en tu base de datos (Debe ser único para cada documento) Esta valor se utiliza como control para evitar repetir documentos en el sistema |
cadena | SI | |
fechaInicio | Fecha de liquidación inicial (YYYYMMDD) Ejemplo: 20200321 |
cadena | SI | |
fechaFin | Fecha de liquidacion final (YYYYMMDD) Ejemplo: 20200321 |
cadena | SI | |
fechaGen | Fecha de generacion del documento (YYYYMMDD) Ejemplo: 20200321 |
cadena | SI | |
horaGen | Hora de generacion del documento (HHMMSS) Ejemplo: 175430 |
cadena | SI | |
periodoNomina | Codigo del período de nómina según tabla DIAN consultar tabla |
cadena | SI | |
notas1 | Nota para ser agregada al documento Aparece en el PDF |
cadena | NO | |
notas2 | Nota para ser agregada al documento Aparece en el PDF |
cadena | NO | |
notas3 | Nota para ser agregada al documento Aparece en el PDF |
cadena | NO | |
notas4 | Nota para ser agregada al documento Aparece en el PDF |
cadena | NO | |
notas5 | Nota para ser agregada al documento Aparece en el PDF |
cadena | NO | |
trabajador | Datos básicos del trabajador Ir a: trabajador |
objeto | SI | |
lugarTrabajo | Datos de la localización del sitio de trabajo Ir a: lugarTrabajo |
objeto | SI | |
pago | Medios y métodos de pago de la nómina Ir a: pago |
objeto | SI | |
devengado | Todos los valores a favor del empleado Ir a: devengado |
objeto | SI | |
deducido | Todos los valores en contra del empleado Ir a: deducido |
objeto | SI | |
totales | Valores totales del documento Ir a: totales |
objeto | SI |
Resultados
Devuelve un objeto resultadoNomina con el resultado de la operación
Importante: Verifica toda la informacion que resultadoNomina devuelve ingresando al objeto.
{ "resultadoNomina":{ "status":{ "code":200, "text":"Operación realizada con exito" }, "documento":{ "type":"nominaIndividual", "mode":"Creation", "tascode":"ni-969527772dbe01117b63a3ef6aec715a-v300", "intID":"2122", "document":"NOM156", "CUNE":"b84b1889239498d4b1f34a63bec5290589a3aa880a9eaa5ab36a6837ae66bf649325130500dec0cbacc0b4c513f00df6", "process":"0", "retries":"0", "customer":"0" } } }
A tener presente
- El resultado incluye el campo "tascode", que es el codigo único interno en nuestro sistema e identifica el documento. Es requerido para cualquier acción posterior sobre este documento. (Es importante conservarlo)
- No se debe considerar un documento como válido por la DIAN, hasta que el resultado de una verificación del documento, muestre a process con: 2
Objetos empleados
Usado por
Los siguientes recursos:
Temas complementarios
Enlaces
- LaFactura.co: https://lafactura.co
- GitHub: https://github.com/FacturacionElectronicaColombia/lafactura.co
Importante
Recuerda que nosotros no te cobramos absolutamente nada por que pruebes nuestra plataforma.
Si deseas tener un usuario y contraseña , comunícate con nosotros.