Central de Ajuda Quaza Provedores

Fatura — Documento de cobrança do contrato (PT)

Fatura — Documento de cobrança do contrato — Quaza

A Fatura é o documento mensal de cobrança do Quaza: ela agrupa os débitos de um contrato (mensalidade e, se configurado, vendas) de uma competência num único documento, com vencimento, valores e a cobrança correspondente (boleto, PIX ou cartão).

Esta wiki cobre o módulo Fatura ponta a ponta: o que é, quando usar, como o módulo é ativado, como a fatura nasce do contrato, quais ações você executa em cada fatura, como enviá-la, como ler estados e o que fazer quando algo dá errado. Audiência: equipe financeira e operadores de provedores que cobram seus clientes pelo Quaza.

Resumo de uma linha: a Fatura é o "documento único" que o cliente recebe a cada mês — em vez de receber vários boletos soltos, ele recebe uma fatura consolidando os débitos do contrato no período, com um vencimento e uma forma de pagamento. As faturas são geradas em lote por uma tarefa automática a partir das regras de cobrança do contrato.

Nesta wiki:

Quando usar a Fatura (e quando NÃO)

O módulo de Fatura serve para consolidar a cobrança mensal de um cliente num documento único. Use a tabela abaixo para confirmar em segundos se a Fatura é o caminho:

Necessidade	Caminho
Entregar ao cliente um documento único por mês reunindo mensalidade e demais débitos do contrato	Fatura (este documento)
Cobrar uma mensalidade ou débito individual via boleto/PIX/cartão	Cobrança
Definir quando o sistema gera e envia as cobranças do contrato	Regras de cobrança
Cadastrar o serviço recorrente que vira mensalidade	Mensalidade
Reunir várias mensalidades vencidas em um único carnê	Carnê

A Fatura não substitui a cobrança — ela a organiza. Por baixo, a fatura continua tendo uma cobrança (boleto, PIX ou cartão) que é o que o banco/gateway processa. A fatura é a "capa" que o cliente vê; a cobrança é o instrumento de pagamento.

Não existe fatura avulsa. Você não cria uma fatura "do zero" na tela. A fatura sempre nasce de um contrato com débitos marcados para a próxima fatura — pela tarefa automática ou pela ação Regerar fatura. Tentar adicionar uma fatura manualmente retorna o aviso "Não é possível criar uma fatura avulsa, somente via regra de cobrança".

Passo a passo — da ativação à primeira fatura

Roteiro mínimo, do zero até a primeira fatura enviada ao cliente:

Passo	Ação	Onde
1	Crie um template de fatura — o layout do documento que o cliente recebe (logo, dados, lista de itens, código de barras/PIX). Sem template, a fatura não tem como ser impressa nem enviada.	Cliente → Fatura Template
2	Ative o módulo de faturas. Na ativação você define os padrões: tipos de débito, período, juros, template e se faturas pagas continuam sendo enviadas. Esses padrões são aplicados a todos os contratos.	Configurações → Configurações da fatura
3	Confira a regra de cobrança dos contratos: ela precisa ter as ações Geração de Fatura e Enviar Fatura (e-mail e/ou WhatsApp), com os dias de referência configurados.	Contrato → Regras de cobrança
4	Garanta que existam débitos para faturar: as mensalidades/vendas do contrato precisam estar marcadas com Adicionar na próxima Fatura?. Sem isso, o contrato é ignorado na geração.	Cliente → Contrato
5	Gere a primeira fatura: aguarde a tarefa diária rodar, ou gere manualmente abrindo o contrato e usando Regerar fatura (seleciona os débitos e cria o documento).	Cliente → Fatura
6	Confira a fatura gerada: abra-a na listagem, valide competência, valores e a cobrança vinculada. Use Imprimir fatura para ver o PDF como o cliente verá.	Cliente → Fatura
7	Envie ao cliente — por e-mail, WhatsApp ou WhatsApp Web. As tarefas automáticas fazem isso em lote, mas você pode reenviar manualmente quando precisar.	Cliente → Fatura → [a fatura]

