Errores

La API de Facturación de Tandia utiliza códigos de estado HTTP y tipos de errores para comunicar el resultado de las solicitudes. A continuación, se detallan los códigos de estado y los tipos de errores que puedes encontrar al interactuar con nuestra API.

Códigos de Estado HTTP

• 200 - OK: Todo funcionó como se esperaba.

• 400 - Bad Request: La solicitud no fue aceptable, a menudo debido a la falta de un parámetro requerido.

• 401 - Unauthorized: No se envió token Bearer o el token no es válido.

• 403 - Forbidden: La clave de API no tiene permisos para realizar la solicitud.

• 404 - Not Found: El recurso solicitado no existe.

• 422 - Unprocessable Entity: La estructura enviada no cumple las validaciones del endpoint.

• 500, 502, 503, 504 - Server Errors: Algo salió mal en el extremo de Tandia.io. (Estos son raros).

Tipos de Errores

• general_error: Los errores de API abarcan cualquier otro tipo de problema (por ejemplo, un problema temporal con los servidores de Tandia.io) y son extremadamente raros.

• database_error: Este tipo de error indica un problema en la base de datos de Tandia.io. Esto puede deberse a una interrupción temporal en la base de datos que estamos trabajando para resolver. Te recomendamos intentar la solicitud nuevamente en un momento posterior. Si el problema persiste, no dude en ponerse en contacto con nuestro equipo de soporte para obtener asistencia adicional.

• validation_error: Los errores de validación se producen cuando los datos proporcionados en la solicitud no cumplen con los requisitos o restricciones esperados. Para resolver este tipo de error, asegúrate de que los datos proporcionados cumplan con las reglas de validación especificadas en nuestra documentación. Si sigues teniendo problemas, verifica la estructura de la solicitud y los datos enviados para asegurarte de que sean correctos.

Errores de validación tributaria

Cuando un comprobante no cumple con reglas de formato, montos o catálogos, la API responde con un error de validación. En estos casos revisa especialmente:

• que number o serie cumplan el formato del tipo de comprobante;
• que tax_amounts coincida con los impuestos de los ítems;
• que los importes sale_value, tax_total, subtotal y total sean consistentes;
• que document_related_type y document_related_number existan en notas de crédito y débito;
• que los objetos detraction, retention y perception incluyan sus montos, porcentajes y códigos cuando se usen.

Los errores de SUNAT o del proveedor tributario pueden quedar reflejados en failure_code, failure_message, result o logs al consultar el documento.

Error Object

Objeto de error utilizado para representar respuestas de error.

Atributos

---

---

---

---

---

---