Diferencia entre revisiones de «API LaFactura.co:NominaIndividual»
Ir a la navegación
Ir a la búsqueda
(→Campos) |
(→Campos) |
||
Línea 76: | Línea 76: | ||
| 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 || | | 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 || || cadena || SI || | + | | fechaInicio || <br/><small>(YYYYMMDD) Ejemplo: 20200321</small>|| cadena || SI || |
|- | |- | ||
− | | fechaFin || || cadena || SI || | + | | fechaFin || <br/><small>(YYYYMMDD) Ejemplo: 20200321</small>|| cadena || SI || |
|- | |- | ||
− | | fechaGen || Fecha de generacion del documento<br> | + | | fechaGen || Fecha de generacion del documento<br/><small>(YYYYMMDD) Ejemplo: 20200321</small> || cadena || SI || |
|- | |- | ||
− | | horaGen || Hora de generacion del documento<br> | + | | 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|| cadena || SI || | | periodoNomina || Codigo del período de nómina según tabla DIAN|| cadena || SI || | ||
|- | |- | ||
− | | notas1 || Nota | + | | notas1 || Nota para ser agregada al documento<br/><small>Aparece en el PDF</small> || cadena || NO || |
|- | |- | ||
− | | notas2 || Nota | + | | notas2 || Nota para ser agregada al documento<br/><small>Aparece en el PDF</small> || cadena || NO || |
|- | |- | ||
− | | notas3 || Nota | + | | notas3 || Nota para ser agregada al documento<br/><small>Aparece en el PDF</small> || cadena || NO || |
|- | |- | ||
− | | notas4 || || cadena || SI || | + | | notas4 || Nota para ser agregada al documento<br/><small>Aparece en el PDF</small>|| cadena || SI || |
|- | |- | ||
− | | notas5 || || cadena || SI || | + | | notas5 || Nota para ser agregada al documento<br/><small>Aparece en el PDF</small>|| cadena || SI || |
|- | |- | ||
| trabajador || || objeto || SI || | | trabajador || || objeto || SI || |
Revisión del 15:22 11 jun 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.
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" }, "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 | (YYYYMMDD) Ejemplo: 20200321 |
cadena | SI | |
fechaFin | (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 | 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 | SI | |
notas5 | Nota para ser agregada al documento Aparece en el PDF |
cadena | SI | |
trabajador | objeto | SI | ||
lugarTrabajo | objeto | SI | ||
pago | objeto | SI | ||
devengado | objeto | SI | ||
deducido | objeto | SI | ||
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":"Factura", "mode":"Creation", "tascode":"ni-54984309jtr0ret90jjrg", "intID":"2122", "document":"BOG-2092092", "CUNE":"43059843095203948093248093483048039248093403298409328490348903483094", "process":"0", "retries":"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.