Como realizar o processamento de retornos bancários

Visão geral

Este conteúdo detalha a rotina de processamento de arquivos de retorno bancário (CNAB). Esse arquivo é o documento digital enviado pelo banco contendo o consolidado das movimentações diárias dos boletos, informando ao sistema quais cotas foram pagas, registradas, baixadas ou rejeitadas pela instituição financeira.

Quando usar este artigo

Utilize este guia diariamente, logo após realizar o download do arquivo de retorno no portal do banco tradicional (Itaú, Bradesco, Santander, etc.), para que a sua equipe faça a leitura desse arquivo no sistema e automatize as baixas de recebimentos.

Sintoma ou cenário

Você precisa atualizar o caixa do condomínio e dar baixa nas cotas que os condôminos pagaram no dia anterior. Fazer isso manualmente, boleto por boleto, levaria horas, então você utiliza o arquivo do banco para que o sistema faça a liquidação em lote.

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

Automação de Baixas: O sistema liquida dezenas ou centenas de boletos em poucos segundos.
Redução de Erros: Elimina falhas humanas na digitação de valores pagos, juros, multas e datas de crédito.
Controle de Rejeições: Permite identificar rapidamente se o banco recusou o registro de algum boleto por erro de cadastro (como CPF inválido).

Onde acessar / contexto de uso

Acesse o sistema e navegue até o menu Receitas > Retorno bancário

Pré-requisitos (Antes de começar)

Perfil de Acesso: Permissões de escrita e gestão no módulo de Receitas.
Arquivo do Banco: Ter baixado o arquivo de retorno (geralmente com a extensão .ret ou .txt) diretamente do portal do banco homologado.
Configuração: A conta bancária do condomínio já deve estar homologada e configurada com o layout correto (CNAB 400 ou 240) no sistema.

Causas prováveis

Execução da rotina diária de conciliação bancária e atualização da inadimplência dos condomínios da administradora.

Como fazer ou corrigir

O arquivo de retorno bancário contém informações enviadas pelo banco sobre pagamentos de boletos, como liquidação, registro, baixa de cobranças e rejeições. Retornos do PJBank são processados automaticamente, sem necessidade de intervenção manual.

Para realizar o processamento dos retornos bancários, execute os passos a seguir:

Acesse: Receitas > Retorno bancário;
Vá em ‘Processar arquivos’ e selecione os arquivos em sua máquina.

Atenção: O sistema permite processar até 20 arquivos de retorno simultaneamente. As tarifas e diferenças identificadas serão processadas conforme as regras estabelecidas nas configurações. Veja Aqui como configurar.

Resultado esperado

Ao concluir o processamento, o sistema exibirá um resumo da leitura. As cobranças listadas no arquivo terão seus status atualizados (ex: de "Pendente" para "Recebida"), as tarifas serão contabilizadas e as unidades que pagaram sairão da lista de inadimplência automaticamente.

Quando escalar

Acione o suporte técnico caso o sistema apresente um erro de "Layout Inválido" impedindo a leitura do arquivo inteiro, ou se o processamento for concluído com sucesso, mas os boletos permanecerem em aberto no sistema (não baixarem).

Informações que devem ser reunidas antes do escalonamento

O arquivo de retorno original recebido do banco (em anexo). Atenção: nunca abra este arquivo no Excel antes de enviar ao suporte.
Print da tela de erro ou do resumo de leitura.
ID de pelo menos um boleto que consta no arquivo mas não foi baixado.
Nome e CNPJ do condomínio.

Regras importantes / Observações

Nunca abra o arquivo de retorno (CNAB) em programas de planilhas como o Excel. O Excel corrompe a estrutura do arquivo ao remover os "zeros à esquerda" das linhas e colunas, o que invalidará a leitura no momento em que você tentar processá-lo no sistema. Se precisar visualizar o conteúdo por curiosidade, use o Bloco de Notas (Notepad).

Problemas comuns e como resolver

Problema: O arquivo carregou, mas várias liquidações não foram encontradas no sistema.
Causa provável: O condomínio pode ter mudado de sistema ou os boletos pagos pertencem a uma remessa gerada fora da plataforma atual.
Ação recomendada: Verifique no log de leitura quais foram as ocorrências. Se o nosso-número do boleto não existir no sistema atual, a baixa não poderá ser feita automaticamente.
Problema: O sistema acusa que o arquivo já foi processado.
Causa provável: Sua equipe baixou o arquivo do mesmo dia (ou de dias anteriores) novamente no portal do banco.
Ação recomendada: O sistema possui uma trava de segurança contra duplicidade. Certifique-se de baixar apenas os arquivos novos (não lidos) no painel do banco.

Dúvidas relacionadas

P: Preciso separar os arquivos de retorno por condomínio?
R: Não. Se você tiver múltiplos arquivos de diferentes condomínios, pode selecioná-los todos de uma vez (até o limite de 20). O sistema reconhecerá automaticamente a qual condomínio cada linha pertence através dos dados bancários.

P: Onde vejo o histórico dos arquivos que já processei?
R: Na própria tela de Receitas > Retorno bancário, há uma listagem com o histórico de arquivos lidos, datas de processamento e links para visualizar o relatório detalhado de cada um.

Palavras-chave de busca

Como realizar o processamento de retornos bancários, ler arquivo CNAB, baixar arquivo .ret, liquidação em lote de boletos, conciliação arquivo de retorno, erro layout CNAB, Superlógica Condomínios