- Centro de Ayuda
- Integración API DATAICO S.A.S
- Nómina Electrónica.
-
Módulo de Terceros
-
Módulo de Ventas
-
Módulo de Contabilidad
-
Módulo de Nómina
-
Módulo de Compras
-
Módulo de Cartera
-
Módulo de Productos e Inventarios
-
Suscripciones
-
Integración API DATAICO S.A.S
-
Eventos de recepción
-
Importaciones
-
Preguntas frecuentes (FAQ)
-
Anexos Técnicos y Resoluciones
-
Recursos adicionales
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:
-
- El error se encuentra en el array
"accruals", en la posición1, dentro del campo"amount_ns".
- El error se encuentra en el array
-
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