Fluxo geral — do contrato à fatura paga

Do contrato à fatura paga: a tarefa diária agrupa os débitos da competência numa fatura, gera a cobrança, o cliente recebe e paga, e a fatura é baixada. As ações de pós-geração (regerar, receber, reenviar) são feitas manualmente na tela.

Glossário

Termo	O que é
Fatura	Documento mensal que agrupa os débitos de um contrato numa competência, com vencimento, valores e a cobrança correspondente. É o que o cliente recebe.
Competência	Mês/ano de referência da fatura (ex.: Maio de 2026). Identifica o período cobrado. Há sempre uma fatura por competência e por contrato.
Débito	Cada valor a receber do cliente (mensalidade, venda, multa, juros). A fatura reúne os débitos marcados para a próxima fatura.
Adicionar na próxima fatura	Marca de cada débito que define se ele entra na próxima fatura do contrato. Débito sem essa marca não é faturado.
Cobrança	Instrumento de pagamento vinculado à fatura (boleto, PIX ou cartão). Uma fatura pode ter uma ou mais cobranças associadas.
Template de fatura	Layout do documento (logo, textos, lista de itens, código de barras/PIX) preenchido com os dados da fatura na hora de imprimir/enviar.
Data limite de envio	Data até a qual a fatura deve ser enviada ao cliente. É a base para a tarefa de envio decidir o disparo.
Data de envio	Data do último envio realizado da fatura ao cliente.
Tipos de débito para fatura	Define o que entra na fatura: Apenas mensalidade ou Mensalidades e Vendas.
Período dos débitos	Define quais débitos por data entram: todos sem fatura até o fim do mês, todos em aberto até o fim do mês, ou apenas os com vencimento dentro do mês.
Considerar juros	Define se a fatura inclui juros dos débitos: nenhum, só das vendas, só das mensalidades ou de todos os tipos.
Regra de cobrança	Conjunto de ações por contrato (gerar fatura, enviar por e-mail/WhatsApp etc.) e os dias de referência de cada uma. Comanda a automação da fatura.
Valor original / Valor da fatura / Valor pago / Valor em aberto	Valor dos débitos antes de descontos, valor cobrado na fatura, quanto já foi pago e quanto ainda falta.
Portal do cliente	Área online onde o cliente acessa suas faturas e cobranças. A fatura tem um link de acesso ao portal.

Ativar o módulo de faturas

O módulo de faturas vem desligado. Enquanto desligado, as tarefas de geração e envio não produzem nada — mesmo agendadas. A ativação é uma operação global: ela vale para todos os contratos do sistema.

AtivaçãoConfigurações → Configurações da fatura

Use o botão Ativar módulo de faturas. Vai aparecer um aviso de que o procedimento aplica os padrões a todos os contratos. Antes de ativar, defina os valores padrão:

Campo	O que define	Opções
Tipos de débito para fatura	O que a fatura agrupa	Apenas mensalidade · Mensalidades e Vendas
Período dos débitos para fatura	Quais débitos entram por data de vencimento	Todos sem fatura até o fim do mês · Todos em aberto até o fim do mês · Apenas vencimentos do mês
Considerar juros na fatura	Se inclui juros, e de quais débitos	Não considerar · Só das vendas · Só das mensalidades · Todos os tipos
Template da fatura	Layout padrão usado na impressão e no envio	Um dos templates cadastrados
Enviar faturas pagas	Se faturas já pagas continuam sendo enviadas pela tarefa	Sim · Não
Débitos antigos inclusos na primeira fatura	O que a primeira fatura recolhe do histórico	Todos · Somente os do período atual

É preciso ter ao menos um template antes de ativar. A ativação pede o template padrão da fatura. Crie o template primeiro (próxima seção) e só depois ative o módulo.

Desligar o módulo também é global: o botão Desativar módulo de faturas desliga para todos os contratos. As faturas já criadas não somem, mas a geração e o envio automáticos param.

Tela de Faturas — listagem e detalhe

