Central de Ajuda Quaza Provedores

Remessa & Retorno (CNAB) (PT)

Remessa & Retorno (CNAB) — Quaza

Remessa & Retorno — CNAB + OFX + Conciliação

Remessa e Retorno são os arquivos CNAB que falam com o banco — antes (Quaza envia boletos pra registrar) e depois (banco devolve baixas dos pagamentos). É o "transporte" entre o sistema e a infraestrutura bancária.

Antes do PIX, era a forma quase exclusiva de cobrança. Hoje continua essencial pra boletos tradicionais, débito automático e clientes corporativos que só pagam por TED. Cada banco tem seu layout CNAB — Itaú, Bradesco, Santander, Caixa, Sicredi.
Nesta wiki:

Visão geral — fluxo CNAB completo

┌──────────────────────────────────────────────────────────────────────┐ │ COBRANÇA gerada no Quaza (boleto/PIX/débito) │ └──────────────────────────────────────────────────────────────────────┘ ↓ Quaza monta arquivo ┌──────────────────────────────────────────────────────────────────────┐ │ ARQUIVO REMESSA (CNAB 240 ou 400) │ │ Linhas com: nosso número, valor, vencimento, cliente, instruções │ └──────────────────────────────────────────────────────────────────────┘ ↓ operador upload manual ou API ┌──────────────────────────────────────────────────────────────────────┐ │ BANCO recebe │ │ • Valida → registra boleto │ │ • Boleto fica "registrado" → cliente pode pagar │ │ • Devolve PROTOCOLO + status │ └──────────────────────────────────────────────────────────────────────┘ ↓ no dia seguinte ┌──────────────────────────────────────────────────────────────────────┐ │ CLIENTE PAGA o boleto (em qualquer banco) │ └──────────────────────────────────────────────────────────────────────┘ ↓ banco processa em lote ┌──────────────────────────────────────────────────────────────────────┐ │ ARQUIVO RETORNO (CNAB 240 ou 400) │ │ Linhas com: nosso número, valor pago, data, ocorrência (09=Pagamento)│ └──────────────────────────────────────────────────────────────────────┘ ↓ operador faz upload (ou API) ┌──────────────────────────────────────────────────────────────────────┐ │ QUAZA importa │ │ • Pra cada linha: localiza cobrança via "nosso número" │ │ • Marca como Paga + data + valor │ │ • Atualiza mensalidade/fatura em cascata │ └──────────────────────────────────────────────────────────────────────┘ ↓ extrato bancário (OFX) ┌──────────────────────────────────────────────────────────────────────┐ │ CONCILIAÇÃO (opcional) │ │ • Importa OFX do extrato │ │ • Compara movimentos com cobranças baixadas │ │ • Identifica TEDs/PIX sem boleto, taxas, diferenças │ └──────────────────────────────────────────────────────────────────────┘

Glossário

Termo Significado
CNAB Centro Nacional de Automação Bancária. Padrão FEBRABAN pra arquivos entre empresas e bancos
CNAB 240 Versão moderna do CNAB — 240 caracteres por linha. Mais detalhada, suporta PIX
CNAB 400 Versão antiga — 400 caracteres por linha. Ainda usada em alguns bancos (Itaú)
Remessa Arquivo ENVIADO pra banco — registra novos boletos, comanda baixas manuais
Retorno Arquivo RECEBIDO do banco — informa pagamentos, rejeições, devoluções
Nosso número ID único do boleto no banco — gerado quando emite, identifica retorno
Ocorrência Código de 2 dígitos no retorno (09=pago, 06=protestado, 21=erro endereço...)
OFX Open Financial Exchange. Formato padrão de extrato bancário (banco → empresa)
Conciliação Comparação entre o que o sistema espera receber × o que efetivamente entrou na conta
Débito Automático Banco debita conta do cliente — Quaza envia remessa de débito; banco devolve sucesso/recusa
Protocolo Resposta do banco confirmando recebimento do arquivo (não é baixa)
Lote Conjunto de cobranças/baixas em um único arquivo CNAB

Formatos suportados

