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

# SPB no Cabine

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

A área de trabalho do Lerian SPB no Lerian Cabine aparece como **STR**. Os operadores a usam para acompanhar operações e mensagens do STR, movimentar a liquidez da reserva, assinar emissões, buscar evidências e configurar o canal.

## Visão geral

***

A tela **Visão geral** lê [`GET /v1/str/operational-summary`](https://docs.lerian.studio/pt/reference/rails/spb/get-operational-summary). Ela mostra os casos de conciliação abertos (**Backlog de conciliação**) e os certificados em alerta (**Certificados em alerta**). Ela também mostra o volume de operações por família (**Volume por família**) e o instrumento de liquidez. **Abrir operações** abre a lista de operações.

## Liquidez

***

A tela **Liquidez** mostra a liquidez do dia: **Curva do dia**, **Indicadores BCBS 248** e **Obrigações com horário**. Ela lê [`GET /v1/str/operations`](https://docs.lerian.studio/pt/reference/rails/spb/list-operations) e [`GET /v1/str/schedule`](https://docs.lerian.studio/pt/reference/rails/spb/get-schedule). Ela lê o saldo da reserva com [`POST /v1/str/reserve-balance-queries`](https://docs.lerian.studio/pt/reference/rails/spb/create-reserve-balance-query) e [`GET /v1/str/reserve-balance-queries/{id}`](https://docs.lerian.studio/pt/reference/rails/spb/get-reserve-balance-query).

O instrumento de liquidez também aparece em **Visão geral**. Ele oferece um aporte quando o recomenda, e um resgate quando o saldo da Conta PI cobre o piso. Cada ação chama [`POST /v1/str/operations/liquidity-transfers`](https://docs.lerian.studio/pt/reference/rails/spb/create-liquidity-transfer-operation).

## Moeda eletrônica

***

A tela **Moeda eletrônica** trabalha com a CCME de uma instituição de moeda eletrônica.

* **Depósito**, **Saque** e **Devolução** enviam um movimento com [`POST /v1/str/operations/sme-transfers`](https://docs.lerian.studio/pt/reference/rails/spb/create-sme-transfer-operation). A tela o acompanha com [`GET /v1/str/operations/sme-transfers/{operationId}`](https://docs.lerian.studio/pt/reference/rails/spb/get-sme-transfer).
* **Extrato CCME** pede o extrato da CCME com [`POST /v1/str/sme-statement-queries`](https://docs.lerian.studio/pt/reference/rails/spb/create-sme-statement-query) e lê a resposta com [`GET /v1/str/sme-statement-queries/{nuOp}`](https://docs.lerian.studio/pt/reference/rails/spb/get-sme-statement-query).
* **Avisos CCME** lista os avisos de moeda eletrônica que o trilho recebeu. Ela lê [`GET /v1/str/sme-advices`](https://docs.lerian.studio/pt/reference/rails/spb/list-sme-advices).

## Operações

***

A tela **Operações** lista as operações do STR. Ela lê [`GET /v1/str/operations`](https://docs.lerian.studio/pt/reference/rails/spb/list-operations). Você pode buscar por NUOp ou valor e usar **Exportar CSV**.

A tela **Detalhe da operação** lê [`GET /v1/str/operations/{operationId}`](https://docs.lerian.studio/pt/reference/rails/spb/get-operation). As abas **Linha do tempo** e **Auditoria** leem [`GET /v1/str/operations/{operationId}/timeline`](https://docs.lerian.studio/pt/reference/rails/spb/get-operation-timeline) e [`GET /v1/str/operations/{operationId}/audit-records`](https://docs.lerian.studio/pt/reference/rails/spb/list-audit-records-for-operation). Ela pode oferecer uma de duas ações, conforme a situação da transferência:

* **Devolver** devolve um crédito de TED que a instituição recebeu, com um código de devolução do BACEN. Ela chama [`POST /v1/str/operations/bank-transfers/{operationId}/returns`](https://docs.lerian.studio/pt/reference/rails/spb/create-bank-transfer-return-operation).
* **Cancelar operação** cancela uma transferência bancária. Ela chama [`POST /v1/str/operations/bank-transfers/{operationId}/cancellations`](https://docs.lerian.studio/pt/reference/rails/spb/create-bank-transfer-cancellation-operation).

## Aprovações

***

A tela **Aprovações** lista as emissões que aguardam assinatura. Ela lê [`GET /v1/str/emission-approvals`](https://docs.lerian.studio/pt/reference/rails/spb/list-emission-approvals). As regras de **Governança de alçada** decidem quais emissões aguardam aqui. Cada linha oferece duas ações:

* **Assinar** chama [`POST /v1/str/emission-approvals/{id}/approve`](https://docs.lerian.studio/pt/reference/rails/spb/approve-emission).
* **Negar** chama [`POST /v1/str/emission-approvals/{id}/deny`](https://docs.lerian.studio/pt/reference/rails/spb/deny-emission).

## Recuperação

***

A tela **Recuperação**, com o título **Operações travadas**, lista as operações travadas. Ela lê [`GET /v1/str/stuck-operations`](https://docs.lerian.studio/pt/reference/rails/spb/list-stuck-operations). Você pode buscar e filtrar por **Idade** e **Estado**. O trilho decide quais ações cada linha oferece.

* **Reconhecer**, **Investigar**, **Resolver** e **Descartar** registram uma ação no caso com [`POST /v1/str/reconciliations/{reconciliationId}/actions`](https://docs.lerian.studio/pt/reference/rails/spb/create-reconciliation-action). **Retirar pedido** retira um pedido de encerramento pela mesma operação.
* **Pedir encerramento** pede para encerrar como falha uma transferência que passou do prazo. Ela chama [`POST /v1/str/stuck-operations/actions`](https://docs.lerian.studio/pt/reference/rails/spb/submit-stuck-operation-action).
* **Aprovar encerramento** aprova esse pedido. O Lerian SPB recusa a aprovação do operador que fez o pedido. O BACEN não é notificado. Ela chama [`POST /v1/str/stuck-operations/actions/{railActionRef}/approve`](https://docs.lerian.studio/pt/reference/rails/spb/approve-stuck-operation-action).
* **Reconhecer selecionadas** reconhece cada linha selecionada. Ela faz uma chamada à operação de ação no caso para cada linha.

## Mensagens

***

A tela **Mensagens** lista as mensagens do STR. Ela lê [`GET /v1/str/messages`](https://docs.lerian.studio/pt/reference/rails/spb/list-messages). Você pode buscar por NUOp, tipo ou número de controle e usar **Exportar CSV**.

A tela **Detalhe da mensagem** lê [`GET /v1/str/messages/{nuOp}`](https://docs.lerian.studio/pt/reference/rails/spb/get-message-status). A aba **Campos** mostra os campos. A aba **XML assinado** lê [`GET /v1/str/messages/{nuOp}/frame`](https://docs.lerian.studio/pt/reference/rails/spb/get-message-frame).

A tela **Nova mensagem** compõe e envia uma mensagem. Seu seletor oferece estes tipos. Uma mensagem que as regras de **Governança de alçada** retêm aguarda em **Aprovações**.

* **Transferir entre IFs**, **Creditar cliente**, **Enviar TED**, **Transferir não-correntista**, **Transferir cliente à IF** e **Repassar IBS** chamam [`POST /v1/str/messages/compose`](https://docs.lerian.studio/pt/reference/rails/spb/compose-str-message).
* **Consultar horários** chama [`POST /v1/str/schedule-queries`](https://docs.lerian.studio/pt/reference/rails/spb/create-schedule-query) e lê a resposta com [`GET /v1/str/schedule-queries/{id}`](https://docs.lerian.studio/pt/reference/rails/spb/get-schedule-query).
* **Consultar saldo** chama [`POST /v1/str/reserve-balance-queries`](https://docs.lerian.studio/pt/reference/rails/spb/create-reserve-balance-query) e lê a resposta com [`GET /v1/str/reserve-balance-queries/{id}`](https://docs.lerian.studio/pt/reference/rails/spb/get-reserve-balance-query).
* **Consultar extrato** chama [`POST /v1/str/reserve-statement-queries`](https://docs.lerian.studio/pt/reference/rails/spb/create-reserve-statement-query) e lê a resposta com [`GET /v1/str/reserve-statement-queries/{id}`](https://docs.lerian.studio/pt/reference/rails/spb/get-reserve-statement-query).

A tela **Avisos GEN** lista os avisos GEN que o trilho recebeu. Ela lê [`GET /v1/str/gen-notices`](https://docs.lerian.studio/pt/reference/rails/spb/list-gen-notices) e oferece **Exportar CSV**.

## Evidências

***

As telas **Evidências** leem o que o trilho registrou.

* **Consulta** encontra uma mensagem por NUOp. Ela lê [`GET /v1/str/messages/{nuOp}`](https://docs.lerian.studio/pt/reference/rails/spb/get-message-status).
* **Relatórios** gera **Movimento financeiro**, **Volumetria** ou **Transações rejeitadas** para um período, com **Gerar relatório**. Os relatórios leem [`GET /v1/str/reports/movement`](https://docs.lerian.studio/pt/reference/rails/spb/get-report-movement), [`GET /v1/str/reports/volumetria`](https://docs.lerian.studio/pt/reference/rails/spb/get-report-volumetria) e [`GET /v1/str/reports/rejected`](https://docs.lerian.studio/pt/reference/rails/spb/get-report-rejected).
* **Catálogo**, com o título **Capacidades**, lista as capacidades do trilho com [`GET /v1/str/capabilities`](https://docs.lerian.studio/pt/reference/rails/spb/list-capabilities). Uma capacidade abre [`GET /v1/str/capabilities/{capabilityId}`](https://docs.lerian.studio/pt/reference/rails/spb/get-capability).
* **Conciliação** lista os casos de conciliação com [`GET /v1/str/reconciliations`](https://docs.lerian.studio/pt/reference/rails/spb/list-reconciliation-cases). Um caso lê [`GET /v1/str/reconciliations/{reconciliationId}`](https://docs.lerian.studio/pt/reference/rails/spb/get-reconciliation-case). Suas ações de caso estão em [Recuperação](#recovery).
* **Auditoria** lista os registros de auditoria com [`GET /v1/str/audit-records`](https://docs.lerian.studio/pt/reference/rails/spb/list-audit-records) e oferece **Exportar CSV**.

## Configuração

***

A tela **Configuração** tem três seções. **Reserva** guarda os pisos operacionais (veja [Configurando o Lerian Cabine](https://docs.lerian.studio/pt/rails/cabine/cabine-configuration.md)). **Canal** mostra o vínculo do participante, lido com [`GET /v1/str/settings`](https://docs.lerian.studio/pt/reference/rails/spb/get-settings). **Certificados** lista os certificados, lidos com [`GET /v1/str/certificates`](https://docs.lerian.studio/pt/reference/rails/spb/list-certificates).

* **Salvar alterações** no formulário do canal chama [`PATCH /v1/str/settings`](https://docs.lerian.studio/pt/reference/rails/spb/update-settings).
* **Rotacionar certificado (GEN0006)** tem dois passos. **Rotacionar** chama [`POST /v1/str/certificates/rotate`](https://docs.lerian.studio/pt/reference/rails/spb/rotate-certificate). **Ativar** chama [`POST /v1/str/certificates/activate`](https://docs.lerian.studio/pt/reference/rails/spb/activate-certificate).
* **Testar conectividade** envia um teste de conectividade com [`POST /v1/str/connectivity-tests`](https://docs.lerian.studio/pt/reference/rails/spb/create-connectivity-test).

Três telas ficam sob **Configuração**:

* **Governança de alçada** define as regras **Faixas de valor** e **Por mensagem**. Ela lê [`GET /v1/str/governance`](https://docs.lerian.studio/pt/reference/rails/spb/get-str-governance) e salva com [`PUT /v1/str/governance`](https://docs.lerian.studio/pt/reference/rails/spb/put-str-governance).
* **Transferência automática** define a transferência automática da Conta PI para **Reservas (RB/CL)** e **Moeda eletrônica (CCME)**. Ela chama [`POST /v1/str/operations/auto-transfer-config`](https://docs.lerian.studio/pt/reference/rails/spb/create-auto-transfer-config).
* **Responsáveis** envia o **Roster** de responsáveis. Ela chama [`POST /v1/str/responsibles`](https://docs.lerian.studio/pt/reference/rails/spb/update-responsibles).

**XML assinado** exige `str-message-frames:read`. A edição do canal exige `str-settings:write`, e a rotação de certificado exige `str-certificates:rotate`. O roster exige `str-responsibles:submit`.

## Relacionados

***

* [Operação do Lerian SPB](https://docs.lerian.studio/pt/rails/spb/spb-operations.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.