Central de Ajuda Quaza Provedores

O que é a fatura e como configurar

O que é a Fatura e como configurar

O que é a Fatura

A fatura é o documento que agrupa todos os débitos de um contrato do cliente em uma única cobrança. Pense nela como a conta mensal que o cliente recebe, reunindo mensalidades, vendas e parcelas em um só lugar.

A fatura não pode ser criada manualmente. Ela é gerada automaticamente pelo sistema com base nas regras de cobrança configuradas no contrato.


Onde encontrar

Menu: Cliente > Contrato > Fatura

Na listagem você visualiza:

  • Código — Identificador único da fatura
  • Competência — Mês/ano de referência (ex: “Março de 2026”)
  • Cliente — Nome do cliente (clique para abrir o cadastro)
  • Contrato — Número do contrato (clique para abrir)
  • Valor Fatura — Valor total
  • Data envio — Quando a fatura foi enviada pela última vez
  • Data limite de envio — Data máxima para envio automático
  • Situação — Status atual da fatura

Situações da Fatura

Situação O que significa
Em aberto O cliente ainda não realizou nenhum pagamento.
Pagamento parcial O cliente pagou parte do valor da fatura.
Pago Todos os débitos foram quitados. Fatura finalizada.
Sem cobrança A fatura foi gerada mas não possui débitos vinculados.

Tela de Edição da Fatura

Ao clicar em uma fatura na listagem, você acessa a tela de edição. Todos os campos são somente leitura.

Campo Descrição
Competência Mês/ano de referência da fatura
Empresa Empresa responsável
Situação Status atual (Em aberto, Parcial, Pago, Sem cobrança)
Cliente Cliente vinculado
Contrato Contrato vinculado
Vencimento Data de vencimento da cobrança
Data limite de envio Data máxima para envio automático
Data último envio Quando foi enviada pela última vez
Template de fatura Template usado para gerar o PDF
Valor Original Soma dos débitos antes de pagamentos e descontos
Valor Fatura Valor total calculado da fatura
Valor Desconto Total de descontos aplicados
Valor Aberto Quanto falta pagar (Original - Pago - Desconto)
Valor Pago Quanto já foi pago

Aba “Cobrança”

Aparece somente quando a fatura possui cobrança vinculada (boleto, PIX, etc).

Campo Descrição
Forma de pagamento Carteira/modelo utilizado (ex: Boleto Sicredi, PIX)
Situação da cobrança Status do boleto/PIX no financeiro
Número Número da cobrança
Nosso Número Identificação bancária
Vencimento Data de vencimento da cobrança
Valor Valor original da cobrança
Data de pagamento Quando foi pago (se aplicável)
Valor pago Quanto foi pago
Código de barras Código de barras do boleto
Linha digitável Linha digitável do boleto
PIX QR Code para pagamento via PIX

Itens da Fatura

Abaixo dos valores, aparece a grade de itens mostrando cada débito que compõe a fatura, e também as notas fiscais vinculadas.


Ações disponíveis

Os botões de ação ficam na lateral da tela de edição. Alguns só aparecem dependendo da situação da fatura e das suas permissões.

Enviar fatura

Ícone: Envelope
O que faz: Envia a fatura para o cliente pelo canal escolhido.
Canais:
  • E-mail — Envia com PDF da fatura em anexo. Pode incluir notas fiscais se configurado.
  • WhatsApp — Envia via integração automática com WhatsApp.
  • WhatsApp Web — Abre o WhatsApp Web no navegador para envio manual.
Requisito: O contrato precisa ter um template de fatura configurado.

Passo a passo:

  1. Abra a fatura desejada
  2. Clique no botão “Enviar fatura”
  3. Escolha o canal de envio (E-mail, WhatsApp ou WhatsApp Web)
  4. Confirme o envio
  5. O sistema registra a data de envio no histórico da fatura

Regerar fatura

Ícone: Fatura (file-invoice-dollar)
O que faz: Recalcula a fatura do zero: atualiza valores, refaz os itens e gera nova cobrança se necessário.
Quando usar:
  • Um débito foi adicionado ou removido após a geração da fatura
  • O valor de algum débito mudou
  • Precisa gerar nova cobrança com valor atualizado
Requisitos: Fatura não pode estar paga. Precisa da permissão “Permitir regerar fatura”.
[SCREENSHOT]
Print do popup de regeração de fatura
Atenção: Ao regerar, as cobranças anteriores que tiverem valor ou vencimento diferente serão removidas e substituídas por novas. Certifique-se de que o cliente não já pagou a cobrança antiga antes de regerar.

