Central de Ajuda Quaza Provedores

Cobrança (PT)

Cobrança — Quaza

Cobrança — geração e gestão das cobranças do provedor (boleto, PIX, carnê e débito em conta)

Esta página cobre a tela Cobranças do Quaza de ponta a ponta: o que é uma cobrança, como ela nasce a partir de uma mensalidade ou parcela, como enviar ao cliente, como ela é dada como paga (baixa), o que fazer quando o cliente não paga e como reabrir, renegociar ou remover. Voltada para quem opera o financeiro do provedor de internet — atendentes, financeiro e quem está começando agora.

Resumo em uma linha: a cobrança é o documento que o cliente paga (um boleto, um PIX ou uma parcela do carnê). Cada cobrança tem um vencimento, um valor e um estado (Aberto → Pago, ou Baixado). Ela nasce de uma mensalidade/parcela e é gerada conforme a carteira de cobrança escolhida, que define o meio (boleto/PIX/cartão/carnê) e o banco.

Nesta página:

Quando usar (e quando NÃO usar)

A tela Cobranças é onde você consulta, envia, reemite e acompanha tudo que o cliente tem a pagar. Use-a quando precisar achar um boleto, mandar a 2ª via, conferir se uma cobrança foi paga ou tratar um inadimplente.

Use a tela Cobranças quando…	NÃO é aqui — vá para…
Reemitir um boleto / pegar a 2ª via	—
Enviar a cobrança por e-mail ou WhatsApp	—
Conferir se um boleto/PIX foi pago	—
Reabrir uma cobrança baixada por engano	—
Configurar quais bancos/meios o provedor usa	Regras de cobrança / Carteira de cobrança
Conectar uma maquininha/gateway de pagamento	Gateway bancário
Imprimir o carnê do ano inteiro de um cliente	Carnê
Parcelar uma dívida vencida do cliente	Renegociação
Entender o agrupamento que origina a cobrança	Fatura

Passo a passo — da mensalidade ao recebimento

Passo	Ação	Onde
1	Tenha uma carteira de cobrança configurada (qual banco, qual meio — boleto, PIX, carnê). Sem ela o sistema não consegue gerar a cobrança.	Financeiro → Carteira de cobrança
2	A mensalidade ou parcela vira cobrança. Isso acontece sozinho (tarefa diária) quando chega perto do vencimento, ou você gera na hora pela tela do cliente.	automático OU pela tela do cliente
3	Confira a cobrança na listagem — valor, vencimento, meio de pagamento e estado Aberto.	Financeiro → Cobranças
4	Envie ao cliente. Abra a cobrança e clique Enviar (e-mail / WhatsApp) ou Imprimir financeiro para a 2ª via.	Cobranças → abrir → Enviar
5	O cliente paga. Banco/PIX/gateway devolve o pagamento e a cobrança vira Paga automaticamente (baixa de retorno).	automático
6	Confirme o recebimento. Use os marcadores Pagos / Atrasados da listagem para acompanhar quem pagou e quem não pagou.	Financeiro → Cobranças

Ciclo de vida da cobrança

Ciclo de vida da cobrança — do nascimento ao recebimento (raias: Você · Quaza · Banco/Cliente). Abaixo da linha pontilhada: o que acontece quando o cliente não paga.

Leia o diagrama assim: a cobrança nasce Aberta, é enviada ao cliente, ele paga e ela vira Paga pela baixa de retorno do banco. Se não pagar, fica vencida (continua Aberta, mas em atraso) até você reemitir, baixar manualmente ou renegociar.

Glossário

