Central de Ajuda Quaza Provedores

Mensalidade (PT)

Mensalidade — Quaza

A mensalidade é a cobrança recorrente do plano do cliente: todo mês o Quaza gera um lançamento no valor do contrato, com a data de vencimento combinada. Este guia mostra como a mensalidade nasce, como gerá-la manualmente, como funciona a geração automática mês a mês, o cálculo proporcional do primeiro mês e onde acompanhar tudo. Voltado a quem opera o financeiro do provedor.

Nesta wiki:

Quando usar mensalidade (e quando NÃO)

A mensalidade serve para a cobrança recorrente do plano (internet, TV, telefonia) ligada a um contrato. Use esta tela quando precisar gerar, conferir ou reemitir a cobrança mensal de um cliente.

Use mensalidade quando...	NÃO use mensalidade quando...
O cliente tem um contrato ativo com valor mensal definido.	For uma cobrança avulsa e única (taxa de instalação, multa) — use um lançamento avulso.
Precisa gerar a cobrança do mês corrente ou de meses futuros.	For juntar várias mensalidades de um cliente num boleto só — isso é o papel da Fatura .
O cliente foi ativado no meio do mês e precisa do valor proporcional.	For configurar juros, multa ou prazos — isso fica nas Regras de Cobrança .
Precisa reemitir um mês que ficou faltando.	For gerar o carnê anual de vários boletos — use o Carnê .

Como a mensalidade nasce

Toda mensalidade parte de um contrato ativo. O contrato guarda dois dados-chave: o valor mensal e o dia de vencimento. Com base neles, o Quaza cria um lançamento financeiro do tipo Mensalidade para cada mês, com o mês de referência e a data de vencimento corretos.

Esse lançamento pode ser criado de duas formas, que dão exatamente o mesmo resultado:

Manual — você abre a tela do cliente ou a tela de Lançamento/Mensalidade e gera a cobrança de um ou vários meses na hora.
Automática — uma tarefa diária do servidor varre os contratos e gera, sozinha, a mensalidade de quem chegou a hora de cobrar. Você não precisa fazer nada.

O Quaza nunca gera o mesmo mês duas vezes: antes de criar, ele confere se já existe um lançamento de Mensalidade com aquele vencimento para aquele contrato. Se existir, pula.

Passo a passo — gerar a mensalidade de um cliente

Para gerar manualmente a cobrança mensal de um cliente específico:

#	O que fazer
1	Abra o cadastro do cliente e entre no contrato dele.
2	Vá na aba Débito do contrato — ela lista todas as mensalidades já geradas, com situação, vencimento e valor.
3	No menu de ações do contrato, clique em Gerar mensalidade.
4	Escolha a Data inicial e a Data Final (mês/ano). Para gerar só o mês atual, deixe as duas iguais. Para gerar vários meses de uma vez, escolha um intervalo.
5	Confira o Valor (já vem preenchido com o valor do contrato) e a Descrição. A tabela ao lado mostra uma prévia dos lançamentos que serão criados e seus vencimentos.
6	Clique em Gerar (na hora) ou Gerar em 2º plano (quando for muito cliente, o sistema processa e avisa ao terminar).
7	Pronto: as mensalidades aparecem em Aberto na aba Débito e na tela de Lançamento/Mensalidade, prontas para virar boleto/cobrança.

O botão Gerar mensalidade abre a mesma janela tanto a partir do contrato quanto da tela de sequências. A diferença: pelo contrato você mira um cliente; pela tela de sequências você pode mirar vários clientes ao mesmo tempo (por empresa, cidade, bairro, modelo da carteira).

Tela de Lançamento / Mensalidade: cada linha é uma mensalidade, com cliente, contrato, situação (Pago / Em aberto), mês de referência, vencimento e valor. Os filtros do topo (Em aberto, Atrasado, Pago, Isento) ajudam a achar o que você procura.

Fluxo da mensalidade — do contrato ao pagamento

Ciclo da mensalidade: do contrato ativo ao lançamento pago. A geração pode ser manual (botão na tela) ou automática (tarefa diária). No 1º mês, se a ativação caiu no meio do mês, o sistema soma o valor proporcional. Ao pagar, o lançamento passa a Pago (linha pontilhada = repete todo mês).

Glossário

