Guía de Solución de Problemas - API Factura Electrónica

Para cada error encontrarás el mensaje exacto del response, 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 en Dataico y copiar las credenciales actualizadas. Verificar que no haya espacios al pegar los valores.	LINK
"La ciudad 'X' no es válida para el departamento 'Y'"	El código de ciudad del cliente no corresponde al departamento según el catálogo de la DIAN, o el tercero no tiene dirección registrada.	Actualizar la dirección del tercero en Dataico o corregir el campo address.city en el JSON con el código DANE correcto.	LINK
"No implementation of method: :db of protocol…Connection found for class: java.lang.Boolean"	El campo dataico_account_id se está enviando como booleano (true/false) en lugar de string, o está vacío.	Verificar que dataico_account_id sea un string con el ID de la cuenta, no una variable sin inicializar.	LINK
"El número para este documento 'X' es inválido. Tiene que ser el siguiente número 'x1'"	El consecutivo enviado está fuera de la secuencia actual de la numeración. La API exige el número exactamente siguiente al último utilizado.	Consultar el último consecutivo usado en Ventas > Facturas y ajustar el valor en la solicitud.	LINK
"El campo 'base_amount' es requerido"	El campo charges se envía como objeto {} en lugar de array [{}]. El sistema no puede leer las propiedades internas.	Cambiar la estructura de charges de objeto a array de objetos en el JSON.	LINK
"No se encuentra numeración '{prefix, resolution_number}' en la cuenta de DATAICO"	La numeración referenciada en el JSON no existe en la cuenta, o las credenciales no corresponden a la cuenta que tiene esa numeración.	Verificar en Ventas > Configuración > Numeraciones que el prefijo y número de resolución coincidan exactamente con los del JSON.	LINK
"errors": [{"path": ["invoice"], "error": null}]	La payment_date es anterior a la issue_date. El sistema asigna la hora actual a issue_date si no se especifica, lo que puede generar este desfase.	Asegurarse de que payment_date sea igual o posterior a issue_date. Si no se especifica issue_date, enviar payment_date con la fecha y hora del momento del envío.	LINK

¿El error no aparece en esta tabla?
Consulta la Documentación Técnica de la API de Dataico o escríbenos al chat de soporte con el response completo.

Guía de Solución de Problemas - API Factura Electrónica

Este artículo cubre los errores más comunes al integrar la API de Factura Electrónica de Dataico.