Central de Ajuda Quaza Provedores

Fatura (PT)

Fatura — Quaza

Fatura — Agrupamento de Cobranças em 1 Boleto

A Fatura é o documento que agrupa múltiplas cobranças de um cliente em um único boleto/PIX. Ao invés de gerar 3 boletos separados (mensalidade + telefonia + cobrança avulsa), gera 1 só com o valor total.

É um conceito separado da Mensalidade e da Cobrança :
  • Mensalidade = débito recorrente do contrato
  • Cobrança = boleto/PIX/cartão concreto pra pagar 1 débito
  • Fatura = "embrulho" que junta múltiplos débitos em 1 cobrança consolidada
Habilitar fatura é opcional — provedores mais simples cobram débito a débito. Provedores maduros usam fatura pra reduzir confusão do cliente.
Nesta wiki:

Visão geral — fatura vs cobrança avulsa

Sem Fatura (modo simples) Com Fatura (modo agrupado)
Cliente recebe 3 boletos: mensalidade (R$ 100), telefonia (R$ 50), instalação (R$ 200) — total R$ 350 em 3 envios Cliente recebe 1 boleto/PIX único de R$ 350 com detalhamento dos 3 itens
Cada boleto tem sua própria data de vencimento Todos vencem no mesmo dia (configurável)
Cliente pode pagar 1, esquecer o outro 1 pagamento resolve tudo — menos inadimplência parcial
Mais simples de configurar Requer template + regras de agrupamento
Ideal pra provedor pequeno Ideal pra provedor com diversos serviços (internet + telefonia + SVA)
Por que usar fatura? Reduz reclamações ("recebi vários boletos!"), aumenta taxa de pagamento integral, simplifica o portal do cliente. Provedor com só 1 produto (internet) não ganha muito; com múltiplos produtos, ganha bastante.

Glossário

Termo Significado
Fatura Documento agrupador com N itens — uma "conta consolidada" do mês
Item de fatura Cada linha dentro: mensalidade, telefonia, SVA, lançamento manual
Template de fatura Modelo visual/de regras — define agrupamento, layout PDF, dia de vencimento
Vencimento agrupado Data única do total — sobrescreve datas individuais dos itens
Fatura pré-paga Cobrança antes da prestação do serviço (ex: 1ª fatura adiantada)
Fatura pós-paga Cobrança após uso (ex: telefonia VoIP — cobra minutos do mês passado)
Regra de agrupamento O que entra em qual fatura (por contrato, por carteira, por mês de competência)
Fatura mestre / detalhe Pra clientes corporativos: 1 fatura mestre com N detalhes por filial/unidade

Fluxo completo (Mensalidade → Fatura → Cobrança)

DEBITOS GERADOS no mês: • Mensalidade contrato 1: R$ 100 (vence dia 10) • Telefonia (VoIP): R$ 50 (vence dia 10) • Instalação (lançamento manual): R$ 200 (vence dia 15) ↓ Cron de Fatura roda (Tarefa "Contrato - Criar as Faturas") ↓ Sistema lê regra do Template: • Agrupar débitos do mesmo contrato no mesmo mês • Vencimento agrupado: dia 10 (do menor) • Layout: template "Padrão" ↓ ┌─────────────────────────────────────────────┐ │ FATURA criada │ │ Total: R$ 350 (R$ 100 + R$ 50 + R$ 200) │ │ Vencimento: dia 10 │ │ Itens: 3 linhas detalhadas │ └─────────────────────────────────────────────┘ ↓ Cron de Cobrança roda ↓ ┌─────────────────────────────────────────────┐ │ COBRANÇA (boleto/PIX) registrada no banco │ │ Valor único: R$ 350 │ │ Linha digitável única │ └─────────────────────────────────────────────┘ ↓ Cliente recebe e paga R$ 350 de uma vez ↓ RETORNO → fatura paga → automaticamente baixa os 3 itens (mensalidade, telefonia, instalação)
Sem fatura: os 3 débitos viram 3 cobranças (3 boletos), 3 vencimentos, 3 retornos. Com fatura: 1 boleto, 1 vencimento, 1 retorno, e baixa em cascata dos 3 itens.

1. Listagem de Faturas

Caminho: Contrato → Fatura

Colunas principais

Coluna O que mostra
Cliente Dono da fatura
Mês Referência Período de competência (04/2026)
Valor Total agrupado de todos os itens
Vencimento Data agrupada da fatura
Itens Quantos débitos foram agrupados
Situação Aberta / Paga / Vencida / Cancelada / Renegociada
Cobrança gerada Sim/Não — se já tem boleto pra cliente pagar

2. Templates de Fatura

Caminho: Contrato → Fatura Template

Cada Template define:

  • Layout do PDF — logo, cores, ordem dos itens, mensagens
  • Regra de agrupamento — por contrato, por carteira, por categoria
  • Dia de vencimento — fixo (todo dia 10) ou variável (menor dos itens)
  • Itens incluídos — mensalidade + telefonia + lançamentos? Só mensalidade?
  • Cliente alvo — todos / só corporativos / por carteira

Campos do template

Campo O que faz
Descrição Nome interno (Padrão, Corporativo, Pré-paga)
Empresa Em multi-empresa, qual empresa usa este template
Carteira Qual carteira de cobrança vai processar (Itaú, Asaas, etc.)
Dias antes do vencimento — gerar fatura Quantos dias antes do vencimento o cron cria a fatura (ex: 5)
Dia padrão de vencimento Se fixo (todo dia 10), preenche aqui
Tipos de débito incluídos Mensalidade / Telefonia / SVA / Lançamento manual / Renegociação
Layout PDF HTML/CSS do PDF — logo, cores, instruções de pagamento
Permite parcial Cliente pode pagar parte da fatura?
Template "Padrão" é obrigatório: sistema usa ele como fallback quando contrato não tem template específico. Não desabilite o padrão sem ter substituto definido.

3. Faturas no Contrato

Caminho: Cliente → editar Contrato → aba Faturas

O que vê

  • Faturas abertas (pendentes de pagamento)
  • Faturas pagas (com data de baixa)
  • Faturas canceladas (com motivo)
  • Botão pra gerar fatura manual (forçar agrupamento agora)
  • Botão pra imprimir 2ª via

Pegadinhas frequentes

1. Cliente recebe 2 boletos: 1 da fatura + 1 da mensalidade avulsa
Aconteceu quando mensalidade foi gerada FORA do período de agrupamento da fatura. Solução: ajustar template pra incluir mensalidade do mês corrente, ou cancelar a cobrança avulsa e regenerar a fatura.
2. Fatura "Paga" mas item interno aparece "Em aberto"
Bug de cascata da baixa. Geralmente quando fatura é parcialmente paga (cliente pagou só 1 item). Verifique configuração "Permite parcial" no template.
3. Cron de Fatura não rodou — clientes com débito sem fatura
Tarefa "Contrato - Criar as Faturas" desabilitada ou com erro. Veja Admin → Tarefas Log . Religar + rodar manual em massa pra recuperar.
4. Fatura cancelada mas itens continuam gerando cobrança
Cancelamento de fatura NÃO cancela os débitos internos — só o agrupamento. Os débitos voltam a ser cobrados individualmente. Pra cancelar tudo, cancele cada item separadamente.
5. Template editado afeta faturas já geradas
Mudou template "Padrão" → mudança vale só pra faturas FUTURAS. Faturas existentes não são reprocessadas. Pra ressincronizar, cancele + gere novamente.
6. Cliente com 2 contratos — 1 fatura ou 2?
Depende da regra de agrupamento. Se "agrupar por cliente", 1 fatura única. Se "agrupar por contrato", 2 faturas. Configure conforme política comercial — corporativos preferem 1 fatura unificada.
7. Fatura com valor zerado / negativo
Item virou crédito (ex: estorno) com valor maior que outros itens. Quaza não emite boleto com valor ≤ 0 — fatura fica "Aberta sem cobrança". Cancele + redistribua crédito.

Galeria de telas

Menu caminho
Menu caminho
Listagem faturas
Listagem faturas
Listagem templates
Listagem templates
Form editar template
Form editar template
Contrato aba fatura
Contrato aba fatura

Documentos relacionados

Aprofunde-se nos temas conexos:

FAQ

Posso desabilitar fatura e voltar pra cobrança avulsa?

Sim — desabilitar o template default ou definir contratos pra "Sem agrupamento". Mas faturas já abertas continuam até serem pagas/canceladas.

Cliente quer pagar só 1 item da fatura — pode?

Só se "Permite parcial=Sim" no template. Senão tem que pagar tudo ou nada. Configure conforme política.

Como fatura lida com cliente que pediu cancelamento do serviço no meio do mês?

Cancela contrato → próximas faturas não geram. Fatura atual (do mês corrente) pode ser ajustada manualmente pra pró-rata, ou mantida cheia conforme política contratual.

Tem como ver KPI "fatura média do cliente"?

Cliente → editar → aba financeira mostra histórico. Pra média da base: Relatórios Financeiros → ticket médio.

Cliente reclamou que fatura veio com item que não reconhece — como auditar?

Abra a fatura → veja os N itens com origem (contrato, lançamento manual, etc.). Cada item tem link pro débito original.

Posso gerar uma fatura "antecipada" do próximo mês?

Sim — caso típico de fatura pré-paga. Use geração manual no template configurado pra antecipação.

Multi-empresa: fatura junta cobranças de 2 empresas?

Não — fatura é por empresa fiscal. Cliente com contratos em 2 empresas recebe 2 faturas separadas (RUC/CNPJ diferentes).