Saltar al contenido principal
Lerian SILOC está orientado a eventos en sus bordes. Con una conexión MQ de SILOC configurada, consume los mensajes de SFN admitidos desde Núclea y emite hechos 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

  • Mensajes de SFN desde Núclea. Con el descriptor de conexión MQ de SILOC completo configurado, Lerian SILOC descifra y decodifica cada mensaje entrante desde el envelope regulado, y luego lo enruta con una política cerrada de (CodProdt, CodMsg). LDL0020, LDL0006 y cualquier otro par no admitido fallan de forma cerrada hacia una excepción operativa. Consulta Cómo funciona Lerian SILOC para ver las rutas.
  • Hechos de liquidación LDL de SPB, cuando LDL_FACT_CONSUMER_ENABLED=true. Cada hecho registra el resultado de la instrucción que nombra.
  • Comandos de tarjeta de Lerian SLC, cuando CARD_COMMAND_CONSUMER_ENABLED=true. El servicio envía cada comando a Núclea y publica su resultado.

​
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 la parte del mensaje: BCMSG.NUOp y su número de parte, NumSeq.
  • 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 studio.lerian.br-siloc.siloc_participant.registered, studio.lerian.br-siloc.siloc_participant.updated y studio.lerian.br-siloc.siloc_participant.status-changed como CloudEvents en el backbone de streaming de la plataforma. Los sistemas downstream siguen el directorio de participantes sin necesidad de polling.
  • Hechos operativos. Transiciones de alertas (studio.lerian.br-siloc.siloc_alert.raised, studio.lerian.br-siloc.siloc_alert.cleared y studio.lerian.br-siloc.siloc_alert.acknowledged), cambios de horario, avisos de la câmara, respuestas a las solicitudes de la institución, resultados multilaterales de la câmara y hechos de liquidación de los ciclos OT.
  • Solicitudes fallidas. Cuando una solicitud saliente termina en FAILED, Lerian SILOC publica studio.lerian.br-siloc.siloc_outbound.failed en la misma transacción que el cambio de estado. Ninguna respuesta y ningún rechazo llegan después. El evento lleva id, codMsg, numCtrlIF, nuop, ispbIF, ispbLDL, codProdt cuando la solicitud tiene uno, status, reason y failedAt. reason es schema_invalid, unregistered_code, lbtr_closed o movement_day_ended.

​
Sin punto de contacto con Midaz

Lerian SILOC no tiene integración directa con el ledger. No mantiene ninguna posición contable. 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. Envía las solicitudes de transferencia y de retiro de la institución a Núclea, que las ejecuta.

​
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.
  • Idempotencia. Una solicitud que cambia el estado necesita un header X-Idempotency de hasta 255 caracteres. Durante 24 horas, un reintento de la misma solicitud con la misma clave devuelve la respuesta almacenada en lugar de ejecutar el comando otra vez. Una solicitud rechazada con un 4xx no consume su clave.
  • 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.