Central de Ajuda Quaza Provedores

Mensalidade (PT)

Mensalidade — Quaza

Mensalidade — 5 maneiras de gerar

O que é uma "Mensalidade" no Quaza?
Mensalidade é o débito mensal que o sistema cria pra cada contrato — o valor que o cliente vai pagar naquele mês pelos serviços contratados. Cada contrato gera uma mensalidade por mês (ou por período definido na regra de cobrança). Depois que é gerada, vira item da fatura mensal.

Cadeia completa: Plano de Vendas (define o valor) → Contrato (vincula plano ao cliente) → Mensalidade/Fatura (débito mensal gerado pelo contrato) → Fatura (boleto consolidado).

Nesta wiki:

Visão geral — as 5 maneiras
Glossário — débito, sequência, ciclo, regra de cobrança
Requisitos pra mensalidade ser gerada
1. Automática (cron) — modo padrão
2. Manual em massa
3. Individual por contrato
4. Por Sequência (reprocessar)
5. Lançamento manual avulso
Estados de uma mensalidade
Pegadinhas frequentes
Documentos relacionados
FAQ

Visão geral — as 5 maneiras

#	Maneira	Quando usar	Quem dispara
1	Automática (cron)	Operação normal — sistema gera sozinho segundo a Regra de Cobrança	Tarefa do sistema, agendada via crontab
2	Manual em massa	Antecipar geração de período inteiro, ou refazer mensalidades de mês passado	Operador (financeiro)
3	Individual	Cliente novo no meio do mês, ou ajuste de contrato específico	Operador, dentro do contrato
4	Por Sequência	Reprocessar mensalidades que falharam ou acompanhar lotes em curso	Operador, tela de Sequências
5	Manual avulso	Cobrança extra (taxa de instalação, multa, ajuste) que não vem do plano	Operador, Lançamento Manual

Em 99% dos casos é a Maneira 1 (Automática). O sistema cuida sozinho de todo mundo. As outras existem pra situações pontuais — clientes novos, cobranças avulsas, reprocessamentos. Comece entendendo a Maneira 1.

Glossário

Termo	Significado
Mensalidade	Débito mensal gerado pra um contrato — uma "linha" na fatura mensal do cliente
Débito	Genérico — qualquer valor a receber. Mensalidade é um tipo de débito; lançamento avulso é outro
Regra de Cobrança	Define quando, como e com qual carteira gerar a mensalidade do contrato
Ciclo	Período do faturamento (geralmente mês, mas pode ser semanal, anual)
Sequência	Lote de geração — agrupa N mensalidades que rodam juntas em um período
Tarefa (cron)	Função do sistema que roda automaticamente em intervalos fixos. Admin → Tarefas
Lançamento manual	Cobrança avulsa criada pelo operador (não vem do plano) — instalação, multa, ajuste
Carteira	Conjunto de regras bancárias (banco, conta, forma boleto/PIX/cartão) que define como cobrar
Fatura	Documento consolidado com 1+ débitos do mês (mensalidade + lançamentos manuais)

Requisitos pra mensalidade ser gerada

O sistema só gera mensalidade quando todas as condições abaixo são atendidas:

Condição	Verificar em
Cliente Habilitado	Cliente → situação=Habilitado
Contrato em estado Ativo	Contrato → estado=Ativo (não cancelado, bloqueado, pré-cadastro)
Contrato com Valor > 0	Contrato → valor mensal definido
Contrato com Regra de Cobrança	Contrato → regraDeCobranca vinculada
Não existir mensalidade duplicada no ciclo	Sistema confere automaticamente — não gera 2x no mesmo mês

Cliente sem mensalidade? Veja a tela Verificações → Cliente sem boleto — auditoria automática lista os contratos ativos sem mensalidade no ciclo atual.

1. Automática (cron) — modo padrão

Caminho: Admin → Tarefas → "Contrato - Criar as Faturas"

