Skip to main content
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, 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.