Receber fatura (dar baixa)

Ícone: Dinheiro (money-bill-wave) — botão verde
O que faz: Registra o pagamento da fatura. Liquida as cobranças e marca a fatura como Pago.
Requisitos: Fatura não pode estar paga. Precisa da permissão “Pagar” no módulo financeiro.
[SCREENSHOT]
Print do popup de pagamento mostrando os campos “Valor pago” e “Data de pagamento”.

Passo a passo:

  1. Abra a fatura desejada
  2. Clique no botão “Receber fatura” (verde)
  3. Informe o valor pago
  4. Informe a data do pagamento
  5. Confirme
  6. O sistema liquida as cobranças e atualiza a situação para “Pago”

Gerar cobrança

Ícone: Código de barras (barcode) — botão vermelho
O que faz: Gera um novo boleto/cobrança para a fatura. Útil quando a cobrança anterior expirou ou foi cancelada.
Requisitos: Fatura não pode estar paga. Precisa da permissão “Adicionar” no módulo financeiro.

Verificar gateway

Ícone: Sync — botão vermelho
O que faz: Consulta o gateway de pagamento (banco/operadora) para verificar se houve pagamento ainda não registrado no sistema.
Quando usar: O cliente diz que pagou, mas a fatura ainda aparece “Em aberto”.
Requisitos: A cobrança precisa ter integração com gateway configurada na carteira modelo.

Imprimir fatura

Ícone: Impressora (print)
O que faz: Gera o PDF da fatura usando o template configurado e abre no navegador. Você pode salvar ou imprimir.
Requisitos: Sempre disponível.

Acessar portal do cliente

Ícone: Check
O que faz: Abre o portal do cliente em uma nova aba, na visão do cliente. Útil para dar suporte.
Requisitos: O portal do cliente precisa estar habilitado nas configurações do sistema.

Links rápidos

Botão Abre
Ver Contrato O contrato vinculado à fatura (nova aba)
Ver Cliente O cadastro do cliente (nova aba)
Ver Cobrança A cobrança financeira vinculada (nova aba)
Ver Template de Fatura O template usado para gerar o PDF (nova aba)

Geração automática de faturas

O sistema executa uma tarefa agendada diária que gera as faturas automaticamente. Nenhuma ação manual é necessária se as regras estiverem configuradas corretamente.

Como funciona

  1. O sistema verifica todas as Regras de Cobrança que possuem a ação “Gerar Fatura”
  2. Para cada regra, calcula se hoje é o dia correto para gerar, com base no dia de referência
  3. Busca os contratos elegíveis:
    • Contrato usa essa regra de cobrança
    • Contrato não faz parte de cobrança unificada
    • Contrato não possui fatura na competência atual
    • Contrato possui pelo menos 1 débito marcado para próxima fatura
  4. Para cada contrato, o sistema:
    • Junta os débitos pendentes
    • Calcula o valor total da fatura
    • Cria a fatura com competência e vencimento
    • Gera a cobrança (boleto/PIX) automaticamente
Dica: O vencimento respeita dias úteis e feriados quando a configuração de vencimento está definida como “Dia da Semana”. Vencimentos que caem em feriados ou finais de semana são automaticamente movidos para o próximo dia útil.

Regras importantes sobre a geração

  • Faturas são geradas por contrato. Sem contrato ativo, não há geração.
  • Se o contrato estiver ativo mas sem débitos, a fatura não é gerada.
  • Clientes com múltiplos contratos geram múltiplas faturas. Para unificar, configure a cobrança unificada nos contratos.
  • A fatura gera uma cobrança (boleto) que unifica os valores de mensalidade, podendo incluir vendas e parcelas conforme configuração.
  • O valor é a soma do que falta pagar dos débitos em aberto.
  • Débitos já vinculados a outras cobranças não geram cobrança duplicada.
  • Vendas vinculadas ao contrato não geram cobrança separada se o contrato estiver configurado para vincular todos os tipos de débitos na fatura.
[SCREENSHOT]
Print da tela de Regra de Cobrança mostrando a ação “Gerar Fatura” configurada com o dia de referência.

Envio automático de faturas

Outra tarefa agendada diária cuida do envio automático das faturas para os clientes.

Canais de envio