É o jeito padrão — sistema gera sozinho, sem ninguém precisar clicar. Roda como cron agendado no servidor (frequência depende do crontab Linux — geralmente diário), verifica contratos elegíveis, gera mensalidades pendentes.

Como o cron decide quando gerar

Cron roda (segundo agendamento Linux) ↓ Pega contratos com: • estado=Ativo • regraDeCobranca preenchida • valor > 0 ↓ Pra cada contrato: • Olha a Regra de Cobrança • Calcula "qual ciclo deveria gerar agora?" • Confere: já existe mensalidade desse ciclo? ↓ ↓ SIM (já gerou) NÃO (precisa gerar) → ignora → gera mensalidade → cria débito no financeiro → registra no histórico

Vantagens do automático: ninguém esquece, todo mundo é processado, sem variação. Limitações: só roda no horário agendado — se quer agora, antes do próximo ciclo, use Maneira 2/3.

2. Manual em massa

Caminho: Financeiro → Mensalidade → Botão "Gerar Mensalidades"

Quando precisa forçar a geração de um ou mais contratos sem esperar o cron. Útil pra:

Antecipar geração de período inteiro (próximo mês inteiro de uma vez)
Refazer mensalidades de mês passado (após correção em regra de cobrança)
Geração imediata após troca de dia de vencimento em massa

Filtros disponíveis

Filtro	Pra que serve
Período	Gerar só pro mês X (ou range de meses)
Carteira	Gerar só clientes de uma carteira (boleto, PIX, cartão)
Cidade / Bairro	Geração geográfica (útil em multi-empresa)
Plano	Gerar só pra clientes de um plano específico
Empresa	Em multi-empresa, escolher a empresa fiscal

Cuidado com "Gerar todas": sem filtro, gera mensalidades pra TODOS os contratos elegíveis. Em provedor grande (50k+ clientes), pode demorar minutos e gerar carga de banco. Use filtros pra limitar quando possível.

3. Individual por contrato

Caminho: Cliente → editar Contrato → aba Débitos → "Adicionar Mensalidade"

Quando precisa gerar mensalidade de um cliente só. Caso típico: cliente novo, instalado no dia 20, precisa do boleto do mês corrente.

Quando usar

Cenário	Solução
Cliente instalado no meio do mês	Geração individual com valor pró-rata
Ajuste manual após reclamação	Cancelar mensalidade atual + gerar nova corrigida
Cliente VIP que precisa boleto agora	Geração imediata sem esperar cron
Cobrança avulsa não recorrente	Use Maneira 5 (Lançamento Manual) em vez de mensalidade

4. Por Sequência (reprocessar)

Caminho: Financeiro → Sequência

Cada execução em massa (Maneira 1 ou 2) cria uma "Sequência" — um lote agrupado. Você pode acompanhar progresso, ver erros, e reprocessar individualmente.

Estados de uma sequência

Estado	O que significa
Em processamento	Está rodando agora
Concluída	Terminou normalmente — todas geradas
Com erros	Terminou mas N mensalidades falharam (motivo na linha)
Cancelada	Operador interrompeu manualmente

Reprocessar uma sequência com erro

1Abrir a Sequência com erro
2Ver lista de contratos que falharam + motivo
3Corrigir cada motivo (ex: ativar contrato bloqueado, preencher regra de cobrança)
4Botão "Reprocessar" — tenta de novo só os que falharam

Motivos comuns de erro: contrato sem regra de cobrança, valor zerado, cliente desabilitado, conflito de geração (já existe mensalidade do mesmo ciclo).

5. Lançamento manual avulso

Caminho: Financeiro → Lançamento Manual → Adicionar

Pra cobranças que não são mensalidade — taxa de instalação, multa por atraso, ajuste, ressarcimento, equipamento vendido. Vão pra fatura mas não viram "Mensalidade".

Quando usar