Termo	O que significa
Mensalidade	O lançamento financeiro recorrente que cobra o valor do plano do cliente em um mês. Tem mês de referência, vencimento, valor e situação.
Recorrência	A repetição mês a mês da cobrança. O mesmo contrato gera uma mensalidade nova a cada período, sempre no dia de vencimento combinado.
Proporcional	Cobrança parcial do primeiro mês, quando o cliente foi ativado no meio do mês. Cobra só os dias entre a ativação e o fim do primeiro período, no valor diário do plano.
Vencimento	O dia em que a mensalidade deve ser paga. Vem do contrato (dia de vencimento). Se o mês não tiver aquele dia, o sistema usa o último dia do mês.
Mês de referência	O mês que aquela mensalidade representa (ex.: "Maio de 2026"). É diferente do vencimento: a mensalidade de maio pode vencer em junho, conforme a regra de cobrança.
Ciclo de cobrança	O período de cada mensalidade. No modo Mensal, é o mês-calendário; no modo por Vencimento, é o intervalo de um vencimento ao outro.
Sequência	Um lote de geração de mensalidades. Cada vez que você manda gerar (manual ou automático), o Quaza cria uma sequência, registra quantos lançamentos saíram e o valor total, e guarda o resultado para você conferir e reprocessar se der erro.
Lançamento	Nome genérico de qualquer registro a receber no financeiro. A mensalidade é um tipo de lançamento; também existem lançamentos de serviço, venda, etc.

Configuração — pré-requisitos

Para a mensalidade ser gerada corretamente, alguns dados precisam estar prontos antes:

Contrato ativo Cliente → Contrato

O contrato precisa estar ativo, com valor mensal maior que zero e um dia de vencimento definido. Contrato cancelado ou sem valor não gera mensalidade.

Modelo da carteira Cobrança → Carteira de Cobrança

Define como a cobrança será feita (boleto, gateway, pix), a moeda e eventuais juros/multa/tarifa. Toda mensalidade nasce ligada a um modelo de carteira.

Regras de cobrança Cobrança → Regras de Cobrança

Definem o dia de referência e o período de cobrança. É onde se decide, por exemplo, se a cobrança é por mês-calendário ou de vencimento a vencimento. Detalhes em Regras de Cobrança .

O modo de operação (Mensal ou por Vencimento) e o uso de proporcional são definidos uma vez nas configurações do financeiro, normalmente junto com a implantação. Se você não tem certeza de como está configurado, fale com quem implantou o provedor antes de gerar em massa.

Proporcional — o primeiro mês

Quando o cliente é ativado no meio do mês, não faz sentido cobrar a mensalidade cheia do período que já passou. Por isso o Quaza calcula o proporcional: cobra apenas os dias entre a data de ativação e o fim do primeiro período, no valor diário do plano (valor mensal dividido por 30).

O proporcional aparece somado à primeira mensalidade do cliente, com uma descrição explicando quantos dias foram cobrados. Da segunda mensalidade em diante, a cobrança volta a ser o valor cheio do plano.

Na janela Gerar mensalidade existe a opção Gerar proporcional. Quando ligada, o valor parcial do primeiro mês já entra na prévia. O proporcional só é calculado se o contrato tiver uma data de ativação válida.

Se a ativação caiu dentro da tolerância de instalação (um número de dias antes do vencimento, configurado na regra de cobrança), o Quaza pode pular a cobrança do primeiro mês para não cobrar poucos dias. Isso é proposital — o cliente começa a pagar a partir do mês seguinte.

Tela de Lançamento / Mensalidade

Recebimento → Lançamento/Mensalidade

Esta é a tela central para ver todas as cobranças a receber, incluindo as mensalidades. Cada linha traz o cliente, o contrato, a situação, o mês de referência, o vencimento, o valor total, o valor ainda em aberto e o valor já pago.

Os filtros no topo agrupam por situação: Em aberto, Atrasado, Pago, Pago parcial, Isento, Removido e Não faturado. Use-os para, por exemplo, listar só o que está atrasado de um cliente, ou conferir tudo que foi gerado no mês.

Cada linha tem atalhos para editar o lançamento, gerar a cobrança/boleto e imprimir. Para ver as mensalidades de um cliente específico, abra o contrato dele e use a aba Débito, que filtra só aquele contrato.

A área de Recebimento também reúne os lançamentos manuais (movimentos avulsos). Mensalidades ficam na listagem principal de lançamentos; movimentos manuais são para entradas pontuais que não vêm de contrato.

Geração em massa (Processar financeiros)

Quando precisa gerar a mensalidade de muitos clientes de uma vez (por exemplo, virou o mês e você quer rodar a cobrança de todo mundo), use a geração em massa. Cada rodada cria uma sequência, que você acompanha numa listagem própria.

