Skip to main content
O Lerian SISBAJUD é orientado a eventos onde encontra o ledger. Ele consome eventos de mudança de saldo do Midaz para disparar os bloqueios permanentes. Ele emite eventos de negócio operacionais que outros sistemas podem observar. Ele não envia webhooks de saída para consumidores de terceiros; as suas interfaces são o ledger, o endpoint de notificação de entrega de remessas e a sua superfície administrativa.

​
Eventos que consome do ledger

A integração assina os eventos de mudança de saldo do Midaz. Ela trata cada evento como um gatilho, não como uma regra. Um evento não decide nada por si só. Ele acorda a lógica de bloqueio permanente para reavaliar uma conta monitorada e tentar o bloqueio pendente. Uma reiteração usa esse caminho para capturar os fundos que chegam após a primeira tentativa. Após um bloqueio tradicional inicial parcial, um crédito mais tarde no mesmo dia também pode disparar tentativas complementares. Cada evento carrega a identidade do tenant. A integração correlaciona cada mudança de saldo apenas a ordens da mesma instituição. O isolamento por instituição se sustenta através do limite de eventos.

​
Eventos de negócio que emite

O Lerian SISBAJUD emite eventos de negócio operacionais sem dados pessoais nos seus payloads:
  • Um evento de conta de bloqueio criada quando uma execução cria uma retenção de bloqueio — um sinal operacional, não um portador de dinheiro nem de dados pessoais.
  • Um evento de chave rotacionada quando uma instituição rotaciona a sua chave mestra de criptografia.
Esses eventos servem para observabilidade e coordenação. Os movimentos de dinheiro vivem no ledger do Midaz, não nos payloads dos eventos.

​
Limite com o Midaz

O Midaz é o conector de ledger. Por meio dele, o Lerian SISBAJUD:
  • envia operações de bloqueio e desbloqueio para as contas do cliente e as retenções de bloqueio pertinentes
  • cria e arquiva retenções de bloqueio conforme uma execução precisa delas
  • descriptografa o CPF/CNPJ somente para a consulta ao CRM e nunca o registra em logs; não resolve uma conta apenas por token
  • lê o saldo disponível de uma conta monitorada
  • reconcilia as ordens de monitoramento contra snapshots de saldo do ledger
O código de bloqueio downstream torna as escritas de bloqueio idempotentes. Um bloqueio reprocessado não contabiliza duas vezes.

​
Semântica de entrega

  • Escritas de bloqueio idempotentes. O código de bloqueio downstream identifica cada escrita de bloqueio. Uma repetição não contabiliza duas vezes.
  • Eventos ao menos uma vez. Em funcionamento normal do cache, o Lerian SISBAJUD suprime identificadores de evento duplicados. Se o cache estiver indisponível, a deduplicação falha aberta e o evento prossegue; a idempotência do código de bloqueio downstream é o backstop contra a aplicação duplicada de um bloqueio.
  • Escopo do tenant. Os eventos de mudança de saldo consumidos carregam a identidade da instituição. Em implantações multi-tenant, os eventos emitidos também a carregam. Em implantações de tenant único, um evento de conta de bloqueio criada pode omitir a extensão ce-tenantid do CloudEvents quando o contexto de execução está vazio.
  • Sem webhooks de saída para terceiros. O Lerian SISBAJUD não empurra para consumidores de webhook de terceiros. Ele também expõe um endpoint operacional de notificação de entrega de remessas; esse endpoint não é uma API de entrada de ordens.

​
Transporte de arquivos

Os arquivos judiciais entram e saem pelo canal de troca de arquivos do BACEN. Lerian STA documenta essa integração de propriedade do cliente. O Lerian SISBAJUD é um produto de origem consumidor desse transporte. O Lerian STA entrega o objeto de remessa de entrada e o seu claim-check de integridade; POST /remittance-files/notifications recebe e faz o parsing síncrono do objeto já entregue. O Lerian SISBAJUD executa a ordem e devolve os arquivos de resultado.