Central de Ajuda Quaza Provedores

Remessa e Retorno (CNAB) (PT)

Remessa e Retorno (CNAB)

A Remessa e o Retorno são a forma de o Quaza conversar com o banco por troca de arquivos, no padrão CNAB. Você gera no Quaza um arquivo de remessa (que registra seus boletos no banco em lote), envia esse arquivo no portal do seu banco e, depois, importa de volta no Quaza o arquivo de retorno que o banco devolve — é ele que dá baixa automática nos boletos pagos e mostra as ocorrências de cada título. Esta página é para quem cuida do financeiro do provedor: explica como gerar a remessa, como processar o retorno, o que significam as ocorrências mais comuns e o que fazer quando um boleto pago não baixa.

Nesta wiki:

Quando usar Remessa/Retorno (e quando NÃO)

A Remessa/Retorno é o caminho por arquivo: o Quaza não fala direto com o banco — você é o mensageiro que leva o arquivo de remessa ao portal do banco e traz de volta o arquivo de retorno. É o caminho usado pelos bancos que não oferecem integração direta. Quando o seu banco oferece Gateway bancário (integração direta, online), prefira o gateway: ele dispensa o vai e vem de arquivos e a baixa é praticamente instantânea.

Use Remessa/Retorno quando…	NÃO use quando…
Seu banco trabalha por troca de arquivos CNAB (remessa e retorno) e não oferece integração direta.	Seu banco oferece Gateway (integração direta) — nesse caso o gateway registra e baixa sozinho.
Você quer registrar vários boletos de uma vez (lote) em um único arquivo enviado ao banco.	Sua cobrança é só caixa local (recebimento em mãos, sem banco).
Você aceita conferir e enviar/importar os arquivos no ritmo do banco (manual, em geral diário).	Você precisa de baixa em tempo real, sem nenhuma etapa manual.

Remessa/Retorno x Gateway: os dois registram a cobrança no banco e confirmam o pagamento — a diferença é o meio. Remessa/Retorno = troca de arquivos (você envia e importa). Gateway = integração direta (online, quase instantâneo). Uma mesma carteira usa um ou outro, conforme o que o banco disponibiliza. Detalhes do gateway em Gateway bancário .

Passo a passo — da remessa à baixa pelo retorno

1	Gere os boletos dos clientes normalmente (pela Cobrança , faturas, mensalidades). Eles ficam "Em aberto" e ainda não foram informados ao banco.
2	Na tela de Remessa, clique em Gerar remessa. Escolha a carteira, o tipo (normalmente Entrada/Baixa), o período ou as datas e confirme. O Quaza monta o arquivo com todos os boletos em aberto daquele filtro.
3	Baixe o arquivo de remessa (clicando no nome do arquivo na lista) e envie no portal do seu banco, na área de cobrança/CNAB. A partir daí o banco passa a reconhecer esses boletos.
4	O cliente paga o boleto no banco dele, dentro do prazo.
5	O banco gera o arquivo de retorno (em geral diariamente) com a confirmação dos registros, os pagamentos e demais ocorrências. Baixe esse arquivo no portal do banco.
6	Na tela de Retorno, clique em Processar retorno e envie o arquivo que o banco devolveu. O Quaza lê cada linha, dá baixa nos boletos pagos e registra as ocorrências.
7	Confira os itens do retorno para tratar o que não baixou (rejeitados, não encontrados, valor diferente). O ciclo se repete: nova remessa, novo retorno.

Fluxo geral — do Quaza ao banco e de volta

O ciclo da Remessa/Retorno: o Quaza monta o arquivo de remessa, você o envia no portal do banco; o banco cobra e devolve o arquivo de retorno, que você importa de volta no Quaza para dar baixa automática nos boletos pagos.

Repare nas duas etapas manuais e externas (em amarelo): enviar a remessa e baixar o retorno acontecem no portal do banco, não dentro do Quaza. É isso que diferencia da integração direta (Gateway), onde o sistema faz tudo sozinho.

