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

# Integração com o Lerian SLC

> Integração com o Lerian SLC: famílias de outbox CloudEvents para o ciclo de vida de liquidação e compensação de cartões, webhooks assinados com HMAC, e Midaz e Reporter opcionais.

O Lerian SLC é orientado a eventos nas suas bordas. Ele consome as mensagens de entrada da Nuclea. Ele emite seus fatos de negócio por meio de um **outbox transacional** para o backbone de streaming da plataforma e para **webhooks assinados com HMAC**. Todo evento carrega um envelope **CloudEvents**. O Lerian SLC publica um evento apenas depois que sua mudança de estado é confirmada.

## O que ele consome

***

Da entrada da Nuclea, pela **RSFN**:

* **GEN0015**
* **SLC0001** (prévia e final da compensação)
* **SLC0002**
* **PAG0101** (status operacional)

O Lerian SLC correlaciona cada costura de retorno pela chave que a contraparte ecoa: uma linha **RET** pelo seu número de controle de 20 posições, uma linha **ASLC023** ou D+1 pelo seu **NUliquid**, e um **PRO** em nível de arquivo pelo número de controle do lote transmitido.

## O que ele emite

***

Toda emissão passa pelo outbox transacional. O Lerian SLC publica um evento se e apenas se sua mudança de estado for confirmada. Cada evento carrega um envelope CloudEvents. A plataforma o entrega no backbone de streaming e para webhooks assinados com HMAC.

* **Eventos de ciclo de vida da operação**: um por transição de estado da operação.
* **`operation.status_relayed`**: o trilho repassou um status de operação para a IF Domicílio.
* **`operation.forward_rejected`**: uma submissão de saída ficou em espera e precisa de ação do operador. O payload, não o nome do evento, informa qual perna e por quê. `stage` identifica a perna afetada: `forward` para a IF Domicílio ou `dispatch` para Núclea. Em ambos os casos, `parkReason` é `attempt_budget_exhausted`. Os ids de operação do payload são o que o endpoint de retomada recebe.
* **`cancellation.confirmed_by_domicile`**: a IF Domicílio confirmou um cancelamento e o evento carrega o NUliquid.
* **`d1.value_mismatch`**: uma divergência de valor entre D0 e D+1.
* **`certificate.expiring`**: um certificado se aproximando do vencimento.
* A família **`clearing.*`**: `cycle_opened`, `cycle_closed`, `cycle_recalculated`, `preview_available`, `final_available`, `credit_settled`, `credit_returned`, `deposit_required`, `deposit_deadline_approaching` e `divergence_reported`.

Os webhooks do fluxo de domicílio carregam o **NUliquid**. Os consumidores o usam para correlacionar o crédito ao lojista de cada operação e sua evidência de retorno do domicílio.

## Ponto de contato com o Midaz

***

O Lerian SLC é autônomo. Ele não lança no ledger por conta própria. O **Midaz** é um consumidor **opcional**. O Midaz pode se inscrever nos eventos do Lerian SLC ou chamar sua API para espelhar a liquidação no ledger. O Lerian SLC não depende do Midaz.

## Ponto de contato com o Reporter

***

O **Reporter** é um consumidor **opcional** dos eventos do Lerian SLC. O Reporter também pode ser um **provedor plugável opcional de materialização do ASLC** por meio de templates. O Lerian SLC mantém a propriedade regulatória do layout do ASLC. O Reporter apenas o renderiza quando você o conecta.

## Limite do caminho do dinheiro

***

O Lerian SLC detém a mensageria de liquidação de cartões com a Nuclea. Ele não faz a liquidação monetária em si. A posição líquida se liquida na SLC e na Nuclea. A perna de reserva se liquida no BACEN. A família de liquidação líquida diferida do domínio de cartões chega ao Lerian SLC repassada pelo [Lerian SILOC](/pt/rails/siloc/what-is-lerian-siloc), a conectividade SILOC do lado do participante.

## Convenções de API

***

* **Ingestão idempotente.** As submissões da API canônica são idempotentes por `external_id`. O Lerian SLC rejeita um `external_id` duplicado, então uma submissão reenviada nunca é liquidada duas vezes.
* **Autenticação online.** mTLS e uma assinatura JWS por requisição protegem cada operação online individual via REST.
* **Certificados são referências, não segredos.** Um certificado registrado carrega seu certificado público e uma referência de custódia. O Lerian SLC nunca armazena ou retorna a chave privada.