Neste manual vamos demonstrar as configurações, funcionalidades e demais informações sobre a fatura.

Neste manual vamos demonstrar as configurações, funcionalidades e demais informações sobre a fatura.

O que é

Uma nova forma, mais simplificada, de agrupar os débitos e cobrar os clientes, onde o cliente e a empresa conseguem ter um melhor controle do que esta sendo cobrado.

Como funciona

Todos os dias, será executada uma tarefa que irá verificar as regras de cobrança de contrato e poderá gerar as faturas, e outra tarefa para o envio das faturas por e-mail ou whatssapp, de acordo com a configura-
ção de envio no contrato regra ou no campo dias de aviso vencimento do contrato, respeitando os dias de vencimento ante a regra.

Em caso de data limite informada na fatura, se a fatura não tiver data do ultimo envio, o sistema vai enviar a fatura do jeito que está.

Tarefas Localizadas em:

web/quaza/tarefas/contrato/contratofaturagerar.php
web/quaza/tarefas/contrato/contratofaturaenviar.php

Regras de Contrato - Gerar

No exemplo da WIKI, utilizarei o dia 10.

A quantidade de dias adicionado a ação da regra é a quantidade de dias, com referência ao dia do vencimento, como foi escolhido o dia -5, ele irá gerar as faturas, 5 dias antes do dia 10.
Se não tiver regra de geração de fatura cadastrada, não irá gerar faturas. Essas regras são informadas no contrato

Regras de Contrato - Enviar

Enviar Fatura, tanto por E-mail quanto por Whatsapp, podera ser escolhido um template, desde que seja do tipo de envio fatura.

Informações

As faturas serão geradas em cima dos contratos com debitos em aberto, se contrato inativo e sem debitos, não cria, se contrato ativo e sem debitos, será gerada uma fatura sem itens e sem cobrança.

Se o cliente tiver mais de um contrato ativo, será gerado mais de uma fatura, para gerar uma única fatura, terá que ser feito a "unificação de contrato".

A fatura irá gerar, se necessario, uma cobrança, (Financeiro), unificando todos os valores de mensalidade do cliente, dependendo da configuração, poderá adicionar até as vendas/parcelas, o valor da fatura será a soma
do que falta pagar dos débitos abertos, caso a fatura seja so da unica mensalidade, ou seja, tiver um financeiro com, data de vencimento, valor, e contrato, não vinculado a outra fatura

A cobrança será gerada para débitos (debitoDetalhe) que não serão inclusas na fatura, ou seja, TODAS as mensalidades, não gerarão mais cobrança, pois gerarão cobrança na fatura, isso fará que o
cliente não seja cobrado duas vezes sobre o mesmo débito. As vendas, se vinculadas a contrato, não gerarão cobrança, SE contrato estiver marcado como vincular TODOS os tipo de débitos na fatura.

Cliente e Operador ainda poderão gerar cobranças manuais, eles terão que cuidar, nos débitos tera uma flag (checkbox) que avisa se o débito vai estar ou esta vinculada a uma fatura.

As faturas serão geradas automaticamente, de acordo com a configuração de regra de cobrança do contrato.

As faturas poderão ser enviadas para os clientes via e-mail, utilizando um template de e-mail, ou de forma automática pela tarefa diária conforme as datas de envio configuradas.

Se for removido o débido recebimento, e este débito estiver vinculado a uma fatura, a fatura sera re gerada automaticamente, o sistema ira pedir se precisa gerar/vincular uma nova cobrança com a fatura.

Como verificar as faturas

Menu Cliente -> Fatura

Todos os campos em azul são links para suas respectivas e Edições/Visualizações.

Se clicar no icone do código, ira visualizar a fatura, outra maneira é dar um duplo clique com o botão esquerdo em qualquer lugar da linha.

Menu Cliente -> Cliente -> Edição do Cliente -> Tab Fatura

Menu Cliente -> Contrato -> Edição do contrato -> Tab Fatura

Como Verificar os templates de Fatura

Menu Cliente -> Fatura Template

Entidades

Fatura

competência

Vai exibir qual o mês de referência essa fatura está cobrando.

empresa

Qual empresa que está aplicando a cobrança desta fatura.

situação

A Situação da fatura, pode ser "Em aberto", "Parcial" ou "Pago".

cliente

Nome e código do cliente a quem está vinculada a fatura.

contrato

Número e código do contrato sobre qual estão vinculadas as mensalidades e as vendas/parcelas de serviços/compras.