Glossário

Termo	O que é
CNAB	Padrão de arquivo usado pelos bancos brasileiros para trocar informações de cobrança. Os mais comuns são o CNAB 240 e o CNAB 400 (boletos) e o de débito em conta (150).
Remessa	O arquivo que o Quaza gera com seus boletos em lote para registrá-los no banco. Você o envia no portal do banco.
Retorno	O arquivo que o banco devolve, com a confirmação dos registros, os pagamentos e demais ocorrências de cada título. Você o importa de volta no Quaza.
Registro	O ato de o banco reconhecer o boleto a partir da remessa. Só um boleto registrado é cobrado e baixado corretamente pelo banco.
Baixa	O momento em que o boleto deixa de estar "Em aberto" e passa a "Pago" no Quaza. No retorno, acontece sozinha quando o banco confirma o pagamento.
Carteira	O cadastro do Quaza que representa sua conta no banco (agência, conta, convênio) e onde fica a configuração de cobrança. Os boletos são gerados ligados a uma carteira.
Nosso número	O identificador que o boleto tem dentro do banco. É por ele (ou pelo número do título) que o Quaza encontra, no retorno, qual boleto pagar.
Ocorrência	O código que o banco informa para cada título no retorno, dizendo o que aconteceu com ele (entrada confirmada, liquidação, rejeição, tarifa, etc.).
Liquidação	O termo bancário para "pagamento confirmado". É a ocorrência que faz o Quaza dar baixa no boleto.
Entrada rejeitada	Quando o banco recusa o registro de um boleto que veio na remessa (dado inválido, fora de padrão). O título não fica registrado e precisa ser corrigido e reenviado.
Tarifa / custo	Valor que o banco cobra por título ou por operação. Aparece no retorno como custo e o Quaza pode lançá-lo no caixa.
Débito em conta	Modalidade em que o banco debita a fatura direto da conta do cliente (em vez de boleto). Tem remessa e retorno próprios e usa o arquivo no padrão de débito.

Antes de começar — o que precisa estar pronto

Carteira de cobrançaFinanceiro → Carteiras de cobrança

É preciso ter uma carteira cadastrada com os dados bancários (banco, agência, conta, convênio/cedente, carteira) e uma configuração de cobrança do tipo Registrado (CNAB 240) — sem ser gateway. Sem isso, a tela de Remessa não lista nenhuma carteira para gerar.

Homologação do banco

Cada banco tem um processo de homologação (validação da remessa e do retorno) antes de operar de verdade. Procure na Central de ajuda o guia do seu banco (por exemplo "Homologação Sicoob — Remessa e Retorno", "Homologação Santander", "Homologação Itaú", "Homologação Banrisul", "Homologação Cresol").

Cidade do cliente é obrigatória. Ao gerar a remessa, o Quaza usa o endereço do cliente. Se um cliente estiver sem cidade preenchida, a geração para com um aviso indicando o nome do cliente. Corrija o cadastro e gere de novo.

Gerar a remessa

Onde ficaFinanceiro → Remessa

A tela "Listar remessas" mostra o histórico de remessas geradas, filtrado por carteira. Use o botão Gerar remessa para criar uma nova.

A lista traz, para cada remessa: a sequência (número da remessa naquela carteira), o arquivo (clique para baixar), o tipo de remessa, a data de geração, a quantidade de títulos, o valor total, a carteira e o criador.

Linhas em vermelho são remessas com mais de um dia que ainda não têm nenhum retorno vinculado. Isso pode indicar que a remessa não chegou a ser enviada ao banco (ou que o retorno correspondente ainda não foi processado). Confira no portal do banco.

O que escolher ao gerar

Ao clicar em Gerar remessa, o Quaza abre uma janela com estas opções:

Campo	O que escolher
Remessa (tipo)	O tipo de movimento. Entrada/Baixa é o uso normal (registra os boletos novos e, quando a carteira pede, também envia as baixas de títulos pagos manualmente ou removidos). Veja os tipos abaixo.
Data	Por período (escolhe Ano e Mês) ou Por data (escolhe data inicial e final). Define a faixa de vencimento dos boletos que entram na remessa.
Ano / Mês	Quando o tipo de data é "Por período": o mês/ano de vencimento dos boletos a incluir.
Data inicial / Data final	Quando o tipo de data é "Por data": a faixa de vencimento. A data inicial não pode ser maior que a final.
Carteira	A carteira (conta no banco) cujos boletos serão enviados.
Cliente	Opcional: gera a remessa de um único cliente. Útil para reenviar um boleto específico (disponível conforme a permissão do usuário).

Tipos de remessa

Tipo	Quando usar
Entrada	Só registra os boletos novos (em aberto) no banco.
Entrada/Baixa	O uso mais comum: registra os boletos novos e, se a carteira estiver configurada para baixar título, envia também as baixas de títulos que foram pagos por fora ou removidos.
Alteração de juros	Envia ao banco a alteração dos juros de títulos já registrados. Disponível conforme o banco.
Alteração de vencimento	Envia ao banco a prorrogação de vencimento de títulos já registrados. Disponível conforme o banco e a permissão do usuário.
Cancelamento de protesto	Envia ao banco a sustação/cancelamento de protesto de títulos já registrados. Disponível conforme o banco.

Os tipos de alteração e cancelamento só aparecem para os bancos que suportam aquela instrução. Para o uso do dia a dia, deixe em Entrada/Baixa.

Depois de confirmar, o Quaza abre o arquivo gerado para download e a nova remessa aparece no topo da lista. Baixe o arquivo (pelo nome dele na coluna Arquivo) e envie no portal do seu banco.

Desfazer a última remessa

Se você gerou uma remessa por engano e ainda não enviou ao banco, use o botão Desfazer última remessa. Ele remove a remessa, devolve os títulos para "sem remessa" e reverte a numeração de sequência.

Não dá para desfazer uma remessa que já foi enviada ao banco. Se já houver retorno vinculado àqueles títulos, o Quaza bloqueia a operação — desfazer nesse ponto deixaria o sistema fora de sincronia com o banco. (Esse botão depende de permissão; pode não aparecer para todos os usuários.)

Processar o retorno

Onde ficaFinanceiro → Retorno

A tela "Listar retornos" mostra o histórico de retornos importados. Use o botão Processar retorno para enviar um arquivo novo que o banco devolveu.

A lista traz, para cada retorno: o arquivo (clique para baixar), o estado, o tipo (240 - Boleto, 400 - Boleto ou 150 - Débito), se gera nota, a quantidade de itens, o valor, os juros, o custo, a data de criação e o criador. A lupa à esquerda abre os itens daquele retorno.

O que escolher ao processar

Campo	O que escolher
Retorno (arquivo)	Selecione o arquivo de retorno que você baixou no portal do banco.
Simulado	Não processa de verdade (dá as baixas). Sim apenas simula: o Quaza lê o arquivo e mostra o que faria, sem dar baixa. Útil para conferir antes.
Gerar Nota	Quando Sim, gera as notas fiscais vinculadas aos títulos liquidados (conforme a configuração fiscal do provedor). Deixe como vier configurado se não tiver certeza.

Há dois botões para confirmar:

Botão	O que faz
Processar e aguardar	Processa na hora e você acompanha o resultado na própria tela. Indicado para arquivos menores — é preciso aguardar o fim do processo.
Processar em 2º plano	Processa em segundo plano e envia uma notificação ao terminar. Indicado para arquivos grandes (muitos títulos), para não travar a tela.

Estado de cada retorno