#	Passo
1	Abra a tela de sequências (Listar sequências) e clique em Processar financeiros.
2	Defina o intervalo (Data inicial / Data Final) e os filtros: empresa, modelo da carteira, cidade, bairro, regra de vencimento. Você pode mirar todos os clientes ou só um recorte.
3	Confira a descrição e as opções (gerar proporcional, gerar cobranças) e clique em Gerar em 2º plano. Para muitos clientes, sempre use o 2º plano.
4	O Quaza processa em segundo plano e envia uma notificação quando termina, com a quantidade de lançamentos gerados e o valor total.
5	Acompanhe o resultado na listagem de sequências: situação (Processando, Finalizado, Finalizado com erros, Falhado), itens gerados e valor.

Listar sequências: cada linha é um lote de geração de mensalidades, com código, cliente, quantidade de contratos, valor total, horários de início/fim e situação. O botão Processar financeiros (canto superior) abre a janela para gerar um novo lote.

Se uma sequência terminar como Finalizado com erros ou Falhado, abra o registro dela para ler a mensagem de erro por contrato e use o botão Reprocessar. O reprocessamento só refaz o que faltou — não duplica o que já foi gerado.

Estados de uma mensalidade

Cada mensalidade (lançamento) tem uma situação que mostra onde ela está no ciclo de cobrança:

Situação	O que significa	Próxima ação
Aberto	Mensalidade gerada e ainda não paga. Pode estar dentro ou fora do prazo.	Gerar a cobrança/boleto e aguardar o pagamento.
Pago	O cliente quitou a mensalidade. Mostra a data e o valor pago.	Nada — ciclo concluído para aquele mês.
Baixado	O lançamento foi encerrado sem pagamento normal (cancelado, isento ou ajustado).	Conferir o motivo no histórico do lançamento.

Na listagem, os filtros Atrasado, Pago parcial e Isento são recortes da situação Aberto/Pago combinados com data e valor — ajudam a achar casos específicos sem mudar o estado de fundo.

Tarefas automáticas

A geração automática das mensalidades é feita por tarefas que rodam no servidor em horário programado. Elas fazem sozinhas o que você faria pela tela — você só precisa entender o que cada uma faz para saber a quem recorrer quando algo não gerou.

Tarefa	O que faz
Financeiro - Processar sequência	Processa os lotes de geração de mensalidade em segundo plano (é a mesma rotina que o botão Processar financeiros aciona). É a tarefa que de fato cria as mensalidades do mês.
Contrato - Criar as Faturas	Quando o módulo de Faturas está ligado, agrupa as mensalidades em aberto de cada contrato numa fatura única, no dia de referência configurado.
Contrato - Enviar as Faturas	Envia as faturas geradas ao cliente (por e-mail), após a criação.
Financeiro - Aviso de vencimento	Avisa o cliente (e-mail/SMS) sobre mensalidades a vencer ou vencidas, conforme os dias configurados.
Financeiro - Documento recorrente	Gera documentos recorrentes avulsos (cobranças fixas que não vêm de contrato), no dia de inclusão definido.
Financeiro - Atualiza valor	Recalcula o valor de lançamentos em aberto (juros, multa, desconto antecipado) conforme a regra de cobrança.

Quem liga, desliga e define o horário dessas tarefas é o administrador do servidor (pela crontab) — não dá para fazer isso pela tela. A tela Admin → Tarefas apenas mostra as tarefas cadastradas, a descrição e quando rodaram pela última vez. Se a mensalidade do mês não gerou sozinha, o primeiro passo é conferir com o responsável se a tarefa de processar sequência está ativa.

Tela Admin → Tarefas: lista as rotinas automáticas, com descrição, tempo-limite e última alteração. Em destaque, a tarefa Contrato - Criar as Faturas. Esta tela só informa — ligar/desligar e agendar é feito pelo administrador do servidor.

Pegadinhas frequentes

Contrato sem valor ou cancelado não gera mensalidade. Se o cliente reclama que não recebeu cobrança, confira se o contrato está ativo e com valor mensal maior que zero.

O vencimento não é o mês de referência. A mensalidade de maio pode vencer em junho. Ao conferir um cliente, olhe a coluna Mês de referência, não só o vencimento.

Mês já gerado não gera de novo. Se você mandar gerar um mês que já existe, o Quaza pula — por isso "não apareceu nada" às vezes significa que já estava gerado, não que deu erro.

