Retornos bancários

O arquivo de retorno é o arquivo CNAB enviado pelo banco após processar os pagamentos dos boletos. Ao importar esse arquivo no Atlaz, o sistema dá baixa automática nas cobranças pagas, registra tarifas bancárias e informa ocorrências como boletos rejeitados ou cobranças já baixadas.

Bancos tradicionais exigem esse processo manual. Gateways (Efí, Iugu, Widepay) realizam o retorno de forma automática, dispensando esse passo.

Acesso à página

Caminho: Financeiro → Retornos

---

Visão geral da tela

A tela de retornos apresenta:

1. Gráfico de tarifas bancárias — exibe os últimos 6 meses com barras de total de tarifas e número de boletos compensados, além de uma linha de tarifa média por boleto.
2. Tabela de retornos enviados — lista todos os arquivos de retorno já importados no sistema.

Considere usar um gateway

A tela exibe uma comparação entre bancos tradicionais e os principais gateways integrados ao Atlaz (Efí, Iugu, Widepay). Gateways oferecem remessa e retorno automáticos, eliminando o envio manual de arquivos.

---

Enviar um arquivo de retorno

Passo 1 — Obter o arquivo de retorno do banco

Acesse o internet banking ou o software do seu banco e baixe o arquivo de retorno CNAB referente ao período desejado. O arquivo geralmente tem extensão .ret ou .txt.

Passo 2 — Fazer o upload no Atlaz

1. Na tela de Retornos, clique em Enviar novo arquivo (botão verde no topo ou no rodapé da lista).
2. Na tela de upload, preencha:

Campo	Descrição
Arquivo	Selecione o arquivo de retorno baixado do banco (campo obrigatório)
Conta	Selecione o método de cobrança (conta bancária) correspondente ao arquivo

1. Clique em Enviar.

O sistema importa o arquivo e ele passa a constar na lista de retornos. Neste momento, os boletos ainda não foram baixados — é necessário processar o arquivo.

---

Processar o arquivo e dar baixa nos boletos

Após o upload, o arquivo fica na lista com o status de não processado. Para efetivar as baixas:

1. Na tabela de retornos, localize o arquivo desejado.
2. Na coluna Ações, clique em Processar e dar baixa nos boletos.
3. O sistema exibe a tela de processamento com dois painéis:

Painel 1 — Pagamentos (liquidações)

Lista todos os títulos identificados no arquivo como pagos pelo banco:

Coluna	Descrição
Título	Id da cobrança no Atlaz
Assinante	Nome do assinante (com link para o cadastro)
Valor original	Valor original do título
Valor pago	Valor efetivamente pago pelo assinante
Vencimento	Data de vencimento do boleto
Data de pagamento	Data em que o banco confirmou o pagamento
Nosso número	Código de identificação do boleto no banco
Ocorrência	Descrição do tipo de ocorrência retornada pelo banco
Tarifa	Tarifa bancária cobrada por esse boleto
Status	Resultado do processamento (ver abaixo)

Status possíveis:

Status	Significado
Sucesso	Cobrança localizada e baixa efetuada com sucesso
Cobrança não localizada	O nosso número do retorno não corresponde a nenhuma cobrança ativa no sistema
Cobrança deletada em DD/MM/AAAA	A cobrança existiu, mas foi excluída antes do processamento

Ao final da tabela, é exibido o total de valor pago e o total de tarifas do lote.

Painel 2 — Outros registros

Lista ocorrências presentes no arquivo que não são liquidações (pagamentos), como:

• Confirmações de registro de boleto no banco
• Solicitações de baixa processadas
• Alterações de vencimento
• Boletos rejeitados pelo banco
• Outras ocorrências informativas

A estrutura das colunas é idêntica ao painel de liquidações, exceto que a coluna Valor do título substitui o Valor pago.

:::important Verifique os itens com status "Cobrança não localizada" Esse status pode indicar que o boleto foi gerado fora do Atlaz, ou que houve inconsistência entre o "nosso número" registrado no banco e o que consta no sistema. Nesses casos, avalie se a baixa precisa ser feita manualmente. :::

---

Histórico de retornos

Todos os arquivos importados ficam registrados na tabela principal de retornos:

Coluna	Descrição
Data de envio	Data e hora do upload do arquivo
Nome do arquivo	Nome do arquivo importado
Banco	Banco ao qual o retorno pertence
Enviado por	Usuário do sistema que fez o upload
Ações	Links para Processar e dar baixa ou fazer Download do arquivo

Reprocessamento

Você pode acessar o link Processar e dar baixa nos boletos em um arquivo já processado para consultar os resultados novamente. Cobranças já baixadas não serão afetadas em uma segunda visualização.

---

Fluxo completo de retorno

flowchart TD
    A([Baixar arquivo de retorno no banco]) --> B[Acessar Financeiro → Retornos]
    B --> C[Clicar em Enviar novo arquivo]
    C --> D[Selecionar arquivo e conta]
    D --> E[Clicar em Enviar]
    E --> F[Arquivo aparece na lista]
    F --> G[Clicar em Processar e dar baixa]
    G --> H{Processar arquivo}
    H --> I[Liquidações: baixa automática nas cobranças]
    H --> J[Outros registros: confirmações e ocorrências]
    I --> K([Cobranças pagas baixadas no sistema])

    style A fill:#8724fb,stroke:#8724fb,color:#fff
    style K fill:#8724fb,stroke:#8724fb,color:#fff
    style B fill:#4ea1ff,stroke:#4ea1ff,color:#fff
    style C fill:#4ea1ff,stroke:#4ea1ff,color:#fff
    style D fill:#4ea1ff,stroke:#4ea1ff,color:#fff
    style E fill:#4ea1ff,stroke:#4ea1ff,color:#fff
    style F fill:#4ea1ff,stroke:#4ea1ff,color:#fff
    style G fill:#49d0e2,stroke:#49d0e2,color:#fff
    style H fill:#49d0e2,stroke:#49d0e2,color:#fff
    style I fill:#4ea1ff,stroke:#4ea1ff,color:#fff
    style J fill:#ff9a3d,stroke:#ff9a3d,color:#fff

---

Boas práticas

• Importe o arquivo de retorno regularmente (idealmente todo dia útil) para manter as baixas em dia.
• Após processar, verifique os itens com status Cobrança não localizada e avalie se alguma baixa manual é necessária.
• Acompanhe as tarifas bancárias pelo gráfico da tela de retornos para controlar os custos por boleto compensado.
• Se o volume de retornos manuais for alto, considere migrar para um gateway com retorno automático.