A Cobrança é o documento que o cliente paga: boleto, PIX, cartão ou pagamento local. Esta wiki explica como a cobrança nasce, seus estados, as formas de pagamento, a carteira, como o pagamento é baixado e como juros/multa/desconto entram. Audiência: equipe financeira/atendimento.
Resumo em uma linha: a Cobrança é o meio de pagamento concreto de um valor — com vencimento, nosso número, linha digitável e/ou QR Code PIX. Ela nasce de um débito (mensalidade, serviço, venda) e fica Em aberto até ser paga ou baixada.
Onde a cobrança se encaixa:
-
Débito / Mensalidade — o valor a receber (o "quanto").
-
Fatura — agrupa vários débitos num documento. Veja Fatura
.
-
Cobrança — o boleto/PIX/cartão que o cliente efetivamente paga.
O que é a Cobrança
A Cobrança é o documento financeiro que representa um valor a receber de um cliente, com um vencimento e um meio de pagamento. Dependendo da forma, ela carrega nosso número, linha digitável e código de barras (boleto) e/ou QR Code / Copia e Cola (PIX). É o que o cliente recebe e paga.
Recebimento → Cobrança
Fluxo — do débito ao pagamento
O débito gera a cobrança pela carteira (que define banco e meio de pagamento); a cobrança vai ao cliente; quando pago — por retorno do banco, gateway ou baixa manual — a cobrança fica Paga e o débito é quitado.
A tela e os filtros
Recebimento → Cobrança
A listagem traz as cobranças com atalhos (filtros rápidos) por situação:
Listagem de cobranças. Os atalhos Abertos · Atrasados · Pagos · Baixados filtram por situação; a aba Filtros 1 abre filtros detalhados. Cada linha mostra Código, Nosso número, Forma de pagamento, Estado, Cliente, Vencimento, Valor original e Valor atualizado (com juros/multa).
| Filtro |
Mostra |
| Abertos |
Cobranças aguardando pagamento (ainda no prazo ou não). |
| Atrasados |
Cobranças em aberto cujo vencimento já passou. |
| Pagos |
Cobranças quitadas. |
| Baixados |
Cobranças canceladas/baixadas (sem efeito). |
No detalhe de cada cobrança você vê o cliente, o contrato, a carteira, o valor (e o valor atualizado com juros/multa), o vencimento, a forma de pagamento e os dados do documento (nosso número, linha digitável, código de barras, QR Code PIX).
Detalhe de uma cobrança. 1 Forma de pagamento (a carteira) · 2 Vencimento · 3 Valor original · 4 Código de barras e 5 Linha digitável. No topo, o estado (Aberto) e o botão Ações; à direita, as ações da cobrança; a aba Histórico registra tudo que aconteceu (veja Histórico Financeiro
).
Estados da cobrança
| Estado |
O que significa |
| Em aberto |
Cobrança gerada, aguardando pagamento. Continua em aberto mesmo após o vencimento — aí é considerada atrasada/vencida. |
| Pago |
Pagamento recebido (por retorno do banco, gateway ou baixa manual). Pode ser pagamento total ou parcial. |
| Baixado |
Cobrança cancelada/baixada — sem efeito de cobrança. Pode ser reaberta por quem tem permissão (se não estiver em remessa de baixa). |
"Vencida" não é um estado próprio: é uma cobrança Em aberto cujo vencimento já passou (aparece no filtro "Atrasados"). É nela que incidem juros e multa.
A forma de pagamento define por quais meios a cobrança pode ser paga. O Quaza trabalha com estas combinações:
| Forma |
O que é |
| Boleto |
Boleto bancário tradicional (nosso número, linha digitável, código de barras). |
| Boleto + PIX |
Um documento com boleto e QR Code PIX juntos — o cliente escolhe como pagar. |
| Boleto + Cartão |
Boleto com opção de pagar no cartão. |
| Boleto + PIX + Cartão |
As três opções no mesmo documento. |
| PIX |
Só PIX — QR Code / Copia e Cola, pagamento instantâneo. |
| Cartão |
Cobrança no cartão de crédito (via gateway). |
| Local |
Pagamento presencial (no caixa do provedor), sem boleto/PIX — baixa manual. |
A forma disponível depende da
carteira
usada — uma carteira pode oferecer só boleto, só PIX, ou combinações, conforme o banco/gateway configurado.
Carteira de cobrança
A carteira é a configuração que define como a cobrança é gerada: qual banco/gateway, qual forma de pagamento e como ela é registrada. Cada contrato aponta para uma carteira. Os três tipos de registro determinam o caminho da cobrança:
| Tipo de registro |
O que significa |
| Sem registro |
O boleto/PIX é gerado localmente, sem comunicar ao banco antecipadamente. Mais simples; a baixa costuma ser manual ou por conferência. |
| Débito automático |
O valor é debitado direto na conta do cliente (via arquivo enviado ao banco), sem o cliente pagar manualmente. |
| Registro CNAB (240) |
A cobrança é registrada no banco por arquivo de remessa CNAB; o pagamento volta por arquivo de retorno. Veja Remessa e Retorno
. |
Quando a carteira usa gateway (PIX/cartão integrado), o registro e a baixa acontecem por API/webhook — veja Gateway Bancário
. A carteira também guarda as regras de juros, multa e desconto
e o layout do boleto.
Como a cobrança nasce
| # |
Passo |
| 1 |
Existe um débito a cobrar (mensalidade, serviço, venda) no contrato do cliente. |
| 2 |
A cobrança é gerada — automaticamente (pela rotina de cobrança do contrato) ou manualmente — agregando o(s) débito(s). |
| 3 |
O sistema usa a carteira do contrato para definir o banco, a forma de pagamento e o vencimento, e monta o documento (nosso número, linha digitável, QR Code). |
| 4 |
Se a carteira é CNAB, a cobrança entra numa remessa para o banco registrar; se é gateway, é registrada por API. A cobrança fica Em aberto. |
| 5 |
Você envia a cobrança ao cliente (e-mail, WhatsApp ou portal). |
Quando você junta vários débitos numa
Fatura
, é a fatura que gera uma única cobrança com o total — em vez de uma cobrança por débito.
Pagamento e baixa
A cobrança vira Paga de três formas:
| Origem da baixa |
Como funciona |
| Retorno do banco (CNAB) |
O arquivo de retorno traz os pagamentos; o Quaza baixa as cobranças correspondentes. |
| Gateway / PIX |
O gateway avisa o pagamento (webhook) e uma tarefa confirma a baixa. Veja Gateway Bancário
. |
| Baixa manual |
Um operador com permissão registra o pagamento (data e valor) na própria cobrança. |
Pagamento parcial. É possível registrar um valor menor que o total — a cobrança fica paga pelo valor recebido, e o saldo continua a ser tratado conforme a regra. Confira sempre o valor pago.
O Quaza protege a baixa contra duplicação (trava a cobrança durante o registro), então o boleto pago e o retorno do banco não geram baixa em dobro.
Juros, multa e desconto
Cada cobrança carrega as regras de encargos vindas da carteira/contrato:
| Configuração |
O que faz |
| Dias para multa |
Carência após o vencimento antes de a multa incidir. |
| Multa |
Percentual ou valor aplicado quando a cobrança vence. |
| Juros |
Cobrados por dia/mês de atraso. |
| Desconto por antecipação |
Abatimento se o cliente paga antes do vencimento. |
| Desconto fixo |
Abatimento fixo aplicado à cobrança. |
O sistema mostra o valor atualizado (valor original + juros/multa − descontos), recalculado conforme a data. Por isso uma cobrança vencida aparece com valor maior que o original, e uma paga adiantada pode vir menor. Confirme as regras com o financeiro.
Ações da tela
Botões de ação na cobrança (canto superior direito): 1 Enviar · 2 Imprimir financeiro · 3 Ver cliente · 4 Ver débito. As demais ações abaixo aparecem conforme o estado da cobrança e a permissão.
| # |
Ação |
O que faz |
Quando |
| 1 |
Imprimir / 2ª via |
Gera o PDF do boleto/cobrança. |
Cobrança em aberto. |
| 2 |
Enviar |
Manda a cobrança por e-mail/SMS/WhatsApp ao cliente. |
Cobrança em aberto. |
| 3 |
Registrar pagamento |
Baixa manual (data + valor). Depende de permissão. |
Cobrança em aberto. |
| 4 |
Alterar vencimento |
Muda a data de vencimento. |
Em aberto e sem registro no banco/gateway. |
| 5 |
Remover |
Baixa/cancela a cobrança. Depende de permissão. |
Cobrança em aberto. |
| 6 |
Reabrir |
Volta uma cobrança baixada para aberta. Depende de permissão e de não estar em remessa de baixa. |
Cobrança baixada. |
| 7 |
Verificar gateway |
Consulta o status do pagamento no gateway. |
Carteira com gateway. |
| 8 |
Desvincular remessa |
Solta a cobrança de uma remessa CNAB/débito. |
Cobrança em remessa, com permissão. |
Tarefas automáticas
| Tarefa |
O que faz |
| Gateway de pagamento |
Consulta os gateways e baixa as cobranças cujo pagamento foi confirmado. |
| Atualiza valor |
Recalcula o valor atualizado (juros/multa) das cobranças em aberto. |
| Aviso de vencimento |
Notifica o cliente (e-mail/SMS/WhatsApp) antes/depois do vencimento. |
| Alerta de fim de carnê |
Avisa quando o carnê
do cliente está acabando. |
Manual ou automático. Essas tarefas só rodam se o administrador as tiver cadastrado e ativado. A baixa por gateway/retorno e os avisos dependem delas; sem elas, a baixa fica por conta do retorno CNAB ou da baixa manual.
Glossário
| Termo |
O que é |
| Cobrança |
O documento que o cliente paga (boleto/PIX/cartão/local), com vencimento e valor. |
| Carteira |
Configuração de banco/gateway, forma de pagamento e tipo de registro usada para gerar a cobrança. |
| Nosso número |
Identificador do boleto no banco, gerado na emissão. |
| Linha digitável / código de barras |
A sequência do boleto que o cliente usa para pagar no banco/app. |
| QR Code / Copia e Cola |
O código PIX para pagamento instantâneo. |
| Baixa |
O registro do pagamento (ou cancelamento) da cobrança. |
| Remessa / Retorno |
Arquivos CNAB trocados com o banco para registrar cobranças e receber baixas. Ver Remessa e Retorno
. |
| Valor atualizado |
Valor da cobrança recalculado com juros/multa (se vencida) ou desconto (se antecipada). |
| Carnê |
Conjunto de cobranças (parcelas) num PDF único. Ver Carnê
. |
Pegadinhas frequentes
1. Reemitir gera um documento novo. Ao reemitir uma cobrança, o nosso número e a linha digitável mudam — o boleto antigo não deve mais ser pago. Oriente o cliente a usar sempre a via mais recente.
2. Cobrança em remessa não muda de vencimento. Se a cobrança já foi registrada no banco (remessa CNAB), não dá para alterar o vencimento direto — é preciso desvincular da remessa primeiro.
3. Boleto demora 1-2 dias para baixar. O pagamento de boleto chega pelo retorno do banco (CNAB), que costuma vir no dia útil seguinte. PIX e gateway baixam quase na hora; boleto, não.
4. Cobrança de débito de outro cliente. Se a titularidade do débito mudou, o sistema avisa que o débito pertence a outro cliente — confirme antes de cobrar para não emitir no nome errado.
5. Valor do boleto maior que a mensalidade. Uma cobrança vencida soma juros e multa ao valor original (valor atualizado) — por isso o boleto pode vir maior que o valor base.
6. Cobrança sem carteira ou com valor zero. Sem uma carteira válida (ou com valor zerado), a cobrança não é gerada/registrada. Acerte a carteira do contrato e o valor antes.
7. Trocar de banco/gateway não mexe nas cobranças já emitidas. Mudar a carteira vale para as próximas cobranças; as já registradas continuam no banco/gateway anterior até serem pagas ou baixadas.
FAQ
Qual a diferença entre débito, fatura e cobrança?O débito é o valor a receber; a fatura agrupa vários débitos; a cobrança é o boleto/PIX/cartão que o cliente efetivamente paga.
O mesmo cliente pode ter boleto e cartão?Sim — a forma de pagamento depende da carteira do contrato. Há carteiras que oferecem boleto, PIX e cartão no mesmo documento.
Cliente pagou mas a cobrança continua em aberto — por quê?Boleto baixa pelo retorno do banco (1-2 dias úteis); PIX/gateway baixam quase na hora. Se passou o prazo, verifique o retorno/gateway ou registre a baixa manual conferindo o comprovante.
Cliente perdeu o boleto — como gerar a 2ª via?Na cobrança, use Imprimir/2ª via, ou o cliente acessa o portal. Atenção: se reemitir, a linha digitável muda.
Cliente pagou duas vezes — o que fazer?A baixa é protegida contra duplicação na mesma cobrança. Pagamento em duplicidade real (dois meios) é tratado como crédito/estorno no financeiro do cliente.
Como configurar PIX?O PIX vem da carteira: ela aponta o gateway/banco e a chave. A configuração da integração está em Gateway Bancário
.
Por que a cobrança veio maior que a mensalidade?Porque está vencida: o valor atualizado inclui juros e multa. Pago dentro do prazo (ou com desconto de antecipação), volta ao valor esperado.
Documentos relacionados