Cenário	Por que não usar Mensalidade?
Taxa de instalação (R$ 150 uma vez)	Mensalidade é mensal recorrente — taxa é one-shot
Multa contratual	Não vem do plano — é punição
Equipamento vendido (roteador R$ 200)	Não é serviço recorrente
Ajuste financeiro	Não tem relação com plano

Lançamento manual também aparece na fatura. Quando o cron de Fatura roda, agrupa Mensalidade(s) do mês + Lançamentos manuais pendentes em um só boleto. Cliente vê tudo junto.

Estados de uma mensalidade

Estado	O que significa	Próximo passo natural
Aberta	Gerada mas ainda não paga	Aguardar pagamento ou virar inadimplente
Paga	Cliente pagou — bateu na conta	Estado final feliz
Cancelada	Operador anulou (erro de geração, isenção, troca de plano)	Estado final
Vencida	Passou do dia de vencimento sem pagar	Vira inadimplente — gera juros/multa após N dias
Renegociada	Substituída por novo acordo — ver Renegociação	Estado final

Pegadinhas frequentes

1. "Contrato ativo sem mensalidade gerada"
Apareceu no alerta amarelo do Painel . Causas: contrato sem regra de cobrança, valor=0, contrato com data de início futura, cliente em "Pré-cadastro" (não Ativo). Sempre verifique requisitos antes de bater no suporte.

2. Mensalidade duplicada do mesmo mês
Não acontece pelo cron normal — sistema verifica antes. Acontece quando operador roda Maneira 2 (Manual em massa) com filtro errado E o cron já rodou. Solução: cancelar uma das duas manualmente.

3. Mensalidade gerada com valor antigo após troca de plano
Cliente trocou de plano dia 10, mensalidade do mês já tinha sido gerada dia 5 com valor antigo. Solução: cancelar mensalidade antiga + gerar nova com valor novo (Maneira 3 individual).

4. Cron parou de rodar — contratos sem mensalidade acumulando
Tarefa "Contrato - Criar as Faturas" desabilitada ou com erro. Acompanhar em Admin → Tarefas Log . Religar o cron + rodar Maneira 2 pra recuperar atrasados.

5. Mensalidade não vira fatura — boleto não gerado
Mensalidade existe mas cliente não recebe boleto. Causa: cron de Cobrança não rodou, ou carteira sem configuração de boleto. Veja Geração de Cobrança .

6. Lançamento manual virou mensalidade por engano
Operador confundiu telas. Lançamento Manual aparece com flag "Avulso" ou "Manual" — Mensalidade NÃO. Corrigir cancelando e refazendo no lugar certo.

7. Sequência travada em "Em processamento" há horas
Geralmente cron morreu no meio. Acessar Admin → Tarefa Log, identificar tarefa, força reiniciar. Reprocessar a sequência depois.

Galeria de telas

Guia detalhado (migrado da wiki antiga)

As 5 maneiras de gerar mensalidades

#	Maneira	Quando usar	Quem dispara
1	Automático (cron)	Operação normal: o sistema gera as mensalidades sozinho conforme a Regra de Cobrança de cada contrato.	Tarefa do sistema, a cada hora
2	Manual em massa	Quando precisa antecipar a geração de um período inteiro, ou refazer mensalidades de um mês passado.	Operador (financeiro)
3	Individual por contrato	Cliente novo que entrou no meio do mês, ou ajuste de um contrato específico.	Operador, dentro do contrato
4	Por Sequência	Reprocessar mensalidades que falharam ou acompanhar lotes em andamento.	Operador, na tela de Sequências
5	Lançamento manual avulso	Casos especiais: uma cobrança extra (taxa de instalação, multa, ajuste) que não vem do plano.	Operador, na tela de Lançamentos Manuais

Em 99% dos casos é a Maneira 1 (Automático). O sistema cuida sozinho de todo mundo. As outras maneiras existem para situações pontuais — clientes novos, cobranças avulsas, reprocessamentos. Comece entendendo a Maneira 1 e use as outras quando precisar.

Pré-requisitos para uma mensalidade ser gerada

