> ## 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 da instituição 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 própria de uma instituição financeira com 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 canais separados de auditoria e de negócio para os consumidores. Ele é API-first e event-first. Para arquivos de entrada descobertos, o STA resolve `source_product` a partir do filtro de origem configurado. Arquivos sem correspondência são marcados como `unrouted`.

## 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](https://docs.lerian.studio/pt/rails/sisbajud/what-is-lerian-sisbajud.md)) busca o artefato e processa o seu conteúdo. O consumidor é o dono de qualquer lançamento no ledger.

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

Downstream, ele atende os produtos Lerian que consomem os arquivos que entrega.

## Glossário

***

| Termo | Significado |
| - | - |
| **Lerian STA** | A integração da Lerian de propriedade da instituição 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 que vincula um código de sistema do BACEN a um produto de origem, com sua cadência de polling e sua credencial. |
| **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. O seu componente Mensageria 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](https://docs.lerian.studio/pt/rails/native-messaging.md).


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