Saltar al contenido principal
BACEN entrega cada orden judicial como un archivo de remesa. La Mensageria recibe el archivo a través de Lerian STA, registra las órdenes y las libera una a la vez. El executor ejecuta cada orden en el ledger de Midaz e informa el resultado. Luego, la Mensageria escribe el archivo de respuesta y lo envía a BACEN a través de Lerian STA.

​
Flujo de la orden

Flujo de órdenes de Lerian SISBAJUD

​
Entrada de las órdenes

Los eventos de Lerian STA son el único camino por el que un archivo de órdenes entra en la Mensageria. La Mensageria consume el tópico lerian.streaming.br-sta en el consumer group br-sisbajud-sta-intake-v1. Conserva los eventos cuyo producto de origen coincide con su configuración STA_SOURCE_PRODUCT e ignora los demás. Antes de descargar un archivo, la Mensageria compara el tamaño del archivo con STA_MAX_INBOUND_SIZE_BYTES. Después de la descarga, compara el digest SHA-256 del archivo con el digest del evento. Una diferencia rechaza el archivo. La Mensageria lee el entorno, producción u homologación, en el encabezado del archivo. El archivo de remesa de bloqueo es texto de ancho fijo en ISO-8859-1. El layout 2026 tiene registros de 684 caracteres. El layout CNJ v1.11 tiene registros de 410 caracteres. SISBAJUD_REMITTANCE_LAYOUTS lista los layouts que la Mensageria acepta. El valor predeterminado es v111,v2026. La Mensageria rechaza un archivo en un layout que no está en la lista.

​
Registro de la orden

La Mensageria convierte cada archivo en órdenes judiciales. Registra estos tipos de orden:
  • BLOQUEIO (bloqueo)
  • DESBLOQUEIO (desbloqueo)
  • REQUISICAO_INFORMACAO (solicitud de información)
  • REITERACAO (reiteración)
  • NOTIFICACAO_RECEBIMENTO_TRANSFERENCIA (aviso de una transferencia judicial por recibir, registro 08)
La Mensageria completa una orden NOTIFICACAO_RECEBIMENTO_TRANSFERENCIA cuando la registra. El executor no recibe aviso de ejecución para ella. Un archivo de respuesta de bloqueo la responde con el código 01 (Recebida). La Mensageria estaciona las órdenes TRANSFERENCIA (transferencia) y CANCELAMENTO (cancelación), y algunas órdenes DESBLOQUEIO. También estaciona las solicitudes de aclaración (registro 09) y las interrupciones de un bloqueo permanente (registro 10). Una orden pasa por los estados PENDING, PROCESSING, MONITORING, COMPLETED y FAILED. La Mensageria cifra los campos sensibles con una clave de datos para cada operación. Una clave de cifrado de claves envuelve esa clave de datos. El gestor de claves es HashiCorp Vault Transit o AWS KMS.

​
Bloqueo permanente

En el layout 2026, cada registro de bloqueo lleva un indicador de bloqueo permanente. El valor P o D marca un bloqueo permanente, y D también lleva una fecha de plazo. Cualquier otro valor marca un bloqueo que no es permanente. En el layout CNJ v1.11, esas posiciones son un espaciador, y la Mensageria las ignora.

​
Órdenes estacionadas

La Mensageria no ejecuta una orden TRANSFERENCIA ni una orden CANCELAMENTO. Estaciona la orden para un procedimiento manual. El executor no recibe aviso de ejecución para una orden estacionada, y ningún archivo de respuesta la responde. Para un CANCELAMENTO estacionado, el bloqueo puede seguir en Midaz hasta que lo liberes manualmente. La Mensageria también estaciona una orden DESBLOQUEIO cuando no tiene un registro utilizable del BLOQUEIO original, por ejemplo un bloqueo de un sistema anterior. El dinero puede seguir bloqueado hasta que lo liberes manualmente. La Mensageria estaciona una solicitud de aclaración (registro 09) porque una persona debe escribir la respuesta. Responde al juzgado manualmente. La Mensageria estaciona la interrupción de un bloqueo permanente (registro 10). El executor mantiene ese bloqueo permanente activo, y nuevos créditos pueden seguir bloqueados hasta que detengas el bloqueo manualmente. La Mensageria registra en el log cada orden estacionada con su ID. La métrica sisbajud_parked_open_total cuenta las órdenes estacionadas abiertas. Cuando vence el plazo de la respuesta de una orden estacionada, la Mensageria registra un error en el log con el ID de la orden.

​
Liberación al executor

La Mensageria libera las órdenes de un sujeto una a la vez. Un sujeto es el CPF o CNPJ al que apunta una orden, dentro de una institución. La siguiente orden de un sujeto se libera después de que se resuelve la orden anterior. Un resultado del executor puede resolverla. La Mensageria graba la liberación y su aviso de ejecución en la misma transacción de base de datos. La base de datos, y no el broker, mantiene el orden de las liberaciones de un sujeto.

​
Ejecución en Midaz

Para cada aviso de ejecución, el executor:
  1. Obtiene la orden de la Mensageria.
  2. Verifica que la institución de la orden esté registrada en este executor como propia. Para cualquier otra institución, no escribe nada.
  3. Escribe el bloqueo o el desbloqueo en Midaz. Cada escritura lleva una clave de idempotencia formada por el ID de la orden y la revisión de la orden.
  4. Informa el resultado a la Mensageria.
Para una solicitud de información, el executor lee los saldos del sujeto y no escribe nada en el ledger. Cuando el executor no puede terminar una orden solo, entrega la orden a un operador como una decisión humana. Cómo ejecuta órdenes Lerian SISBAJUD executor describe cada operación.

​
Archivos de respuesta

La Mensageria genera dos tipos de archivo de respuesta:
  • Un archivo de respuesta de bloqueo: 5302 en producción, 5312 en homologación.
  • Un archivo de respuesta de información: 5309 en producción, 5319 en homologación. Responde a las solicitudes de información.
Un barrido en un intervalo configurado toma las órdenes terminadas que aún no tienen respuesta. RETURN_FILE_GENERATION_ENABLED activa las respuestas de bloqueo, y INFORMATION_RETURN_FILE_GENERATION_ENABLED activa las respuestas de información. Un archivo de respuesta usa el ambiente, producción u homologación, de la remesa que sus órdenes responden. RETURN_FILE_ENVIRONMENT solo se aplica cuando ninguna remesa respalda las órdenes. El valor predeterminado es HOMOLOGATION. SISBAJUD_RESPONSE_LAYOUT con auto, el valor predeterminado, responde en el layout de la remesa original. Los valores v111 y v2026 fuerzan un layout. Con STA_TRANSFERS_ENABLED activado, la Mensageria envía cada archivo de respuesta. Graba el archivo en el bucket compartido y luego llama a POST /v1/transfers en Lerian STA. El transporte de intercambio de archivos en sí es la integración de la institución que describe Lerian STA. Lerian SISBAJUD es uno de sus productos de origen downstream.