Antes de qualquer maneira funcionar, o contrato precisa ter 4 informações configuradas:

Pré-requisito	Onde configurar	O que acontece se faltar
Plano de Vendas vinculado	Edição do contrato → campo "Plano de venda"	Mensalidade não tem valor base — não é gerada.
Carteira de Cobrança definida	Edição do contrato → aba COBRANÇA	Sistema não sabe em qual carteira lançar — pula o contrato.
Regra de Cobrança ativa	Edição do contrato → campo "Regra de Cobrança"	Sem regra, o cron não tem dia para disparar.
Estado do contrato = Ativo	Edição do contrato → campo "Estado"	Contratos cancelados/inativos são pulados.

O erro mais comum: contrato novo cadastrado e a equipe pergunta "por que não está gerando mensalidade?" — quase sempre é um dos 4 pré-requisitos faltando. Comece a investigação por aí.

1 Maneira 1 — Geração Automática (cron)

Quaza → tarefa Contrato - Crear las facturas (executa a cada hora)

O caminho padrão de geração. O Quaza tem uma tarefa que roda continuamente — varre todos os contratos ativos e gera as mensalidades quando o dia da Regra de Cobrança bate. Ela é a responsável por 99% das mensalidades do sistema.

Na tela de listagem das tarefas, a tarefa Contrato - Crear las facturas (destacada em roxo, número 1) é a que cria as mensalidades. Outras tarefas relacionadas:

Tarefa	O que faz	Frequência
Contrato - Crear las facturas	Cria as mensalidades dos contratos elegíveis para hoje.	De hora em hora
Contrato - Enviar las facturas	Envia por e-mail/WhatsApp as faturas geradas.	De hora em hora
Financiero - Documento recurrente	Cria cobranças recorrentes não vinculadas a contrato (ex: vendas avulsas).	Diariamente
Financiero - Aviso de vencimento	Manda aviso de vencimento ao cliente antes da fatura vencer.	Diariamente

Como o cron decide quando gerar

A Regra de Cobrança define o dia do mês em que a mensalidade será gerada. Quando o dia bate, o cron pega aquele contrato:

Regra de Cobrança	Dia de geração	Cenário típico
Vencimento dia 05	Geralmente 5 dias antes do vencimento (dia 30)	Cliente paga no início do mês
Vencimento dia 10	5 dias antes (dia 5)	Cliente recebe boleto antes do vencimento
Vencimento dia 15, 20, 25	Mesma lógica — antecipação configurada na regra	Pacotes diferentes para clientes diferentes

Por que a antecipação: a fatura precisa estar gerada e enviada antes do vencimento para o cliente conseguir pagar. Por isso o cron gera com antecedência configurável (geralmente 5-10 dias).

Não desabilite a tarefa "Contrato - Crear las facturas". Se ela ficar parada por mais de 24h, mensalidades começam a faltar e a operação trava. Se precisar parar (raro — só em manutenção), reabilite o quanto antes e rode a Maneira 2 (massa) para recuperar o atraso.

2 Maneira 2 — Geração Manual em Massa

Cobrança → Lançamento/Mensalidade

Tela usada quando você precisa forçar a geração de mensalidades — para um período inteiro, para um conjunto de clientes, ou para refazer um mês que ficou furado. É o "plano B" quando o automático falhou ou quando precisa antecipar.

A listagem mostra todas as mensalidades já geradas no sistema, com filtros por cliente, período, situação. Para gerar novas em massa, clique em Procesar financieros (no canto superior direito) e abre o popup que pergunta:

Campo	O que preencher
Data inicial	Primeiro mês a gerar (ex: `01/04/2026`).
Data final	Último mês a gerar (ex: `30/04/2026` — gera só Abril).
Cliente (opcional)	Filtra para um cliente específico. Em branco = todos.
Contrato (opcional)	Filtra para um contrato específico.
Regra de Cobrança (opcional)	Filtra por regra (ex: só clientes com vencimento dia 10).

