Pular para o conteúdo principal
O Lerian SPB expõe a superfície de mensagens STR como um conjunto de operações tipadas. Cada fluxo persiste o trabalho antes do envio, retorna um estado aceito mas ainda não liquidado, e concilia com a resposta assíncrona do BACEN.

​
Onboarding

Você rotaciona o certificado ICP-Brasil, ativa-o no BACEN com o GEN0006 e testa a conectividade com um eco do GEN0001. A prontidão não espera a confirmação do GEN0006 nem o eco do GEN0001. Os comandos de transferência bancária, devolução, cancelamento, IBS repasse, Conta PI, transferência automática, moeda eletrônica, redesconto e movimentação de compulsório verificam a prontidão do trilho antes de registrar qualquer coisa. READY e DEGRADED admitem comandos. PENDING_CONFIGURATION e UNAVAILABLE os bloqueiam. A prontidão avalia a configuração do canal e o estado do certificado. A configuração do canal precisa de um ISPB de participante explícito. Enquanto a conexão com o queue manager está fora do ar, o trilho recusa cada requisição que enviaria uma nova mensagem STR com 503 e SPB-1001.

​
Transferências bancárias

Você declara as partes remetente e destinatária tipadas. A plataforma deriva o código de transferência STR: STR0004, STR0005, STR0006, STR0007 ou STR0008. Ela persiste a operação e o trabalho de saída, e apenas então envia. O trilho retorna o status SUBMITTED. Ele aceitou a requisição, mas o BACEN ainda não a liquidou.

​
Devoluções e cancelamentos

Uma devolução e um cancelamento são ambos sub-recursos de uma operação pai. O id da operação pai no caminho da requisição vincula cada um a essa operação pai.
  • Uma devolução (STR0010) devolve um crédito TED que você recebeu. A operação pai é o crédito recebido, no estado DELIVERED. A devolução leva o valor integral do crédito. Enquanto uma devolução do crédito está vigente, o trilho recusa uma segunda. Depois que o STR liquida a devolução, o crédito termina em RETURNED, e o trilho recusa qualquer devolução posterior dele.
  • Um cancelamento (STR0011) exige uma operação pai que não liquidou: ACCEPTED, SUBMITTED, SENT ou DELIVERED. Quando o BACEN o aceita, a transferência e o cancelamento terminam em CANCELLED. Se o trilho ainda não enviou a transferência, ele a cancela localmente e não envia nenhum STR0011. O trilho recusa um cancelamento enquanto um envio está sem resolução. Uma transferência que aguarda aprovação termina quando um operador a nega.
O trilho recusa uma requisição contra o estado errado da operação pai. Um crédito TED que o Lerian SPB não recebeu não tem operação pai. Para devolvê-lo, declare o número de controle, o valor integral e o ISPB que o enviou. O trilho recusa um crédito com data posterior ao primeiro dia em que o Lerian SPB recebeu um crédito TED.

​
IBS repasse

Um IBS repasse (STR0053) transfere valores de liquidação do IBS da conta Reservas Bancárias para o comitê gestor. O trilho traduz a requisição para a mensagem STR0053, a persiste e a envia. O BACEN confirma de forma assíncrona.

​
Liquidez da Conta PI

Duas operações movem liquidez entre a conta Reservas Bancárias/de liquidação de uma instituição e sua Conta PI:
  • O Aporte (LPI0001) financia a Conta PI a partir da conta Reservas Bancárias.
  • O Resgate (LPI0003) recolhe os fundos de volta para a conta Reservas Bancárias.
Com o tipo de conta CCME, as mesmas duas direções usam o LPI0002 e o LPI0004 e movimentam apenas os fundos da própria instituição. Ambas retornam PENDING. A resposta de liquidação recebida (LPI0001R1 a LPI0004R1) move a operação para SETTLED ou REJECTED. O Lerian SPB projeta o valor da resposta literalmente. As grades de janela operacional do GEN0021 são persistidas e consultáveis. Elas não impõem uma rejeição genérica de todo envio fora de uma janela operacional. A regra de admissão explícita ligada ao cronograma é a RLPI0007: durante a janela de aporte adicional, um aporte para a Conta PI de outra instituição é rejeitado. Aportes para a própria Conta PI da instituição e resgates continuam permitidos.

