> ## 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 STA
> Lerian STA devuelve respuestas de error estructuradas. Consulta cada código de error de STA, qué significa y el estado HTTP que lleva.
**Formato de error**
Lerian STA devuelve los errores como problem details de RFC 9457 con el tipo de medio `application/problem+json`:
```json JSON theme={null}
{
"code": "STA-0016",
"detail": "The requested route does not exist on this service.",
"status": 404,
"title": "Not Found",
"type": "https://errors.lerian.studio/v1/STA-0016"
}
```
**Definiciones de campos**
* **`type`** – Un URI que identifica el error en el catálogo de errores de Lerian, construido como `https://errors.lerian.studio/v1/`. Una respuesta sin `code` lleva el valor predeterminado de RFC `about:blank`.
* **`title`** – El texto del estado HTTP (por ejemplo, `Not Found`).
* **`status`** – El código de estado HTTP.
* **`detail`** – Una explicación legible de esta ocurrencia. En las respuestas `5xx`, STA reemplaza el detail por `internal error`. Una causa interna no queda en el cuerpo de la respuesta. Decide la rama con `code` en su lugar.
* **`code`** – Un identificador estable para el error (`STA-NNNN`). Decide la rama con este campo. Una solicitud que falla la validación del esquema de la solicitud no lleva `code`, y `errors` nombra los campos responsables. Dos errores pueden compartir un `title` y un estado y aun así diferir aquí. `STA-0005` y `STA-0016` responden ambos `404` con el título `Not Found`. El `code` te dice cuál obtuviste.
* **`errors`** – Lista opcional de detalles de error individuales, cada uno con una `location`, un `message` y un `value`.
## Errores de solicitud y de enrutamiento
***
Estos errores se aplican a la solicitud misma. Cubren su sintaxis, sus campos, su ruta y el estado del servicio que la recibió.
| `code` | Descripción | Estado |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| STA-0001 | Solicitud incorrecta. El servicio no pudo leer la sintaxis de la solicitud. | 400 |
| STA-0002 | Error interno del servidor. Una falla inesperada. El `detail` dice `internal error`. | 500 |
| STA-0003 | No autorizado. El recurso requiere autenticación. | 401 |
| STA-0004 | Prohibido. El emisor de la llamada no tiene permiso para este recurso. | 403 |
| STA-0005 | No encontrado. La ruta existe, y el recurso solicitado no. | 404 |
| STA-0006 | Entidad no procesable. El servicio leyó la solicitud y no puede procesarla en su forma actual. | 422 |
| STA-0007 | Conflicto. La solicitud entra en conflicto con el estado actual del recurso. | 409 |
| STA-0008 | Servicio no disponible. Una dependencia que la solicitud necesita no está disponible. Intenta de nuevo más tarde. | 503 |
| STA-0009 | Demasiadas solicitudes. Llegaron demasiadas solicitudes en un período dado. | 429 |
| STA-0010 | Entidad de solicitud demasiado grande. El payload de la solicitud es más grande de lo que acepta el endpoint. | 413 |
| STA-0011 | Solicitud incorrecta. El código de reserva para un rechazo del lado del cliente sin una entrada dedicada. | 400 |
| STA-0012 | Campos faltantes en la solicitud. La solicitud omite uno o más campos obligatorios. | 400 |
| STA-0013 | Campos desconocidos en la solicitud. El cuerpo de la solicitud lleva uno o más campos que el endpoint no acepta. | 400 |
| STA-0014 | Campos de solicitud no válidos. Uno o más campos suministrados fallan la validación. | 400 |
| STA-0015 | Error de unmarshalling. Un campo lleva el tipo JSON incorrecto, así que el cuerpo no se puede decodificar. El mensaje nombra el campo, el tipo esperado y el tipo recibido. | 400 |
| STA-0016 | Ruta no encontrada. La ruta de la solicitud no coincide con ninguna ruta montada. Corrige la URL, porque un reintento da el mismo resultado. | 404 |
| STA-0017 | Método no permitido. La ruta coincide con una ruta montada, y el método no. Cuando el enrutador rechaza el método, la respuesta lleva un encabezado `Allow` que enumera los métodos que la ruta acepta. | 405 |
## Errores de credenciales y de transferencia
***
Estos errores se aplican a las credenciales de BACEN, a la configuración de la fuente entrante y a la credencial bajo la cual se envía una transferencia.
| `code` | Descripción | Estado |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ |
| STA-0102 | Conflicto. Una solicitud de rotación apunta a una credencial que no está activa. | 409 |
| STA-0103 | Conflicto de código de institución. Ya existe una credencial activa para el mismo código de institución. | 409 |
| STA-0104 | Presupuesto de polling superado. La configuración de la fuente entrante llevaría la reserva de descubrimiento entrante de la credencial más allá de su tope de consultas por minuto. | 422 |
| STA-0105 | Credencial predeterminada no resoluble. La solicitud omite `credentialId`, y el tenant no tiene una credencial elegible a la cual resolver. | 422 |
| STA-0106 | Credencial predeterminada ambigua. Coincide más de una credencial elegible, así que el servicio se niega en lugar de elegir una. Nombra la credencial que quieres. | 422 |
| STA-0107 | Credencial de institución no encontrada. El `institutionCode` suministrado no coincide con ninguna credencial elegible. | 422 |