> ## 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 STA?

> O Lerian STA é sua integração de propriedade do cliente com o hub de troca de arquivos STA do BACEN: transporte regulatório de arquivos nos dois sentidos, com integridade SHA-256 e eventos terminais.

O **Lerian STA** é a integração de mensageria de propriedade do cliente entre uma instituição financeira e o **STA do BACEN (Sistema de Transferência de Arquivos)**, o hub de troca de arquivos do Banco Central. Ele move arquivos regulatórios e operacionais nos dois sentidos. A instituição envia arquivos ao BACEN (saída), e o BACEN disponibiliza arquivos para a instituição baixar (entrada).

O Lerian STA autentica cada troca com uma credencial de operador do BACEN armazenada para a instituição. Ele valida a cadeia TLS pública do BACEN pelo pool de raízes do sistema e não anexa nenhum certificado de cliente. Ele conduz cada transferência pela máquina de estados de protocolo do BACEN e verifica a integridade do arquivo por **SHA-256**. Ele armazena os artefatos de entrada de forma durável e pode publicar fatos de estado terminal por outboxes separadas de auditoria e de negócio para os consumidores. Ele aceita um modo multi-tenant com isolamento físico de banco de dados por tenant, além da operação single-tenant, e é API-first e event-first.

## O que o Lerian STA faz e não faz

***

* Ele é a **fronteira de transporte e integridade** entre a instituição e o hub de arquivos do BACEN. Ele move os bytes, autentica a troca, verifica o SHA-256 e registra o resultado. Ele não interpreta o conteúdo de negócio do arquivo.
* Ele **não lança no ledger**. Ao concluir um download de entrada, o Lerian STA publica um evento de estado terminal que carrega um claim-check. O produto de domínio consumidor (por exemplo, [Lerian SISBAJUD](/pt/rails/sisbajud/what-is-lerian-sisbajud)) busca o artefato e o concilia no **ledger do cliente**. O lançamento no ledger pertence ao consumidor, não ao Lerian STA.
* Ele aceita um **modo multi-tenant** com isolamento físico de banco de dados por tenant. No **modo single-tenant**, ele usa o banco de dados/pool padrão sem contexto de tenant.

## Quem ele atende

***

O Lerian STA atende instituições financeiras que operam nos trilhos do BACEN e precisam de um caminho governado e auditável para a troca de arquivos com o Banco Central. Ele pode rodar em modo single-tenant ou, quando o multi-tenancy está habilitado, atender várias instituições em um único deployment com bancos de dados isolados.

Downstream, ele atende os produtos Lerian que consomem os arquivos que entrega. O Lerian STA roteia cada arquivo de entrada a um **produto de origem**, o produto downstream que é dono do significado de negócio do arquivo. Esse produto se inscreve nos próprios eventos.

## Glossário

***

| Termo                                 | Significado                                                                                                                                                                                                                                                                                                     |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Lerian STA**                        | A integração de propriedade do cliente da Lerian com o hub de troca de arquivos do BACEN (Sistema de Transferência de Arquivos).                                                                                                                                                                                |
| **Transferência**                     | Uma troca de entrada ou de saída de um único arquivo entre a instituição e o BACEN, rastreada ao longo do seu ciclo de vida.                                                                                                                                                                                    |
| **Transferência de saída**            | Um arquivo que a instituição envia ao BACEN.                                                                                                                                                                                                                                                                    |
| **Transferência de entrada**          | Um arquivo que o BACEN disponibiliza para a instituição baixar.                                                                                                                                                                                                                                                 |
| **Número de protocolo**               | O identificador atribuído pelo BACEN para uma transferência; a chave de conciliação e idempotência.                                                                                                                                                                                                             |
| **Configuração de origem de entrada** | Uma política por tenant que vincula um código de sistema do BACEN a um produto de origem, com cadência de polling, credencial, retenção e tamanho máximo de arquivo.                                                                                                                                            |
| **Credencial**                        | Uma senha de operador do BACEN criptografada, identificada por código da instituição e ID do operador.                                                                                                                                                                                                          |
| **Rotação de senha**                  | A troca em três fases de uma senha do BACEN — preparar, alterar no BACEN, promover localmente.                                                                                                                                                                                                                  |
| **Claim-check**                       | O `object_key`, `sha256`, `size_bytes` e `file_name` carregados em um evento de sucesso de entrada, para que um consumidor possa buscar e reverificar o artefato. `document_code` carrega o código do BACEN observado; `document_type` carrega o mnemônico corroborado ou mantém o código para compatibilidade. |
| **Produto de origem**                 | O produto downstream ao qual um arquivo de entrada descoberto é roteado (por exemplo, Lerian SISBAJUD).                                                                                                                                                                                                         |
| **Lerian SISBAJUD**                   | O produto de ordem judicial de ativos que consome os eventos de arquivo de entrada do Lerian STA.                                                                                                                                                                                                               |

Para saber como o Lerian STA se posiciona ao lado dos outros trilhos nativos e das interfaces de parceiros, veja [Mensageria nativa e interfaces de parceiros](/pt/rails/native-messaging).
