- Centro de Ayuda
- Integración API DATAICO S.A.S
- Nómina Electrónica.
-
Módulo de Ventas.
-
Módulo de Nómina.
-
Módulo de Contabilidad.
-
POS Electrónico.
-
Suscripciónes.
-
Integración API DATAICO S.A.S
-
Facturación electrónica.
-
Nómina Electrónica.
-
Módulo de Compras.
-
Eventos de recepción
-
Productos e Inventarios
-
Módulo de Terceros.
-
Módulo de Cartera.
-
Anexo 1.9
-
Importaciones.
-
Generalidades de Dataico.
-
Anexos Técnicos y Resoluciones.
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