A tela de faturas reúne a listagem (todas as faturas) e o detalhe (uma fatura específica, só leitura, com a área de botões).

Listagem

Cliente → Fatura

A listagem mostra todas as faturas geradas. Não há botão de adicionar — fatura não é criada manualmente aqui. Use a busca rápida e os filtros para localizar uma fatura por cliente, contrato, competência ou situação.

Colunas da listagem:

Coluna	O que mostra
Código	Número interno da fatura.
Competência	Mês/ano de referência por extenso (ex.: Maio de 2026).
Cliente	Cliente dono do contrato (link para o cadastro do cliente).
Contrato	Contrato de origem (link para o contrato).
Data envio	Quando a fatura foi enviada ao cliente pela última vez.
Data limite de envio	Até quando a fatura deve ser enviada.
Valor fatura	Valor cobrado na fatura.
Situação	Em aberto, Pagamento parcial, Pago ou Sem cobrança (ver seção Situações).
Alteração / Alterador	Data da última alteração e quem alterou.

Detalhe

Ao abrir uma fatura, os campos vêm em somente leitura — a fatura não é editada campo a campo, e sim regerada. O detalhe mostra:

Dados da fatura: competência, empresa, situação, cliente, contrato, vencimento, datas de envio, template, e os valores (original, fatura, desconto, em aberto, pago).
Detalhe dos débitos: a relação dos débitos que compõem a fatura e as notas de débito relacionadas.
Cobrança (quando existe): forma de pagamento, situação, número, nosso número, vencimento, valor, código de barras, linha digitável e PIX. Quando há PIX, aparece um botão para abrir o QR Code.
Histórico: aba com o histórico de alterações da fatura.

Situações da fatura

A situação resume o estado de pagamento da fatura. Ela é calculada a partir das cobranças vinculadas:

Situação	O que significa	Próxima ação típica
Em aberto	Fatura gerada e ainda não paga (ou sem nenhum pagamento registrado).	Enviar ao cliente; aguardar pagamento.
Pagamento parcial	Parte do valor já foi paga, mas ainda resta saldo em aberto.	Cobrar o saldo restante.
Pago	Fatura totalmente quitada.	Nenhuma — ciclo encerrado.
Sem cobrança	Fatura sem nenhuma cobrança vinculada (boleto/PIX/cartão não foi gerado).	Gerar cobrança para a fatura.

Fatura "Sem cobrança" é um alerta. O sistema avisa no painel quando existem faturas Em aberto sem nenhuma cobrança gerada — isso costuma acontecer quando a fatura ficaria com valor zero ou negativo (ex.: crédito/estorno maior que os débitos). Abra a fatura e use Gerar cobrança, ou regenere ajustando os débitos.

Área de botões — ações da fatura

No detalhe de cada fatura há uma área de botões. Quais aparecem depende da situação da fatura, da forma de cobrança e das suas permissões.

#	Botão	Quando aparece	O que faz
1	Enviar fatura	Sempre (precisa de template configurado).	Abre o envio ao cliente por e-mail, WhatsApp ou WhatsApp Web.
2	Regerar fatura	Fatura não paga, com a permissão de regerar.	Reabre a seleção de débitos, vencimento e template, e gera/atualiza a fatura.
3	Receber fatura	Fatura não paga, com permissão de pagar.	Registra o pagamento (data e valor) e baixa a fatura, enviando o comprovante.
4	Verificar gateway	Fatura não paga, com cobrança em gateway/integração.	Consulta o gateway para atualizar a situação de cobrança e pagamento.
5	Gerar cobrança	Fatura não paga, com permissão financeira.	Cria a cobrança (boleto/PIX/cartão) da fatura.
6	Acessar portal	Portal do cliente habilitado.	Abre o portal do cliente já autenticado naquele cliente.
7	Imprimir fatura	Sempre.	Gera o PDF da fatura usando o template, para conferência ou impressão.
8	Ver Contrato / Ver Cliente / Ver Cobrança / Ver Template de Fatura	Conforme os vínculos da fatura.	Abrem as telas relacionadas em nova aba (navegação rápida).