Tipo Formato Onde Quaza usa
CNAB 240 (FEBRABAN) Texto, 240 chars/linha Remessa + Retorno na maioria dos bancos modernos
CNAB 400 (Bradesco/Itaú legado) Texto, 400 chars/linha Bancos com versão antiga
OFX 1.0/2.0 XML/SGML, extrato Importar extrato pra conciliação
API bancária (CNAB-less) JSON via HTTP Asaas, Iugu, bancos digitais — substitui CNAB
Tendência: bancos modernos (Nubank PJ, Inter, Asaas) usam API JSON ao invés de CNAB. Quaza suporta ambos. Pra novos bancos, prefira API — menos suscetível a erro de layout e processamento mais rápido.

1. Gerar Remessa

Caminho: Menu → Remessa

Gerar nova remessa

  1. 1Botão "Gerar Remessa" → seleciona banco/carteira
  2. 2Sistema busca cobranças pendentes de registro (estado "A registrar")
  3. 3Monta arquivo CNAB (240 ou 400 conforme banco)
  4. 4Operador baixa arquivo .REM e envia ao banco (via portal internet banking ou API)
  5. 5Banco confirma recebimento (protocolo)
  6. 6Banco processa boletos um por um — D+1 estão "registrados"

Remessa de Débito Automático

Cliente que autorizou débito em conta recebe o valor cobrado direto pela remessa. Não é boleto — é instrução ao banco "debita R$ X da conta Y".

Vantagem Desvantagem
Cliente não precisa fazer nada — automático Requer autorização prévia do cliente no banco
Reduz drasticamente inadimplência Se conta sem saldo, retorna "Insuficiente"
Baixa imediata no retorno Só funciona com banco do cliente = banco da carteira (mesma instituição)

2. Importar Retorno

Caminho: Menu → Retorno

Como funciona

  1. 1Banco gera arquivo .RET diário com pagamentos do dia
  2. 2Operador baixa do portal banco
  3. 3Upload no Quaza — "Importar Retorno" → seleciona arquivo
  4. 4Sistema processa cada linha:
    • Localiza cobrança via "nosso número"
    • Identifica ocorrência (09=pago, 06=protestado, etc.)
    • Marca cobrança como Paga + data + valor
    • Cascade: mensalidade/fatura também viram "Paga"

Códigos de ocorrência comuns

Código Significado
02 Entrada confirmada (boleto registrado)
03 Entrada rejeitada (erro no registro)
06 Liquidação (pago)
09 Baixa manual
17 Liquidação após baixa
21 Erro de endereço
02 + valor zero Confirmação sem pagamento ainda
Automatize: alguns bancos disponibilizam integração via API (Asaas, Iugu, Bradesco Hub) — Quaza puxa retorno automaticamente via webhook/polling. Sem upload manual diário.

3. Importar Extrato OFX

Caminho: Financeiro → Conciliação Bancária (OFX) ou Financeiro → Movimentação

Extrato bancário em formato padrão. Inclui todos os movimentos da conta: créditos (pagamentos recebidos), débitos (tarifas, pagamentos a fornecedores), TEDs/PIX entrantes.

Para que serve

  • Conciliação: comparar movimento OFX × cobrança que Quaza espera baixar
  • Pagamentos PIX/TED sem boleto: cliente paga via PIX sem identificar — Quaza encontra via OFX
  • Tarifas bancárias: registrar débitos de tarifas como despesa contábil
  • Análise de fluxo de caixa: ver entradas/saídas reais vs previstas
OFX × Retorno CNAB: são DIFERENTES. Retorno CNAB tem só cobranças do banco específico. OFX tem TUDO da conta. Use os dois — CNAB pra baixa rápida de boletos; OFX pra conferir o resto.

4. Conciliação Bancária

Caminho: Financeiro → Conciliação bancária

Fluxo

  1. 1Período: escolher mês ou range
  2. 2Sistema lista cobranças do período
  3. 3Compara com movimentos importados (CNAB + OFX)
  4. 4Mostra 3 grupos:
    • Conciliado — cobrança ↔ movimento batem
    • Sem cobrança — movimento existe (PIX/TED), cobrança não
    • Sem movimento — cobrança aberta, sem entrada na conta
  5. 5Operador resolve manualmente os "Sem cobrança" — pode atribuir cliente, criar lançamento manual
