Como configurar o processamento de retornos bancários

Visão geral

Este conteúdo detalha como parametrizar as regras de leitura dos arquivos de retorno bancário (CNAB). Essa configuração define como o sistema deve se comportar ao encontrar tarifas cobradas pelo banco e como lidar com diferenças de centavos (pagamentos a maior ou a menor) efetuados pelos condôminos durante a baixa automática.

Quando usar este artigo

Utilize este guia ao implantar a gestão financeira de novos condomínios, quando renegociar o valor das tarifas com o banco homologado, ou quando desejar automatizar a aprovação de divergências de centavos que costumam travar a liquidação dos boletos.

Sintoma ou cenário

Ao processar o arquivo de retorno diário, você percebe que o sistema não está lançando a despesa da tarifa bancária automaticamente no caixa do condomínio, ou nota que muitas liquidações estão caindo em "baixa manual" porque os condôminos pagaram o boleto com uma diferença de poucos centavos.

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

Conciliação Exata: Automatiza o lançamento da despesa bancária simultaneamente à entrada da receita.
Produtividade: Reduz a necessidade de intervenção humana (baixa manual) para aprovar diferenças irrisórias de pagamento.
Flexibilidade: Permite adaptar o comportamento do sistema às diferentes negociações que a sua administradora possui com a rede bancária.

Onde acessar / contexto de uso

Acesse o sistema e navegue até o menu Receitas > Retorno bancário. A configuração é feita através do ícone de engrenagem no canto superior direito dessa tela.

Pré-requisitos (Antes de começar)

Perfil de Acesso: É necessário possuir permissões de administrador/gestão no módulo de Receitas para alterar configurações globais de retorno.
Dados Técnicos: Saber o valor exato da tarifa negociada com o banco para liquidação de boletos.

Causas prováveis

Configuração inicial do sistema ou necessidade de otimização de tempo da equipe do "Contas a Receber" que está gastando muitas horas aprovando diferenças de centavos manualmente.

Como fazer ou corrigir

Acesse Receitas e selecione Retorno bancário;
Clique no ícone de configurações (engrenagem) no canto superior direito da tela;
Em Debitar taxa bancária, selecione a forma de tratamento das tarifas:
3.1 Não debitar tarifa, exceto PJBank: o sistema não lançará tarifa nas liquidações, exceto nos boletos PJBank;
3.2 Sempre debitar tarifa: será aplicado o valor da tarifa definido no campo Valor da Tarifa;
3.3 Nunca debitar tarifa, inclusive PJBank: nenhuma tarifa será lançada, independentemente da origem do boleto.
Em Confiar nos cálculos do banco, defina como tratar diferenças de valores:
4.1 Nunca: o sistema exibirá qualquer diferença entre o valor pago e o registrado;
4.2 Sempre: o sistema ignorará as diferenças e confiará nos cálculos do banco;
4.3 Confiar até a diferença permitida: defina um valor limite no campo Diferença permitida, e diferenças até esse valor serão desconsideradas.
Clique em Salvar para aplicar as configurações.

Observações: As configurações serão aplicadas aos próximos retornos processados ou reprocessados. Para contas que utilizam Conta Digital PJBank, a tarifa será sempre debitada automaticamente para garantir a conciliação correta.

Resultado esperado

Ao concluir e salvar, os próximos arquivos de retorno processados pela sua equipe respeitarão as novas regras, lançando as tarifas no caixa automaticamente e aprovando/rejeitando diferenças financeiras com base no limite estabelecido.

Quando escalar

Acione o suporte técnico caso, mesmo com a opção "Sempre debitar tarifa" ativada e o valor preenchido, os novos arquivos processados continuem não gerando o lançamento da despesa bancária na conta do condomínio.

Informações que devem ser reunidas antes do escalonamento

Print da tela de "Configurações de Retorno" mostrando as regras salvas.
O arquivo de retorno original (em anexo) que apresentou a falha de leitura.
ID de uma cobrança liquidada no dia em que a tarifa deveria ter sido cobrada.

Regras importantes / Observações

Retroatividade: As configurações salvas são aplicadas apenas aos próximos arquivos lidos ou àqueles que forem reprocessados. Elas não alteram baixas de dias anteriores.
Exceção Conta Digital: Para condomínios que utilizam a Conta Digital PJBank, a tarifa de liquidação de boletos será sempre debitada automaticamente (separada do repasse) para garantir a conciliação do extrato, independentemente de algumas marcações nesta tela.

Problemas comuns e como resolver

Problema: Alterei o valor da tarifa para R$ 3,00 hoje de manhã, mas os boletos baixados ontem continuam com a tarifa de R$ 2,50.
Causa provável: O comportamento sistêmico padrão. Regras de retorno não têm efeito retroativo.
Ação recomendada: Se precisar corrigir as tarifas de ontem, será necessário desfazer o processamento do arquivo anterior e reprocessá-lo para que o sistema leia os dados novamente com a nova regra de R$ 3,00 aplicada.
Problema: Configurei a diferença permitida para R$ 0,10, mas boletos com R$ 0,05 de diferença não baixaram.
Causa provável: O banco não enviou a indicação de liquidação correta no arquivo, ou há divergência nos juros calculados pelo banco x sistema.
Ação recomendada: Verifique o "Log/Relatório" do arquivo processado para entender o motivo exato da rejeição pelo sistema antes de alterar a configuração.

Dúvidas relacionadas

P: A configuração de "Confiar nos cálculos do banco" afeta multas e juros?
R: Sim. Se o banco cobrar R$ 2,00 de juros, mas o sistema esperava R$ 2,50, essa diferença de R$ 0,50 será analisada pela regra de tolerância que você configurou.

P: Posso colocar a taxa bancária como R$ 0,00?
R: Sim, se você optar por lançar as despesas bancárias no final do mês através de um lançamento manual consolidado, basta marcar "Não debitar tarifa".

Palavras-chave de busca

Como configurar o processamento de retornos bancários, debitar taxa bancária, configurar tarifa CNAB, diferença permitida arquivo de retorno, confiar nos cálculos do banco, pagamento a maior diferença de centavos, Superlógica Condomínios