> ## 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 no Cabine

> A área de trabalho do Lerian SLC no Lerian Cabine.

A área de trabalho do Lerian Cabine para o Lerian SLC aparece como **SLC**. Os operadores a usam para acompanhar operações, enviá-las à Núclea, ler posições de clearing e depósitos de cartão, responder liquidações como IF Domicílio, responder resultados do LBTR e administrar o trilho.

O Cabine lê as permissões do Lerian SLC do operador no Access Manager e oculta o que o operador não pode usar. [Permissões por controle](#permissions-by-control) lista a permissão que cada controle exige. Veja [Acesso e papéis no Lerian Cabine](https://docs.lerian.studio/pt/rails/cabine/cabine-access-and-roles.md).

## A borda do SLC

***

O navegador não chama o Lerian SLC. Ele chama a borda do Lerian SLC, um componente que você instala. A borda exige um token bearer no cabeçalho `Authorization`. Ela repassa os caminhos `/v1/*`, `/webhooks*` e `/admin/*` ao Lerian SLC sem alteração, e o Lerian SLC decide o que o operador pode fazer. Quando o Lerian SLC não responde, a borda responde `503`.

* Defina o endereço da borda em `VITE_SLC_EDGE_URL`. Veja [Configurando o Lerian Cabine](https://docs.lerian.studio/pt/rails/cabine/cabine-configuration.md). Sem ele, o Cabine oculta a área de trabalho e não faz nenhuma chamada.
* Defina o endereço do Lerian SLC em `SLC_UPSTREAM_URL` na borda. A borda não inicia sem ele.
* Defina `SLC_EDGE_CORS_ALLOWED_ORIGINS` na borda com a origem em que os operadores abrem o Cabine.
* A borda precisa de uma licença. Ela não inicia sem `LICENSE_KEY` ou `LICENSE_FILE_PATH`. Quando os dois estão definidos, a borda usa o arquivo e ignora a chave.

A borda responde `/health` e `/readyz`. O `/readyz` informa a conexão com o Lerian SLC e a licença.

## Operações

***

A tela **Operações** lista as operações do Lerian SLC. Ela lê `GET /v1/operations`. Você pode buscar por ID externo e restringir a lista por tipo, lote e período. Uma busca por NUliquid lê `GET /v1/operations/nuliquid/{nuliquid}` e mostra a resposta da Núclea (SLC0908).

O detalhe da operação lê `GET /v1/operations/{operationId}`. Ele mostra o estado, o que a operação aguarda, o último erro, os erros ESLC e o histórico de `GET /v1/operations/{operationId}/history`.

Um operador com a permissão pode agir sobre uma operação. Um botão fica desligado, com o motivo, em um estado que não permite a ação.

| Ação | Quando | O que faz |
| - | - | - |
| **Cancelar** | **CREATED** ou **QUEUED** | Cancela a operação antes do envio, com `DELETE /v1/operations/{operationId}`. |
| **Requeue** | **CREATED** | Coloca a operação na fila, com `POST /v1/operations/{operationId}/requeue`. |
| **Retry** | **REJECTED** | Envia a operação de novo como uma nova operação ligada à primeira, com `POST /v1/operations/{operationId}/retry`. O Cabine abre a nova operação. |
| **Advance (override)** | Qualquer estado | Move a operação por uma transição existente da máquina de estados, com `POST /v1/operations/{operationId}/advance`. O operador informa uma justificativa e uma referência de evidência. O histórico mostra a auditoria. |
| **Retransmitir** | **QUEUED** | Envia de novo a operação na fila, com `POST /v1/connectivity/operations/{id}/retransmit`. O envio não duplica. |

## Enviar operações

***

A tela **Intake** aparece como **Enviar operações**. Ela tem três formas de enviar:

* **Enviar arquivo assinado** envia um arquivo ASLC assinado com `POST /v1/files`. O formulário pede o participante, o controle do emissor, o nome do arquivo e um motivo. A tela **Arquivo de intake** lê o arquivo com `GET /v1/files/{id}` e lista as operações que vieram dele.
* **Criar operação** cria uma operação com `POST /v1/operations`.
* **Enviar lote** envia operações em NDJSON, de um arquivo ou da caixa de texto, com `POST /v1/operations/batch`. Quando o Lerian SLC recusa linhas, uma tabela mostra cada uma com o número da linha, o ID externo, o código e a mensagem.

## Clearing e depósitos

***

A tela **Posições de clearing** lê `GET /v1/clearing/positions`. Você pode filtrar por data de referência, ciclo e estágio.

A tela **Depósitos de cartão** lista as instruções de depósito. Ela lê `GET /v1/funding/settlement-instructions`. Você pode filtrar por data, ciclo e estado. A tela **Instrução de depósito** lê `GET /v1/funding/settlement-instructions/{instructionId}`. Ela tem duas visões:

* **Rodadas** mostra cada rodada com o valor, o prazo e os lançamentos do STR que o Lerian SPB registrou para ela.
* **Pedido de depósito** mostra o pedido de depósito da instrução.

Quando o último lançamento do Lerian SPB da rodada atual foi recusado, a rodada oferece **Depositar de novo a rodada N (LDL0022)**. Ele envia o depósito com `POST /v1/str/operations/card-deposits` ao Lerian SPB, não à borda do SLC.

## IF Domicílio

***

A tela **Domicílio** lista as liquidações que a Núclea notificou à sua instituição como IF Domicílio. Ela lê `GET /v1/domicile/settlements`. Você pode filtrar por tipo, resposta (inclusive **Estacionada**), data de pagamento e arquivo. A tela **Liquidação** lê `GET /v1/domicile/settlements/{nuLiquid}` e mostra as respostas enviadas para ela.

* **Confirmar** e **Recusar** respondem uma liquidação, ou as liquidações que você seleciona na lista. **Recusar** pede um código de recusa (**Código de recusa**). O Cabine envia cada resposta com `POST /v1/domicile/responses` e mostra o resultado de cada liquidação.
* Cada resposta mostra a fase, a decisão, o estado, o arquivo e os erros da Núclea. **Liberar arquivo** libera um arquivo de resposta estacionado com `POST /v1/domicile/responses/unpark`.

## LBTR

***

A tela **Resultados LBTR** lista os resultados que a câmara anunciou. Ela lê `GET /v1/lbtr/results`. A tela **Resultado LBTR** lê `GET /v1/lbtr/results/{resultId}` e as respostas enviadas até agora em `GET /v1/lbtr/commands`.

* **Responder** responde o resultado com um LTR0002. O operador escolhe **Confirmar** ou **Divergir** e confere o valor anunciado. O Cabine envia com `POST /v1/lbtr/results/{resultId}/decision`.
* **Pagar com LTR0004** paga o resultado com um LTR0004. O Cabine envia ao Lerian SPB com `POST /v1/str/operations/ltr-transfers`.

## Referência

***

* A tela **Relatórios** lista os relatórios da Núclea com `GET /v1/reports`.
* A tela **Participantes** lista os participantes com `GET /v1/participants`. **Novo participante** cria um. A tela de detalhe edita ou exclui o participante e tem duas visões. **Arranjos** lista, cria, edita e exclui os arranjos do participante. **Conectividade** mostra o estado da API da Núclea, da conexão C:D, da conexão RSFN e do certificado. Ela também envia o teste AGEN001 com `POST /v1/participants/{participantIspb}/test-connectivity`.
* A tela **Catálogo XSD** lista os esquemas com `GET /v1/xsd-schemas` e mostra um documento com `GET /v1/xsd-schemas/{type}`.

## Administração

***

O menu **Admin** tem estas telas.

* **Webhooks** lista as assinaturas de webhook com `GET /webhooks`. **Novo webhook** cria uma, e você pode editá-la, excluí-la ou testá-la com **Testar**. O segredo é somente de escrita: o Cabine não o mostra. A tela de detalhe lista as entregas do webhook. **Reenviar** envia uma entrega de novo com `POST /webhooks/{id}/deliveries/{deliveryId}/replay`.
* **DLQ** aparece como **Mensagens mortas**. Ela lista uma fila com `GET /admin/dlq/{queue}`. **Reprocessar** devolve uma mensagem ao processamento com `POST /admin/dlq/{queue}/{id}/replay`.
* **Drenagem** executa as ações de recuperação da conectividade: **Despacho** envia o backlog de crédito na fila, **Retornos** processa os retornos recebidos e **Reprocessar participante** age sobre um ISPB.

## Permissões por controle

***

O Cabine oculta cada controle abaixo de um operador que não tem a permissão dele. O Lerian SLC também recusa a chamada com `403`.

| Controle | Permissão | Papéis |
| - | - | - |
| **Intake**, **Cancelar**, **Requeue** e **Retry** | `operations:write` | `admin`, `operator` |
| **Advance (override)** | `operations:admin` | `admin` |
| **Retransmitir**, **Drenagem** e **Liberar arquivo** | `connectivity:admin` | `admin` |
| **Depósitos de cartão** | `funding:read` | `admin`, `operator` |
| **Confirmar** e **Recusar** em **Domicílio** | `domicile:write` | `admin`, `operator` |
| **Responder** | `lbtr:write` | `admin`, `operator` |
| **Pagar com LTR0004** | `str-operations:write` no Lerian SPB | Os papéis do Lerian SPB que a têm |
| **Participantes** | `participants:read` | `admin` |
| **Webhooks** | `webhooks:admin` | `admin` |
| **DLQ** | `dlq:read` | `admin` |

Em BYOC, o Access Manager concede `domicile:read` e `domicile:write` depois que o Lerian SLC publica a declaração de permissões dele. Crie no Access Manager a aplicação machine-to-machine do Lerian SLC, com o nome `br-slc`. Depois defina `IDP_DECLARATION_ENABLED=true` no Lerian SLC, com `IDP_HOST`, `IDP_M2M_CLIENT_ID` e `IDP_M2M_CLIENT_SECRET` dessa aplicação. `PLUGIN_AUTH_ENABLED` deve ser `true`.

## Relacionados

***

* [Operando o Lerian SLC](https://docs.lerian.studio/pt/rails/slc/slc-operations.md)
* [Integração com o Lerian SLC](https://docs.lerian.studio/pt/rails/slc/slc-integration.md)
* [Acesso e papéis no Lerian Cabine](https://docs.lerian.studio/pt/rails/cabine/cabine-access-and-roles.md)


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