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

> Integración con Lerian SLC: familias de outbox en CloudEvents para el ciclo de vida y el clearing de la liquidación de tarjetas, webhooks firmados con HMAC, y Midaz y Reporter opcionales.

Lerian SLC es orientado a eventos en sus bordes. Consume los mensajes de entrada de Nuclea. 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**. Cada evento lleva un envelope **CloudEvents**. Lerian SLC publica un evento solo después de que su cambio de estado se confirma.

## Qué consume

***

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

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

Lerian SLC correlaciona cada tramo de retorno por la clave que la contraparte repite: una línea **RET** por su número de control de 20 posiciones, una línea **ASLC023** o D+1 por su **NUliquid**, y un **PRO** del archivo completo por el número de control del segmento transmitido.

## Qué emite

***

Cada emisión pasa por el outbox transaccional. Lerian SLC publica un evento si y solo si su cambio de estado se confirma. Cada evento lleva un envelope CloudEvents. La plataforma lo entrega en el backbone de streaming y 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`** — el rail retransmitió un estado de operación a la IF Domicílio.
* **`operation.forward_rejected`** — una entrega de salida quedó aparcada y necesita acción del operador. El payload, no el nombre del evento, dice qué tramo y por qué. `stage` es `forward` — el tramo hacia el IF Domicílio, emparejado con `parkReason` `permanent_rejection` — o `dispatch`, el tramo hacia Núclea, emparejado con `attempt_budget_exhausted`. Los ids de operación del payload son los que toma el endpoint de des-aparcado.
* **`cancellation.confirmed_by_domicile`** — la IF Domicílio confirmó una cancelación y el evento 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`.

Los webhooks del flujo de domicilio llevan el **NUliquid**. Los consumidores lo usan para correlacionar el crédito al comercio de cada operación y su evidencia de retorno de domicilio.

## Touchpoint con Midaz

***

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

## Touchpoint con Reporter

***

**Reporter** es un consumidor **opcional** de los eventos de Lerian SLC. Reporter también puede actuar como un **proveedor pluggable opcional de materialización ASLC** mediante plantillas. Lerian SLC conserva la propiedad regulatoria del layout ASLC. Reporter solo lo renderiza cuando lo conectas.

## 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. 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`. Lerian SLC rechaza un `external_id` duplicado, de modo que un envío reintentado nunca liquida dos veces.
* **Auth en línea.** mTLS y una firma JWS por solicitud aseguran cada operación individual en línea sobre REST.
* **Los certificados son referencias, no secretos.** Un certificado registrado lleva su certificado público y una referencia de custodia. Lerian SLC nunca almacena ni devuelve la clave privada.