API LaFactura.co:NominaIndividual

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"
     }
   }
}

---

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	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":"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

Usado por

Los siguientes recursos:

Temas complementarios

• Nomina

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.