O sistema processa em lote, registra cada item em uma Sequência (ver Maneira 4) e mostra o resumo no final.

Cuidado com geração duplicada: o Quaza usa o campo Mês de Referência (formato YYYYMM) para garantir que a mesma combinação contrato + mês não gere duas mensalidades. Se você tentar gerar Abril/2026 para um contrato que já tem mensalidade desse mês, o sistema pula. Isso protege contra cobrança duplicada — pode rodar com segurança.

Quando é útil:

Cliente novo entrou hoje, mas a regra dele só dispara dia 25. Você quer cobrar a mensalidade do mês corrente já — gere manualmente o mês atual desse contrato.
O cron ficou desligado por 2 dias e algumas mensalidades não foram criadas. Rode em massa o período faltante.
Migração de sistema: trazendo histórico de outro provedor — gere os meses anteriores para que a contabilidade bata.

3 Maneira 3 — Geração Individual por Contrato

Cliente → Contrato → editar → aba DÉBITO

Quando você quer gerar a mensalidade de um único contrato sem mexer em mais ninguém, o caminho mais rápido é abrir o contrato e clicar no botão.

Na aba DÉBITO de um contrato, você vê todas as mensalidades já geradas para ele (Pago, Aberto, Atrasado, etc) e o botão Gerar mensalidade (1) à direita. Ao clicar, abre o mesmo popup da Maneira 2 — mas já filtrado para esse contrato.

Os passos:

Passo	O que fazer
1	Abrir o contrato (Cliente → Contrato → editar).
2	Ir na aba DÉBITO (mostra a contagem de mensalidades existentes ao lado).
3	Clicar em Gerar mensalidade.
4	Informar o período (data inicial e final).
5	Confirmar — a mensalidade aparece na tabela de débitos do próprio contrato.

Use também para conferir: mesmo sem gerar, a aba DÉBITO mostra todas as mensalidades de um contrato — vencimentos, valores, valor aberto, data de pagamento. É a tela de conferência mais usada quando o cliente liga reclamando de cobrança.

Botões parecidos no contrato:

Gerar mensalidade — gera o débito recorrente do plano.
Gerar venda — gera uma cobrança de produto avulso (não mensal).
Gerar proporcional — gera mensalidade proporcional ao período (ex: cliente entrou no dia 15 e o mês fechou — cobra 15 dias).
Criar cobrança — cria uma cobrança avulsa fora dos débitos do contrato.

Os 4 são diferentes — não confunda.

4 Maneira 4 — Por Sequência (acompanhar e reprocessar)

Cobrança → Sequência

A tela de Sequência é onde você vê o histórico de todas as gerações em massa que rodaram (tanto manuais quanto do cron). Cada execução vira uma "sequência" listada aqui.

Cada linha mostra:

Coluna	O que mostra
Cód Sequência	Identificador do lote.
Cliente	Cliente alvo (se foi filtrado por cliente).
Contrato Atual / Quantidade Contratos	Quantos contratos foram processados.
Valor Total	Soma das mensalidades geradas no lote.
Iniciado em / Finalizado em	Quando começou e terminou.
Situação	`Finalizado` (todos OK), `Finalizado com Erros` (alguns falharam), `Em andamento` (rodando agora).

Reprocessar uma sequência com erro

Quando uma sequência fica com Finalizado com Erros, o sistema oferece a ação Reprocesar para tentar de novo só os itens que falharam:

Passo	O que fazer
1	Filtrar a listagem por situação `Finalizado com Erros`.
2	Abrir a sequência e ler o detalhe — qual contrato falhou e por quê.
3	Corrigir o problema raiz no contrato (carteira faltando, plano errado, etc).
4	Clicar em Reprocesar — o sistema tenta de novo só os itens que erraram.

Por que existe a Sequência: ela funciona como o "histórico" das gerações em massa, e dá visibilidade dos contratos que falharam — sem ela, os erros ficariam invisíveis nos logs do servidor. Use para auditoria e suporte.

