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

# Integración con Lerian SLC

> Qué consume y qué emite Lerian SLC — las familias de eventos de ciclo de vida y de clearing en CloudEvents sobre el outbox transaccional, los webhooks firmados con HMAC, el webhook de domicilio con clave NUliquid— y los touchpoints opcionales de Midaz y Reporter.

Lerian SLC es orientado a eventos en sus bordes. Consume los mensajes de entrada de Nuclea y emite sus hechos de negocio a través de un **outbox transaccional** hacia el backbone de streaming de la plataforma y hacia **webhooks firmados con HMAC**, todo en un envelope **CloudEvents**. Un evento se publica solo cuando su cambio de estado se ha confirmado.

## Qué consume

***

De Nuclea, de entrada, sobre la **RSFN**:

* **GEN0015**
* **SLC0001** — preview y final de clearing
* **SLC0002**
* **PAG0101** — estado operativo

Los retornos de archivo —**PRO / ERR / RET**— se correlacionan de vuelta a su archivo **por nombre de archivo**.

## Qué emite

***

Cada emisión pasa por el outbox transaccional, de modo que un evento se publica si y solo si su cambio de estado se confirmó. Los eventos llevan un envelope CloudEvents y se entregan tanto en el backbone de streaming como a webhooks firmados con HMAC.

* **Eventos de ciclo de vida de la operación** — uno por transición de estado de la operación.
* **`operation.status_relayed`** — se ha retransmitido un estado.
* **`cancellation.confirmed_by_domicile`** — una cancelación confirmada por la IF Domicílio, que lleva el NUliquid.
* **`d1.value_mismatch`** — una divergencia de valor D0-versus-D+1.
* **`certificate.expiring`** — un certificado que se acerca a su vencimiento.
* La familia **`clearing.*`** — `cycle_opened`, `cycle_closed`, `cycle_recalculated`, `preview_available`, `final_available`, `credit_settled`, `credit_returned`, `deposit_required`, `deposit_deadline_approaching` y `divergence_reported`.

Un **webhook con clave NUliquid** señala el crédito al comercio y lleva la evidencia del retorno del flujo de domicilio.

## Touchpoint con Midaz

***

Lerian SLC es standalone; no postea a un ledger por sí mismo. **Midaz** es un consumidor **opcional** —puede suscribirse a los eventos de Lerian SLC o llamar a su API para reflejar la liquidación en el ledger— pero Lerian SLC no depende de Midaz.

## Touchpoint con Reporter

***

**Reporter** es un consumidor **opcional** de los eventos de Lerian SLC, y también puede actuar como un **proveedor pluggable opcional de materialización ASLC** mediante plantillas. La propiedad regulatoria del layout ASLC permanece en Lerian SLC; Reporter, cuando se conecta, solo lo renderiza.

## Frontera de la ruta del dinero

***

Lerian SLC es dueño de la mensajería de liquidación de tarjetas con Nuclea. No realiza la liquidación monetaria en sí —la posición neteada se liquida en el SLC y en Nuclea, y la pierna de reservas se liquida en el BACEN. La familia de liquidación diferida neta del dominio de tarjetas llega a Lerian SLC retransmitida desde [Lerian SILOC](/es/rails/native/siloc/what-is-lerian-siloc), la conectividad SILOC del lado del participante.

## Convenciones de API

***

* **Intake idempotente.** Los envíos por la API canónica son idempotentes por `external_id`, de modo que un envío reintentado nunca liquida dos veces.
* **Auth en línea.** Las operaciones individuales en línea sobre REST se aseguran con mTLS y una firma JWS por solicitud.
* **Los certificados son referencias, no secretos.** Un certificado registrado lleva su certificado público y una referencia de custodia; la clave privada nunca se almacena ni se devuelve.