/api/v1/siloc. La superficie en vivo cubre la conectividad y la administración. Un descriptor de conexión MQ de SILOC completo activa el procesamiento entrante de SFN, que envía los códigos de mensaje admitidos. El servicio también mantiene los registros de participantes, certificados y cobertura que respaldan este trabajo.
Ciclo de vida de la conexión del gateway
Cuando un descriptor de conexión MQ de SILOC completo activa el procesamiento entrante de SFN, el servicio abre y mantiene una conexión de gateway de mensajería con el SILOC de Nuclea a través de la red del sistema financiero nacional. Cuatro protecciones resguardan la conexión:
- un disyuntor que se activa tras fallos repetidos,
- reconexión automática con un backoff limitado,
- una parada por credencial deshabilitada que detiene el gateway tras la revocación de un certificado, y
- una sonda de readiness que informa la conexión y el estado de salud del gateway.
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, el servicio descifra y decodifica los mensajes entrantes desde el envelope regulado antes de enviar un mensaje admitido.
Envío entrante de SFN
Después de la decodificación, la ingesta selecciona una ruta a partir de una política cerrada de (
CodProdt, CodMsg). Los mismos tres códigos de financiamiento tienen destinos diferentes según el producto:
| Código | OT | SLC |
| --- | --- |
| PAG0102 | Diferimiento duradero de apertura de período | Retransmisión a Lerian SLC |
| LDL0021 | Diferimiento duradero de instrucción de depósito | Retransmisión a Lerian SLC |
| PAG0103 | Diferimiento duradero de cierre de período | Retransmisión a Lerian SLC |
| PAG0101 | Diferimiento duradero del estado del participante | Diferimiento duradero del estado del participante |
El servicio no admite LDL0020, LDL0006 ni ningún otro par de producto/código. Fallan de forma cerrada hacia una excepción operativa. El servicio nunca los retransmite como financiamiento de liquidación. Un envelope indecodificable o un mensaje con un BCMSG.NUOp en blanco sigue la misma ruta de fallo cerrado.
Envío al menos una vez con desduplicación duradera
La fuente puede reenviar un mensaje, por lo que 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, el servicio verifica la desduplicación duradera mediante BCMSG.NUOp antes de retransmitir. La política trata ese número de operación como único globalmente. El servicio no usa una clave basada solo en el ID de mensaje.
El servicio escribe el registro de mensaje procesado solo después de una retransmisión exitosa y antes de confirmar la recepción a la fuente. No crea ese registro para un mensaje no decodificado o no admitido. Un fallo antes de que se escriba ese registro puede dejar el mensaje elegible para otra entrega. No trates este comportamiento como una garantía incondicional de exactamente una vez de extremo a extremo.
Resultados de fallos
- Un fallo de envío reintentable permanece sin confirmar. Con confirmaciones de fuente seguras por offset, el servicio vuelve a leer el mensaje después de un reinicio, desde el último offset confirmado. Un fallo transitorio persistente puede detener su partición hasta el reinicio.
- Un fallo no reintentable, como un envelope con formato incorrecto o un par (
CodProdt,CodMsg) no admitido, falla de forma cerrada hacia una excepción operativa duradera. El servicio confirma el mensaje solo después de que se confirme ese registro de excepción, de modo que la partición pueda avanzar. - El registro de mensaje procesado protege solo los mensajes decodificados correctamente y admitidos descritos arriba. No promete la retención de cada frame ni efectos de exactamente una vez en todos los sistemas downstream.
Observabilidad de la ingesta
- Listar mensajes procesados: el feed de auditoría de los mensajes de SFN admitidos que el servicio envió.
- Leer el estado de la ingesta: el estado de salud actual de la ruta de ingesta habilitada, más la marca de tiempo del último envío.
Directorio de participantes
Lerian SILOC mantiene un directorio de los participantes de SILOC para los que liquida. Tú registras, listas, obtienes y actualizas un participante, y lees el estado de un participante. Cada participante incluye su ISPB, su rol y su estado operativo. Cada registro genera una entrada en el historial de estado y emite un hecho de participante. Las escrituras de registro son idempotentes mediante una clave de idempotencia, de modo que un registro reintentado no crea un duplicado.
El estado operativo usa el dominio de siete valores de estado de SILOC:
Certificados regulados
El servicio conserva los certificados regulados de la conexión como referencias, no como secretos. Tú registras un certificado público junto con una referencia de custodia externa. El servicio analiza el certificado para obtener su asunto, número de serie y ventana de validez, y no almacena ninguna clave privada. Luego listas, obtienes y revocas certificados a través de la misma superficie.
Cobertura de capacidades
Un listado de capacidades de solo lectura describe las capacidades de cobertura de liquidación como una superficie de transparencia. Para cada tipo de mensaje, informa la dirección, el estado de implementación y la disposición.