Guía de Solución de Problemas API de Nómina Electrónica en Dataico
Este artículo cubre los errores más comunes al integrar la API de Nómina Electrónica de Dataico.
Para cada error encontrarás el response exacto, la causa y la solución. Si necesitas más detalle, cada fila enlaza al artículo completo.
| Mensaje de error (response) | Causa | Solución rápida | Artículo completo |
| "No estás autorizado a usar esta cuenta de Dataico" | El Auth-token o el dataico_account_id es inválido, está vencido o no corresponde a la cuenta. | Ir a Configuración > API en Dataico y copiar las credenciales actualizadas. Verificar que no haya espacios al pegar los valores. | LINK |
| {"error-code": "invalid-key", "path": ["software", "test_set_id"]} o ["software", "dian_id"] | Los valores de test_set_id y dian_id son incorrectos o fueron modificados. Son valores fijos para todas las cuentas. |
Usar siempre los valores predefinidos: dian_id: d0e88268-a4ab-447d-918c-19c1c248b5c3 / pin: 4123412. |
LINK |
| {"error-code": "invalid-key", "path": ["accruals", N, "amount_ns"]} | La clave del concepto salarial o no salarial en accruals es incorrecta. El nombre del campo no corresponde a ningún concepto válido. | Revisar el nombre del concepto en la posición N del array accruals y compararlo contra el catálogo de conceptos de la documentación técnica. | LINK |
| {"error-code": "invalid-value", "path": ["accruals", N], "message": "unknown error"} | El campo days de un devengado tiene un valor fuera del rango admitido. Por ejemplo, VACACION admite máximo 30 días. | Revisar la tabla de días admitidos por concepto (BASICO: 30, VACACION: 30, PRIMA: 180, INCAPACIDAD: 30) y corregir el valor en la posición N. | LINK |
| {"path": [0, "accruals", 0, 0, 0, "base-salary", "days"], "in": ["accruals", 3, "precise-days"], "value": 50.0} | El valor de days en precise-days supera el máximo permitido para el devengado BASICO u otro concepto de la misma familia. | Verificar que days no supere 30 en los devengados de salario base. El campo precise-days acepta decimales pero dentro del mismo rango máximo. | LINK |
¿El error no aparece en esta tabla?
Consulta la Documentación Técnica de la API de Dataico — Nómina Electrónica o escríbenos al chat de soporte con el response completo y el JSON que estás enviando.
Recursos Adicionales
Si necesitas más información, estos recursos te serán de gran utilidad: