B4 Guia

Passo 7 · Importar o retorno do banco

A tela Detalhes do retorno: escolher a conta e o arquivo, conferir os dados convertidos, importar o retorno, o que cada tipo de ocorrência faz, e consultar retornos anteriores.

Sistema: SoftWay Comercial (Retaguarda) · Atualizado em 22/11/2026

Conteúdo criado com apoio de inteligência artificial · em revisão pela equipe da B4 System

O retorno é o arquivo em que o banco conta o que aconteceu com os boletos: registrou, o cliente pagou, baixou, recusou. Ao importar, o sistema baixa as parcelas pagas e lança o dinheiro na conta corrente. Abra por Controle Bancário → Gestão Cobrança Bancária → Retorno (senha 179). O título é “Detalhes do retorno”.

#Antes de importar

  • Baixe o arquivo de retorno do banco e salve na pasta de retorno da carteira (a mesma que está no cadastro da carteira, passo 5 dos bancos).
  • O arquivo precisa ter a extensão que a carteira diz em Tipo Arq Retorno (por exemplo, RET): a lista só mostra esses.
  • Confira se o dia não está fechado: com o fechamento do dia ligado, o retorno não baixa até a data mudar.

#Puxar o retorno

Detalhes do retorno: conta, carteira, pasta, arquivos, dados convertidos e Importa Retorno

Um arquivo com dois boletos pagos e um registro confirmado.

  1. Conta Corrente nº: a conta do banco que enviou o retorno. Vem a conta padrão.
  2. Carteira Cobrança: a carteira. Define a pasta, a extensão e o layout do arquivo.
  3. Caminho arquivo retorno do banco: a pasta onde estão os arquivos (o botão ... muda). A pasta fica gravada na carteira quando você fecha a tela.
  4. Operador Padrão: o código do operador de recebimento (forma de recebimento) usado nos lançamentos do retorno. Vem do campo Cod. Consiliação Sistema da conta (dados de cobrança). Se o código não existir no cadastro de operadores, a baixa grava a descrição “DESCRICAO SEM CADASTRO”.
  5. Puxar retorno: o modo de importar um arquivo novo. É o modo que abre.
  6. Buscar retornos anteriores: o modo de consultar retornos já importados (veja abaixo).
  7. Lista de arquivos: os arquivos da pasta. Clique no arquivo do dia.
  8. Tipo Ocorrência: filtra a grade por tipo de ocorrência (por exemplo, só as liquidações).
  9. Grade Dados Convertidos: o conteúdo do arquivo, uma linha por título.
  10. Valor Recebido: o total recebido do que a grade mostra.
  11. Importa Retorno: grava o retorno no sistema.
  12. Exibe alertas ?: marcada, o sistema mostra uma mensagem para cada ocorrência que ele não sabe tratar (veja abaixo).

Ao clicar no arquivo, o sistema o converte: aparece “Preparando ambiente de retorno” e “Lendo arquivo retorno”. Se a conversão falhar, a faixa fica vermelha com “Arquivo de retorno não foi gerado”.

#As colunas da grade

A grade mostra Sacado, CNPJ, Vencimento, Documento (o seu número), Ocorrência, Nosso Numero, Mora Juros, Recebido e Tipo Ocorrencia. A primeira coluna fica vermelha quando o nosso número não tem parcela no contas a receber daquela conta. Essas linhas não baixam nada no contas a receber.

#Importar

  1. Confira a grade e o Valor Recebido contra o aviso do banco.
  2. Clique em Importa Retorno.
  3. O sistema pergunta se deve apagar o arquivo depois:

Mensagem: Deseja excluir o retorno após o processamento ?

  1. Ao terminar, aparece “O retorno ..., foi finalizado com sucesso !”.

Mensagem: O retorno RETORNO.RET, foi finalizado com sucesso !

#O que cada ocorrência faz