data de vencimento

A data de vencimento da cobrança, caso não tenha uma, preenche com a data que seria gerada a fatura, de acordo com a regra de cobrança do contrato.

data limite envio

A data limite de envio é ate quando a fatura pode ficar sem ser enviada, inalteravel por enquanto.

data ultimo envio

A data de ultimo envio, é a data que pela ultima vez foi enviada a fatura para o cliente, tanto por e-mail quanto whatsapp, atualmente nao envia por SMS.

Template de fatura

Com qual o template a fatura sera gerada, podendo ter mais de um template configurado, é obrigatório ter pelo menos um template, Tempalte vinculado seguindo cadastro do contrato.

valor original

Valor das mensalidades/produtos sem acréscimos e sem descontos.

valor fatura

Valor das mensalidades/produtos com acréscimos e descontos.

valor aberto

Valor que terá/tem a cobrança, será o valor da fatura menos os valores já pagos.

valor pago

Valores que já foram pagos das mensalidade/parcelas.

débitos vinculados

A lista de todos os débitos de mensalidade e parcelas que foram vinculados a fatura na sua geração. Esses débitos são todos os débitos individuais(?), se for uma fatura de um contrato unificado,
irá aparecer TODOS os débitos de TODOS os contratos, se tiver mil e duzentos contratos unificados, terão mil e duzentos débitos vinculados.

notas fiscais

A lista de todas as notas ativas das mensalidades/parcelas que estão vinculadas aos débitos da fatura.

Fatura Template:

No template ficará as informações de título, corpo e os envios para cada modelo.

O conteúdo do template será um HTML que será gerado em PDF trocando as TAGs pelo valores individuais, será permitido alguns comandos a mais como validações (IFs) e iterações (FOREACHs)

O padrão configurado para cada um dos clientes ficará, para em caso de Boleto

Exemplo de uma fatura com pix, boleto, e com cobranças de mensalidades, vendas e telefonias.

Configurações

Menu Cliente - > Contrato -> Tab Cobrança

Existem 3 tipos de configurações

1. Tipo de Débito para fatura

Quais tipos de débitos serão incluídos na fatura.

Apenas mensalidades

O sistema pegará os débitos que:

• não possuem vinculo com vendas
• não estão marcados como removidos
• não foram desmarcados como próxima fatura

Mensalidades e Vendas (Padrão)

O Sistema pegará os débitos que:

• não estão marcados como removidos
• não foram desmarcados como próxima fatura

2. Período de débitos para a fatura

Período de vencimento dos débitos que entrarão na próxima fatura.

Opções

Todos débitos sem fatura até o final do mês de geração (Padrão)

O sistema pegará os débitos

• a data de vencimento seja ate o dia de vencimento, do contrato
• não já estejam vinculada a uma fatura
• não estão marcados como removidos
• não foram desmarcados como próxima fatura

Todos débitos em aberto até o final do mês de geração

O sistema pegará os débitos que

• a data de vencimento seja ate o dia de vencimento, do contrato
• que a situação seja EM ABERTO
• não estão marcados como removidos
• não foram desmarcados como próxima fatura.

3. Considerar Juros na Fatura

Utilizado para definir se a fatura vai considerar o valor dos juros dos débitos atrasados na hora de gerar o seu valor.

Lembrando que, se o débito tem uma data de vencimento anterior a data de vencimento da fatura, ele pode ter seus próprios valores de juros e multa e essa configuração vai dizer se a fatura deve
incluir esses valores de acréscimo anteriores a data de vencimento da fatura. Essa opção diz respeito somente para a geração da fatura, a cobrança da fatura estará sujeita as suas próprias regras

de desconto, juros e multa da carteira informada.

Não considerar juros:

Não irá considerar nenhum juros dos débitos atrasados na geração do valor da fatura. Pegará o valor original para a geração da cobrança da Fatura.

Somente das vendas:

Irá considerar somente os juros dos débitos de vendas atrasados na geração do valor da fatura. Para os demais débitos, pegará o valor original para a geração da cobrança da Fatura.

Somente das mensalidades:

Irá considerar somente os juros dos débitos das mensalidades na geração do valor da fatura. Para os demais débitos, pegará o valor original para a geração da cobrança da Fatura.

Todos os tipos de débitos:

Irá considerar os juros dos débitos atrasados na geração do valor da fatura.

Outras Funcionalidades

Verificar Próxima fatura

Uma previsão da próxima fatura pode ser verificada em dois lugares:

• Menu Cliente -> Cliente -> Edição do Cliente -> Tab Fatura

• Menu Cliente -> Contrato -> Edição do contrato -> Tab Fatura

Ambos lugares terão um botão a direita para mostrar a previsão para a próxima fatura, nele é aberto um popup mostrando o contrato, a data de geração da fatura, a data de vencimento da fatura,
configuração atual do contrato, os valor previstos para o vencimento, e os débitos que já estão vinculados e que serão cobrados. Lembrando que é uma previsão e que a fatura pode sofrer alterações
até a geração.

OBS:

Se a tela for aberta pelo menu cliente, será possível escolher entre os contratos ativos, quais quer ver, se for aberto pelo contrato, não poderá escolher o contrato.

A próxima fatura vai respeitar a configuração do contrato, então se modificar o configuração do contrato, as informações podem sofrer mudanças.

Campos

Contrato

Um campo para poder selecionar os contratos ativos do cliente atual, se aberto pelo contrato, não poderá selecionar outro. Ao mudar, o sistema irá preencher as informações com valores e débitos
do novo contrato de forma automática.

Data geração

Um campo para informar a possível data de geração da fatura, se não sofrer alterações. Para modificá-la, acesse o contrato regra e modifique a ação de Gerar Fatura.

Data vencimento

Um campo informando a possível data de vencimento, é em cima dessa informação que os débitos da fatura serão "vinculados". Para modificá-la, acesse o contrato e mude a regra de cobrança.

Tipo de Fatura, Tipo período e Considerar os juros dos débitos

Esses campos são responsáveis para saber quais débitos buscar para "vincular" a fatura, e a regra de geração do valor da cobrança. Para modificá-la, acesse o contrato na aba Info.

Carteira

Um campo para informar carteira modelo vinculada ao contrato. Para modificá-la, acesse o contrato.

Valor original

Um campo para informar o valor que a fatura teria, se cobrasse a soma dos valores originais dos débitos, inclusive do que já foi pago.

Valor fatura

Um campo para informar o valor da Fatura, a soma dos valores originais com os acréscimos e os descontos.

Valor pago

Um campo para informar o valor total já pago dos débitos.

Valor cobrança

O valor que falta pagar dos débitos "vinculados", sendo a soma dos valor da fatura menos o valor pago, o valor da cobrança.

Débitos

A tabela dos débitos que estão inclusos na fatura com a composição de valores de cada.

Regerar Fatura

O Regerar Fatura pode ser acessado tanto pela tela de edição de fatura, quanto pelo contrato, na aba fatura, desde que tenha permissão de Fatura -> Permitir Regerar.

Menu Cliente -> Fatura -> Edição da Fatura -> Botão Regerar Fatura.

O regerar fatura, serve para qualquer alteração sobre a fatura, seus itens, template e a cobrança, se os itens sofrerem mudanças, alguma delas for paga, a fatura tem que ser regerada, juntamente
com a cobrança se necessário.

Na tela, será buscado todos os débitos do cliente para o contrato, e poderá ser escolhido quais débitos querem incluir na fatura e escolher nova data de vencimento para a fatura.

Em caso de fatura não gerada para a competência atual, devido algum problema ou erro, o Regerar Fatura pode ser usado para gerar a fatura mais recente.

Os itens serão buscados mediante, cliente, contrato, data de vencimento e proxima fatura (opção do debito)

Enviar Fatura

O Regerar Fatura pode ser acessado pela tela de edição de fatura.

Menu Cliente -> Fatura -> Edição da Fatura -> Botão Enviar Fatura.

Enviar Fatura precisa ter um template de e-mail criado e um template de fatura criado e vinculado, ele enviara um e-mail para o cliente com o PDF da fatura criado em cima do template de fatura.

Para envio de fatura, o sistema permite enviar via E-mail, WhatsApp e SMS, dependendo do que a empresa tem contratado. Lembrando que para SMS, não envia o PDF.

Para cada tipo de método de envio, é necessário um template do tipo cadastrado que será aberto o corpo com a configuração do template.

O envio do E-mail vai enviar a fatura e(ou) fatura, boletos e notas fiscais, dependendo da configuração, se tiver a configuração de multiplos boletos, vai adicionar todos os boletos no arquivo zip, se
tiverem Notas Fiscais tiver a configuração de enviar notas fiscais, era adicionar no arquivo zip que sera enviado.

Pagar Fatura

O Pagar fatura pode ser acessado pela tela de edição de fatura, e pode ser quitado por dentro, desde que tenha a permissão de Debito Recebimento -> Pagar

