API LaFactura.co:NominaIndividual

De API LaFactura.co
Ir a la navegación Ir a la búsqueda

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

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.