​
Política de transferência automática

Com o LPI0005, você declara a regra de transferência automática STR para as duas classes de conta, RB/CL e CCME, em cada mensagem: um percentual ou um valor. Um zero desabilita a transferência automática para essa classe, e uma nova regra substitui a anterior. O BACEN confirma o recebimento (LPI0005R1) e depois relata cada transferência automática que faz (LPI0006). O Lerian SPB repassa os valores relatados literalmente e não faz nenhum cálculo sobre eles.

​
Fila de aprovação para emissões de alto valor

O trilho classifica cada valor declarado em relação a faixas configuradas semiabertas e pode aplicar uma substituição para um tipo de mensagem específico. A regra selecionada determina o estado: requiredSignatures igual a 0 envia a emissão para SUBMITTED. Um valor diferente de zero a envia para PENDING_APPROVAL. No teto de uma faixa, aplica-se a próxima faixa. Acima de todos os tetos, aplica-se o requisito do nível mais alto. Um operador pode assinar ou negar uma emissão em fila. Cada assinatura vem de um operador diferente, nunca de quem criou a emissão. Um operador substitui as faixas e as substituições por tipo pela API de governança, e a mudança se aplica sem reinício.

​
Composição curada de mensagens

Uma superfície de composição controlada por catálogo monta um tipo de mensagem STR presente na allowlist (STR0004, STR0005, STR0006, STR0007, STR0008, STR0046, STR0047, STR0048, STR0052 ou STR0053). O tipo escolhido deve ser resolvido no catálogo de capacidades e deve ser publicamente submetível. Caso contrário, o trilho recusa a requisição.

​
Consultas assíncronas de parte única

Leituras de posição de reserva e de cronograma retornam um id de correlação com PENDING. A resposta do BACEN chega de forma assíncrona. Você a lê de volta por esse id de correlação. O Lerian SPB projeta o que o BACEN envia e não calcula nenhuma posição própria.

​
Moeda eletrônica

As movimentações de moeda eletrônica (SME) movem fundos para dentro e para fora da conta correspondente a moeda eletrônica (CCME) que um emissor de moeda eletrônica mantém no BACEN. Você declara o tipo, e a plataforma deriva o código:
  • O Depósito (SME0001) financia a CCME a partir da conta Reservas Bancárias ou de liquidação.
  • A Retirada (SME0002) recolhe fundos da CCME.
  • A Devolução (SME0004) devolve um lançamento recebido por engano. Ela cita o número de controle STR do lançamento original.
Uma movimentação retorna PENDING. A resposta do STR a move para SETTLED, REJECTED ou CANCELLED. Uma consulta SME0003 retorna o extrato da CCME de forma assíncrona.

​
Redesconto

Um redesconto (RDC) é um empréstimo do BACEN garantido por títulos federais registrados no Selic. Você declara o tipo, e a plataforma deriva o código RDC. A operação começa como PENDING, antes de o BACEN responder. ACCEPTED significa que o BACEN registrou a solicitação, mas ela não foi liquidada e nenhum fato de liquidação é emitido. SETTLED significa que existe um lançamento na conta Reservas Bancárias, com uma referência de liquidação. Quando a sua conversão (RDC0005) liquida, o redesconto que ela converte termina em CONVERTED. No fechamento do STR, o BACEN converte um redesconto intradia não pago pelo RDC0015. O trilho termina esse redesconto em CONVERTED e registra o novo redesconto de um dia útil. Duas consultas retornam o preço unitário de um título elegível (RDC0001) e os redescontos em aberto do dia (RDC0006).

​
Depósitos compulsórios

  • Uma movimentação transfere fundos entre os depósitos compulsórios da instituição no BACEN e sua conta Reservas Bancárias: uma retirada (RCO0010) ou um depósito (RCO0011). Ela retorna PENDING, e a resposta do BACEN define seu estado final.
  • Uma declaração (RCO0002) informa o demonstrativo de compulsório de um período de cálculo. O trilho recusa um dia fora do período declarado. Quando a resposta do BACEN traz a exigibilidade que o BACEN calcula, o trilho registra a exigibilidade no período.
  • As consultas retornam o calendário de períodos (RCO0001), a releitura de uma declaração (RCO0003), o extrato de movimentações (RCO0005), a posição de cumprimento (RCO0006) e o registro de custos (RCO0007).