Estado	Significado	O que fazer
Processando	O retorno está sendo lido (em geral, processamento em 2º plano).	Aguarde. O Quaza não deixa processar dois retornos ao mesmo tempo.
Finalizado	O retorno foi lido até o fim e os itens foram registrados.	Confira os itens para tratar o que não baixou.
Falhado	Algo impediu a leitura (arquivo inválido ou erro no processamento).	Confira o arquivo. Retornos não finalizados podem ser reprocessados pela tela.

No detalhe de um retorno que não foi finalizado, há a opção de reprocessar: o Quaza tenta ler o arquivo de novo em segundo plano e avisa ao terminar. Retornos já finalizados não são reprocessados.

Se o provedor exigir conferência de sequência, o Quaza só aceita o retorno se o anterior na sequência já tiver sido processado — assim você não pula nem repete arquivos. Se aparecer "o retorno não está na sequência esperada", verifique se há um retorno anterior ainda não importado.

Acompanhar os itens do retorno

Onde ficaFinanceiro → Retorno → (lupa de um retorno)

A tela "Listar itens do retorno" mostra cada título que veio no arquivo, com a ocorrência do banco e a mensagem do Quaza sobre o que aconteceu. É aqui que você trata o que não baixou.

Cada linha traz: o financeiro (com link para o título), o cliente, o nosso número, o vencimento, a data de pagamento, o valor pago, os juros, o custo, a operação e a ocorrência informadas pelo banco, e a mensagem do Quaza.

Cor da linha	O que significa
Sem cor	Item tratado normalmente (em geral, pagamento efetuado).
Amarelo	Alerta: o título já estava pago antes deste retorno (pagamento anterior). Só confira se não houve duplicidade.
Vermelho	Precisa de atenção: não baixou (rejeitado, não encontrado, conta não encontrada, insuficiência de fundos, não foi liquidado). Trate caso a caso.

A tela tem uma Listagem com filtros prontos. Use a opção que mostra só os erros para ir direto aos itens que precisam de atenção, sem percorrer os que baixaram normalmente.

Ocorrências e mensagens mais comuns

O banco informa uma ocorrência (o que houve com o título). O Quaza traduz isso em uma mensagem (o que ele fez ou por que não baixou). As mais comuns:

Ocorrências do banco

Operação	O que o banco está dizendo	Efeito no Quaza
2	Entrada confirmada — o boleto foi registrado.	Confirma o registro; não dá baixa.
3	Entrada rejeitada — o banco recusou o registro.	Não baixa; se não estava registrado, o título sai da remessa para poder ser corrigido e reenviado.
6	Liquidação — o boleto foi pago.	Dá baixa no título (marca como pago).
9	Baixa de título — o banco baixou o boleto.	Registra a baixa; não marca como pago automaticamente.
17	Liquidação após baixa ou de título não registrado — pagamento confirmado.	Dá baixa no título (marca como pago).
28	Débito de tarifas/custas.	Registra o custo cobrado pelo banco; não dá baixa.

Os arquivos de retorno trazem dezenas de outras ocorrências (alteração de vencimento confirmada, instrução rejeitada, despesas de protesto, etc.). Todas aparecem na coluna Operação do item; as que importam para o seu dia a dia são as de pagamento (6, 17) e as de rejeição (3).

Mensagens do Quaza

