Skip to main content

Manejo de Errores

Conceptos Generales​

Separamos nuestros errores en dos grandes categorías según el código HTTP.

Estructura del cuerpo de error​

Todos los errores devuelven un cuerpo con esta forma:

{
  "status": 400,
  "message": "Descripción legible de qué salió mal",
  "error": "Bad Request",
  "path": "/v1/...",
  "timestamp": "2026-01-01T12:00:00"
}

El detalle para entender el problema viene en el campo message.

4xx Errores del lado del cliente​

400 Bad Request Hay algo mal en los datos enviados a la API (validación, formato, o un recurso que no existe: la API responde 400, no 404, para los recursos de negocio no encontrados). Revisá el campo message para entender qué corregir.

401 Unauthorized No estás autenticado: el token falta, es inválido o está vencido. Volvé a solicitar el token (ver Autenticación).

403 Forbidden Estás autenticado, pero no tenés permisos suficientes para acceder a ese recurso (por rol o porque el recurso pertenece a otra organización).

5xx Error en nuestra API​

Estos errores no son frecuentes, pero si sucede un error de tipo 500 recomendamos intentar de nuevo más tarde, ya que no habremos podido procesar la solicitud en ese momento.