Termo	O que é
Cobrança	O documento que o cliente paga (boleto, PIX ou parcela do carnê). Tem vencimento, valor e estado próprios. Uma cobrança pode reunir uma ou mais mensalidades/parcelas.
Boleto	Forma de cobrança bancária com linha digitável e código de barras. O cliente paga em qualquer banco, lotérica ou app até (ou após) o vencimento.
PIX	Pagamento instantâneo brasileiro. No boleto híbrido aparece um QR Code PIX; o cliente lê e paga na hora. A baixa é quase imediata.
Carnê	Bloco de várias cobranças do mesmo cliente impressas juntas (uma por mês), entregue de uma vez. Cada folha é uma cobrança individual com seu vencimento.
Carteira de cobrança	A configuração que define como a cobrança é emitida: qual banco, qual meio (boleto/PIX/cartão/carnê), multa, juros e desconto. Aparece na coluna Forma de pagamento da listagem.
Nosso número	O identificador da cobrança junto ao banco. Aparece no boleto e é o que o banco usa para casar o pagamento com a cobrança certa.
Linha digitável	A sequência de números do boleto que o cliente digita no app do banco para pagar.
CNAB	Padrão de arquivo que o sistema troca com o banco: a remessa registra as cobranças no banco e o retorno informa quais foram pagas. É o que permite a baixa automática em bancos sem gateway.
Remessa / Retorno	Remessa é o arquivo que você envia ao banco com as cobranças a registrar. Retorno é o arquivo que o banco devolve dizendo o que foi pago, e que o sistema lê para baixar.
Gateway	Serviço online (Asaas, Mercado Pago, Sicredi, Banco do Brasil, etc.) que registra a cobrança e avisa o pagamento automaticamente, sem precisar de arquivo de retorno.
Baixa	O ato de marcar a cobrança como resolvida. Baixa de pagamento = o cliente pagou (estado Pago). Baixa sem pagamento = a cobrança foi cancelada/substituída (estado Baixado).
Aberto	Estado da cobrança que ainda não foi paga nem cancelada. Se passou do vencimento, fica destacada como vencida/atrasada.
Inadimplência	Situação do cliente com cobranças vencidas e não pagas. É o gatilho para aviso de vencimento, renegociação e, em alguns provedores, bloqueio.
Renegociação	Acordo que junta cobranças vencidas em um novo parcelamento, com novas datas e valores. As cobranças antigas são baixadas e nascem as novas.
Valor atualizado	O valor da cobrança hoje, já com multa e juros de atraso aplicados (quando vencida). O valor original é o que valia no vencimento.
2ª via	Reemissão do boleto de uma cobrança ainda em aberto, normalmente com o vencimento atualizado para o cliente conseguir pagar.

Configuração / pré-requisitos

Para uma cobrança ser gerada e paga, três coisas precisam estar prontas antes. Se o passo a passo travar logo no início, é quase sempre porque falta um destes itens.

Carteira de cobrançaFinanceiro → Carteira de cobrança

Define o banco e o meio de pagamento (boleto, PIX, cartão, carnê ou débito em conta), além das regras de multa, juros e desconto. Sem uma carteira habilitada, nenhuma cobrança é gerada. Veja os detalhes em Regras de cobrança .

Gateway ou conta no bancoFinanceiro → Gateway bancário

Se a carteira usa um gateway (Asaas, Mercado Pago, Sicredi, Banco do Brasil, etc.), as credenciais precisam estar configuradas e válidas. Se usa boleto registrado por arquivo, a sequência de remessa/retorno tem que estar ativa. Veja Gateway bancário .

Modelo de mensagem para envioComunicação → Modelos

O botão Enviar usa um modelo de e-mail (e, se houver, de WhatsApp) para mandar a cobrança. Sem modelo configurado, o envio falha avisando que o modelo não foi definido.

Cliente sem e-mail nem WhatsApp: o envio por e-mail exige um endereço cadastrado no cliente. Se faltar, o sistema avisa “cliente não possui e-mails cadastrados”. Cadastre o contato ou use a 2ª via impressa.

Tela de Cobranças — listagem e detalhe

O módulo tem duas telas que trabalham juntas: a listagem com todas as cobranças (filtráveis) e o detalhe de cada uma. Da listagem você abre o detalhe clicando no lápis (1ª coluna); volta pelo botão Voltar.

Listagem

Financeiro → Cobranças

Lista todas as cobranças do provedor. No topo há os marcadores rápidos Padrão, Abertos, Atrasados, Pagos e Baixados — um clique já filtra a lista. Linhas vencidas aparecem em vermelho, pagas em azul e baixadas em cinza.

