O contrato é a origem da fatura: é nele que você define o que entra na fatura, de quais débitos, com ou sem juros, com qual layout e quando o sistema gera tudo isso. Esta wiki explica a relação entre o contrato e a fatura — onde configurar cada regra no contrato e como essa configuração comanda a fatura que o cliente recebe.
Audiência: equipe financeira e operadores de provedores que cobram seus clientes pelo Quaza. Para a tela de Faturas em si (listagem, ações, template, envio), veja a wiki de Fatura
— aqui o foco é o que o contrato manda para ela.
Resumo de uma linha: a fatura não tem configuração própria — quem decide quais débitos ela agrupa, se inclui juros e qual layout usar é o
contrato, na aba
Cobrança. A fatura é gerada por uma tarefa automática que lê a
regra de cobrança
do contrato e junta os débitos marcados para a próxima fatura.
Quando usar esta wiki (e quando NÃO)
Use esta wiki para entender e ajustar o que o contrato manda para a fatura. Se a sua dúvida é sobre a tela de Faturas, há um documento específico:
| Necessidade |
Caminho |
| Definir o que entra na fatura de um contrato (débitos, juros, período, layout) |
Contrato e Fatura (este documento) |
| Trabalhar com a fatura já gerada (listagem, regerar, receber, enviar, template) |
Fatura
|
| Definir quando o sistema gera e envia a fatura do contrato |
Regras de cobrança
|
| Cobrar uma mensalidade ou débito individual (boleto/PIX/cartão) |
Cobrança
|
| Cadastrar o serviço recorrente que vira mensalidade |
Mensalidade
|
| Juntar a cobrança de vários contratos num só documento |
Contrato unificado
|
A fatura nasce do contrato — não se cria fatura "do zero". Você não monta uma fatura avulsa na tela. Ela é sempre gerada a partir de um contrato que tenha a regra de cobrança certa e débitos marcados para a próxima fatura — pela tarefa automática ou pela ação Regerar fatura.
Passo a passo — configurar o contrato para gerar fatura
Roteiro mínimo, partindo de um contrato existente, para que ele passe a gerar fatura:
| Passo |
Ação |
Onde |
| 1 |
Ative o módulo de faturas e tenha ao menos um template de fatura cadastrado. Sem o módulo ligado, nada é gerado; sem template, a fatura não tem como ser impressa nem enviada. |
Configurações → Configurações da fatura |
| 2 |
Abra o contrato e vá até a aba Cobrança. É lá que ficam os campos que definem a fatura desse contrato. |
Cliente → Contrato → aba Cobrança |
| 3 |
Defina os campos da fatura: tipos de débito (apenas mensalidade ou também vendas), período dos débitos, se considera juros e o template de fatura. |
Contrato → aba Cobrança |
| 4 |
Confira a regra de cobrança do contrato: 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 |
| 5 |
Marque os débitos para a fatura: as mensalidades/vendas do contrato precisam estar com Adicionar na próxima Fatura?. Débito sem essa marca é ignorado na geração. |
Cliente → Contrato → aba Débito |
| 6 |
Gere a fatura: aguarde a tarefa diária rodar, ou gere na hora abrindo o contrato e usando Regerar fatura (escolhe os débitos, vencimento e template). |
Cliente → Contrato / Cliente → Fatura |
| 7 |
Acompanhe a fatura na aba Fatura do contrato ou na tela de Faturas. A partir daí, as ações da fatura seguem no documento de Fatura
. |
Contrato → aba Fatura |
Fluxo geral — do contrato à fatura
Do contrato à fatura: você configura na aba Cobrança o que entra e marca os débitos; a tarefa diária lê a regra de cobrança, agrupa os débitos da competência e cria a fatura com a cobrança; o cliente a recebe. Os ajustes (regerar, mudar débitos ou regra) são feitos manualmente.
Glossário
| Termo |
O que é |
| Contrato |
O acordo do cliente com o provedor. Reúne o plano, os valores, a forma de cobrança e as regras de fatura. É a origem de toda fatura. |
| 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 (ex.: Maio de 2026). Define o período cobrado. Há 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 do contrato 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. |
| Tipos de débito para fatura |
Campo do contrato que define o que entra: Apenas mensalidade ou Mensalidades e Vendas. |
| Período dos débitos para fatura |
Campo do contrato que define quais débitos entram por data: 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 na fatura |
Campo do contrato que define se a fatura inclui juros: nenhum, só das vendas, só das mensalidades ou de todos os tipos. |
| Template da fatura |
Layout do documento que o cliente recebe, escolhido no contrato. Quem cria o layout é a tela de Fatura
. |
| 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. É o que comanda a automação da fatura. |
| Contrato unificado |
Contrato cuja cobrança é direcionada para outro contrato (o contrato pai). Os débitos do unificado entram na fatura do pai, não numa fatura própria. |
| Competência do financeiro / da nota |
Ajuste de mês usado pelo contrato: define se o débito e a nota fiscal contam a competência como o mês passado, o mês atual ou o próximo. |
Configuração / pré-requisitos
Antes de um contrato gerar fatura, três coisas precisam estar prontas no sistema:
Módulo de faturas ativoConfigurações → Configurações da fatura
O módulo de faturas vem desligado. Enquanto desligado, as tarefas de gerar e enviar não produzem nada, mesmo agendadas. A ativação é global (vale para todos os contratos) e define os padrões aplicados a cada contrato. Veja como ativar na wiki de Fatura
.
Template de fatura cadastradoCliente → Fatura Template
O contrato aponta para um template (layout) na hora de imprimir e enviar. Sem ao menos um template, não há como ativar o módulo nem gerar o documento. A criação e a edição do template ficam na wiki de Fatura
.
Regra de cobrança com as ações de faturaContrato → Regras de cobrança
A regra de cobrança vinculada ao contrato precisa ter a ação Geração de Fatura e, para o envio, Enviar Fatura (E-Mail) e/ou Enviar Fatura (WhatsApp). É a regra que determina quando cada coisa acontece. Detalhes em Regras de cobrança
.
Como o contrato configura a fatura — campos
Os campos que definem o conteúdo da fatura ficam todos na aba Cobrança do contrato. Eles respondem à pergunta "o que esta fatura deve agrupar?".
Cliente → Contrato → aba Cobrança
| Campo |
O que define |
Opções |
| Tipos de débito para fatura |
Quais débitos a fatura agrupa |
Apenas mensalidade · Mensalidades e Vendas |
| Período dos débitos para fatura |
Quais débitos entram, por data de vencimento |
Todos os débitos sem fatura até o final do mês de geração · Todos os débitos em aberto até o final do mês de geração · Apenas débitos com vencimento dentro do mês de geração |
| Considerar juros na fatura |
Se a fatura inclui juros, e de quais débitos |
Não considerar juros · Somente das vendas · Somente das mensalidades · Todos os tipos de débito |
| Template da fatura |
O layout usado na impressão e no envio |
Um dos templates cadastrados |
De onde vêm os valores padrão. Ao ativar o módulo de faturas, você define padrões que valem para todos os contratos. Esses campos no contrato começam com esses padrões — você só precisa mexer aqui quando um contrato específico deve fugir do padrão (ex.: um cliente que fatura mensalidade e vendas juntas, enquanto os demais faturam só a mensalidade).
Ainda na aba Cobrança, dois campos ajustam a competência usada pelo contrato:
| Campo |
O que faz |
Opções |
| Competência do financeiro |
Em qual mês o débito é contabilizado em relação ao vencimento |
Passada · Atual · Futura |
| Competência da nota |
Em qual mês a nota fiscal considera a competência |
Passada · Atual · Futura |
Competência na prática: "Atual" usa o próprio mês do vencimento; "Passada" considera o mês anterior; "Futura", o seguinte. É o que faz uma mensalidade vencida em junho aparecer na competência de maio, por exemplo. Ajuste só se a contabilidade do provedor exigir.
A regra de cobrança que dispara a fatura
Os campos da aba Cobrança dizem o que entra na fatura. A regra de cobrança diz quando ela é gerada e enviada. Sem a ação certa na regra, o contrato é configurado mas nunca gera fatura.
| Ação na regra de cobrança |
O que ela faz no contrato |
| Geração de Fatura |
No dia de referência, o sistema cria a fatura da competência juntando os débitos marcados. É a ação obrigatória — sem ela, não há fatura. |
| Enviar Fatura (E-Mail) |
Envia a fatura por e-mail no dia configurado, usando o template de e-mail de envio de fatura. |
| Enviar Fatura (WhatsApp) |
Envia a fatura por WhatsApp no dia configurado, pela integração de WhatsApp. |
Cada contrato aponta para uma regra de cobrança. Se vários contratos compartilham a mesma regra, mexer na regra afeta todos eles. Para mudar só um contrato, troque a regra dele ou crie uma regra específica. A configuração completa das ações e dos dias está em
Regras de cobrança
.
Quais débitos entram na fatura
Na hora de gerar, o sistema parte de todos os débitos do contrato e aplica os filtros do contrato. Um débito entra na fatura quando atende a todas as condições abaixo:
| Condição |
Detalhe |
| Está marcado para a próxima fatura |
O débito precisa estar com Adicionar na próxima Fatura? marcado. É o filtro principal — sem essa marca, o débito nunca é faturado. |
| Bate com o tipo escolhido |
Se o contrato fatura Apenas mensalidade, débitos de venda ficam de fora. Se for Mensalidades e Vendas, entram os dois. |
| Bate com o período escolhido |
Conforme o Período dos débitos para fatura: 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 de geração. |
| Não está removido |
Débitos cancelados/removidos não entram. |
Mensalidade nova sem a marca não aparece. O erro mais comum é configurar tudo no contrato e a fatura sair vazia ou incompleta porque os débitos não estão com Adicionar na próxima Fatura?. Confira essa marca na aba Débito do contrato antes de cobrar suporte.
Contrato individual x contrato unificado
Um cliente pode ter mais de um contrato (ex.: internet de casa e do escritório). Por padrão, cada contrato gera a sua própria fatura. Mas você pode unificar a cobrança: direcionar a cobrança de um contrato para outro, de modo que tudo caia numa única fatura.
| Tipo |
Como gera a fatura |
| Contrato individual |
Gera a sua própria fatura, agrupando apenas os seus débitos. |
| Contrato pai (recebe a unificação) |
Gera uma fatura que reúne os seus débitos mais os débitos dos contratos unificados a ele. |
| Contrato unificado (filho) |
Não gera fatura própria. Seus débitos vão para a fatura do contrato pai. A tarefa de geração pula esse contrato. |
Onde se define. Na aba Cobrança do contrato filho, o campo de cobrança unificada aponta para o contrato pai, com uma data de início da unificação. A partir dessa data, os débitos do filho passam a entrar na fatura do pai. Quando um contrato é filho, vários campos da aba Cobrança ficam bloqueados e o sistema mostra um aviso indicando o contrato pai — as alterações devem ser feitas no pai.
Antes de unificar, confira: ambos os contratos devem ser do mesmo cliente e estar ativos. Um contrato que já tem outros unificados a ele não pode, por sua vez, ser unificado a um terceiro. O passo a passo completo está em
Contrato unificado
.
Acompanhar as faturas do contrato
Cada contrato mostra as faturas que já gerou em uma aba própria.
Cliente → Contrato → aba Fatura
Abra o contrato e vá até a aba Fatura. Ela lista as faturas geradas para aquele contrato (e, no caso de um contrato pai, também as dos contratos unificados a ele). O título da aba traz a quantidade entre parênteses (ex.: Fatura (3)) quando há faturas. A partir daí você abre uma fatura e segue com as ações dela (regerar, receber, enviar, imprimir) — todas explicadas na wiki de Fatura
.
Atalho. Você também chega a todas as faturas pela tela geral em Cliente → Fatura, filtrando por contrato. A aba dentro do contrato é o caminho rápido quando você já está olhando aquele cliente.
Tarefas automáticas
As faturas dos contratos não são criadas uma a uma. O Quaza tem tarefas que rodam em horários programados e fazem a geração e o envio em lote, lendo a regra de cobrança de cada contrato. Cada tarefa é controlada pela crontab do servidor.
Quem liga/desliga uma tarefa: é o sysadmin editando a crontab do servidor. 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 unificados (os débitos deles vão para o contrato pai). |
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. |
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). É a primeira parada para diagnosticar: se a fatura de um contrato não saiu, aqui você vê quando a tarefa rodou e o que ela reportou.
Módulo desligado trava as tarefas. Se o módulo de faturas estiver desativado, as tarefas de criar e enviar param na hora — mesmo ativas na crontab. Para o lote sair, o módulo precisa estar ligado em Configurações → Configurações da fatura.
Quando dá errado
| Sintoma |
Causa provável |
O que fazer |
| Contrato configurado, mas não gerou fatura no mês |
Sem a ação Geração de Fatura na regra; sem débitos marcados; contrato unificado; ou já tem fatura da competência. |
Confira a regra de cobrança, os débitos marcados e se a fatura já existe. Veja o resumo em Admin → Tarefas. |
| Fatura saiu sem alguns débitos |
Débitos sem a marca Adicionar na próxima Fatura?, ou fora do tipo/período configurado. |
Marque os débitos na aba Débito do contrato e confira os campos de tipo e período na aba Cobrança. |
| Contrato unificado gerou fatura própria (ou não gerou) |
Data de início da unificação ainda não chegou, ou a unificação não foi salva. |
Confira o contrato pai e a data de unificação na aba Cobrança do filho. |
| Fatura veio sem juros (ou com juros indevidos) |
Campo Considerar juros na fatura diferente do esperado. |
Ajuste o campo na aba Cobrança e use Regerar fatura. |
| "Não é possível criar uma fatura avulsa, somente via regra de cobrança" |
Tentou adicionar fatura manualmente na tela de Faturas. |
A fatura nasce do contrato. Use Regerar fatura ou aguarde a tarefa diária. |
| Vendas não entraram na fatura |
Contrato configurado como Apenas mensalidade. |
Mude o tipo para Mensalidades e Vendas e regenere. |
Pegadinhas frequentes
A fatura não tem configuração própria. Tudo que define o conteúdo da fatura está no contrato (aba Cobrança) e na regra de cobrança. Procurar essas opções na tela de Faturas é o engano mais comum.
Sem débito marcado, sem conteúdo. Só entram na fatura os débitos com Adicionar na próxima Fatura?. Mensalidade nova que não recebeu a marca é ignorada na geração.
Sem a ação na regra, nada acontece. Configurar os campos da fatura no contrato não basta: a regra de cobrança precisa ter a ação Geração de Fatura para o contrato realmente gerar.
Contrato unificado não gera fatura própria. Os débitos do contrato filho vão para a fatura do contrato pai. Se você procura a fatura no contrato filho, ela não está lá.
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 no contrato — não tente gerar de novo.
Regra compartilhada afeta vários contratos. Editar uma regra de cobrança usada por muitos contratos muda a fatura de todos. Para isolar um contrato, dê a ele uma regra própria.
Tipo "Apenas mensalidade" esconde as vendas. Se o cliente reclama que uma venda não foi cobrada na fatura, confira primeiro o campo Tipos de débito para fatura do contrato.
Mudou o template no contrato e não conferiu? Sempre teste a impressão com uma fatura real após trocar o template — variável errada quebra o PDF que o cliente vê (a tela de Fatura tem o botão Testar impressão).
Perguntas frequentes
Onde defino o que entra na fatura de um contrato?Na aba Cobrança do contrato (Cliente → Contrato → aba Cobrança). Lá ficam os campos Tipos de débito para fatura, Período dos débitos para fatura, Considerar juros na fatura e Template da fatura. A fatura não tem configuração própria — quem manda é o contrato.
A fatura tem opção de configuração separada?Não. O que define o conteúdo é o contrato (aba Cobrança) e a regra de cobrança. A tela de Faturas serve para trabalhar com a fatura já gerada: listar, regerar, receber, enviar e imprimir.
Por que um contrato não gerou fatura no mês?As causas mais comuns: a regra de cobrança não tem a ação Geração de Fatura, não há débitos marcados para a próxima fatura, o contrato está unificado a outro, ou já existe fatura da competência. Confira o resumo em Admin → Tarefas.
Como faço para a fatura incluir as vendas, não só a mensalidade?No contrato, na aba Cobrança, mude o campo Tipos de débito para fatura de Apenas mensalidade para Mensalidades e Vendas e regenere a fatura.
O que é "Adicionar na próxima Fatura?"É a marca de cada débito que diz se ele entra na próxima fatura do contrato. Fica na aba Débito do contrato. Débito sem essa marca nunca é faturado, por mais que o contrato esteja bem configurado.
Como junto a cobrança de dois contratos do mesmo cliente numa fatura?Use a unificação: na aba Cobrança do contrato filho, aponte a cobrança para o contrato pai e defina a data de início. A partir daí, os débitos do filho entram na fatura do pai. Detalhes em Contrato unificado
.
O contrato unificado gera fatura própria?Não. Os débitos do contrato unificado (filho) vão para a fatura do contrato pai. A tarefa de geração pula o filho. Se você procura a fatura no contrato filho, ela não estará lá — está no pai.
Como a fatura inclui ou ignora os juros?Pelo campo Considerar juros na fatura do contrato: não considerar, somente das vendas, somente das mensalidades ou todos os tipos de débito. Ajuste no contrato e regenere.
Mudei a regra de cobrança e a fatura de outros clientes mudou — por quê?Porque vários contratos podem usar a mesma regra de cobrança. Mexer na regra afeta todos eles. Para isolar um contrato, troque a regra dele ou crie uma regra específica.
Onde vejo as faturas que um contrato já gerou?Na aba Fatura dentro do contrato (o título traz a quantidade entre parênteses). Você também vê todas na tela geral Cliente → Fatura, filtrando por contrato.
O que significam "Competência do financeiro" e "Competência da nota"?São ajustes de mês do contrato: definem se o débito e a nota fiscal contam a competência como o mês passado, o atual ou o futuro em relação ao vencimento. Mexa apenas se a contabilidade do provedor exigir.
Posso gerar a fatura na hora, sem esperar a tarefa diária?Sim. Abra o contrato (ou a fatura) e use Regerar fatura: ela deixa você escolher os débitos, o vencimento e o template e cria/atualiza o documento na hora. O passo a passo está em Fatura
.
Documentos relacionados
-
Fatura
— a tela da fatura: listagem, ações, template e envio. Esta wiki cobre o que o contrato manda para ela.
-
Regras de cobrança
— onde se define quando a fatura é gerada e enviada
-
Contrato unificado
— como juntar a cobrança de vários contratos numa só fatura
-
Mensalidade
— o serviço recorrente que vira débito e entra na fatura
-
Cobrança
— o boleto/PIX/cartão que a fatura agrupa e que o cliente paga
-
Cliente
— dono do contrato e destinatário da fatura