5 Maneira 5 — Lançamento Manual Avulso

Cobrança → Lançamentos Manuais

Lançamento Manual é para cobranças fora do fluxo normal de mensalidade: uma taxa de instalação, uma multa, um ajuste de saldo, uma transferência entre carteiras. Não substitui a mensalidade — complementa.

Na tela, dois botões verdes:

Botão	Quando usar
Adicionar movimento manual	Lançar uma cobrança ou crédito avulso para um cliente (ex: taxa de instalação R$ 200, ajuste de R$ 50, multa).
Adicionar transferência	Transferir valor entre carteiras (ex: tirar R$ 1.000 da carteira "Caixa" e colocar na carteira "Banco do Brasil").

Não use lançamento manual para mensalidades recorrentes. Se o cliente paga R$ 100 todo mês, isso é mensalidade — vai pelo Plano de Vendas + Maneira 1. O lançamento manual é para coisas únicas: instalação, taxa de mudança, ajuste, etc. Mensalidade no manual quebra os relatórios e a contabilidade.

Como o sistema evita gerar duplicado

Esse é o medo mais comum: "se eu rodar a geração em massa, vai duplicar minhas mensalidades?" — Não. O Quaza tem 3 mecanismos de proteção:

Mecanismo	Como funciona
Mês de Referência (campo `mesReferencia`, formato YYYYMM)	Cada mensalidade tem o mês fiscal a que se refere. O sistema impede inserir 2x o mesmo contrato + mesReferencia.
Próxima Fatura (campo `proximaFatura`)	Marca se aquele débito ainda está pendente para virar fatura. Quando vira fatura, o flag muda.
Situação (campo `situacao`)	0=Removido, 1=Aberto, 2=Pago. Mensalidades removidas/pagas não são recriadas.

Pode rodar a Maneira 2 (massa) com segurança. Se rodar 2x o mesmo período, na 2ª vez ele só vai gerar o que ainda não tinha — os demais são pulados. Não há risco de cobrança duplicada por erro de operador.

Fluxo completo da receita

Para entender o todo, é bom ver onde a mensalidade se encaixa no ciclo do dinheiro:

Etapa	O que acontece	Onde
1. Cadastro do plano	Equipe comercial monta o "produto" (R$ 99/mês, 12 meses fidelidade)	Cliente → Plano de venda
2. Cliente fecha contrato	Vendedor cria contrato vinculando plano + carteira + regra de cobrança	Cliente → Contrato
3. Mensalidade gerada	Sistema (cron) cria o débito do mês baseado no plano	Cobrança → Mensalidade
4. Fatura consolidada	Mensalidade(s) vira(m) uma fatura com vencimento	Cobrança → Fatura
5. Envio ao cliente	Sistema manda boleto/PIX por e-mail/WhatsApp	Tarefa "Enviar las facturas"
6. Cliente paga	Banco devolve a confirmação via OFX/CNAB	Cobrança → Conciliação
7. Mensalidade vira "Paga"	Sistema baixa o débito automaticamente	Automático

Troubleshooting

Problema	Causa provável	Como resolver
"O cron rodou mas o contrato X não gerou mensalidade"	Falta um dos 4 pré-requisitos (plano, carteira, regra, ou contrato inativo).	Abrir o contrato e conferir cada um dos 4 campos.
"Tem mensalidade duplicada para o mesmo mês"	Quase impossível pelo cron — investigar se foi criada manualmente via Lançamento Manual.	Verificar histórico do débito e remover a duplicada (campo Situação = Removido).
"Geração em massa terminou com 'Finalizado com Erros'"	Algum contrato do lote tem problema de configuração.	Abrir a Sequência, ler o detalhe, corrigir o contrato problemático e Reprocesar.
"Cliente novo entrou e não foi cobrado este mês"	O cron só gera no dia da Regra de Cobrança. Se entrou depois desse dia, fica para o próximo mês.	Usar a Maneira 3 (Individual) — abrir o contrato e gerar a mensalidade manualmente.
"Quero cobrar uma taxa de instalação separada"	Mensalidade não é o caminho — use Lançamento Manual (Maneira 5) ou "Gerar venda" no contrato.	Lançamento Manual ou Gerar venda no contrato.
"Mensalidade aparece com valor zero"	Plano de Vendas configurado com valor zero, ou serviço sem valor.	Conferir o Plano (cadastro) e os serviços vinculados ao contrato.