Por que conciliar? Cliente paga PIX direto na chave (sem boleto), mensagem do PIX é só "Pagamento Cliente Silva". Quaza não baixa automático. Conciliação OFX permite achar esse PIX e atribuir manualmente — 1 cliente menos inadimplente.

Pegadinhas frequentes

1. Arquivo CNAB rejeitado pelo banco — "Header inválido"
Configuração da Carteira tem dado errado (convênio, agência, conta). Banco devolve sem processar. Confira em Carteira os campos específicos do banco (cada um exige seus formatos).
2. Retorno baixou cobrança errada — valor batia mas era outro cliente
Cliente pagou boleto vencido (mesmo "nosso número" foi reutilizado). Sistema baixou no boleto novo, deixando o antigo aberto. Solução: rastrear por data, mover baixa manualmente. Configure "Bloquear reutilização nosso número".
3. OFX importado 2x — gerou duplicatas
Operador importou mesmo arquivo 2x no Quaza. Sistema permite isso se não detectar (depende de versão). Solução: cancelar movimentos duplicados manualmente; configurar verificação de hash do arquivo.
4. Banco mudou layout CNAB sem avisar
Versão atualizada do CNAB exige novos campos. Remessa começa a falhar. Solução: Quaza atualiza homologação periodicamente — abra chamado com Quaza Tecnologia pra ajustar.
5. Conciliação mostra "Sem movimento" em massa — provedor entrou em pânico
Esqueceu de importar retorno do dia. Antes de assumir inadimplência, importe os retornos pendentes. Se ainda assim sobrou, aí sim cliente não pagou.
6. PIX recebido aparece duplicado no extrato OFX
Banco às vezes lista cada PIX 2x (uma como "credito" outra como "transferência recebida"). Algorítmo Quaza tenta deduplicar mas nem sempre acerta — confira manualmente.
7. Débito automático recusado — cliente sem saldo
Retorno com ocorrência "Débito não efetuado - saldo insuficiente". Quaza marca cobrança como "Não baixada". Reenvio: configurar quantas tentativas (3 é padrão) antes de virar inadimplente normal.

Galeria de telas

Rem remessa
Rem remessa
Rem remessadebito
Rem remessadebito
Rem retornocnab
Rem retornocnab
Rem retornoitem
Rem retornoitem
Rem ofx
Rem ofx
Rem conciliacao
Rem conciliacao
Rem remessa
Rem remessa
Rem retorno
Rem retorno
Rem remdebito
Rem remdebito
Rem conciliacao
Rem conciliacao
Rem ofx
Rem ofx
Rem movimento
Rem movimento

Documentos relacionados

Aprofunde-se nos temas conexos:

FAQ

Posso ter remessa em mais de 1 banco?

Sim — cada Carteira = 1 banco. Cliente "A" tem boleto no Itaú, cliente "B" no Bradesco. Quaza gera 2 remessas separadas.

Banco demora 1-2 dias pra processar retorno — normal?

Sim — banco processa em lote, geralmente 1x/dia (madrugada). Pagamentos do dia X aparecem no retorno do dia X+1. Pra baixa instantânea: use PIX via gateway com webhook.

Esqueci de importar retorno por 1 semana — perdi algo?

Não — banco mantém arquivos disponíveis por 30-60 dias. Baixe todos os pendentes e importe um por um (ou em lote). Quaza processa retroativamente.

Como começar com novo banco?

1) Solicitar credenciais e layout CNAB ao banco. 2) Quaza homologa a integração (1-2 semanas). 3) Cadastrar Carteira com dados. 4) Gerar primeira remessa de teste com 1 boleto. 5) Validar retorno. 6) Liberar pra produção.

Posso editar arquivo CNAB antes de enviar?

Tecnicamente sim mas desaconselhado. Banco recusa qualquer alteração de formato. Se precisa ajustar valor/data, regenere a cobrança no Quaza e refaça a remessa.

Conciliação pode ser totalmente automática?

Para PIX/TED com identificação (CPF/CNPJ na descrição), sim — Quaza tenta casar automaticamente. Para movimentos genéricos ("Pagamento Cliente"), conferência manual é necessária.

OFX é confiável? Pode ter inconsistência?

Sim — alguns bancos OFX está ruim (campos vazios, datas erradas). Confira manualmente as primeiras importações de cada banco antes de confiar.