Por que a cobrança não foi registrada no PJBank
Visão geral
Este conteúdo detalha os motivos pelos quais uma cobrança emitida via PJBank pode não ter sido registrada na rede bancária, fornecendo uma orientação clara e prática para diagnosticar a causa e regularizar a situação no sistema.
Quando usar este artigo
Utilize este guia sempre que houver ocorrências de boletos rejeitados, quando o locatário (inquilino) relatar o erro de "boleto não localizado/registrado" no aplicativo do banco, ou quando encontrar dúvidas sobre as regras de validação do PJBank.
Sintoma ou cenário
O operador do sistema gera o boleto de aluguel, mas, ao tentar realizar o pagamento ou consultar o status, identifica que a cobrança não foi registrada oficialmente pela CIP (Câmara de Interbancária de Pagamentos), impossibilitando a quitação imediata por parte do inquilino.
Benefício para o usuário ou operação
Identificação rápida de inconsistências cadastrais ou cronológicas.
Evita o envio de cobranças inválidas para a carteira de clientes.
Autonomia para corrigir dados e reemitir títulos sem depender de suporte externo.
Onde acessar / contexto de uso
Acesse o sistema com suas credenciais e navegue até o menu Receitas > Receitas a Receber ou consulte a aba financeira diretamente no cadastro 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.
Recursos Sistêmicos: Integração com o gateway PJBank ativa e em produção.
Insumos e Dados Técnicos: Código da cobrança afetada, ID do contrato de locação e acesso ao histórico de logs do título.
Causas prováveis
Geração da cobrança de forma retroativa (data de geração igual ou posterior ao vencimento).
Ausência ou inconsistência de dados obrigatórios do pagador (CPF/CNPJ inválido, CEP incorreto ou endereço incompleto), violando as normas da Febraban.
Decurso do tempo padrão de sincronização assíncrona da API do banco.
Como fazer ou corrigir
Para que o PJBank registre um boleto com sucesso, o título precisa passar por uma validação estrutural de dados e respeitar uma janela cronológica específica. Caso uma cobrança não tenha sido registrada, execute o seguinte procedimento de auditoria e correção:
Passo 1: Verificar a Linha Cronológica do Boleto
Acesse o menu Receitas > Receitas a Receber;
Localize a cobrança em questão e verifique a Data de Geração e a Data de Vencimento;
Analise a Regra de Retroatividade: Certifique-se de que a data de geração não é igual ou posterior ao vencimento. O PJBank não realiza o registro automático de cobranças emitidas com datas retroativas ou vencidas no mesmo dia da criação, pois o ecossistema bancário exige tempo hábil de processamento antes do vencimento do título.
Passo 2: Auditar os Dados Cadastrais do Locatário (Regra Febraban)
Os bancos rejeitam o registro de boletos que possuam dados do pagador incompletos.
Acesse a ficha do contrato e clique no perfil do Locatário;
Certifique-se de que os seguintes campos obrigatórios estão preenchidos corretamente:
CPF ou CNPJ: Deve estar ativo e com a numeração correta (sem dígitos faltantes);
Endereço Completo: Logradouro, número, bairro e cidade;
CEP: O código postal deve ser válido e compatível com a base dos Correios.
Passo 3: Analisar o Log de Ocorrências da Cobrança
Na tela de Receitas a Receber, clique sobre a cobrança desejada para expandir os detalhes;
Verifique o Log de Alterações ou a aba de retornos da API. O sistema exibirá mensagens específicas caso o PJBank tenha devolvido alguma rejeição (Exemplo: "CPF do pagador inválido" ou "CEP não localizado").
Passo 4: Executar o Fluxo de Contingência (Invalidar e Clonar)
Caso seja confirmada uma inconsistência de datas ou erro cadastral já corrigido, o boleto antigo não receberá o registro retroativamente. Você deve reemitir o título:
Com o cadastro do cliente já retificado, acesse a cobrança incorreta e clique em Invalidar;
Em seguida, utilize a ferramenta do sistema para realizar a Clonagem da cobrança ou gerar uma nova cobrança avulsa;
Esse processo garante a integridade dos dados e assegura que um novo comando de registro limpo seja disparado e enviado corretamente ao PJBank com o layout atualizado.
Resultado esperado
Ao concluir as verificações e correções, o sistema processará o novo comando de faturamento com sucesso. O PJBank registrará o boleto na rede bancária dentro dos prazos regulamentares, permitindo que o inquilino efetue o pagamento em qualquer canal de atendimento com total transparência.
Quando escalar
Caso todos os dados cadastrais do inquilino estejam rigorosamente corretos, a data de vencimento seja futura e, mesmo após realizar o processo de invalidação e clonagem, o novo boleto continue apresentando o status de não registrado ou retorne erros de comunicação com o gateway.
Informações que devem ser reunidas antes do escalonamento
Print da tela de detalhes da cobrança e do log de erros do PJBank.
ID do contrato de locação e a linha digitável/Nosso Número do boleto afetado.
Data e hora exata em que o lote ou a cobrança avulsa foi gerada.
Regras importantes / Observações
- Mantenha os dados sempre atualizados para evitar inconsistências em relatórios futuros.
- Prazos de Sincronização: Lembre-se de que o registro via API não é instantâneo em tempo real absoluto. Dependendo da fila de processamento bancário, o boleto pode levar alguns minutos para ficar disponível para leitura nos aplicativos de internet banking após a sua geração no Superlógica.
Problemas comuns e como resolver
- Problema: O log da cobrança exibe o erro "Payer document invalid" (Documento do pagador inválido).
Causa provável: O CPF ou CNPJ do locatário foi digitado com erro ou pertence a um cadastro desativado na Receita Federal.
Ação recomendada: Confirme o documento correto com o cliente, acesse o cadastro de pessoas no menu Contratos, corrija a numeração, invalide a cobrança antiga e clone-a para disparar o registro corrigido.
Problema: O operador tenta clonar o boleto, mas o sistema bloqueia ou indica erro de duplicidade.
Causa provável: Tentativa de gerar um novo título com o mesmo "Nosso Número" ou mesma competência sem antes invalidar o boleto que apresentou falha.
Ação recomendada: Certifique-se de concluir o processo de invalidação do boleto com erro antes de salvar a nova emissão avulsa para o mesmo período de referência.
Dúvidas relacionadas
P: É possível emitir uma segunda via atualizada de um boleto que não foi registrado por vencimento retroativo? R: Não diretamente sobre o mesmo título. Se o boleto original não foi registrado porque a data de geração foi tardia, a única solução contábil é invalidar essa cobrança e gerar um novo título avulso ajustando a data de vencimento para um prazo futuro amigável, permitindo que o PJBank processe o registro.
P: Como posso evitar que a Régua de Cobrança envie e-mails de boletos para os inquilinos antes que eles estejam registrados no PJBank? R: Acesse o menu Receitas > Régua de Cobrança e ative a trava de segurança "Não notificar na régua se o boleto não estiver registrado". Isso garante que o sistema só faça o disparo do e-mail ou SMS após a confirmação de sucesso na esteira do banco, blindando a operação contra reclamações de clientes.
Palavras-chave de busca
boleto não registrado, rejeição PJBank, regras Febraban, erro de CEP, clonar cobrança, cobrança retroativa