Skip to main content
Lerian SPB opera dentro de dos realidades operativas del STR. El STR abre solo dentro de las ventanas de operación de BACEN. La liquidación es siempre asíncrona. El riel persiste cada mensaje antes de despacharlo, así que nunca envía un mensaje sin registrar.

​
Ventanas de operación

BACEN anuncia las grillas de la ventana de operación del STR mediante GEN0021. El riel las persiste y consultas las grillas vigentes con STR0001. El riel también envía, de lunes a viernes, un STR0001 para las grillas del día. Una vista de programación en vivo lista los horarios de apertura y cierre por fecha de referencia. El último anuncio para una fecha de referencia es el que vale. El riel no impone un rechazo genérico de cada envío fuera de una ventana de operación. Su regla explícita de admisión relacionada con la programación es RLPI0007: durante la ventana de aporte adicional, rechaza un aporte a una Conta PI ajena. Los aportes a la propia Conta PI de la institución y los resgates siguen permitidos. El riel cierra un mensaje que no salió antes del cierre de su grilla del STR en su día de movimiento. El mensaje termina FAILED sin enviarse, y una transferencia o un movimiento informa settlement.failed. Cuando el riel no tiene la hora de cierre de esa grilla en ese día, cierra el mensaje cuando termina el día de movimiento. El riel no cierra un mensaje LDL o LTR de esta forma. Un mensaje que un envío pudo haber entregado no se cierra de esta forma. El riel marca una transferencia en ese caso como SENT y no la envía de nuevo. La transferencia espera la respuesta de BACEN o que los operadores la cierren como fallida.

​
Rotación de certificados

El riel hace hot reload del certificado ICP-Brasil y de la clave de su identidad SFN sin reiniciar. Una rotación carga la nueva clave desde la custodia que define SPB_SIGNER_KIND, y escribe evidencia de auditoría. Después, el riel firma con la nueva clave. Hasta el próximo reinicio, descifra con la nueva clave y con la anterior, así que los mensajes que BACEN cifró para el certificado anterior todavía se abren. Una activación anuncia el nuevo certificado a BACEN mediante GEN0006. Las respuestas nunca exponen la ruta de la clave privada ni ningún material de clave. Las advertencias de certificado aparecen en las vistas de readiness y de resumen antes de que el certificado expire. Después de una rotación, configura PROCESS_CERT_PATH y la configuración de clave de tu custodia con el nuevo certificado y la nueva clave antes del próximo reinicio. El riel se niega a empezar con un certificado que vence antes del certificado rotado. BACEN anuncia un nuevo certificado propio mediante GEN0018. El riel acepta los mensajes entrantes firmados con ese certificado en cuanto llega el GEN0018. Desde las 00:00 en hora de Brasília de la fecha de activación, cifra los mensajes salientes para el nuevo certificado. BACEN_PUBLIC_CERT_PATH no necesita cambios, y el riel no necesita reiniciar.

​
Contingencia y durabilidad

  • Persistir antes de enviar garantiza que el riel no despacha ningún mensaje sin registrar.
  • Un barrido de despacho reenvía un mensaje que no salió, sin límite de intentos. DISPATCH_RETRY_BACKOFF_CEILING define la espera más larga entre dos envíos.
  • Mientras la conexión al gestor de colas está caída, el riel rechaza cada solicitud que enviaría un nuevo mensaje STR con 503 y SPB-1001. No almacena nada para esa solicitud. Las lecturas y las demás solicitudes siguen funcionando. La verificación ibm-mq de /readyz aparece como caída, y esa verificación por sí sola no hace fallar /readyz. Cuando el gestor de colas rechaza la configuración del riel, /readyz falla.

​
Conciliación

El riel abre un caso de conciliación para una operación que necesita revisión, como una que está atascada o tiene un resultado incierto. Un operador resuelve un caso registrando una acción sobre él. El riel resuelve un caso que abrió un envío fallido o incierto cuando el mensaje deja de esperar el envío. Un caso terminal no acepta más acciones.

​
Invariantes de liquidación

Dos invariantes se mantienen en todo momento:
  • Un envío es despacho, no confirmación. SUBMITTED (una TED) o PENDING (un movimiento de Conta PI o SME) significa que el riel aceptó el despacho. La pata R entrante mueve el mensaje STR de la TED a CONFIRMED o REJECTED. Esa pata R lleva los campos de liquidación de BACEN, por ejemplo numCtrlSTR y sitLancSTR, proyectados textualmente.
  • El riel es neutral respecto al dinero. Reenvía exactamente los montos declarados y no calcula ninguna posición ni saldo. Tu consumidor de ledger registra cualquier posición contable.