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

# Como o Lerian SPB funciona

> A sequência de habilitação, os fluxos de transferência e de ciclo de vida, as operações de liquidez e as consultas assíncronas que compõem a superfície de mensagens do STR.

O Lerian SPB expõe a superfície de mensagens do STR como um conjunto de operações tipadas. Cada fluxo persiste o seu trabalho antes de despachar, retorna um estado aceito-mas-não-liquidado e concilia contra a resposta assíncrona do BACEN.

## Habilitação

***

A habilitação segue uma ordem obrigatória, e cada passo é o seu próprio recurso. Um envio tentado antes de passar na verificação de disponibilidade é recusado.

1. **Gire** o certificado de assinatura ICP-Brasil.
2. **Ative-o** junto ao BACEN (GEN0006, confirmado por GEN0006R1).
3. Confirme que o trilho reporta **`READY`**.
4. Passe em um **teste de eco de conectividade** (GEN0001, respondido por GEN0001R1).
5. A partir daqui, os envios são permitidos.

## Transferências bancárias

***

Você declara as partes tipadas de origem e destino; a plataforma deriva o código de transferência STR (STR0004, STR0005, STR0006, STR0007 ou STR0008), persiste a operação e o trabalho de saída, e só então despacha. A resposta é `SUBMITTED` — o despacho foi aceito, não liquidado. O BACEN confirma de forma assíncrona, e a operação passa a `SETTLED` ou `REJECTED`.

## Devoluções e cancelamentos

***

Uma devolução e um cancelamento são ambos subrecursos de uma operação pai e estão ligados estruturalmente a ela pelo id do pai no caminho da solicitação.

* Uma **devolução** exige que o pai esteja `SETTLED` (pipeline STR0010).
* Um **cancelamento** exige que o pai ainda admita um (pipeline STR0011).

Uma solicitação contra o estado incorreto do pai é recusada.

## Repasse do IBS

***

Um **repasse do IBS** (STR0053) transfere os valores de liquidação do IBS da conta de reservas para o comitê gestor. A solicitação é traduzida para a mensagem STR0053, persistida, despachada e confirmada de forma assíncrona.

## Liquidez da Conta PI

***

Duas operações movimentam liquidez entre a conta de reservas-liquidação de uma instituição e a sua Conta PI:

* **Aporte** (LPI0001) financia a Conta PI a partir da conta de reservas.
* **Resgate** (LPI0003) devolve fundos à conta de reservas.

Ambas retornam `PENDING`. A resposta de liquidação de entrada (LPI0001R1 / LPI0003R1) move a operação para `SETTLED` ou `REJECTED`, projetada literalmente. Um aporte enviado fora da janela operacional é rejeitado.

## Política de transferência automática

***

Você declara a regra de transferência automática do STR para uma classe de conta (emitindo LPI0005). O BACEN a reconhece (LPI0005R1) e, mais tarde, reporta cada transferência automática que realiza (LPI0006). Os valores reportados são repassados literalmente; o Lerian SPB não faz nenhuma aritmética sobre eles.

## Fila de aprovação para emissões de alto valor

***

Cada emissão é verificada contra uma faixa de valor configurada. Um envio cujo valor ultrapassa a sua faixa fica em `PENDING_APPROVAL` e aparece na fila de aprovação; ele só despacha quando o quórum de aprovação é atingido. Um valor abaixo da faixa vai direto para `SUBMITTED`. As emissões na fila podem ser assinadas ou negadas.

## Composição curada de mensagens

***

Uma superfície de composição controlada por catálogo constrói um tipo de mensagem STR de uma lista permitida (STR0004, STR0005, STR0006, STR0007, STR0008 ou STR0053). O tipo escolhido precisa resolver no catálogo de capacidades e ser publicamente enviável; caso contrário, a solicitação é recusada.

## Consultas assíncronas de uma única parte

***

As leituras de posição de reservas e de calendário retornam um id de correlação e `PENDING`; a resposta do BACEN chega de forma assíncrona e é relida por esse id. O Lerian SPB projeta o que o BACEN envia e não calcula nenhuma posição própria.

| Consulta                      | Código STR | Retorna                                                              |
| ----------------------------- | ---------- | -------------------------------------------------------------------- |
| Saldo da conta de reservas    | STR0013    | Id de correlação + `PENDING`, depois o saldo que o BACEN reporta     |
| Extrato de reservas           | STR0014    | Id de correlação + `PENDING`, depois o extrato em modo mensagem      |
| Calendário operacional do STR | STR0001    | Id de correlação + `PENDING`, depois as faixas da janela operacional |

## Avisos de entrada e roster

***

* Os **avisos** (GEN0001, GEN0004, GEN0005) são registrados literalmente.
* As **difusões de calendário** (GEN0021) atualizam as faixas da janela operacional — vence o último anúncio.
* O **roster de responsáveis** completo do participante é anunciado por substituição total (GEN0019).

## Conciliação e recuperação

***

As divergências de liquidação abrem casos de conciliação. Os operadores registram ações `ACKNOWLEDGE`, `RESOLVE`, `DISMISS` ou `INVESTIGATE` sobre um caso, e os casos terminais ficam bloqueados. Uma visão de operações travadas entre trilhos lista os itens que precisam de atenção, expondo apenas as ações que o trilho realmente pode realizar.