Ocorrência do banco O que o sistema faz
Liquidação (cliente pagou) Atualiza o boleto (data e valor do pagamento, resposta, data do retorno, nome do arquivo) e baixa a parcela ligada a ele: grava a baixa, o juros do retorno e lança o crédito na conta corrente.
Baixa simples Só atualiza o boleto com a resposta do banco e a data. Não baixa parcela.
Registro confirmado Atualiza o boleto com a resposta do banco. E, se a carteira tem Baixa Conta Receber Qualquer Retorno ligada, baixa também a parcela (veja o aviso abaixo).
Qualquer outra Se Exibe alertas ? está marcada, mostra uma mensagem com a posição no arquivo, o nosso número, a descrição e o motivo da rejeição. Não faz mais nada.

#O que uma liquidação grava

Para cada parcela ligada ao boleto pago, o sistema:

  1. marca a parcela como paga (valor baixado = valor da parcela);
  2. grava a baixa com a data do pagamento do banco, o juros (o Mora Juros do retorno), o valor recebido (parcela mais juros), o caixa e o usuário;
  3. lança um crédito na conta corrente, já compensado, com a descrição PGTO BX.REC. e a venda, a letra da parcela e o início do nome do cliente, origem RET.BANCARIO e o Operador Padrão como plano de contas.

Uma parcela já baixada é pulada: reimportar o mesmo arquivo não baixa duas vezes.

Registro confirmado pode baixar a parcela antes do pagamento

Com Baixa Conta Receber Qualquer Retorno ligada na carteira, o retorno de registro confirmado (o banco só avisou que registrou o boleto, e o cliente ainda não pagou) marca a parcela como paga e escreve “BAIXADO NO RETORNO BANCARIO” nela. Esse caminho não lança o crédito na conta corrente nem grava a baixa. Deixe essa opção desligada, a menos que o seu banco só devolva retorno quando o boleto é pago.

Erros ficam em silêncio

A importação roda com os erros ignorados: se uma parcela não puder ser baixada, o sistema segue em frente e, no fim, diz “finalizado com sucesso”. Depois de importar, sempre confira o resultado: o contas a receber, a movimentação da conta e a coluna # vermelha da grade.

Ao abrir a tela, os arquivos .ini da pasta de retorno são apagados

Ao abrir Detalhes do retorno, o sistema apaga os arquivos .ini da pasta de retorno (são os arquivos de trabalho da conversão). Não guarde .ini seus na pasta de retorno.

#Buscar retornos anteriores

Para ver o que já foi importado:

Buscar retornos anteriores: período, cliente, nosso número, tipo de ocorrência e arquivo

A busca dos retornos já gravados.

  1. Buscar retornos anteriores: troca o modo da tela.
  2. Dt. Inicial e 3. Dt. Final: o período.
  3. Cód.Cliente: o cliente.
  4. Nosso Número: o nosso número procurado.
  5. Tipo Ocorrência: o tipo da ocorrência.
  6. Arquivo retorno: o nome do arquivo, ou todos.
  7. Filtra: mostra as linhas encontradas e soma o Valor Recebido.

O sistema guarda uma cópia de cada retorno importado (uma vez por nome de arquivo), e é essa cópia que a busca mostra.

#O resumo do retorno

No menu Configuração da tela está Imprime Resumo Retorno Automático. Ligada, depois de importar o sistema imprime o resumo do retorno.

#Se o retorno não bate

O que você vê O que pode ser
A linha da grade está vermelha O nosso número não tem parcela nesta conta (boleto avulso, boleto excluído, conta errada).
O arquivo não aparece na lista A extensão não é a do Tipo Arq Retorno da carteira, ou o arquivo está em outra pasta.
O valor da parcela não bate O banco enviou juros ou desconto: veja Mora Juros na grade. O sistema grava o juros do retorno junto com o valor da parcela.
“Arquivo de retorno não foi gerado” O componente do banco não conseguiu ler o arquivo. Confira o layout e a carteira.
© 2026 B4 System · B4 Guia, manual de treinamento. Material criado com apoio de inteligência artificial e em revisão pela equipe da B4 System; pode conter imprecisões. Os exemplos usam dados fictícios e as telas são ilustrações geradas a partir do sistema.