Receber fatura registra o pagamento dentro do Quaza (uso típico quando o cliente paga em dinheiro/PIX direto e você baixa manualmente). Já Verificar gateway consulta a operadora de pagamento para baixar automaticamente o que já foi pago online.

Template de fatura — o documento que o cliente recebe

O template define como a fatura é montada visualmente. É um layout em HTML com variáveis que o sistema substitui pelos dados reais (nome do cliente, competência, valor, código de barras etc.) na hora de imprimir ou enviar.

Lista de templatesCliente → Fatura Template

Aqui ficam os templates cadastrados. Cada linha mostra o título, quantas faturas usam aquele template e a última alteração. Use Adicionar template de Fatura para criar um novo.

Edição do templateCliente → Fatura Template → [o template]

Na edição você define o Título, a Situação (Habilitado/Desabilitado) e o Conteúdo (o layout). Há uma aba Imagens para anexar imagens usadas no layout (ex.: logo). Os botões à direita ajudam a montar:

Ver legenda — abre a lista de variáveis disponíveis (dados do cliente, contrato, fatura, cobrança etc.) para você copiar no conteúdo.
Copiar template — duplica o template atual com outro título (útil para variações).
Testar impressão — escolhe uma fatura real e gera o PDF para você ver o resultado antes de usar.

A barra superior tem Gravar template de Fatura, Ações e Voltar.

As variáveis do template são preenchidas automaticamente. Por exemplo, a competência da fatura, o primeiro nome do cliente e o valor formatado entram onde você colocar os marcadores correspondentes (use Ver legenda para ver os nomes exatos). Sempre teste a impressão com uma fatura real depois de mexer no layout.

Envio da fatura ao cliente

A fatura pode ser enviada de três formas. Em todas, é o template e os dados da fatura que montam a mensagem; o PDF da fatura vai anexado/linkado.

Canal	Como funciona
E-mail	Usa um template de e-mail com a função "Envio de fatura". Envia para o endereço do cliente, com o PDF.
WhatsApp	Envio automático via a integração de WhatsApp configurada, usando um template de WhatsApp de envio de fatura.
WhatsApp Web	Monta a mensagem e abre o WhatsApp Web para envio manual (sem integração automática).

Sem template não há envio. Se a fatura não tiver template configurado, o botão Enviar avisa "Nenhum template configurado". Defina o template padrão na ativação do módulo, ou no próprio contrato.

Por padrão, faturas Pago e Sem cobrança não são reenviadas pela tarefa automática — a não ser que a opção Enviar faturas pagas esteja ligada. O reenvio manual pelo botão Enviar fatura funciona em qualquer situação.

Fatura e cobrança — como se relacionam

A fatura é a capa; a cobrança é o instrumento de pagamento. Entender essa relação evita confusão:

Conceito	Papel
Débitos	Os valores individuais a receber (mensalidade, vendas, juros). Existem antes da fatura.
Fatura	Agrupa os débitos de uma competência num documento único, com vencimento e total.
Cobrança	O boleto/PIX/cartão que o banco ou gateway processa. É o que o cliente efetivamente paga.

Quando a fatura é gerada, a cobrança costuma ser criada junto. Se por algum motivo a fatura ficou sem cobrança, use Gerar cobrança no detalhe. Quando o cliente paga, a cobrança é baixada e a situação da fatura passa para Pago (ou Pagamento parcial). Para detalhes sobre boletos, PIX e gateways, veja Cobrança e Gateway bancário .

Tarefas automáticas — gerar e enviar

As faturas das mensalidades não são criadas uma a uma. O Quaza tem tarefas que rodam em horários programados que geram e enviam as faturas sem intervenção manual. Cada tarefa é lida da crontab do servidor.

Quem liga/desliga uma tarefa: é o sysadmin editando a crontab do servidor (comentar a linha desativa; descomentar reativa). Não é feito pelo operador dentro do Quaza. Se uma tarefa precisa começar ou parar, abra um chamado para a equipe técnica.