​
Lançamentos do BACEN

O trilho registra cada aviso SLB do BACEN e lista as cobranças ainda devidas.
  • Um pagamento SLB0002 autoriza o pagamento de uma cobrança. O valor deve ser igual ao total da cobrança. O trilho recusa uma cobrança liquidada ou retirada.
  • Um pagamento SLB0007 paga ao BACEN um valor que nenhuma cobrança exigiu, inclusive a devolução de um crédito SLB0005.
  • Uma consulta SLB0006 pede os lançamentos de uma data, um lançamento ou todos os lançamentos com vencimento a partir de hoje.
Quando a regra de aprovação para o valor exige assinaturas, um pagamento SLB aguarda em PENDING_APPROVAL.

​
Liquidação de câmaras de compensação

O Lerian SPB liquida obrigações de câmaras de compensação no STR. A plataforma deriva os ISPBs do participante e da câmara de compensação e a data do movimento.
  • Liquidação multilateral LDL: o LDL0004 liquida a posição líquida devedora do participante em um ciclo. O LDL0006 devolve fundos transferidos por engano. O LDL0008 financia a liquidação de eventos e emissões de ativos. O LDL0011 move a conta corrente da câmara de compensação para a sua conta de liquidação. O LDL0014 financia um depósito na câmara de compensação.
  • O LDL0022 faz um depósito operacional no SILOC em resposta a um aviso de exigência de depósito do SILOC. O trilho recebe avisos apenas quando LDL_ADVISORY_CONSUMER_ENABLED está habilitado. A requisição informa apenas o aviso, e o trilho obtém dele o valor e o período. Depois que o STR rejeita, cancela ou recusa um depósito, você pode depositar o aviso novamente. O trilho recusa um depósito enquanto outro depósito do mesmo aviso está ativo ou liquidado, ou depois que uma rodada de recálculo posterior substituiu o aviso.
  • Liquidação bruta ou bilateral LTR: o LTR0003 move reservas para outra instituição e faz o STR notificar a câmara de compensação. O LTR0004 liquida o resultado de negociação do participante na conta da câmara de compensação. O LTR0006 devolve fundos transferidos por engano.
O trilho recusa um campo de detalhe que o código escolhido não carrega. Ele recusa um número de controle com espaços no início ou no fim, ou um que outra mensagem de saída já carrega. Ele também recusa um LTR0004 para um resultado de negociação que já tem um LTR0004 ativo ou liquidado. O resultado chega na resposta R1 de cada código.

​
Avisos recebidos e roster

  • O trilho registra avisos (GEN0001, GEN0004, GEN0005, GEN0016R2, GEN0017R2) em um log de avisos consultável.
  • Transmissões de cronograma (GEN0021) atualizam as grades de janela operacional. Uma grade reanunciada para a mesma data de referência substitui a anterior.
  • Uma submissão de responsável roster (GEN0019) substitui completamente o roster do participante.
Para cada família de mensagens de entrada, veja Mensageria de entrada do BACEN.

​
Conciliação e recuperação

O trilho abre um caso de conciliação quando um envio falha ou tem um resultado incerto. Ele também abre um caso quando coloca um frame de entrada em quarentena. Os operadores registram ações de ACKNOWLEDGE, RESOLVE, DISMISS ou INVESTIGATE em um caso. Um caso terminal não aceita mais ações. Uma visão entre trilhos de operações travadas lista os itens que precisam de atenção. Ela expõe apenas as ações que o trilho pode executar.
  • Um operador pode reprocessar um frame de entrada em quarentena pelo caminho de entrada. O reprocessamento não envia nenhum aviso próprio ao BACEN.
  • Um operador pode pedir para fechar como falha uma transferência TED ou Conta PI que passou do seu prazo de liquidação sem resposta do BACEN. Um operador diferente aprova o fechamento. O BACEN não é notificado.
  • Uma devolução fechada como falha não fica vigente, então você pode devolver o crédito de novo. Se as duas devoluções liquidarem, o trilho abre um caso de conciliação que identifica as duas devoluções e os valores delas.