Listagem de cobranças. (1) aba FILTROS para refinar a busca; (2) campo de pesquisa rápida (busca por nosso número ou cliente). Logo abaixo os marcadores Padrão / Abertos / Atrasados / Pagos / Baixados. Linhas em rosa são cobranças vencidas em aberto.

Coluna	O que mostra
Código	Lápis para abrir o detalhe da cobrança.
Nosso número	Identificador da cobrança no banco (o que vai no boleto).
Forma de pagamento	A carteira de cobrança usada (define banco e meio).
Estado	Aberto, Pago ou Baixado (ver Estados ).
Cliente	O cliente do provedor. É link: abre o cadastro em nova aba.
Vencimento	Data limite para pagamento sem multa/juros.
Valor original	Valor no vencimento, sem acréscimos.
Valor atualizado	Valor hoje, já com multa e juros se estiver vencida.
Pagamento	Data em que foi paga (vazio se ainda aberta).
Empresa	A empresa do provedor que emitiu a cobrança.

Botão Ações (canto superior direito): marque várias cobranças com a caixinha da 1ª coluna e use Imprimir boletos (gera o carnê em lote), Enviar boletos (e-mail/WhatsApp em massa), Desvincular remessas ou Remover financeiros.

Detalhe da cobrança

Financeiro → Cobranças → [lápis na 1ª coluna]

Mostra todos os dados da cobrança (em modo leitura) e, à direita, os botões de ação. No topo aparece o estado atual (badge verde “Aberto”, azul “Pago” ou vermelho “Baixado”). A aba Histórico registra tudo que aconteceu com a cobrança (geração, envios, baixa, reabertura).

Detalhe de uma cobrança Aberta. (1) Forma de pagamento (carteira); (2) Vencimento; (3) Valor original; (4) Código de barras e (5) Linha digitável do boleto. Abaixo, o campo Descrição (editável enquanto Aberta) e os dados de criação/alteração.

Campo	O que é
Cliente / Contrato	Quem deve e a qual contrato a cobrança pertence.
Forma de pagamento	A carteira de cobrança (banco + meio).
Número / Nosso número	Número interno e o identificador no banco.
Vencimento / Valor original	Data limite e valor sem acréscimos.
Pagamento / Valor pago	Quando e quanto foi pago (preenchidos após a baixa).
Código de barras / Linha digitável	Dados do boleto para o cliente pagar.
Gateway PIX	Quando há PIX, traz o código “copia e cola” e o botão que abre o QR Code.
Descrição	Texto que aparece para o cliente (ex.: “Mensalidade referente a Junho/2026”). Editável enquanto a cobrança está Aberta.

Estados da cobrança

Estado	O que significa	Próxima ação possível
Aberto	Cobrança gerada e ainda não paga. Se passou do vencimento, fica destacada como vencida/atrasada (em vermelho na lista).	Enviar, reemitir 2ª via, alterar vencimento, aguardar pagamento.
Pago	O pagamento foi recebido (pelo retorno do banco, pelo gateway ou baixa manual). Tem data e valor pagos.	Estado final em condições normais. Em casos especiais, estornar pelo financeiro.
Baixado	Cobrança encerrada sem pagamento — foi cancelada, substituída (por renegociação ou nova geração) ou baixada manualmente.	Reabrir cobrança (se o débito ainda estiver em aberto e você tiver permissão).

“Vencida” não é um estado à parte: uma cobrança vencida continua Aberta — o sistema só a destaca em vermelho e soma multa/juros no valor atualizado. Ela só sai de Aberto quando é paga (vira Paga) ou baixada (vira Baixado).

Ações da cobrança

No detalhe da cobrança, o painel à direita mostra os botões disponíveis. Nem todos aparecem sempre — cada um depende do estado da cobrança, do meio de pagamento e da sua permissão.

