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

# Operando o Lerian SPI

> Liquidação ininterrupta, rotação de certificados, tratamento de contingências e o modelo de reconciliação por trás do Lerian SPI.

O Lerian SPI é construído em torno de duas realidades operacionais do Pix: ele liquida em tempo real, 24 horas por dia, e cada liquidação é confirmada de forma assíncrona. O trilho persiste tudo antes de despachar, de modo que nenhuma mensagem é enviada sem registro.

## Liquidação ininterrupta

***

O Pix liquida individual e instantaneamente, sem interrupção — não há uma janela operacional diária para abrir ou fechar. Duas superfícies adjacentes são restritas aos seus próprios períodos de referência: o agendamento do **Pix Automático** carrega janelas de liquidação para cada instrução agendada, e os relatórios da **Conta PI** são restritos a um período de referência de saldo ou extrato.

## Rotação de certificados

***

O certificado de assinatura do Pix é gerenciado pelo seu ciclo de vida. Você envia o `.cer` público e desativa um certificado que está retirando; uma **chave privada enviada é recusada, fail-closed**. Apenas as impressões digitais SHA-256 e os metadados públicos são armazenados, de modo que nenhum material de chave é exposto em uma resposta. Os avisos de certificado aparecem antes de a expiração se tornar um problema.

## Contingência e recuperação

***

Quando um pagamento fica preso, o trilho expõe apenas as ações que ele de fato consegue executar:

* Uma visão de **operações presas** lista os itens que precisam de atenção.
* A avaliação de **elegibilidade de recuperação** decide se uma operação pode ser recuperada.
* Uma **ação de recuperação** ou uma **resolução manual** libera uma operação elegível.
* Um fluxo de **aprovações de autorização manual** controla as operações que exigem uma aprovação explícita antes de prosseguir.
* Os jobs de **exportação de evidência** empacotam o registro de uma operação para auditoria ou disputa.

## Reconciliação

***

A reconciliação roda em vários grãos para que o estado do trilho nunca se afaste do do BACEN:

* As execuções de **reconciliação do DICT**, tanto completas quanto guiadas pela lista de eventos do BACEN, mantêm o diretório de chaves em sincronia.
* A **limpeza de chaves órfãs** remove as chaves deixadas para trás por um fluxo interrompido.
* O **processamento de prazos de reivindicações** avança ou encerra as reivindicações contra as suas janelas do BACEN.
* A **reconciliação por liquidação** alinha o estado de liquidação de cada pagamento com o ledger.

## Invariantes de liquidação

***

Duas invariantes se mantêm o tempo todo:

* **Um envio é despacho, não confirmação.** Um envio aceito significa que o despacho foi aceito. Apenas a resposta de status recebida `pacs.002` produz `settled` ou `rejected`, com os campos do BACEN projetados literalmente.
* **O trilho é neutro em relação ao dinheiro.** Ele repassa os valores declarados exatamente e não calcula posição ou saldo — toda posição contábil vive no Midaz.
