> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración con Lerian SISBAJUD

> Integración con Lerian SISBAJUD: los eventos de saldo de Midaz que disparan los reintentos de bloqueo permanente, los eventos de negocio que emite, el conector de ledger y la semántica de entrega.

Lerian SISBAJUD es orientado a eventos donde se encuentra con el ledger. **Consume** eventos de cambio de saldo de Midaz para disparar los bloqueos permanentes. **Emite** eventos de negocio operativos que otros sistemas pueden observar. No envía webhooks salientes a consumidores de terceros; sus interfaces son el ledger, el endpoint de notificación de entrega de remesas y su superficie administrativa.

## 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.

Estos eventos sirven para observabilidad y coordinación. Los movimientos de dinero viven en el ledger de Midaz, no en los payloads de los eventos.

## 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

El código de bloqueo downstream hace que las escrituras de bloqueo sean **idempotentes**. Un bloqueo reintentado no contabiliza dos veces.

## 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-tenantid` de 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](/es/rails/native/sta/what-is-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.
