/api/v1/siloc. A través de una sola conexión con Núclea, recibe los mensajes de SILOC y enruta cada uno, y envía las solicitudes propias de la institución. 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
Un descriptor de conexión MQ de SILOC completo activa el procesamiento entrante de SFN. Luego, el servicio abre y mantiene una conexión de gateway de mensajería con el SILOC de Núclea 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.
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):
La retransmisión a SLC actúa al llegar el mensaje. El servicio aparca todos los demás mensajes enrutados y los aplica después:
PAG0101 cuando STATUS_REPLAY_ENABLED=true, y el resto cuando OT_REPLAY_ENABLED=true. LDL0020, LDL0006 y cualquier otro par de producto/código fallan de forma cerrada hacia una excepción operativa, y el servicio nunca los retransmite como financiamiento de liquidación. 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 antes de retransmitir. La clave es la parte del mensaje: su BCMSG.NUOp y su número de parte, NumSeq. Un mensaje enviado entero es la parte 1.
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 el servicio 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 reintentable, como una caída del almacén de datos, devuelve el frame a la cola de recepción, y el servicio lo recibe de nuevo después de
MQ_BACKOUT_DELAY. El servicio aparca en su base de datos, para un operador, un frame rechazado más deMQ_BACKOUT_THRESHOLDveces, y generaINBOUND_QUARANTINED. El frame sale de la cola de recepción solo después de que el servicio lo aparca. - Un fallo no reintentable, como 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. - Cuando la retransmisión a Lerian SLC está caída, el servicio aparca el frame de financiamiento como un fallo de retransmisión y genera
RELAY_DOWN. Un operador lo vuelve a procesar después de que la retransmisión se recupera. - Antes de aplicar un mensaje aparcado, el servicio lo valida contra el XSD oficial. El servicio nunca aplica un mensaje que el esquema rechaza, y genera
INBOUND_SEMANTIC_REJECTED. Mientras el validador no responde, el mensaje espera y el servicio generaXSD_VALIDATOR_DOWN. - 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 retransmitidos: el feed de auditoría de los mensajes de financiamiento que el servicio retransmitió a Lerian SLC.
- Leer el estado de la retransmisión: el estado de salud de la retransmisión (
HEALTHY,DEGRADEDoDOWN), si la liquidación de tarjetas está bloqueada, y la marca de tiempo de la última retransmisión.
Solicitudes salientes
El servicio envía a Núclea las solicitudes propias de la institución: transferencias, movimientos de colateral, consultas, confirmaciones y cambios de estado de participantes. Una solicitud que sigue
DISPATCHED después de su plazo de respuesta genera UNANSWERED_REQUEST.
Después de que el gateway acepta un mensaje de salida en cola, Lerian SILOC registra su transición de SUBMITTED a DISPATCHED en la base de datos. Una falla de despacho que permite un reintento lo mantiene en SUBMITTED para otro intento, hasta que se le acaba el plazo:
LTR0002,LTR0008ySLC0004expiran a las 17h30 de Brasilia de su día de movimiento, cuando cierra el ciclo LBTR.- Los otros códigos expiran cuando termina su día de movimiento, a la medianoche de Brasilia.
FAILED, y lastError indica el motivo. Cuando se acaba el plazo, una solicitud que puede haber llegado ya a Núclea no se marca como fallida ni se envía de nuevo. Se queda en SUBMITTED hasta que llega la respuesta o el rechazo de Núclea.
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 y su rol. El servicio mantiene el estado operativo de un participante por producto, y los mensajes
PAG0101 de la câmara lo establecen.
Registrar o actualizar un participante, o un cambio de su estado, emite un hecho de participante. Las escrituras de registro son idempotentes mediante el header X-Idempotency, 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.