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

> Integración con Lerian SILOC: procesamiento de SFN configurado por MQ, envío de mensajes admitidos, CloudEvents de participantes y convenciones de la API.

Lerian SILOC está orientado a eventos en sus bordes. Con una conexión MQ de SILOC configurada, consume los mensajes de SFN admitidos desde Nuclea y emite hechos de participantes en la plataforma. No tiene **consumidores de webhook orientados al cliente**. Los sistemas downstream se suscriben a los temas de streaming en lugar de recibir callbacks.

## Qué consume

***

El procesamiento entrante de SFN empieza cuando configuras el descriptor de conexión MQ de SILOC completo. Si no hay ningún disparador de conexión presente, el servicio arranca sin conectividad SILOC en vivo. Establecer `MQ_HOST`, `MQ_CHANNEL`, `MQ_QUEUE_MANAGER`, `MQ_SEND_QUEUE` o `MQ_RECEIVE_QUEUE` activa la validación del descriptor completo en el arranque. Proporcionar solo una parte del descriptor falla de forma cerrada e impide que el servicio arranque. Con el descriptor completo configurado, Lerian SILOC descifra y decodifica los mensajes entrantes desde el envelope regulado, y luego aplica una política cerrada de **(`CodProdt`, `CodMsg`)**. Para `OT` y `SLC`, enruta `PAG0102`, `LDL0021` y `PAG0103`. Los frames `OT` difieren de forma duradera, mientras que los frames `SLC` se retransmiten a Lerian SLC. `PAG0101` difiere el estado del participante para cualquiera de los dos productos. `LDL0020`, `LDL0006` y cualquier otro par fallan de forma cerrada hacia una excepción operativa.

## Semántica de ingesta y entrega

***

* La retransmisión a SLC es **al menos una vez**. Para un frame de financiamiento de SLC decodificado correctamente con un `BCMSG.NUOp` no vacío, la clave de desduplicación duradera es **`BCMSG.NUOp`**, no solo un ID de mensaje.
* El servicio escribe ese registro de mensaje procesado solo después de una retransmisión exitosa. No crea ningún registro de mensaje procesado para un mensaje no decodificado o no admitido. Un fallo antes de que se escriba el registro puede resultar en otra entrega, por lo que este comportamiento no es una garantía incondicional de exactamente una vez de extremo a extremo.

## Qué emite

***

* **Hechos de participantes.** Lerian SILOC publica `siloc.participant.registered` y `siloc.participant.updated` como CloudEvents en el backbone de streaming de la plataforma. Los sistemas downstream siguen el directorio de participantes sin necesidad de polling.

## Sin punto de contacto con Midaz

***

Lerian SILOC **no** tiene integración directa con el ledger. No mantiene ninguna posición contable ni hace aritmética monetaria. Enruta bytes y emite hechos. Este riel no registra dinero. La liquidación de la posición neta ocurre en SILOC y en el STR. Cualquier asiento contable corresponde al servicio que posee el movimiento de dinero.

## Límite de la ruta del dinero

***

El riel STR independiente, [Lerian SPB](/es/rails/spb/what-is-lerian-spb), ejecuta la **pata de depósito del STR**, la liquidación monetaria en BACEN. SILOC no lo hace. Lerian SILOC transporta los mensajes de SILOC y administra la conexión. Nunca mueve dinero.

## Convenciones de la API

***

* La **ruta base** es `/api/v1/siloc`, y los errores siguen el formato de detalle de problema de RFC 9457.
* La **autenticación** sigue el esquema estándar de token bearer de la plataforma.
* **El registro de participantes es idempotente** mediante una clave de idempotencia, de modo que un registro reintentado no crea un duplicado.
* **Los certificados son referencias, no secretos.** Un certificado registrado incluye un certificado público y una referencia de custodia externa. No almacena ni devuelve ninguna clave privada.
