Como funciona o registro de boletos no PJBank

Visão geral

Este conteúdo detalha o funcionamento e as regras de negócio que regem o ciclo de vida e o registro de boletos bancários emitidos através do gateway integrado PJBank, fornecendo uma orientação clara e prática para a execução correta da rotina e entendimento das travas de segurança do sistema.

Quando usar este artigo

Utilize este guia sempre que houver necessidade de compreender os prazos de sincronização bancária, entender o motivo do bloqueio de alterações em cobranças ativas ou quando encontrar dúvidas sobre as regras de negócio associadas ao registro de títulos conforme as normas regulatórias.

Sintoma ou cenário

O operador do setor financeiro tenta editar o valor, a data de vencimento ou os encargos de um boleto de aluguel e encontra os campos bloqueados pelo sistema, ou invalida uma cobrança por engano e precisa compreender o tempo de resposta para a baixa efetiva junto ao banco.

Benefício para o usuário ou operação

Alinhamento com as normas de segurança do Banco Central e da Febraban.
Evita a rejeição de pagamentos por falta de registro ou cobranças duplicadas de tarifas.
Maior clareza sobre os prazos de sincronização e travas de edição do sistema.

Onde acessar / contexto de uso

Acesse o sistema com suas credenciais e navegue até o menu Receitas > Receitas a Receber ou acesse o histórico financeiro diretamente na ficha do contrato em Contratos > Contratos.

Pré-requisitos (Antes de começar)

Perfil Exato: É necessário possuir permissões de escrita/gestão no módulo financeiro correspondente.
Recursos Sistêmicos: Integração com a forma de recebimento via PJBank ativa e homologada no plano contratado.
Insumos e Dados Técnicos: Identificação clara do código da cobrança e do contrato de locação a ser analisado.

Causas prováveis

Implementação das diretrizes de segurança da Federação Brasileira de Bancos (Febraban) e do Banco Central, que extinguiram as antigas carteiras de cobrança sem registro para coibir fraudes eletrônicas.

Como fazer ou corrigir

Regras de prazos e bloqueios do registro:

Vencimento em até 2 dias: se o boleto for gerado com vencimento para hoje, amanhã ou depois de amanhã, o registro oficial no banco ocorre no próprio dia do vencimento, após as 16h. Ultrapassado esse prazo, o sistema bloqueia definitivamente alterações em vencimento, valor, juros e multa.
Vencimento futuro (mais de 3 dias): o registro oficial ocorre 3 dias após a geração do título. Após essa carência de 72 horas, as alterações também são travadas.

Fluxo de invalidação:

Ao invalidar um boleto registrado, o sistema agenda um comando de baixa que leva 3 dias úteis para ser processado no banco.
Não é possível cancelar uma invalidação após ela ter sido comandada — o título é desativado permanentemente.

Como proceder se precisar alterar um boleto travado:

Acesse a cobrança na tela de Receitas > A Receber.
Invalide o boleto incorreto.
Clone ou gere uma nova cobrança avulsa com os dados corrigidos para enviar ao locatário.

Resultado esperado

O operador compreenderá os prazos de registro e as travas de segurança do PJBank, executando corretamente o fluxo de invalidação e clonagem quando alterações forem necessárias em boletos já registrados.

Quando escalar

Caso o sistema apresente mensagens de erro de API impeditivas no momento de gerar novos títulos avulsos, ou se um boleto clonado permanecer indisponível para leitura e pagamento nos aplicativos bancários após o decurso dos prazos oficiais de sincronização.

Informações que devem ser reunidas antes do escalonamento

Print da tela de erro ou do comportamento travado.
ID do contrato de locação e a linha digitável/Nosso Número do boleto afetado.
Data e hora em que a cobrança original foi gerada.

Regras importantes / Observações

A migração para carteiras registradas é uma medida mandatória do Banco Central e da Febraban para coibir fraudes — boletos sem registro foram extintos do mercado.
Configure o primeiro disparo da Régua de Cobrança com antecedência segura (ex: 5 dias antes do vencimento) para garantir que o boleto já tenha passado pela janela de registro antes de chegar ao cliente.
Para entender o contexto histórico e técnico dessa implementação de segurança que erradicou os boletos sem registro, você pode consultar o artigo oficial do nosso portal de novidades: Fim do Boleto Sem Registro.

Problemas comuns e como resolver

Problema: Os campos de vencimento, valor de aluguel e encargos de uma cobrança aparecem cinzas e impossibilitados de edição.
Causa provável: O boleto atingiu a janela cronológica de segurança e já foi transmitido para registro oficial no PJBank.
Ação recomendada: Não tente forçar a edição. Siga a regra de contingência padrão do sistema: invalide o boleto atual e comande a geração de uma nova cobrança avulsa com os dados retificados.
Problema: O inquilino tenta pagar o boleto gerado hoje e o aplicativo do banco dele retorna o erro de "Boleto não registrado".
Causa provável: O locatário tentou realizar a leitura do código de barras na mesma hora em que a imobiliária criou o título, antes do tempo necessário para o lote de sincronização da API ser processado pelo banco.
Ação recomendada: Oriente o locatário a aguardar alguns minutos e tentar refazer a operação, ou utilize a ferramenta de simulação em PDF para validar se a composição financeira está correta.

Dúvidas relacionadas

P: É possível emitir uma segunda via atualizada sem a incidência de multas e juros para um boleto que já venceu? R: Sim. Se o boleto estiver vencido mas ainda em aberto, você pode acessar a tela de Receitas a Receber, abrir as opções da cobrança e configurar a excepcionalidade de encargos diretamente na emissão da segunda via para o inquilino.

P: Como posso automatizar o envio desses alertas e lembretes para que o inquilino não tente pagar o boleto antes do registro? R: Você pode parametrizar os prazos de aviso ativando as notificações automáticas por e-mail e SMS na ferramenta de Régua de Cobrança. Recomenda-se configurar o primeiro disparo da régua com uma antecedência segura (Ex: 5 dias antes do vencimento), garantindo que o título já tenha passado pela janela de registro de 3 dias do PJBank antes de chegar ao e-mail do cliente.

Palavras-chave de busca

registro de boletos PJBank, carteira registrada, boleto travado, alterar vencimento boleto, invalidação de cobrança, Febraban,