Tarefa	O que faz	Frequência típica
Contrato — Criar as Faturas	Percorre as regras de cobrança, identifica os contratos do dia com débitos marcados para a próxima fatura e gera a fatura da competência. Pula contratos que já têm fatura no período ou unificados.	Diária
Contrato — Enviar email das faturas	Envia as faturas do dia por e-mail e WhatsApp, conforme as ações da regra de cobrança e os dias de referência. Respeita a opção de não reenviar faturas pagas.	Diária

Acompanhamento no QuazaAdmin → Tarefas

A tela apenas informa sobre cada tarefa — não liga/desliga. Em cada linha você consulta o resumo da última execução (quantas faturas gerou/enviou, eventuais erros), o e-mail de notificação e o tempo limite. É a primeira parada para diagnosticar: se uma fatura não saiu, aqui você vê quando a tarefa rodou e o que ela reportou.

Tarefa bloqueada pelo módulo desligado. Se o módulo de faturas estiver desativado, as tarefas de criar e enviar param na hora com o aviso "O módulo de faturas está desabilitado" — mesmo ativas na crontab. Para o lote sair, o módulo precisa estar ligado.

Como ler erros e resolver

Sintoma	Causa provável	O que fazer
"Não é possível criar uma fatura avulsa, somente via regra de cobrança"	Tentou adicionar fatura manualmente na listagem.	Fatura nasce do contrato. Use Regerar fatura no contrato ou aguarde a tarefa diária.
"O módulo de faturas está desabilitado"	Módulo de faturas desligado.	Ative em Configurações → Configurações da fatura.
"Nenhum template configurado"	A fatura/contrato não tem template de fatura.	Defina o template padrão na ativação do módulo, ou no contrato.
"Nenhum contrato com débitos, marcados para próxima fatura"	Os débitos do contrato não estão marcados para a próxima fatura.	No contrato, marque os débitos com "Adicionar na próxima Fatura?".
Fatura ficou "Sem cobrança"	Valor da fatura ≤ 0 (crédito maior que débitos) ou cobrança não foi gerada.	Ajuste os débitos e regenere, ou use Gerar cobrança.
Contrato sem fatura no mês	Contrato unificado, sem débito do período, ou já tem fatura na competência.	Confira a unificação do contrato, os débitos marcados e se a fatura já existe.
"Contrato não possui regra de envio por e-mail/WhatsApp"	A regra de cobrança não tem a ação de envio de fatura.	Adicione a ação Enviar Fatura (E-Mail / WhatsApp) na regra de cobrança.
Fatura paga mas situação ainda Em aberto	Pagamento online não foi sincronizado.	Abra a fatura e use Verificar gateway.

Pegadinhas frequentes

Fatura não é boleto. A fatura é a capa que agrupa os débitos; o boleto/PIX/cartão é a cobrança por baixo. Cliente pode pagar pela cobrança mesmo sem "abrir" a fatura.

Ativar o módulo é global. A ativação aplica os padrões a todos os contratos do sistema — não é por contrato. Confirme os padrões antes de clicar em Ativar.

Sem débito marcado, sem fatura. Só entram na fatura os débitos com "Adicionar na próxima Fatura?". Mensalidade nova que não recebeu essa marca não aparece.

Uma fatura por competência por contrato. Se já existe fatura da competência, a tarefa não cria outra. Para mudar o conteúdo, use Regerar fatura, não tente gerar de novo.

Faturas pagas não são reenviadas por padrão. A tarefa de envio pula faturas Pago/Sem cobrança, a menos que "Enviar faturas pagas" esteja ligado. Para reenviar uma fatura paga, use o botão Enviar fatura manualmente.

Mudou o template e não testou? Sempre use Testar impressão com uma fatura real após editar o layout — variável errada quebra o PDF que o cliente vê.

Crédito maior que débito gera fatura sem cobrança. Estorno/crédito acima dos débitos deixa a fatura com valor ≤ 0 e sem boleto. Redistribua o crédito ou ajuste os débitos.

Detalhe da fatura é só leitura. Você não edita campos da fatura aberta. Para mudar valores ou itens, use Regerar fatura.