Proporcional só no primeiro mês. Se o valor da primeira mensalidade veio "quebrado", é o proporcional dos dias do meio do mês — não é erro. Da segunda em diante volta ao valor cheio.

Geração em massa para muitos clientes: use 2º plano. Gerar na hora para milhares de contratos pode estourar o tempo. O 2º plano processa em segundo plano e avisa ao terminar.

Limite de mensalidades em aberto. Se o provedor configurou um limite de mensalidades pendentes, contratos acima do limite podem ter a nova mensalidade marcada como irregular (não vai para remessa) até o cliente regularizar.

Cobrança unificada muda a regra. Contratos ligados a uma cobrança unificada não geram mensalidade separada — entram no boleto único do contrato principal. Confira se o contrato não está unificado antes de estranhar a ausência.

Sequência com erro precisa de reprocessamento. Uma sequência "Finalizado com erros" deixou contratos para trás. Leia o erro por contrato e reprocesse — não basta mandar gerar de novo do zero.

Perguntas frequentes

A mensalidade é sempre mensal? Pode ser semanal ou anual?

O nome é "mensalidade" porque o ciclo padrão é mensal. O período de cobrança é definido na configuração do financeiro e nas regras de cobrança; o uso mais comum é mês a mês.

Posso gerar a mensalidade de um mês que já passou (retroativo)?

A geração em massa cobre o intervalo que você escolher, mas o sistema evita criar vencimentos iguais ou anteriores a hoje em alguns casos. Para acertar um mês faltante, gere pelo contrato escolhendo o mês exato; se não aparecer, é porque já existe ou o vencimento já passou.

Gerei uma mensalidade por engano. Como removo?

Abra o lançamento na tela de Lançamento/Mensalidade e use a opção de remover/baixar. Lançamentos removidos aparecem no filtro Removido. Se já virou boleto registrado no banco, cancele primeiro a cobrança.

Por que a primeira mensalidade do cliente veio com valor diferente?

Quase sempre é o proporcional: o cliente foi ativado no meio do mês e o Quaza cobrou só os dias até o fim do primeiro período. A descrição do lançamento explica quantos dias foram cobrados.

Como vejo todas as mensalidades de um cliente?

Abra o contrato do cliente e vá na aba Débito — ela lista todas as mensalidades daquele contrato. Para ver de todos os contratos, use a tela de Lançamento/Mensalidade filtrando pelo cliente.

A tarefa automática tem horário fixo?

O horário é definido pelo administrador do servidor na crontab. A tela Admin → Tarefas mostra a última vez que rodou, mas não permite mudar o agendamento.

Cliente com 2 contratos gera 2 mensalidades?

Sim, cada contrato ativo gera sua própria mensalidade — a menos que os contratos estejam em cobrança unificada, caso em que entram num boleto só do contrato principal.

Qual a diferença entre mensalidade e fatura?

A mensalidade é o lançamento de um mês de um contrato. A fatura agrupa várias mensalidades (ou vários contratos) num documento/boleto único. Veja Fatura .

Por que um contrato não gerou mensalidade na rodada em massa?

Motivos comuns: contrato inativo ou sem valor, mês já gerado, vencimento já passado, contrato em cobrança unificada, ou ativação dentro da tolerância de instalação. O detalhe fica no resultado da sequência.

Posso mudar o valor da mensalidade na hora de gerar?

Na janela Gerar mensalidade existe o campo Valor, que vem preenchido com o valor do contrato. Editar esse valor depende de permissão do seu usuário; sem ela, o campo fica somente leitura.

O que é "Gerar em 2º plano"?

É processar a geração em segundo plano, sem travar a tela. Use sempre que for muito cliente: o sistema processa e manda uma notificação quando termina.

A mensalidade vira boleto automaticamente?

A mensalidade nasce como lançamento em Aberto. Conforme a configuração da carteira e das regras de cobrança, ela vira boleto/cobrança (na hora ou por tarefa). O acompanhamento do boleto e do retorno do banco fica na área de Cobrança.

Documentos relacionados

Aprofunde-se nos temas conexos:

Fatura — agrupa várias mensalidades num boleto único
Cobrança — como a mensalidade vira boleto e o pagamento é baixado
Regras de Cobrança — dia de referência, período, juros, multa e prazos
Carnê — gera o PDF anual com vários boletos de uma vez
Contrato e Fatura — onde o valor mensal e o dia de vencimento são definidos
Histórico Financeiro — visão consolidada do que o cliente deve e pagou