Mensagem	O que significa / o que fazer
Pagamento efetuado	Tudo certo: o título foi baixado.
Financeiro anteriormente pago	O título já estava pago antes do retorno. Confira só se não houve cobrança em duplicidade.
Financeiro rejeitado	O banco rejeitou a entrada do boleto. Verifique os dados do título/cliente, gere nova remessa e reenvie.
Financeiro não encontrado	O Quaza não achou no sistema o título do arquivo (nosso número/número divergente, título de outra base). Confira se o retorno é da carteira certa.
Financeiro está removido	O título existia mas foi removido. Em geral não há ação; só investigue se esperava que estivesse ativo.
Valor original do sistema diferente do retorno	O valor pago veio diferente do valor do título (pagamento parcial/a maior, juros). O Quaza baixa, mas vale conferir.
Retorno com valor zerado	A linha veio sem valor de pagamento. O título não é baixado por essa linha.
Insuficiência de fundos	Específico de débito em conta: o banco não conseguiu debitar a conta do cliente. O título não é baixado.
Conta não encontrada	Específico de débito em conta: o Quaza não achou a conta/contrato do cliente para o débito. Atualize os dados bancários do cliente.
SIMULAÇÃO	O retorno foi processado em modo simulado. Nada foi baixado de verdade — reprocesse com Simulado = Não para efetivar.

Tarefas automáticas

O grosso do trabalho da Remessa/Retorno é manual: você gera a remessa, envia ao banco, baixa o retorno e o processa. Há, porém, uma tarefa que atua quando você manda processar um retorno em segundo plano.

Tarefa	O que faz
Financeiro - Processar retorno	Lê o arquivo de retorno em segundo plano (quando você escolhe "Processar em 2º plano" ou reprocessa um retorno), dá as baixas e envia uma notificação ao terminar.

Quem liga e desliga as tarefas é o administrador do sistema (sysadmin), pela agenda do servidor. A tela Admin → Tarefas apenas mostra o histórico de execução (quando rodou, se concluiu ou falhou) — ela não inicia nem programa as tarefas.

Não há tarefa que gere a remessa sozinha nem que importe o retorno sozinho. Diferente do Gateway (que baixa automático), na Remessa/Retorno o envio da remessa e a importação do retorno dependem de você fazer o vai e vem dos arquivos com o portal do banco.

Pegadinhas frequentes

Gerar a remessa e esquecer de enviar ao banco. Gerar o arquivo no Quaza não registra nada — o banco só conhece os boletos depois que você envia a remessa no portal dele. Boletos não enviados não são reconhecidos e o pagamento pode não voltar no retorno. Remessas sem retorno aparecem em vermelho na lista.

Pular um arquivo de retorno. Quando a conferência de sequência está ligada, importar fora de ordem é bloqueado. Importe os retornos na ordem em que o banco os gerou.

Processar o retorno em modo Simulado e achar que baixou. Em Simulado nada é baixado de verdade — os itens vêm com a mensagem "SIMULAÇÃO". Para efetivar, reprocesse com Simulado = Não.

Importar o retorno na carteira errada. Se o arquivo for de outra conta/carteira, o Quaza não acha os títulos e marca tudo como "Financeiro não encontrado". Baixe no portal do banco o retorno da carteira certa.

Tentar desfazer uma remessa já enviada. Se já há retorno vinculado, desfazer é bloqueado — desincronizaria o Quaza do banco. Trate os títulos individualmente em vez de desfazer.

Cliente sem cidade no cadastro. A remessa precisa do endereço completo. Um cliente sem cidade interrompe a geração com um aviso pelo nome dele; corrija e gere de novo.

Confundir baixa por retorno com pagamento manual. Se você baixou um boleto na mão e depois o retorno traz o mesmo pagamento, o item vem como "Financeiro anteriormente pago" (amarelo) — é só conferência, não é erro.

Achar que a tela de Tarefas liga a automação. Ela só mostra o histórico. E na Remessa/Retorno o envio e a importação são sempre manuais — não há tarefa que faça o vai e vem dos arquivos sozinha.

Esquecer da homologação do banco. Antes de operar de verdade, cada banco exige homologar remessa e retorno. Siga o guia do seu banco na Central de ajuda.

Perguntas frequentes

Qual a diferença entre Remessa/Retorno e Gateway?

Os dois registram a cobrança no banco e confirmam o pagamento. A Remessa/Retorno faz por troca de arquivos: o Quaza gera a remessa, você envia no portal do banco e importa o retorno depois. O Gateway faz por integração direta (online, quase instantâneo, com baixa automática). Use o Gateway quando o banco oferecer; veja Gateway bancário .