FAQ

Como crio uma fatura manualmente?

Você não cria fatura "do zero". A fatura nasce do contrato: ou pela tarefa diária Contrato — Criar as Faturas, ou abrindo o contrato/fatura e usando Regerar fatura, que deixa você escolher os débitos, o vencimento e o template.

Qual a diferença entre fatura e cobrança?

A fatura é o documento mensal que agrupa os débitos do contrato (a capa que o cliente vê). A cobrança é o boleto/PIX/cartão que o banco ou gateway processa — é o que o cliente efetivamente paga. Uma fatura tem uma ou mais cobranças por baixo.

O que entra na fatura?

Os débitos do contrato marcados como Adicionar na próxima Fatura?, conforme os padrões definidos na ativação: apenas mensalidade ou mensalidades e vendas, dentro do período escolhido, com ou sem juros.

Como ativo o módulo de faturas?

Em Configurações → Configurações da fatura, clique em Ativar módulo de faturas. Defina os padrões (tipos de débito, período, juros, template, envio de pagas) e confirme. A ativação vale para todos os contratos.

Posso voltar atrás e desligar o módulo?

Sim. Em Configurações → Configurações da fatura há o botão Desativar módulo de faturas, também global. As faturas já criadas continuam existindo; só a geração e o envio automáticos param.

O cliente perdeu a fatura — como reenvio?

Abra a fatura e clique em Enviar fatura. Escolha o canal (e-mail, WhatsApp ou WhatsApp Web). O reenvio manual funciona em qualquer situação, inclusive faturas já pagas.

A fatura aparece "Sem cobrança" — e agora?

Quer dizer que ela não tem boleto/PIX/cartão vinculado. Abra a fatura e use Gerar cobrança. Se o valor estiver zero ou negativo (crédito maior que os débitos), ajuste os débitos e regenere.

Como registro um pagamento em dinheiro/PIX direto?

Abra a fatura e use Receber fatura: informe a data e o valor pago. O sistema baixa a fatura e envia o comprovante. Para pagamentos online, use Verificar gateway em vez disso.

Posso alterar uma fatura já gerada?

Os campos da fatura aberta são só leitura. Para mudar débitos, vencimento ou template, use Regerar fatura — ela reabre a seleção e atualiza o documento.

Onde monto o layout da fatura?

Em Cliente → Fatura Template. Cada template tem título, situação e conteúdo (layout com variáveis). Use Ver legenda para os nomes das variáveis e Testar impressão para conferir o resultado.

Por que um contrato não gerou fatura no mês?

As causas mais comuns: o contrato está unificado a outro, não tem débitos marcados para a próxima fatura, já tem fatura da competência, ou a regra de cobrança não tem a ação de geração de fatura. Confira o Resumo da tarefa em Admin → Tarefas.

Faturas pagas continuam sendo enviadas?

Por padrão não — a tarefa de envio pula faturas Pago e Sem cobrança. Para incluí-las, ligue a opção Enviar faturas pagas na configuração da fatura. O reenvio manual ignora essa regra.

A fatura junta mais de uma cobrança?

Pode. Quando o contrato gera mais de uma cobrança no período, a fatura associa todas. O detalhe mostra a cobrança principal, e o envio inclui as cobranças vinculadas.

Como o cliente acessa a fatura online?

Pelo portal do cliente, se ele estiver habilitado. No detalhe da fatura, o botão Acessar portal abre o portal já no cliente. A fatura também tem um link de acesso ao portal.

Documentos relacionados

Cobrança — o boleto/PIX/cartão que a fatura agrupa e que o cliente paga
Regras de cobrança — onde se define a geração e o envio automáticos das faturas
Mensalidade — o serviço recorrente que vira débito e entra na fatura
Contrato e Fatura — visão do contrato como origem da fatura
Gateway bancário — integração que confirma os pagamentos online
Carnê — alternativa para reunir várias mensalidades num documento
Cliente — destinatário da fatura; e-mail/telefone precisam estar válidos