#	Botão	Quando aparece	O que faz
1	Enviar	Cobrança não baixada	Abre as opções de envio ao cliente: e-mail, WhatsApp ou SMS.
2	Imprimir financeiro	Cobrança não baixada	Gera o boleto/carnê em PDF (2ª via). Se a cobrança está vencida e o provedor permite, pede uma nova data antes de imprimir.
3	Ver cliente	Sempre	Abre o cadastro do cliente em nova aba.
4	Ver débito	Sempre	Abre a mensalidade/parcela (débito) que originou a cobrança. Se for mais de uma, mostra a lista.
5	Verificar gateway	Carteira com gateway e cobrança com integração ativa	Consulta o gateway para conferir o status da cobrança e o pagamento na hora.
6	Alterar vencimento	Cobrança Aberta, sem gateway, com permissão	Muda a data de vencimento da cobrança.
7	Reabrir cobrança	Cobrança Baixada (sem gateway), com débito ainda em aberto e permissão	Volta a cobrança para Aberto. Pede uma observação e registra no histórico.
8	Desvincular remessa	Débito em conta em aberto, com permissão	Solta a cobrança do arquivo de remessa para reenviá-la ao banco.

Cor dos botões: verde = ação segura (enviar); azul = informativo (imprimir); cinza = consulta (ver cliente, ver débito); vermelho/laranja = ação delicada (verificar gateway, reabrir, desvincular). Para apagar a cobrança use Remover no rodapé do formulário (só com permissão e enquanto Aberta).

Meios de pagamento

O meio é definido pela carteira de cobrança. Um mesmo provedor pode ter várias carteiras (um banco só boleto, outro com PIX, um carnê local). Os meios disponíveis:

Meio	Como funciona	Baixa
Boleto	Cobrança bancária com linha digitável e código de barras. Pago em qualquer banco/app.	Por retorno do banco (arquivo) ou gateway.
Boleto/PIX	Boleto híbrido: traz também um QR Code PIX. O cliente escolhe como pagar.	PIX dá baixa quase imediata; boleto pelo retorno.
PIX	Só QR Code / copia e cola, sem boleto. Pagamento instantâneo.	Gateway PIX avisa o pagamento na hora.
Cartão	Cobrança paga por cartão via gateway (quando o provedor oferece).	Gateway confirma a transação.
Carnê (Local)	Cobrança sem registro em banco, paga direto no provedor (caixa) ou em bloco impresso (carnê).	Baixa manual no caixa do provedor.
Débito em conta	O valor é debitado direto da conta do cliente via arquivo de remessa do banco.	Por retorno do banco.

Dica: a cobrança guarda o meio que tinha quando foi gerada. Trocar a carteira depois só afeta as próximas cobranças — as antigas continuam com o meio original.

Tarefas automáticas

Boa parte do ciclo da cobrança roda sozinha, por tarefas que o sistema executa em horários definidos. As principais que tocam a cobrança:

Tarefa	O que faz
Aviso de vencimento	Envia lembrete ao cliente antes/depois do vencimento (antecipado, no dia, vencido).
Criar segunda via	Reemite a 2ª via de cobranças vencidas, atualizando o vencimento.
Criar entrada sequencia / Processar sequencia	Gera as cobranças do período conforme a sequência configurada na carteira.
Criar boleto cliente / Criar boleto PDF	Prepara o PDF do boleto para envio e para o portal do cliente.
Processar retorno	Lê o arquivo de retorno do banco e dá baixa automática nas cobranças pagas.
Processar carnê / Envio carnê PDF	Monta e envia o carnê em PDF aos clientes.
Alerta fim carnê	Avisa quando o carnê do cliente está chegando ao fim, para gerar o próximo.
Atualiza valor	Recalcula o valor atualizado das cobranças vencidas (multa + juros).
Gateway / Remessa gateway	Registra cobranças no gateway e consulta pagamentos para dar baixa.
Documento recorrente	Gera as cobranças recorrentes (assinaturas) automaticamente.
Protesto	Prepara o envio de cobranças vencidas para protesto (quando o provedor usa).
E-mail sem boleto	Avisa clientes que ficaram sem boleto gerado no período.

Quem liga ou desliga essas tarefas é o administrador do servidor (na agenda de tarefas do servidor, a crontab). A tela Admin → Tarefas apenas informa o status — o operador não liga/desliga por ali.

Inadimplência e renegociação

Quando uma cobrança vence e não é paga, o cliente fica inadimplente. O sistema continua mostrando a cobrança como Aberta, porém vencida (vermelha na lista), e soma multa e juros no valor atualizado.

O que você pode fazer com uma cobrança vencida:

