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

> O que o Lerian SLC consome e emite — as famílias de eventos de ciclo de vida e de clearing em CloudEvents sobre o outbox transacional, os webhooks assinados com HMAC, o webhook de domicílio com chave NUliquid— e os touchpoints opcionais de Midaz e Reporter.

O Lerian SLC é orientado a eventos nas suas bordas. Ele consome as mensagens de entrada da Nuclea e emite os seus fatos de negócio através de um **outbox transacional** para o backbone de streaming da plataforma e para **webhooks assinados com HMAC**, tudo em um envelope **CloudEvents**. Um evento é publicado apenas quando a sua mudança de estado foi confirmada.

## O que ele consome

***

Da Nuclea, de entrada, sobre a **RSFN**:

* **GEN0015**
* **SLC0001** — preview e final de clearing
* **SLC0002**
* **PAG0101** — status operacional

Os retornos de arquivo —**PRO / ERR / RET**— são correlacionados de volta ao seu arquivo **por nome de arquivo**.

## O que ele emite

***

Cada emissão passa pelo outbox transacional, de modo que um evento é publicado se e somente se a sua mudança de estado foi confirmada. Os eventos carregam um envelope CloudEvents e são entregues tanto no backbone de streaming quanto em webhooks assinados com HMAC.

* **Eventos de ciclo de vida da operação** — um por transição de estado da operação.
* **`operation.status_relayed`** — um status foi retransmitido.
* **`cancellation.confirmed_by_domicile`** — um cancelamento confirmado pela IF Domicílio, que carrega o NUliquid.
* **`d1.value_mismatch`** — uma divergência de valor D0-versus-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`.

Um **webhook com chave NUliquid** sinaliza o crédito ao estabelecimento e carrega a evidência do retorno do fluxo de domicílio.

## Touchpoint com o Midaz

***

O Lerian SLC é standalone; ele não posta em um ledger por conta própria. O **Midaz** é um consumidor **opcional** —pode assinar os eventos do Lerian SLC ou chamar a sua API para espelhar a liquidação no ledger— mas o Lerian SLC não depende do Midaz.

## Touchpoint com o Reporter

***

O **Reporter** é um consumidor **opcional** dos eventos do Lerian SLC, e também pode atuar como um **provedor plugável opcional de materialização ASLC** por meio de templates. A propriedade regulatória do layout ASLC permanece no Lerian SLC; o Reporter, quando plugado, apenas o renderiza.

## Fronteira da rota do dinheiro

***

O Lerian SLC é dono da mensageria de liquidação de cartões com a Nuclea. Ele não realiza a liquidação monetária em si — a posição líquida liquida no SLC e na Nuclea, e a perna de reservas liquida no BACEN. A família de liquidação diferida líquida do domínio de cartões chega ao Lerian SLC retransmitida a partir do [Lerian SILOC](/pt/rails/native/siloc/what-is-lerian-siloc), a conectividade SILOC do lado do participante.

## Convenções de API

***

* **Intake idempotente.** Os envios pela API canônica são idempotentes por `external_id`, de modo que um envio repetido nunca liquida duas vezes.
* **Auth online.** As operações individuais online sobre REST são protegidas com mTLS e uma assinatura JWS por requisição.
* **Os certificados são referências, não segredos.** Um certificado registrado carrega o seu certificado público e uma referência de custódia; a chave privada nunca é armazenada nem devolvida.