Eventos que consume del ledger
La integración se suscribe a los eventos de cambio de saldo de Midaz. Trata cada evento como un disparador, no como una regla. Un evento no decide nada por sí mismo. Despierta la lógica de bloqueo permanente para reevaluar una cuenta monitoreada e intentar el bloqueo pendiente. Una reiteración usa esta vía para capturar los fondos que llegan después del primer intento. Después de un bloqueo tradicional inicial parcial, un crédito más tarde ese mismo día también puede disparar intentos complementarios. Cada evento lleva la identidad del tenant. La integración correlaciona cada cambio de saldo solo con órdenes de la misma institución. El aislamiento por institución se sostiene a través del límite de eventos.
Eventos de negocio que emite
Lerian SISBAJUD emite eventos de negocio operativos sin datos personales en sus payloads:
- Un evento de cuenta de bloqueo creada cuando una ejecución crea una tenencia de bloqueo — una señal operativa, no un portador de dinero ni de datos personales.
- Un evento de clave rotada cuando una institución rota su clave maestra de cifrado.
Límite con Midaz
Midaz es el conector de ledger. A través de él, Lerian SISBAJUD:
- envía operaciones de bloqueo y desbloqueo para las cuentas del cliente y las tenencias de bloqueo pertinentes
- crea y archiva tenencias de bloqueo según las necesita una ejecución
- descifra el CPF/CNPJ solo para la consulta al CRM y nunca lo escribe en los logs; no resuelve una cuenta solo por token
- lee el saldo disponible de una cuenta monitoreada
- reconcilia las órdenes de monitoreo contra instantáneas de saldo del ledger
Semántica de entrega
- Escrituras de bloqueo idempotentes. El código de bloqueo downstream identifica cada escritura de bloqueo. Una repetición no contabiliza dos veces.
- Eventos al menos una vez. En funcionamiento normal de la caché, Lerian SISBAJUD suprime los identificadores de evento duplicados. Si la caché no está disponible, la deduplicación falla abierta y el evento continúa; la idempotencia del código de bloqueo downstream es el respaldo contra la aplicación duplicada de un bloqueo.
- Alcance del tenant. Los eventos de cambio de saldo consumidos llevan la identidad de la institución. En despliegues multi-tenant, los eventos emitidos también la llevan. En despliegues de tenant único, un evento de cuenta de bloqueo creada puede omitir la extensión
ce-tenantidde CloudEvents cuando el contexto de ejecución está vacío. - Sin webhooks salientes a terceros. Lerian SISBAJUD no empuja a consumidores de webhook de terceros. También expone un endpoint operativo de notificación de entrega de remesas; ese endpoint no es una API de entrada de órdenes.
Transporte de archivos
Los archivos judiciales entran y salen por el canal de intercambio de archivos del BACEN. Lerian STA documenta esta integración propiedad del cliente. Lerian SISBAJUD es un producto fuente consumidor de ese transporte. Lerian STA entrega el objeto de remesa entrante y su claim-check de integridad;
POST /remittance-files/notifications recibe y parsea sincrónicamente el objeto ya entregado. Lerian SISBAJUD ejecuta la orden y devuelve los archivos de resultado.