/api/v1/siloc. La superficie viva es conectividad y administración: una conexión de gateway a Nuclea, un relay literal de la familia de liquidación del dominio de tarjetas a Lerian SLC, y los registros de participantes, certificados y cobertura que los sostienen.
Ciclo de vida de la conexión del gateway
El servicio abre y mantiene una conexión de gateway de mensajería a SILOC de Nuclea sobre la red nacional del sistema financiero. La conexión está protegida por:
- un circuit breaker que se dispara ante fallas repetidas,
- reconexión automática con un backoff acotado,
- una parada por credencial deshabilitada que detiene el gateway cuando su certificado está deshabilitado, y
- una sonda de readiness que reporta si el gateway está conectado y saludable.
Demux entrante y relay literal de tarjetas
Cada mensaje entrante decodificado se clasifica por su código de mensaje. La familia de fondeo y clearing de tarjetas se retransmite byte a byte a Lerian SLC, el servicio de liquidación de tarjetas. El relay es solo de entrada y reenvía el envelope decodificado de forma literal —el servicio no actúa sobre ninguno de los contenidos del mensaje.
| Código | Mensaje |
|---|---|
| LDL0021 | Instrucción de depósito |
| LDL0020 | Crédito liquidado |
| LDL0006 | Crédito devuelto |
| PAG0102 | Apertura de período de ciclo |
| PAG0103 | Cierre de período de ciclo |
Relay exactamente-una-vez
El gateway puede reentregar un mensaje al menos una vez. Lerian SILOC deduplica por el NUOp, el identificador único por operación del BACEN: el NUOp se consulta antes de un relay y se registra solo tras un relay durable. El servicio de liquidación de tarjetas recibe así cada frame exactamente una vez.
Resiliencia y replay del relay
- Un error de relay transitorio devuelve el frame para que el gateway lo reentregue.
- Una interrupción de relay sostenida estaciona el frame de forma durable como una falla de relay y levanta una alerta operativa de relay caído.
- Un operador lista las fallas de relay estacionadas y las reprocesa una vez que el servicio de liquidación de tarjetas se recupera.
Observabilidad del relay
- Listar mensajes retransmitidos — el feed de auditoría de los mensajes del dominio de tarjetas que se han retransmitido a Lerian SLC.
- Leer el estado del relay — el estado de salud actual del relay, más la marca de tiempo del último relay.
Directorio de participantes
Lerian SILOC mantiene un directorio de los participantes de SILOC por los que liquida. Registras, listas, obtienes y actualizas un participante, y lees el estado de un participante. Cada participante lleva su ISPB, su rol y su estado operativo. Cada registro siembra una entrada de 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.
| Rol | Significado |
|---|---|
| Directo | Un participante directo de SILOC. |
| Indirecto | Un participante que liquida a través de otra institución. |
| Institución liquidante | La institución que liquida en nombre de los participantes indirectos. |
| Valor | Estado |
|---|---|
| 1 | Participando |
| 2 | Excluido del ciclo |
| 3 | Excluido de SILOC |
| 6 | En ciclo, excluido de SILOC |
| 7 | Suspendido |
| 8 | Suspendido, excluido del ciclo |
| 9 | Inoperante (régimen especial) |
Certificados regulados
Los certificados regulados de la conexión se conservan como referencias, no como secretos. Registras un certificado público —analizado por su sujeto, serie y ventana de validez— junto con una referencia de custodia externa; el servicio no almacena ninguna clave privada. Luego listas, obtienes y revocas certificados sobre 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, su dirección, si está implementado y su disposición.