> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Lista de errores de SISBAJUD

> Consulta un código de error de SISBAJUD, el estado HTTP que lleva y la acción que lo resuelve.

**Formato de error**

SISBAJUD devuelve los errores con un `code` estable. Un error de operación usa detalles de problema RFC 9457 con el tipo de contenido `application/problem+json`:

<CodeGroup>
  ```json JSON theme={null}
  {
    "type": "https://errors.lerian.studio/v1/SBJ-0001",
    "title": "Bad Request",
    "status": 400,
    "detail": "institutionId path parameter must be a valid non-nil UUID.",
    "code": "SBJ-0001"
  }
  ```
</CodeGroup>

**Definiciones de campos**

* **`code`** – Un identificador estable para el error, con la forma `SBJ-NNNN`. Distingue por este valor cuando la respuesta lo lleva, y por el estado en caso contrario.
* **`type`** – Un URI que identifica el error en el catálogo de errores de Lerian. Construido como `https://errors.lerian.studio/v1/<code>`.
* **`title`** – El texto del estado HTTP (por ejemplo, `Bad Request`).
* **`status`** – El código de estado HTTP.
* **`detail`** – Orientación para esta ocurrencia del error. En las respuestas `5xx`, el detail lleva el texto fijo `internal error`, así que usa `code` para distinguir.
* **`errors`** – Lista opcional de detalles de validación por campo, cada uno con un `message` y un `location`.

Un rechazo que el enrutador hace antes de que la solicitud llegue a una operación, como un método no admitido, responde con el mismo `code` y `title` en un cuerpo JSON plano.

## Errores del cliente

***

| `code`   | Descripción                                                                                                                                                                        | Status     |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
| SBJ-0001 | La solicitud tiene una sintaxis mal formada. Revisa los identificadores de ruta, el formato de la marca de tiempo y la longitud de los campos.                                     | 400        |
| SBJ-0003 | Falló la autenticación. Envía un token bearer válido.                                                                                                                              | 401        |
| SBJ-0004 | La identidad del solicitante no tiene permiso para este recurso.                                                                                                                   | 403        |
| SBJ-0005 | El recurso no existe. Revisa el identificador en la ruta.                                                                                                                          | 404        |
| SBJ-0007 | La solicitud entra en conflicto con el estado actual del recurso, como una creación duplicada o una solicitud que ya llegó a un estado terminal.                                   | 409        |
| SBJ-0010 | El payload de la solicitud, o el contenido del archivo que pidió la solicitud, supera el tamaño aceptado.                                                                          | 413        |
| SBJ-0006 | La sintaxis es correcta, pero el servicio no puede procesar la solicitud. Un valor queda fuera del conjunto aceptado, o el recurso está en el estado incorrecto para la operación. | 422        |
| SBJ-0011 | Un error del cliente fuera de los códigos anteriores, como un método HTTP no admitido. Lee el estado HTTP de la respuesta.                                                         | Otro `4xx` |

## Errores del servidor

***

| `code`   | Descripción                                                                                                                                     | Status |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| SBJ-0002 | El servicio falló de forma inesperada. Envía la solicitud de nuevo, y contacta a soporte si el fallo continúa.                                  | 500    |
| SBJ-0008 | Una dependencia que este endpoint necesita no está disponible. Contacta a tu equipo de plataforma; enviar la solicitud de nuevo no lo resuelve. | 503    |