> ## 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.

# SLC en Cabine

> El espacio de trabajo de Lerian SLC en Lerian Cabine.

El espacio de trabajo de Lerian Cabine para Lerian SLC aparece como **SLC**. Los operadores lo usan para seguir operaciones, enviarlas a Núclea, leer posiciones de clearing y depósitos de tarjeta, responder liquidaciones como IF Domicílio, responder resultados de LBTR y administrar el riel.

Cabine lee los permisos de Lerian SLC del operador en Access Manager y oculta lo que el operador no puede usar. [Permisos por control](#permissions-by-control) lista el permiso que exige cada control. Consulta [Acceso y roles en Lerian Cabine](https://docs.lerian.studio/es/rails/cabine/cabine-access-and-roles.md).

## El edge de SLC

***

El navegador no llama a Lerian SLC. Llama al edge de Lerian SLC, un componente que tú instalas. El edge exige un token bearer en el encabezado `Authorization`. Reenvía las rutas `/v1/*`, `/webhooks*` y `/admin/*` a Lerian SLC sin cambios, y Lerian SLC decide lo que el operador puede hacer. Cuando Lerian SLC no responde, el edge responde `503`.

* Define la dirección del edge en `VITE_SLC_EDGE_URL`. Consulta [Configuración de Lerian Cabine](https://docs.lerian.studio/es/rails/cabine/cabine-configuration.md). Sin ella, Cabine oculta el espacio de trabajo y no hace ninguna llamada.
* Define la dirección de Lerian SLC en `SLC_UPSTREAM_URL` en el edge. El edge no arranca sin ella.
* Define `SLC_EDGE_CORS_ALLOWED_ORIGINS` en el edge con el origen donde los operadores abren Cabine.
* El edge necesita una licencia. No arranca sin `LICENSE_KEY` o `LICENSE_FILE_PATH`. Cuando las dos están definidas, el edge usa el archivo e ignora la clave.

El edge responde `/health` y `/readyz`. `/readyz` informa la conexión con Lerian SLC y la licencia.

## Operaciones

***

La pantalla **Operações** lista las operaciones de Lerian SLC. Lee `GET /v1/operations`. Puedes buscar por ID externo y acotar la lista por tipo, lote y período. Una búsqueda por NUliquid lee `GET /v1/operations/nuliquid/{nuliquid}` y muestra la respuesta de Núclea (SLC0908).

El detalle de la operación lee `GET /v1/operations/{operationId}`. Muestra el estado, lo que la operación espera, el último error, los errores ESLC y el historial de `GET /v1/operations/{operationId}/history`.

Un operador con el permiso puede actuar sobre una operación. Un botón queda apagado, con el motivo, en un estado que no permite la acción.

| Acción | Cuándo | Qué hace |
| - | - | - |
| **Cancelar** | **CREATED** o **QUEUED** | Cancela la operación antes del envío, con `DELETE /v1/operations/{operationId}`. |
| **Requeue** | **CREATED** | Pone la operación en la cola, con `POST /v1/operations/{operationId}/requeue`. |
| **Retry** | **REJECTED** | Envía la operación de nuevo como una operación nueva vinculada a la primera, con `POST /v1/operations/{operationId}/retry`. Cabine abre la operación nueva. |
| **Advance (override)** | Cualquier estado | Mueve la operación por una transición existente de la máquina de estados, con `POST /v1/operations/{operationId}/advance`. El operador da una justificación y una referencia de evidencia. El historial muestra la auditoría. |
| **Retransmitir** | **QUEUED** | Envía de nuevo la operación en cola, con `POST /v1/connectivity/operations/{id}/retransmit`. El envío no se duplica. |

## Enviar operaciones

***

La pantalla **Intake** aparece como **Enviar operações**. Tiene tres formas de enviar:

* **Enviar arquivo assinado** envía un archivo ASLC firmado con `POST /v1/files`. El formulario pide el participante, el control del emisor, el nombre del archivo y un motivo. La pantalla **Arquivo de intake** lee el archivo con `GET /v1/files/{id}` y lista las operaciones que vinieron de él.
* **Criar operação** crea una operación con `POST /v1/operations`.
* **Enviar lote** envía operaciones en NDJSON, desde un archivo o desde el cuadro de texto, con `POST /v1/operations/batch`. Cuando Lerian SLC rechaza líneas, una tabla muestra cada una con su número de línea, ID externo, código y mensaje.

## Clearing y depósitos

***

La pantalla **Posições de clearing** lee `GET /v1/clearing/positions`. Puedes filtrar por fecha de referencia, ciclo y etapa.

La pantalla **Depósitos de cartão** lista las instrucciones de depósito. Lee `GET /v1/funding/settlement-instructions`. Puedes filtrar por fecha, ciclo y estado. La pantalla **Instrução de depósito** lee `GET /v1/funding/settlement-instructions/{instructionId}`. Tiene dos vistas:

* **Rodadas** muestra cada ronda con su monto, su plazo y los lanzamientos del STR que Lerian SPB registró para ella.
* **Pedido de depósito** muestra el pedido de depósito de la instrucción.

Cuando el último lanzamiento de Lerian SPB de la ronda actual fue rechazado, la ronda ofrece **Depositar de novo a rodada N (LDL0022)**. Envía el depósito con `POST /v1/str/operations/card-deposits` a Lerian SPB, no al edge de SLC.

## IF Domicílio

***

La pantalla **Domicílio** lista las liquidaciones que Núclea notificó a tu institución como IF Domicílio. Lee `GET /v1/domicile/settlements`. Puedes filtrar por tipo, respuesta (incluida **Estacionada**), fecha de pago y archivo. La pantalla **Liquidação** lee `GET /v1/domicile/settlements/{nuLiquid}` y muestra las respuestas enviadas para ella.

* **Confirmar** y **Recusar** responden una liquidación, o las liquidaciones que seleccionas en la lista. **Recusar** pide un código de rechazo (**Código de recusa**). Cabine envía cada respuesta con `POST /v1/domicile/responses` y muestra el resultado de cada liquidación.
* Cada respuesta muestra su fase, decisión, estado, archivo y los errores de Núclea. **Liberar arquivo** libera un archivo de respuesta estacionado con `POST /v1/domicile/responses/unpark`.

## LBTR

***

La pantalla **Resultados LBTR** lista los resultados que anunció la cámara. Lee `GET /v1/lbtr/results`. La pantalla **Resultado LBTR** lee `GET /v1/lbtr/results/{resultId}` y las respuestas enviadas hasta ahora en `GET /v1/lbtr/commands`.

* **Responder** responde el resultado con un LTR0002. El operador elige **Confirmar** o **Divergir** y revisa el monto anunciado. Cabine lo envía con `POST /v1/lbtr/results/{resultId}/decision`.
* **Pagar com LTR0004** paga el resultado con un LTR0004. Cabine lo envía a Lerian SPB con `POST /v1/str/operations/ltr-transfers`.

## Referencia

***

* La pantalla **Relatórios** lista los informes de Núclea con `GET /v1/reports`.
* La pantalla **Participantes** lista los participantes con `GET /v1/participants`. **Novo participante** crea uno. La pantalla de detalle edita o elimina el participante y tiene dos vistas. **Arranjos** lista, crea, edita y elimina los arreglos del participante. **Conectividade** muestra el estado de la API de Núclea, de la conexión C:D, de la conexión RSFN y del certificado. También envía la prueba AGEN001 con `POST /v1/participants/{participantIspb}/test-connectivity`.
* La pantalla **Catálogo XSD** lista los esquemas con `GET /v1/xsd-schemas` y muestra un documento con `GET /v1/xsd-schemas/{type}`.

## Administración

***

El menú **Admin** tiene estas pantallas.

* **Webhooks** lista las suscripciones de webhook con `GET /webhooks`. **Novo webhook** crea una, y puedes editarla, eliminarla o probarla con **Testar**. El secreto es de solo escritura: Cabine no lo muestra. La pantalla de detalle lista las entregas del webhook. **Reenviar** envía una entrega de nuevo con `POST /webhooks/{id}/deliveries/{deliveryId}/replay`.
* **DLQ** aparece como **Mensagens mortas**. Lista una cola con `GET /admin/dlq/{queue}`. **Reprocessar** devuelve un mensaje al procesamiento con `POST /admin/dlq/{queue}/{id}/replay`.
* **Drenagem** ejecuta las acciones de recuperación de la conectividad: **Despacho** envía el backlog de crédito en la cola, **Retornos** procesa los retornos recibidos y **Reprocessar participante** actúa sobre un ISPB.

## Permisos por control

***

Cabine oculta cada control de abajo a un operador que no tiene su permiso. Lerian SLC también rechaza la llamada con `403`.

| Control | Permiso | Roles |
| - | - | - |
| **Intake**, **Cancelar**, **Requeue** y **Retry** | `operations:write` | `admin`, `operator` |
| **Advance (override)** | `operations:admin` | `admin` |
| **Retransmitir**, **Drenagem** y **Liberar arquivo** | `connectivity:admin` | `admin` |
| **Depósitos de cartão** | `funding:read` | `admin`, `operator` |
| **Confirmar** y **Recusar** en **Domicílio** | `domicile:write` | `admin`, `operator` |
| **Responder** | `lbtr:write` | `admin`, `operator` |
| **Pagar com LTR0004** | `str-operations:write` en Lerian SPB | Los roles de Lerian SPB que lo tienen |
| **Participantes** | `participants:read` | `admin` |
| **Webhooks** | `webhooks:admin` | `admin` |
| **DLQ** | `dlq:read` | `admin` |

En BYOC, Access Manager concede `domicile:read` y `domicile:write` después de que Lerian SLC publica su declaración de permisos. Crea en Access Manager la aplicación machine-to-machine de Lerian SLC, con el nombre `br-slc`. Después define `IDP_DECLARATION_ENABLED=true` en Lerian SLC, con `IDP_HOST`, `IDP_M2M_CLIENT_ID` y `IDP_M2M_CLIENT_SECRET` de esa aplicación. `PLUGIN_AUTH_ENABLED` debe ser `true`.

## Relacionados

***

* [Operar Lerian SLC](https://docs.lerian.studio/es/rails/slc/slc-operations.md)
* [Integración con Lerian SLC](https://docs.lerian.studio/es/rails/slc/slc-integration.md)
* [Acceso y roles en Lerian Cabine](https://docs.lerian.studio/es/rails/cabine/cabine-access-and-roles.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.