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