Códigos de Error

Cuando una solicitud falla, la API devuelve success: false junto con un mensaje descriptivo:

{
  "success": false,
  "message": "El paquete_id proporcionado no existe."
}

---

Códigos HTTP

Código	Nombre	Descripción
200	OK	Solicitud exitosa
400	Bad Request	Cuerpo de solicitud inválido o parámetros faltantes
401	Unauthorized	API key faltante o inválida
404	Not Found	El recurso no existe
500	Internal Server Error	Error inesperado del servidor

---

Errores de autenticación 401

Ocurren cuando el header x-api-key es incorrecto o no se envía:

{
  "success": false,
  "message": "API key inválida o no autorizada."
}

Solución: Verifica que el header x-api-key esté presente y que la clave sea correcta. Genera una nueva en https://integracion.finalitix.com si es necesario.

---

Errores de validación 400

Ocurren cuando faltan campos requeridos o los valores son inválidos:

{
  "success": false,
  "message": "La CLABE debe tener exactamente 18 dígitos."
}

Casos comunes:

Mensaje	Causa
El campo 'nombre' es requerido.	Falta campo obligatorio
La CLABE debe tener exactamente 18 dígitos.	CLABE con longitud incorrecta
El paquete_id proporcionado no existe.	UUID inválido o inexistente
No se puede eliminar un paquete con transacciones.	Paquete no vacío

---

Errores del servidor 500

Si recibes un error 500, reintenta la solicitud. Si persiste, contacta al soporte de Finalitix.

{
  "success": false,
  "message": "Error interno del servidor. Intenta de nuevo más tarde."
}

Consejo

Guarda los mensajes de error en tus logs para facilitar el diagnóstico. El campo message siempre describe el motivo del fallo.