Error RESPONSE: "error-code: invalid-key" (Devengado con clave inválida)

Guía de solución de problemas API DATAICO NÓMINA ELECTRÓNICA


 

Descripción del error:

El mensaje indica que hay un devengado con una clave inválida en la estructura de la nómina. En este caso, se refiere a un valor incorrecto para el campo relacionado con los conceptos salariales o no salariales.

Detalle (RESPONSE):

{

"error-code": “invalid-key”,

     "path": ["accruals ",1, "amount_ns"],

}

 

¿Cuál es el motivo de este error?

El error se genera porque uno o más conceptos de devengados en la estructura JSON tienen un tipo de concepto incorrecto en el campo clave, ya sea para conceptos salariales o no salariales.

Pasos para solucionar el error:

1. El detalle del error muestra la ubicación del problema en la estructura JSON:


    1. El error se encuentra en el array "accruals", en la posición 1, dentro del campo "amount_ns".
  1. Consulta los siguientes datos para validar si el tipo del concepto devengado es correcto:

 

Tipos de conceptos admitidos para devengados:

Devengados Salariales
“amount”
Devengados No Salariales
"amount-ns"
BÁSICO VIATICO
VIATICO BONIFICACION
AUXILIO_DE_TRANSPORTE AUXILIO:
BONIFICACION BONO_EPCTV
AUXILIO DOTACION
BONO_EPCTV APOYO_PRACTICA
COMISION BONIFICACION_RETIRO
PAGO_TERCERO INDEMNIZACION
ANTICIPO VACACION_COMPENSADA
TELETRABAJO PRIMA
HORA_EXTRA_DIURNA CESANTIAS
HORA_EXTRA_DIURNA_DF OTRO_CONCEPTO
HORA_EXTRA_NOCTURNA  
HORA_EXTRA_NOCTURNA_DF  
HORA_RECARGO_DIURNA_DF  
HORA_RECARGO_NOCTURNO  
HORA_RECARGO_NOCTURNO_DF  
LICENCIA_PATERNIDAD  
LICENCIA_REMUNERADA  
VACACION  
PRIMA  
COMPENSACION  
INCAPACIDAD  
OTRO_CONCEPTO  

 

Deducciones 

SALUD
FONDO_PENSION
FONDO_SOLIDARIDAD_PENSIONAL
FONDO_SUBSISTENCIA
SINDICATO
PAGO_TERCERO
ANTICIPO
PENSION_VOLUNTARIA
RETENCION_FUENTE
AFC
COOPERATIVA
EMBARGO_FISCAL
PLANES_COMPLEMENTARIOS
EDUCACION
REINTEGRO
DEUDA
OTRA_DEDUCCION

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

3.  Asegúrate de asignar el concepto devengado al tipo correcto (salarial o no salarial).

Por ejemplo:
Si el concepto es "VIATICO" y actualmente tiene la clave "amount", corrige esto a "amount-ns" para reflejar que es no salarial.

4.  Reemplaza los conceptos incorrectos en tu código de generación o construcción de nómina para que coincidan con la lista permitida.


5.  Envía la estructura JSON corregida a la API para confirmar que el problema está resuelto.

 

 

Recursos Adicionales


API DOCS Documentación Técnica de NE
+  Documentación Técnica de la API de DATAICO NÓMINA ELECTRÓNICA

 

small-logo