Reemitir a 2ª via com novo vencimento (botão Imprimir financeiro ou a tarefa de segunda via).
Reenviar por e-mail/WhatsApp com lembrete de atraso.
Renegociar: juntar várias cobranças vencidas em um novo parcelamento. As antigas são baixadas e nascem as novas. Veja Renegociação .
Baixar manualmente quando a cobrança foi cancelada/substituída (vira Baixado).

Atenção: baixar uma cobrança (estado Baixado) não registra recebimento — ela some das pendências mas o valor não entra no caixa. Para registrar que o cliente pagou, o correto é a baixa de pagamento (vira Paga), não a baixa simples.

Quando dá errado

Sintoma	Causa provável	O que fazer
Cobrança não foi gerada	Carteira de cobrança desabilitada, ou nenhuma carteira definida no contrato.	Habilite a carteira em Financeiro → Carteira de cobrança e confirme a carteira do contrato.
“Problema com servidor do banco, cobrança não gerada”	Gateway fora do ar ou credencial inválida.	Verifique as credenciais em Gateway bancário e tente novamente.
“Limite de cobranças mensais em aberto atingido”	A carteira tem um teto de cobranças abertas por mês para o cliente.	Aguarde a baixa das existentes ou ajuste o limite na carteira.
Pagou mas continua Aberto	O retorno do banco ainda não foi processado, ou o gateway não sincronizou.	Aguarde a tarefa de retorno/gateway, ou clique Verificar gateway no detalhe.
Envio de e-mail falhou	Cliente sem e-mail, ou modelo de mensagem não configurado.	Cadastre o e-mail do cliente e confirme o modelo em Comunicação → Modelos.
Não consigo reabrir a cobrança	Cobrança tem gateway, ou o débito já foi pago/fechado, ou falta permissão.	Reabertura só vale para cobrança sem gateway, com débito em aberto e permissão de reabrir.
Não aparece “Alterar vencimento”	A cobrança tem gateway, não está Aberta, ou falta permissão.	Só cobranças Abertas sem gateway permitem mudar o vencimento.

Pegadinhas frequentes

1. Cobrança vencida continua “Aberta”. Não existe estado “Vencido”. A cobrança vencida segue Aberta, só aparece em vermelho. Não procure por um estado separado.

2. Baixar ≠ receber. O estado Baixado encerra a cobrança sem dinheiro entrando. Para registrar pagamento, a cobrança tem que virar Paga. Baixar por engano some com a pendência mas não lança o recebimento.

3. Reabrir nem sempre aparece. O botão “Reabrir cobrança” só existe quando a cobrança foi baixada manualmente (sem gateway), o débito ainda está em aberto e você tem a permissão. Cobrança com gateway ou já paga não reabre por ali.

4. Trocar a carteira não muda cobranças antigas. O meio (boleto/PIX/banco) fica gravado na cobrança no momento em que ela é gerada. A troca de carteira só vale para as próximas.

5. PIX e boleto vivem na mesma cobrança. No boleto híbrido, o cliente pode pagar pelo código de barras OU pelo QR Code PIX — é a mesma cobrança. Pagou de um jeito, baixa de qualquer forma; não cobre duas vezes.

6. 2ª via de boleto vencido pode trazer nova data. Quando o provedor permite atualizar a data na 2ª via, ao imprimir um boleto vencido o sistema pergunta o novo vencimento. É o mesmo boleto (mesmo nosso número), só com data nova.

7. Remover ≠ baixar. Remover apaga a cobrança (ação sem volta, exige permissão e às vezes motivo). Baixar apenas a encerra. Use remover só quando a cobrança foi criada errada.

8. Cobrança paga em duplicidade. Se o cliente pagar o mesmo boleto duas vezes (ex.: boleto e PIX), o segundo pagamento entra como duplicidade. Verifique o caixa e devolva/credite conforme a política do provedor.

9. Cobrança com débito de outro cliente. Em troca de titularidade, o débito pode pertencer a um cliente diferente do da cobrança. O sistema avisa no topo do detalhe — confira antes de cobrar.

10. Multa e juros entram no valor atualizado. O valor original é o do vencimento; o valor atualizado já soma os acréscimos de atraso. Cobre sempre pelo atualizado em boletos vencidos.