Canal Configuração na Regra O que envia
E-mail Ação “Enviar Fatura por E-mail” E-mail com PDF da fatura + notas fiscais (se configurado)
WhatsApp Ação “Enviar Fatura por WhatsApp” Mensagem via WhatsApp com dados da cobrança

Como funciona o envio

  1. O sistema verifica as regras de cobrança com ação de envio configurada
  2. Calcula se hoje é o dia correto com base nos dias antes do vencimento
  3. Busca as faturas da competência correspondente
  4. Envia pelo canal configurado
Envio de segurança: Se uma fatura atingir a data limite de envio e nunca tiver sido enviada, o sistema tenta enviar automaticamente por todos os canais disponíveis como fallback.
Dias personalizados por contrato: É possível configurar dias de envio específicos no próprio contrato (campos “Dias e-mail vencimento” e “Dias WhatsApp vencimento”), sobrescrevendo a regra geral. Aceita múltiplos dias separados por vírgula (ex: 5,3,1 para enviar 5, 3 e 1 dia antes do vencimento).
[SCREENSHOT]
Print da tela de Regra de Cobrança mostrando as ações de envio por E-mail e WhatsApp configuradas.

Configurações do sistema

Configuração O que faz
Módulo de Faturas Habilita ou desabilita o módulo inteiro. Se desabilitado, nenhuma fatura é gerada ou enviada.
Múltiplas cobranças Permite que uma fatura tenha mais de uma cobrança vinculada.
Vencimento em dia útil Move vencimentos que caem em fins de semana ou feriados para o próximo dia útil.
Enviar faturas pagas Se ativado, envia faturas mesmo que já estejam com status “Pago” ou “Sem cobrança”.
Portal do cliente Habilita o acesso do cliente ao portal onde pode ver suas faturas.

Permissões necessárias

Para acessar todas as funcionalidades da fatura, o grupo de usuário precisa ter as seguintes permissões:

Permissão Onde configurar O que libera
Permitir regerar fatura Contrato > Fatura Botão “Regerar fatura”
Pagar Financeiro > Débito Recebimento Botão “Receber fatura”
Adicionar Financeiro Botão “Gerar cobrança”

Política de juros

Ao configurar o contrato, você define como os juros dos débitos são considerados na fatura:

Opção Comportamento
Não considerar juros A fatura é gerada sem juros, independente de atraso.
Somente das vendas Calcula juros apenas sobre débitos do tipo “venda”.
Somente das mensalidades Calcula juros apenas sobre débitos do tipo “mensalidade”.
Todos os tipos de débito Calcula juros sobre todos os débitos da fatura.

Tipo de período

Define quais débitos entram na fatura:

Opção Comportamento
Todos débitos sem fatura até o mês de geração Inclui todos os débitos que ainda não foram vinculados a nenhuma fatura.
Todos débitos em aberto até o mês de geração Inclui todos os débitos em aberto, mesmo que já tenham sido faturados anteriormente.

Perguntas frequentes

Posso criar uma fatura manualmente?
Não. A fatura é gerada automaticamente pela regra de cobrança. Para forçar uma nova fatura, configure os débitos e aguarde a tarefa ou use “Regerar” em uma fatura existente.

O cliente pagou mas a fatura ainda aparece “Em aberto”. O que faço?
Clique em “Verificar gateway” para consultar o banco. Se o pagamento for confirmado, o sistema atualiza automaticamente. Caso contrário, use “Receber fatura” para registrar a baixa manualmente.

Preciso mudar o valor da fatura. Como?
Ajuste os débitos no contrato do cliente e depois clique em “Regerar fatura”. O sistema recalcula tudo automaticamente.

A fatura não foi enviada para o cliente. Por quê?
Verifique:

  1. O contrato tem um template de fatura configurado?
  2. A regra de cobrança tem ação de envio configurada?
  3. O cliente tem e-mail ou telefone WhatsApp cadastrado?
  4. A tarefa de envio está rodando? Verifique no log de tarefas.

A fatura apareceu com valor errado. O que aconteceu?
O valor da fatura é calculado com base nos débitos abertos do contrato. Verifique se todos os débitos estão corretos e, se necessário, regere a fatura.

Posso enviar a fatura mais de uma vez?
Sim. Abra a fatura e clique em “Enviar fatura” quantas vezes precisar. Cada envio é registrado no histórico.

O que é a “competência”?
É o mês/ano de referência da fatura. Exemplo: uma fatura com competência “Março de 2026” se refere aos débitos do mês de março. A competência pode ser adiantada conforme a configuração de “competência utilizada” do contrato.