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

# Cómo funciona Lerian SISBAJUD

> Cómo funciona Lerian SISBAJUD: recepción de archivos de orden judicial, ejecución de bloqueo contra el ledger de Midaz, bloqueo permanente, desbloqueo y archivos de respuesta de BACEN.

El canal de intercambio de archivos de BACEN entrega cada orden judicial a Lerian SISBAJUD como un **archivo de remesa**. Las órdenes ingresan a la integración como archivos de remesa, no como payloads de orden por API. La integración recibe el archivo, lo analiza en órdenes canónicas y cumple las órdenes de bloqueo y desbloqueo contra el ledger de **Midaz**. Luego devuelve archivos de respuesta a BACEN. Esta página cubre los tres tipos de orden que la mayoría de las instituciones encuentran primero: **bloqueo**, **desbloqueo** y **bloqueo permanente**. La integración también responde a solicitudes de información.

## Recepción de órdenes por archivo

***

BACEN entrega un **archivo de remesa**. Los archivos de orden usan los códigos `5301` y `5308` en producción, y `5311` y `5318` en homologación. Los veredictos de validación de BACEN sobre los archivos de respuesta vuelven como `5303` y `5310` en producción, y `5313` y `5320` en homologación. Cada código identifica un flujo de archivo distinto.

Un archivo de remesa llega al servicio de una de dos formas:

* **Eventos de Lerian STA.** Con `STA_CONSUMER_ENABLED` activado, el servicio consume los eventos de archivo que publica Lerian STA.
* **Endpoint de notificación.** `POST /remittance-files/notifications` recibe y analiza de forma síncrona un objeto de remesa que ya está almacenado. Acepta `5301`, `5303` y `5308`, y sus códigos de homologación.

Lerian SISBAJUD aplica hash al texto plano, lo cifra en sobre, almacena el texto cifrado y normaliza el archivo en órdenes judiciales canónicas.

El flujo de remesa de bloqueo (`5301` en producción y `5311` en homologación) usa un formato de **ancho fijo** con codificación ISO-8859-1. El layout de 2026 usa registros de 684 caracteres, y el layout CNJ v1.11 usa registros de 410 caracteres. `SISBAJUD_REMITTANCE_LAYOUTS` define qué layouts acepta el servicio. Las posiciones iniciales determinan cada tipo de registro. Un encabezado y un tráiler marcan los límites del archivo. En el layout de 2026, un **indicador de bloqueo permanente** por orden marca cada registro de bloqueo:

| Indicador | Significado |
| - | - |
| **T** | Bloqueo tradicional: un intento inicial, no permanente. Después de un bloqueo inicial parcial, el servicio sigue intentando bloquear el resto hasta el final del día de recepción (UTC). |
| **P** | Bloqueo permanente sin plazo. |
| **D** | Bloqueo permanente con plazo determinado. |

## Ejecución del bloqueo (bloqueio)

***

Para una orden de bloqueo, Lerian SISBAJUD descifra el CPF/CNPJ cifrado para consultar el CRM. No resuelve cuentas únicamente por token. Luego resuelve las cuentas del demandado y ejecuta el bloqueo solicitado a través de Midaz. Una ejecución puede crear retenciones de bloqueo por cuenta.

Toda transacción de ledger que Midaz acepta debe estar balanceada. Ese invariante se aplica por cada transacción de ledger aceptada. No convierte a una orden judicial completa, ni a un tramo particular de bloqueo o desbloqueo, en una única transacción de partida doble.

El servicio registra el bloqueo en cada cuenta. El resultado de la orden alimenta el **archivo de respuesta** a BACEN.

<h2 id="permanent-block">
  Bloqueo permanente
</h2>

***

Una orden permanente (indicador **P** o **D**) no se detiene después del primer intento. Permanece en monitoreo y reintenta el bloqueo del monto pendiente. Esto captura fondos que llegan después del primer intento. Un evento de cambio de saldo del ledger activa un reintento, y un barrido cada 5 segundos también procesa las órdenes de bloqueo abiertas. Ambos caminos solo corren cuando `EXECUTION_ENABLED` está activado.

Los reintentos se detienen en el plazo judicial cuando cae dentro de los 60 días de la primera ejecución. De lo contrario, se detienen 60 días después de la primera ejecución, el **límite de reiteración** del CNJ. La detención surte efecto cuando corre el job de vencimiento de bloqueo permanente (`PERMANENT_BLOCK_EXPIRY_ENABLED`). Con `PERMANENT_BLOCK_EXPIRY_ENABLED` desactivado, el valor predeterminado, los reintentos no se detienen en el plazo.

## Desbloqueo (desbloqueio)

***

Una orden de desbloqueo libera fondos previamente retenidos según la orden. Puede liberar montos a través de las retenciones de bloqueo por cuenta. Cada transacción de ledger aceptada debe estar balanceada. Una orden de desbloqueo no es necesariamente una sola transacción de ledger. Un job en segundo plano procesa las órdenes de desbloqueo pendientes mientras `EXECUTION_ENABLED` está activado.

## Archivos de respuesta

***

Lerian SISBAJUD genera archivos de respuesta para BACEN:

* Una **respuesta de bloqueo** (tipo de archivo `5302` en producción, `5312` en homologación) responde a las órdenes de bloqueo y desbloqueo.
* Una **respuesta de información** (tipo de archivo `5309` en producción, `5319` en homologación) responde a las solicitudes de información.

La generación de archivos de respuesta toma las órdenes en estado final. Con `STA_TRANSFERS_ENABLED` activado, el servicio envía cada archivo de respuesta a través de Lerian STA.

El transporte de intercambio de archivos en sí es la integración de propiedad del cliente que describe [Lerian STA](/es/rails/sta/what-is-lerian-sta). Lerian SISBAJUD es uno de sus productos fuente downstream.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.