Onde envio a remessa e de onde baixo o retorno?

No portal do seu banco (internet banking ou portal de cobrança/CNAB), não dentro do Quaza. O Quaza só gera o arquivo de remessa e importa o arquivo de retorno. O caminho exato no portal varia por banco — veja o guia de homologação do seu banco na Central de ajuda.

Com que frequência preciso fazer isso?

Depende da sua operação. Em geral gera-se a remessa quando há boletos novos a registrar e importa-se o retorno diariamente (a maioria dos bancos gera um retorno por dia). Combine a rotina com o seu banco.

Gerei a remessa por engano. Como desfaço?

Se ainda não enviou ao banco, use "Desfazer última remessa" na tela de Remessa — ele devolve os títulos e reverte a numeração. Se a remessa já tem retorno vinculado (já foi ao banco), o Quaza bloqueia o desfazer; trate os títulos individualmente.

O cliente pagou mas o boleto continua "Em aberto". O que faço?

A baixa só acontece quando o retorno daquele pagamento é importado. Confirme se o retorno do dia já foi baixado no portal do banco e processado no Quaza. Depois confira nos itens do retorno se aquele título não veio com alguma ocorrência de rejeição ou "não encontrado".

O que significa um item em vermelho?

É um item que não baixou e precisa de atenção: rejeitado, não encontrado, conta não encontrada, insuficiência de fundos ou não liquidado. Abra a Listagem "só erros" nos itens do retorno e trate cada um pela mensagem.

E um item em amarelo?

É um alerta de que o título já estava pago antes deste retorno ("Financeiro anteriormente pago"). Em geral é só conferência — confirme que não houve cobrança/pagamento em duplicidade.

Posso conferir o retorno antes de baixar de verdade?

Sim. Processe com Simulado = Sim: o Quaza lê o arquivo e mostra o que faria, sem dar nenhuma baixa (os itens vêm com "SIMULAÇÃO"). Depois, reprocesse com Simulado = Não para efetivar.

O valor pago veio diferente do valor do boleto. Por quê?

Pode ser juros/multa por atraso, desconto ou pagamento parcial. O Quaza baixa o título e marca a mensagem "Valor original do sistema diferente do retorno" para você conferir. Os juros e o custo aparecem em colunas próprias nos itens do retorno.

Posso processar dois retornos ao mesmo tempo?

Não. O Quaza não deixa processar um novo retorno enquanto outro ainda está "Processando" no mesmo dia. Aguarde o anterior finalizar.

Um retorno ficou "Falhado". E agora?

Confira se o arquivo é o de retorno correto do seu banco/carteira. Retornos não finalizados podem ser reprocessados pelo detalhe do retorno — o Quaza tenta lê-lo de novo em segundo plano e avisa ao terminar.

Remessa/Retorno serve para débito automático em conta?

Sim. O débito em conta tem remessa e retorno próprios (arquivo no padrão de débito). O retorno traz a confirmação do débito ou a recusa (por exemplo, insuficiência de fundos), e o Quaza trata as autorizações/desautorizações de débito do cliente.

A remessa registra boleto e PIX?

A remessa CNAB registra boletos (e o boleto pode ter PIX embutido conforme a carteira). PIX dinâmico puro e cartão são feitos por integração direta — veja Gateway bancário .

Documentos relacionados

Gateway bancário — o outro caminho para falar com o banco, por integração direta (online), sem troca de arquivos.
Cobrança — como o boleto é gerado e cobrado do cliente antes de entrar na remessa.
Recebimentos e pagamentos — conferência e baixa manual de títulos.
Histórico financeiro — onde acompanhar baixas, pagamentos e movimentações.
Fatura — o documento mensal que agrupa os débitos e gera os boletos.