> ## 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 SLC
> Consulta los códigos de error de Lerian SLC, el estado HTTP que lleva cada uno y los códigos de rechazo de Nuclea que recibes en una operación de liquidación.
**Formato de error**
Lerian SLC devuelve los errores como problem details de RFC 9457 con el tipo de medio `application/problem+json`:
```json JSON theme={null}
{
"type": "https://errors.lerian.studio/v1/SLC-0105",
"title": "Conflict",
"status": 409,
"detail": "operation is not in a state that permits this transition",
"code": "SLC-0105"
}
```
**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/`.
* **`title`** – El texto del estado HTTP, por ejemplo `Conflict` o `Unprocessable Entity`. Proviene del estado, no del nombre del error.
* **`status`** – El código de estado HTTP, repetido de la línea de estado de la respuesta.
* **`detail`** – Una explicación específica de esta ocurrencia. Una respuesta con estado 500 o superior lleva el texto fijo `internal error`, así que usa `code` para decidir la rama en lugar de analizar este campo.
* **`code`** – El identificador estable para máquinas, con el formato `SLC-NNNN`. Usa este campo para decidir la rama.
* **`errors`** – Una lista de detalles por campo, cada uno con una `location`, un `message` y el `value` que causó el problema. Un fallo de validación de esquema lista una entrada por campo.
## Errores de plataforma y de solicitud
***
Estos códigos pueden llegar desde cualquier endpoint. Cada uno describe la solicitud, la credencial o la disponibilidad del servicio, no la operación de liquidación en sí.
| `code` | Descripción | Estado |
| -------- | -------------------------------------------------------------------------------------------------------------------------- | ------ |
| SLC-0001 | La solicitud está mal formada. Un payload, un filtro o un valor de la ruta no pasó la validación. | 400 |
| SLC-0002 | El servicio encontró una condición inesperada. El `detail` muestra `internal error`. | 500 |
| SLC-0003 | La solicitud llegó a una ruta protegida sin un token bearer válido. | 401 |
| SLC-0004 | La credencial está autenticada, pero carece del permiso que exige la ruta. | 403 |
| SLC-0005 | El recurso solicitado no existe. | 404 |
| SLC-0006 | La solicitud está bien formada, y una regla de negocio la rechaza. | 422 |
| SLC-0007 | El recurso está en un estado que prohíbe la acción, como la repetición de una entrega de webhook que ya se envió. | 409 |
| SLC-0008 | Un transporte o una dependencia no está disponible. La condición se resuelve sola, así que reintenta la solicitud. | 503 |
| SLC-0010 | El cuerpo de la solicitud supera el tamaño aceptado. | 413 |
| SLC-0011 | Una condición 4xx sin un código más específico. Un `405 Method Not Allowed` conserva su propio estado y lleva este código. | 4xx |
| SLC-0012 | La ruta está montada, y la configuración de tu despliegue no la deja disponible. | 501 |
## Errores de operación de liquidación
***
Estos códigos provienen del dominio de operaciones. Describen la instrucción de liquidación que enviaste, la operación original a la que apunta una cancelación, o la respuesta que recibió una conciliación de la contraparte.
| `code` | Descripción | Estado |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| SLC-0102 | Un ISPB en el cuerpo de la solicitud está ausente o no tiene ocho dígitos. Esto abarca los ISPB del acreedor, del domicilio y de la liquidación, el registro de la contraparte y el participante de la conciliación. | 422 |
| SLC-0103 | El `operationType` es un valor reconocido que no está habilitado para el envío. | 422 |
| SLC-0104 | El `externalId` ya pertenece a otra operación. | 409 |
| SLC-0105 | La operación está en un estado que no permite la transición que solicitaste. | 409 |
| SLC-0106 | La operación que nombra la solicitud no existe. | 404 |
| SLC-0107 | El lote NDJSON lleva más líneas que el límite configurado. | 413 |
| SLC-0108 | El NUliquid que suministraste no tiene 21 posiciones. La verificación de formato se ejecuta antes de cualquier búsqueda. | 422 |
| SLC-0109 | El `participantId` no está registrado. | 422 |
| SLC-0110 | La cadena de reintentos de la operación alcanzó su límite. | 409 |
| SLC-0111 | Un anticipo llegó sin la justificación que exige. El anticipo se audita, así que el motivo y la evidencia son obligatorios. | 400 |
| SLC-0112 | Ya existe una operación activa para el mismo `externalId`. Converge en esa operación en lugar de crear una segunda instrucción. | 409 |
| SLC-0113 | La operación original ya no acepta una cancelación. Ya está cancelada, en liquidación, liquidada o confirmada en D+1. | 409 |
| SLC-0114 | El `originalOperationId` al que hace referencia una cancelación no existe. | 422 |
| SLC-0115 | La operación original lleva un tipo que no acepta cancelación. Solo los movimientos CREDIT y DEBIT se pueden cancelar. | 422 |
| SLC-0116 | Nuclea todavía no aceptó la operación original, así que no tiene NUliquid y la cancelación no tiene movimiento que bloquear. | 409 |
| SLC-0117 | Ya hay una cancelación en curso para la misma operación original. | 409 |
| SLC-0118 | El reintento apunta a una operación rechazada cuyo dinero ya se liquidó. | 409 |
| SLC-0119 | La operación no tiene NUliquid, así que la conciliación no tiene una clave con la cual consultar. El `detail` nombra la recuperación adecuada para el estado actual. | 409 |
| SLC-0120 | El NUliquid de la operación queda fuera del horizonte de consulta en línea de 30 días. Reintentar no ayuda, porque el horizonte se aleja cada vez más. | 409 |
| SLC-0121 | La contraparte respondió con un estado de liquidación fuera del vocabulario mapeado, y la conciliación no registró nada. El `detail` cita el token para que puedas plantearlo con Nuclea. | 409 |
| SLC-0122 | La contraparte respondió sobre un NUliquid distinto del consultado, así que la respuesta describe otra operación y la conciliación no registró nada. | 409 |
| SLC-0123 | La consulta de liquidación no produjo respuesta sobre la operación debido a una condición en el canal. El `detail` nombra la condición. | 409 |
| SLC-0150 | Una cancelación llegó sin la categoría numérica de motivo que exige el layout de Nuclea. | 422 |
## Códigos de rechazo de Nuclea
***
Nuclea, la cámara de compensación que opera la SLC, responde a un envío o a un archivo de retorno con sus propios códigos de error de negocio, con el formato `ESLCNNNN`. Lerian SLC los registra contra la operación y los devuelve sin cambios. La respuesta de detalle de la operación lleva `eslcErrors`, un arreglo de los códigos registrados que está vacío cuando la operación no tiene ninguno, y `lastError`, los códigos registrados unidos en una sola cadena. Cada valor de código llega textual desde la red, así que interprétalo como vocabulario de Nuclea y no como un código de Lerian.
Nuclea define 85 de estos códigos en su manual de layout de SLC. La siguiente tabla cubre los que cambian lo que debes hacer a continuación.
| `code` | Descripción | Qué hacer |
| -------- | --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ESLC0006 | La fecha no es válida. | Corrige la fecha y envía de nuevo. |
| ESLC0007 | El CPF o el CNPJ no es válido. | Corrige el número de documento y envía de nuevo. |
| ESLC0029 | La solicitud llegó fuera de la ventana programada. | Envíala en la siguiente ventana. Lerian SLC pone en cola una operación enviada fuera de su ventana y la despacha cuando la ventana se abre. Consulta [Operaciones de SLC](/es/rails/slc/slc-operations). |
| ESLC0042 | No existe una inscripción para esta función. | Completa la inscripción con Nuclea y luego envía de nuevo. |
| ESLC0097 | El número de liquidación no está registrado. | Verifica el NUliquid al que hace referencia la solicitud. |
| ESLC0119 | El participante administrado no está administrado por el participante principal. | Corrige el registro del participante con Nuclea. El mismo archivo tiene éxito en cuanto el registro coincide. |
| ESLC0123 | El participante no se inscribió en la función. | Completa la inscripción con Nuclea. El mismo archivo tiene éxito después. |
| ESLC0140 | El código de instituidor del arreglo no está permitido para el tipo de archivo enviado. | Corrige el registro del arreglo y luego envía de nuevo. |
| ESLC0161 | Un participante administrado no puede enviar por HTTP. | Envía a través del transporte registrado para ese participante. |
| ESLC0163 | La fecha de pago no está permitida para una cancelación. | Cancela dentro del rango de fechas que permite la operación original. |
| ESLC0164 | El registro ya está cancelado, liquidado o en liquidación, así que no acepta una cancelación. | Detén la cancelación. Lerian SLC rechaza la misma condición localmente con `SLC-0113`. |
| ESLC1017 | No se encontraron los números de liquidación para una cancelación en la fecha indicada. | Verifica la fecha y los números de liquidación a los que hace referencia la solicitud. |
Cuatro de estos códigos te llegan en un rechazo síncrono del envío de un archivo: `ESLC0119`, `ESLC0123`, `ESLC0140` y `ESLC0161`. Llegan en el evento `operation.forward_rejected`, en `rejectionCode`, en lugar de en el archivo de retorno. Cada uno es una condición de registro o de inscripción que se aplica a todos los archivos que envía el participante, y un cambio de registro en Nuclea la resuelve. El archivo en sí no necesita ninguna edición.
**Los códigos restantes**
El resto del catálogo describe el registro enviado o el registro del participante. Las familias más grandes son:
* **Dominio y formato de campo** – Un valor está fuera del dominio que permite el layout, o un segmento lleva el formato incorrecto. Aquí aparecen los códigos de moneda, los tipos de persona, los instituidores de arreglo y los códigos de ocurrencia.
* **Registro e inscripción** – Un CNPJ, un ISPB o una relación de participante difiere de lo que Nuclea tiene registrado para el adquirente.
* **Números de control duplicados** – Un número de control o un nombre de archivo repite uno que Nuclea ya registró.
* **Fechas y períodos de reporte** – Una fecha de pago, una fecha de referencia o un rango de reporte está fuera de lo que permite el tipo de producto.
* **Estado del registro y códigos de ocurrencia** – El código de ocurrencia no corresponde al estado actual del registro, como un registro liquidado o uno cancelado.
* **Períodos de retorno** – El registro está dentro de un período de retorno, y Nuclea indica el tipo de archivo que lleva la corrección.
* **Límites y volúmenes** – Un monto de pago, una cantidad de archivos o una cantidad de registros supera el máximo aceptado.
Un código de cualquiera de estas familias te llega en el archivo de retorno, a través de `eslcErrors` en la operación. Cita el código cuando plantees el caso con Nuclea, porque es el identificador con el que trabaja el soporte de Nuclea.