Resumo das maneiras

Cenário	Maneira recomendada
Operação normal do dia-a-dia	1. Automático — não fazer nada
Cron desligou ou ficou para trás	2. Massa — Cobrança → Mensalidade → Procesar
Cliente novo, ainda não chegou no dia da regra	3. Individual — Contrato → aba DÉBITO → Gerar
Reprocessar lote com erros	4. Sequência — Cobrança → Sequência → Reprocesar
Taxa de instalação ou cobrança avulsa	5. Lançamento Manual — Cobrança → Lançamentos Manuais

Próximos passos

Depois que você domina a geração de mensalidade, vale entender os módulos vizinhos:

Plano de Vendas — define o valor base que a mensalidade vai usar.
Fatura — onde as mensalidades viram boleto/PIX.

Pronto. Com as 5 maneiras claras, qualquer cenário do dia-a-dia tem um caminho definido. Em 99% dos casos a Maneira 1 (Automático) cuida de tudo. As outras existem para o que sai do trilho — clientes novos, reprocessamentos, cobranças avulsas. Em caso de dúvidas, contate o suporte da Quaza com o número do contrato/sequência e a mensagem do erro.

🔗 Veja também

🔄 Como os módulos conversam — integrações entre Financeiro, Fiscal e Estoque.

Documentos relacionados

Aprofunde-se nos temas conexos:

Geração de Cobrança — depois que mensalidade existe, vira boleto/PIX/carnê
Fatura — agrupamento de N mensalidades + lançamentos manuais em 1 boleto
Regras de Cobrança — define quando/como gerar (essencial pra cron funcionar)
Renegociação — quando cliente não paga, mensalidade vira acordo de renegociação
Cliente / Contrato — origem dos dados (plano + carteira + regra)
Administração → Tarefas — onde o cron "Contrato - Criar as Faturas" vive
Paineis — alerta amarelo "contratos ativos sem cobrança" linka direto pra cá
Verificações — auditoria automática que pega mensalidades faltando

FAQ

Mensalidade é mensal? Pode ser semanal/anual?

O nome confunde — Mensalidade é o tipo de débito recorrente do contrato, mas a periodicidade vem da Regra de Cobrança . Pode ser mensal (padrão), semanal, quinzenal, anual.

Posso gerar mensalidade com data retroativa?

Sim — usando Maneira 2 (Manual em massa) com filtro de período passado. O sistema gera com data de competência retroativa mas data de geração=hoje.

Cancelei mensalidade por engano, posso reverter?

Sim — abra a mensalidade cancelada, reabra (se versão permite) ou gere nova individual (Maneira 3) com mesmos valores.

Mensalidade aparece negativa — o que é?

Crédito do cliente. Vai pra próxima fatura como dedução. Útil pra devolver valor pago a maior.

Como vejo todas as mensalidades de um cliente?

Cliente → editar contrato → aba Débitos. Lista todas com data, valor, estado, link pro pagamento.

O cron tem horário fixo?

A frequência é definida no crontab do servidor Linux (não no Quaza). Provedores costumam rodar de madrugada (carga baixa) — 2h da manhã é comum. O tempo máximo de execução da tarefa é configurado em Admin → Tarefas (campo Tempo Limite).

Cliente com 2 contratos — gera 2 mensalidades?

Sim — uma por contrato. Pode aparecer como 1 fatura agrupada (se mesma carteira) ou 2 separadas.