Menu Cliente -> Fatura -> Edição da Fatura -> Botão Pagar Fatura.

Esta opção irá abrir a tela padrão de liquidação com todos os débitos em aberto da fatura marcados, para que possa ser informado o valor, acréscimo e desconto de cada débito, lembrando que os
débitos de contratos unificados estarão agrupados na listagem, não podera pagar um sem o outro.

Gerar cobrança

É possivel gerar novas cobranças, desde que a fatura esteja aberta e tenha permissão de Financero -> Adicionar

Menu Cliente -> Fatura -> Edição da Fatura -> Botão Gerar Cobrança.

A geração de cobrança por fatura tem algumas diferenças da geração de cobrança por outras telas, como a fatura possui configuração de acréscimo diferente, o campo mostra a configuração da fatura,
que para mudar tem que regerar a fatura mudando o tipo de juros no contrato. O sistema não vai deixar remover os itens ja vinculados para gerar a cobrança, tambem seguindo o o que está vinculado
na para mudar, tem que regerar a fatura. Débitos pagos não serão inclusos.

Acessar portal

O Acessar portal pode ser acessado pela tela de edição de fatura. (Disponível se a empresa tem link do portal configurado)

Menu Cliente -> Fatura -> Edição da Fatura -> Botão Acessar Portal.

O botão Acessar portal irá abrir em uma nova aba, a área do cliente já logado com a conta do cliente.

Imprimir Fatura

O Imprimir Fatura pode ser acessado pela tela de edição de fatura.

Menu Cliente -> Fatura -> Edição da Fatura -> Botão Imprimir Fatura.

Imprimir Fatura precisa ter um template vinculado, ele irá gerar e exibir em nova aba, o PDF da Fatura, como o cliente irá recebê-la.

Aba cobrança

A Tab Cobrança vai mostrar a cobrança vinculada a fatura, para vincular uma cobrança a fatura é gerando novas cobranças pelo botão da fatura ou gerando a fatura, que vai gerar a cobrança. A
Cobrança que será exibida vai ser:

Cobrança exibida vai seguir ordem: aberta, fechada ou paga com prioridade de carteira vinculada ao contrato, com a data de criação mais antiga.

Aba Histórico

Na aba de histórico, toda alteração e inserção será adicionada, com data e hora, quem fez a ação que fez e as informações informadas/alteradas. Somente os envios de WhatsAppWeb não serão
logados, porque não temos como garantir que foi enviado, so podemos abrir a pagina do WhatsAppWeb e colocar a mensagem, para enviar alguem tem que fazer manualmente.

PORTAL

No portal, o cliente poderá acessar as suas faturas para ver a situação, pagar e baixar os documentos.

Será possível acessar as faturas sem estar logado no portal, desde que acesse via link específico.

Configuração

Menu Portal -> Configuração -> aba Cliente

Para configurar como o cliente poderá acessar a sua fatura ao usar o link específico, se terá acesso direto ou se será necessário preencher com o CPF/CNPJ de acordo com o cadastrado do cliente no sistema para acessá-la. 

Dashboard

Tem um novo menu de dashboard para as faturas.

Fatura

Menu Faturas

Opções: Pagar fatura, Imprimir fatura, Enviar fatura e Baixar documentos da fatura.

Pagar fatura

Abre a tela similar a tela de pagamento em controle financeiros.

Ira mostrar a Situação, Contrato, Vencimento, valor e os itens que estarão sendo cobrados na fatura.

A opção de pagar boleto só irá aparecer SE tiver vinculado a boleto OU tiver configurado no portal do cliente uma carteira de boleto.

A opção de pagar com pix irá aparecer SE tiver um pix preenchido na cobrança tiver OU configurado no portal do cliente uma carteira de pix.

A opção de pagar com cartão irá aparecer SE tiver um cartão preenchido na cobrança OU tiver configurado no portal do cliente uma carteira de cartão.

Imprimir fatura

Abre em nova aba, o PDF da Fatura.

Enviar fatura

Envia a fatura para o e-mail do próprio cliente.

Baixar documentos da fatura

Baixa um arquivo ZIP com o PDF da fatura, sua cobrança e suas Notas Fiscais.

Acessar via Link

Via e-mail ou whatsapp é possivel inserir um link para o cliente acessar uma pagina da fatura sem logar no sistema

Tem uma configuração que faz pedir o CPF ou CNPJ do cliente para acessar a fatura.

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.