Perguntas frequentes

Qual a diferença entre cobrança, débito e fatura?

O débito é a mensalidade/parcela que o cliente deve. A fatura agrupa débitos de um período. A cobrança é o documento que ele paga (boleto/PIX/carnê) gerado a partir desses débitos. Um clique em “Ver débito” no detalhe mostra a origem.

O cliente perdeu o boleto. Como mando a 2ª via?

Abra a cobrança e clique Imprimir financeiro (gera o PDF) ou Enviar (manda por e-mail/WhatsApp). Se estiver vencida e o provedor permitir, o sistema pergunta o novo vencimento antes de imprimir.

O cliente pagou mas a cobrança continua Aberta. E agora?

A baixa depende do retorno do banco (arquivo) ou da sincronização do gateway, que rodam por tarefa. Aguarde o próximo ciclo ou, se a carteira usa gateway, abra a cobrança e clique Verificar gateway para checar na hora.

Baixei a cobrança por engano. Tem como desfazer?

Se ela foi baixada manualmente, não tem gateway e o débito ainda está em aberto, abra o detalhe e clique Reabrir cobrança (precisa de permissão). Ela volta para Aberto e o motivo fica no histórico.

Posso mudar o vencimento de uma cobrança?

Sim, se ela estiver Aberta, não usar gateway e você tiver permissão. Abra o detalhe e use Alterar vencimento. Para cobranças com gateway, a data é controlada pelo próprio gateway.

Como cobro vários clientes de uma vez?

Na listagem, marque as cobranças com a caixinha da 1ª coluna e use o botão Ações → Enviar boletos (e-mail/WhatsApp em massa) ou Imprimir boletos (gera tudo num carnê PDF).

O que é “nosso número”?

É o identificador da cobrança junto ao banco, impresso no boleto. É por ele que o banco sabe qual cobrança foi paga ao processar o retorno.

Boleto e PIX no mesmo documento — cobro duas vezes?

Não. É uma só cobrança. O cliente escolhe pagar pelo código de barras ou pelo QR Code PIX; qualquer um deles dá a baixa. Não gere outra cobrança.

Cobrança vencida cobra multa e juros sozinha?

Sim, conforme configurado na carteira de cobrança. O valor atualizado já traz multa + juros do atraso. Reemita a 2ª via para o cliente pagar o valor correto.

Como parcelo uma dívida antiga do cliente?

Use a Renegociação : ela junta as cobranças vencidas em um novo parcelamento, baixa as antigas e gera as novas com datas e valores acordados.

Qual a diferença entre “Remover” e “Baixar”?

Remover apaga a cobrança (sem volta, exige permissão). Baixar apenas a encerra como Baixado, sem registrar pagamento. Para registrar que o cliente pagou, ela precisa virar Paga.

Posso gerar boleto e PIX ao mesmo tempo?

Depende do banco/gateway da carteira. Alguns oferecem o boleto híbrido (Boleto/PIX) num documento só; outros só boleto ou só PIX. Isso é definido na carteira de cobrança, não na cobrança individual.

A cobrança some se eu cancelar a mensalidade?

A cobrança aberta ligada a uma mensalidade cancelada normalmente é baixada/removida conforme a regra do provedor. Confira sempre o estado na listagem antes de cobrar.

O que aparece para o cliente?

O texto da Descrição (ex.: “Mensalidade referente a Junho/2026”) mais os dados de pagamento (linha digitável, QR PIX). Você pode editar a descrição enquanto a cobrança estiver Aberta.

Documentos relacionados

Regras de cobrança — carteiras, multa, juros, desconto e como o sistema decide gerar/regerar.
Gateway bancário — conectar Asaas, Mercado Pago, Sicredi, Banco do Brasil e outros.
Carnê — gerar e imprimir blocos de cobranças em lote.
Renegociação — parcelar dívidas vencidas em um novo acordo.
Fatura — o agrupador de débitos que origina a cobrança.
Mensalidade — o débito recorrente que vira cobrança todo mês.
Recebimentos e pagamentos — como o dinheiro recebido entra no caixa.
Cliente — cadastro de quem paga a cobrança.