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

# O que é o Lerian SPB?

> O conector direto e não intermediado da Lerian ao STR do BACEN para transferências interbancárias e de alto valor e operações de conta de reservas.

O **Lerian SPB** é o conector de mensageria próprio e não intermediado da Lerian ao **STR** (Sistema de Transferência de Reservas), o núcleo de liquidação bruta em tempo real do sistema de pagamentos brasileiro. Ele alcança o STR pela **RSFN**, a rede nacional privada que transporta as mensagens do sistema de pagamentos entre os participantes e o Banco Central do Brasil (BACEN).

Ele dá a uma instituição participante um caminho direto para enviar e liquidar transferências interbancárias e de alto valor — a família TED — e operações de conta de reservas contra o sistema de liquidação do BACEN, sem nenhum parceiro de conectividade entre a instituição e o BACEN.

## A quem atende

***

O Lerian SPB atende instituições financeiras que mantêm a própria conta de reservas e liquidação no BACEN. Essas instituições enviam transferências da família TED, movimentam liquidez entre a conta de reservas e a conta de liquidez (Conta PI) e consultam a posição de reservas diretamente pelo STR.

## Uma API centrada na operação

***

Você não escolhe um código de mensagem manualmente. Você declara os papéis tipados das partes de uma operação — quem debita, quem credita e se cada lado é uma instituição com conta ou um cliente — e a plataforma deriva para você o código de mensagem STR correto.

| Partes declaradas            | Código STR | Movimento                                                      |
| ---------------------------- | ---------- | -------------------------------------------------------------- |
| Instituição para instituição | STR0004    | Transferência interbancária entre dois participantes com conta |
| Sem conta                    | STR0005    | Transferência com partes que não mantêm conta de reservas      |
| Cliente para instituição     | STR0006    | Um cliente envia a uma instituição                             |
| Instituição para cliente     | STR0007    | Uma instituição envia a um cliente                             |
| Cliente para cliente         | STR0008    | Transferência entre dois clientes em instituições distintas    |

## A liquidação é assíncrona

***

O STR é um sistema de liquidação bruta em tempo real: cada operação liquida individualmente contra os saldos de reservas. Quando você envia uma transferência, a plataforma retorna `SUBMITTED` — o despacho foi aceito, **não** que o BACEN a tenha liquidado. O BACEN confirma de forma assíncrona por meio de uma resposta de liquidação (a R-leg), que move a operação para `SETTLED` ou `REJECTED` e carrega os campos de liquidação do BACEN (por exemplo `numCtrlSTR` e `sitLancSTR`), projetados literalmente.

## Neutralidade em relação ao dinheiro

***

O Lerian SPB é neutro em relação ao dinheiro por projeto. Ele repassa os valores que você declara exatamente como declarados e não calcula nenhum saldo ou posição própria. Toda posição contábil vive no **Midaz**, o ledger; o Lerian SPB transporta a mensagem, o Midaz carrega o dinheiro.

## Glossário

***

| Termo                                          | Significado                                                                                                                          |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **STR** — Sistema de Transferência de Reservas | O sistema de liquidação bruta em tempo real (RTGS) do BACEN, no qual cada operação liquida individualmente.                          |
| **SPB** — Sistema de Pagamentos Brasileiro     | O sistema de pagamentos brasileiro do qual o STR é o núcleo de liquidação.                                                           |
| **RSFN**                                       | A rede nacional privada do sistema financeiro que transporta as mensagens do SPB entre os participantes e o BACEN.                   |
| **TED**                                        | Uma transferência eletrônica liquidada pelo STR.                                                                                     |
| **NUOp**                                       | Identificador de operação do BACEN de 23 dígitos (ISPB + data + sequência) que correlaciona uma mensagem enviada com a sua resposta. |
| **ISPB**                                       | Código do BACEN de 8 dígitos que identifica uma instituição participante do sistema de pagamentos.                                   |
| **Conta PI / conta de reservas-liquidação**    | As contas que uma instituição mantém no BACEN para liquidação e liquidez.                                                            |
| **Certificado ICP-Brasil**                     | O certificado digital usado para assinar as mensagens de saída do SPB.                                                               |
| **Confirmação de liquidação (R-leg)**          | A resposta assíncrona do BACEN que move uma operação enviada para `SETTLED` ou `REJECTED`.                                           |
| **Códigos STR / LPI / GEN**                    | Identificadores oficiais do protocolo do BACEN para cada tipo de mensagem STR e SPB (por exemplo STR0004, LPI0001, GEN0006).         |

Para ver como o Lerian SPB convive com os demais trilhos nativos e as interfaces de provedor, consulte [Mensageria nativa](/pt/rails/native/native-messaging).
