Central de Ajuda Quaza Provedores

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.

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

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.

Aba “Cobrança”

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

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

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

Receber fatura (dar baixa)

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

Verificar gateway

Imprimir fatura

Acessar portal do cliente

Links rápidos

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

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.

Envio automático de faturas

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

Canais de envio

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

Configurações do sistema

Permissões necessárias

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

Política de juros

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

Tipo de período

Define quais débitos entram na fatura:

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.

Glossário

Pegadinhas frequentes

FAQ

Quem pode acessar essa funcionalidade?

Depende da permissão do usuário. Confira com o administrador do Quaza se você não vê a opção.

O que fazer se aparecer um erro?

Anote a mensagem completa, screenshot, e abra um chamado no suporte do Quaza com esses dados.

Esta funcionalidade tem versão para cliente final?

Algumas funcionalidades têm Portal do Cliente. Verifique no módulo Portal .

Posso integrar via API?

Sim — a maioria das funcionalidades do Quaza expõe endpoints REST. Consulte a documentação técnica.

Quaza tem treinamento oficial?

Sim — equipe de suporte oferece sessões de onboarding sob agendamento.

Ciclo completo da operação

Boas práticas operacionais

Para tirar o máximo desta funcionalidade, observe os pontos abaixo. São práticas que provedores experientes adotam para evitar erros recorrentes e maximizar valor extraído do Quaza.

Antes de operar

• Confirme permissão de acesso: nem todo operador tem permissão para todas as funcionalidades. Verifique com o administrador do Quaza se algo não aparece como esperado. Permissões são vinculadas a papéis (operador, supervisor, admin).
• Cadastros pré-requisitos completos: muitas funcionalidades dependem de outros cadastros estarem completos antes. Por exemplo, antes de criar um contrato você precisa ter o cliente cadastrado, plano de vendas configurado, e regras de cobrança definidas.
• Treine pelo menos 2 operadores: redundância previne paralisação por ausência. Funcionário pode sair, ficar doente, ter dia ruim. Mantenha conhecimento distribuído entre múltiplas pessoas.
• Documente procedimentos internos: crie checklist próprio para operações recorrentes. Quem opera amanhã agradece — especialmente se for funcionário novo.

Durante a operação

• Documente decisões não óbvias: se você ajustou algo de forma diferente do default, anote o porquê. Próximo operador agradece e evita refazer análise.
• Operações em massa pedem cuidado: antes de aplicar a 100+ registros, teste com 5 e revise resultado completo. Se possível, exporte CSV antes para ter como rollback.
• Backup antes de mudanças grandes: cancelar/desfazer pode não ser possível em todas as ações. Em dúvida, faça export ou imprima tela antes.
• Comunique alterações: mudanças que impactam outras equipes (atendimento, financeiro) devem ser anunciadas com antecedência. Surpresa gera retrabalho.

Acompanhamento e revisão

• Revisão semanal de 30 minutos: dedique tempo regular para revisar o que rodou, falhou, ficou pendente neste módulo. Anomalia detectada cedo custa 10x menos que descoberta tarde.
• Defina KPIs próprios: 2-3 indicadores que medem saúde da operação. Acompanhe tendências, não só valores absolutos. Variação maior que 20% merece investigação.
• Auditoria mensal: revise sample de operações do mês passado. Use logs para confirmar que tudo aconteceu como esperado, sem desvios silenciosos.
• Compare com período anterior: "Vendi R$ 100k" — é bom? Compare com mês anterior, mesmo mês ano passado. Contexto importa mais que número absoluto.

Resolução de problemas

• Anote a mensagem de erro completa: copie o texto exato. Captura de tela ajuda. Anote quais passos levaram ao problema — facilita diagnóstico.
• Tente reproduzir em ambiente de teste: se possível, simule o erro com dado dummy antes de pedir suporte. Isso acelera resolução.
• Procure no histórico: provavelmente alguém já viu erro similar. Veja log de auditoria para entender o que mudou recentemente.
• Abra chamado bem documentado: equipe de suporte do Quaza resolve mais rápido com contexto: o que esperava, o que aconteceu, frequência, screenshots.

Indicadores típicos a acompanhar

Cada provedor define seus próprios indicadores, mas alguns são quase universais para qualquer operação no Quaza:

• Volume mensal processado (registros/transações/eventos)
• Taxa de erro (% de operações que falharam)
• Tempo médio de processamento
• Cobertura (% da carteira atendida pela funcionalidade)
• Satisfação operacional (feedback da equipe que usa)

Compare valores atuais com média dos últimos 3 meses. Variação maior que 20% em qualquer direção merece investigação — pode ser melhoria sustentável ou degradação silenciosa.

Recursos relacionados no Quaza

Este recurso se conecta com outros módulos do sistema. Conhecer essas conexões ajuda no troubleshooting e em decisões operacionais:

• Cadastro de cliente — base de tudo no Quaza. Cliente bem cadastrado evita problemas downstream.
• Plano de Contas — onde o impacto financeiro é classificado contabilmente.
• Logs de auditoria — histórico de quem fez o quê e quando, essencial para diagnóstico.
• Permissões e papéis — definem quem pode operar o quê.
• Tarefas crontab — automações que tocam neste recurso periodicamente.

Referência rápida

Atalhos e shortcuts para operação eficiente:

• Busca avançada: use filtros de data, status, responsável para reduzir lista. Filtro padrão pode esconder registros antigos.
• Exportação: a maioria das listas exporta para CSV/Excel. Útil para análise externa ou backup pré-mudança.
• Histórico: cada registro tem timeline de modificações. Acesse via botão "Histórico" ou aba lateral.
• Atalhos de teclado: Ctrl+F (busca), Ctrl+S (salvar), Esc (cancelar) na maioria das telas.
• Permissão restrita: se botão estiver cinza, é falta de permissão — não bug.