Como podemos ajudar?

Como funciona a Remessa e o Retorno de boleto (CNAB)

Como funciona a Remessa e o Retorno de boleto (CNAB)

Quando o provedor usa boleto registrado (carteira própria do banco, não Pix nem cobrança via gateway), o sistema não conversa direto com o banco: ele troca dois arquivos.

• A Remessa é o arquivo que o sistema gera com a lista de boletos a registrar no banco.
• O Retorno é o arquivo que o banco devolve avisando o que aconteceu com esses boletos — registrado, pago, rejeitado, etc.

Esse fluxo vale só para carteiras configuradas como "Registrado (CNAB 240)". Pix e cobranças via gateway (Asaas, Cielo, Gerencianet, etc.) têm baixa automática própria e não passam por Remessa/Retorno.

Pré-requisito

• A Carteira do cliente precisa estar configurada com os dados do banco (código do banco, agência, conta, convênio, cedente) na tela Financeiro > Carteira.
• O modelo de carteira vinculado precisa estar como "Registrado (CNAB 240)" em Financeiro > Carteira Modelo — carteiras marcadas como gateway não aparecem nas telas de Remessa/Retorno.
• O cliente precisa ter a cidade preenchida no cadastro — o sistema bloqueia a geração da remessa se faltar esse dado.

Parte 1 — Gerar e enviar a Remessa

1. Acesse Financeiro > Remessa e clique em "Gerar remessa".
2. Escolha a Carteira, o Tipo de remessa (Entrada, Entrada/Baixa, Alteração de juros, Alteração de vencimento ou Cancelamento de protesto) e o período dos títulos a incluir.
3. Clique em "Confirmar". O sistema busca os boletos em aberto do período, monta o arquivo e já abre o download automaticamente.
4. Envie o arquivo baixado pro banco — pelo internet banking ou EDI do banco. Esse envio é manual: o sistema não manda o arquivo pro banco sozinho.

Se precisar desfazer uma remessa gerada por engano, use "Desfazer última remessa" na mesma tela — só funciona enquanto nenhum retorno referente a ela tiver sido processado ainda.

Parte 2 — Processar o Retorno

1. Quando o banco devolver o arquivo de retorno, acesse Financeiro > Retorno CNAB e clique em "Processar retorno".
2. Selecione o arquivo recebido do banco.
3. Escolha "Processar e aguardar" (a tela trava até terminar — melhor pra arquivos pequenos) ou "Processar em 2º plano" (roda em segundo plano e avisa quando terminar — melhor pra arquivos grandes).
4. O sistema lê o arquivo e, título por título, decide o que fazer: boleto pago é baixado automaticamente (o débito do contrato do cliente é liquidado); boleto rejeitado é liberado pra entrar numa remessa nova.
5. Pra conferir o que aconteceu com cada título, acesse os itens do retorno (lupa na grid) — lá aparece, por boleto, a operação, o valor pago e a mensagem (erro em vermelho, alerta em amarelo), com link direto pro financeiro do cliente.

Como saber se uma remessa não foi enviada ao banco

A própria listagem de Remessa pinta de vermelho remessas com mais de um dia sem nenhum retorno vinculado — é o sinal de que ela provavelmente não foi enviada ao banco ainda (ou o banco ainda não devolveu o retorno correspondente).

Erros comuns

• "Nenhuma carteira para gerar remessa!" — não existe nenhuma carteira configurada como Registrado (CNAB 240) pra essa empresa.
• "Remessa: Não há títulos para gerar." — não existe nenhum boleto em aberto no período escolhido.
• "Remessa: Cliente [nome] está sem cidade preenchida." — corrija o cadastro do cliente (aba Endereço) antes de gerar a remessa de novo.
• "Remessa: Não é possível desfazer uma remessa que já foi enviada ao banco." — já existe retorno processado referente a ela; não dá mais pra desfazer.
• "Já existe um retorno sendo processado, por favor aguarde." — o sistema não deixa processar dois retornos ao mesmo tempo no mesmo dia; espere o anterior terminar.
• "O retorno já foi processado anteriormente." — o sistema detecta arquivo duplicado e não deixa reprocessar (evita baixar o mesmo boleto duas vezes).
• "O retorno selecionado não está na sequencia esperada. Verifique se há retornos não processados anteriores ao atual." — falta processar um retorno mais antigo primeiro.
• "O arquivo selecionado não é um arquivo de retorno válido!" — o arquivo enviado não bate com o layout esperado (150/240/400 posições) — confirme se é mesmo o arquivo certo, do banco certo.
• Nos itens do retorno, mensagens comuns: "Financeiro anteriormente pago" (o boleto já tinha sido baixado por outro caminho, ex. Pix), "Insuficiência de fundos" e "Financeiro rejeitado" (o banco recusou o registro do boleto — confira os dados do cliente/carteira).