Geração de mensalidades
Onde: Financeiro → menu Mensalidades → Gerar/Imprimir Mensalidades
Quem pode usar: usuários administrativos com acesso a "Mensalidades" e, para gerar, à ação "Gerar Mensalidades" (concedidos em Usuários e permissões).
Para que serve
Cria, de uma vez, as cobranças de mensalidade de um mês de competência para todas as matrículas ativas — usando a tabela de preços de cada matrícula e o desconto vigente de cada aluno. A tela também lista as mensalidades do mês, imprime boletos em lote e envia e-mails de cobrança.
A tela de mensalidades
Filtros no topo: mês (MM/AAAA), Turma, Período (turno) e Aluno, com o botão Pesquisar.
Colunas da lista: Vencimento (em vermelho quando vencido), Responsável, Aluno, Descrição, Valor, Atraso (dias), Valor Atual (com multa/juros de hoje), Status (Pendente/Confirmado/Cancelado), Boleto (2ª via) e Ação (abre o detalhe da cobrança em Contas a Receber).
Ações
- Gerar boletos — inicia a geração das mensalidades do mês selecionado (com pré-visualização e confirmação; veja abaixo).
- Imprimir — imprime de uma vez os boletos das linhas selecionadas (apenas pendentes com boleto emitido).
- Enviar e-mails — envia por e-mail as cobranças do mês selecionado; o progresso aparece numa barra na própria tela.
- Histórico de gerações — abre a lista de todas as execuções já feitas.
- Excel / Pesquisa — exporta e busca na lista.
Passo a passo — gerar as mensalidades do mês
- Selecione o mês de competência no filtro de data.
- Clique em Gerar boletos.
- O sistema mostra a pré-visualização (nada é gravado ainda):
- Matrículas ativas candidatas — quantas matrículas foram examinadas;
- Serão geradas — quantas cobranças novas serão criadas;
- Já geradas (serão ignoradas) — competência já cobrada, não duplica;
- Fora da cobertura do plano — o plano não cobra este mês.
- Clique em Confirmar geração (ou Cancelar).
- O sistema abre a tela de acompanhamento da execução, com barra de progresso e os contadores Status, Candidatas, Geradas, Ignoradas e Erros, além da lista aluno a aluno com o Resultado (Gerada / Ignorada / Erro), o Detalhe (motivo) e a hora do processamento.
- Ao final, o Status muda para Concluída (ou Concluída com erros — corrija os casos apontados e gere novamente: só os pendentes serão criados).
Histórico de gerações
Cada execução fica registrada com: Solicitada em, Competência, Solicitante, Status (Executando, Concluída, Concluída com erros, Falhou, Interrompida), Candidatas, Geradas, Ignoradas, Erros e o botão Detalhes — que reabre o acompanhamento com a lista aluno a aluno. Uma execução aparece como Interrompida quando o sistema foi reiniciado no meio dela; basta gerar o mês de novo.
Por que um aluno foi ignorado ou deu erro
Os motivos exibidos na coluna Detalhe são exatamente estes:
| Resultado | Mensagem | O que significa / o que fazer |
|---|---|---|
| Ignorada | "Plano não cobre a competência (MM/AAAA a MM/AAAA)." | O mês pedido está fora da janela do plano — entre o mês da primeira mensalidade (ou o mês da matrícula, o que vier depois) e a última parcela. Nada a fazer, é o comportamento esperado |
| Ignorada | "Mensalidade da competência já existe." | Já há cobrança não cancelada deste mês para a matrícula — o sistema nunca duplica |
| Erro | "Matrícula sem plano de pagamento." | A matrícula não tem tabela de preços vinculada — corrija a matrícula |
| Erro | "Configurações de cobrança não definidas." | Preencha as Configurações de pagamento |
| Erro | "Valor de mensalidade do plano inválido (<= 0)." | A tabela de preços está com mensalidade zerada — corrija o plano |
| Erro | "Desconto (R$ X) maior ou igual à mensalidade (R$ Y)." | O desconto calculado zeraria a cobrança — o sistema não cria título com valor zero ou negativo; revise o percentual do convênio |
:::info Regra do sistema
- Vencimento: no primeiro mês de cobrança vale o maior entre o dia de vencimento da matrícula e o "Dia Vencimento da Primeira Mensalidade" do plano; nos demais meses, o dia da matrícula (ou, sem ele, o "Dia de Vencimento" do plano). Em meses curtos, o dia é ajustado para o último dia do mês.
- Desconto de pontualidade: a cobrança nasce com o desconto do convênio válido até o vencimento.
- Erro em um aluno não trava os demais: cada matrícula é processada isoladamente; os erros ficam registrados no histórico.
- A geração cria as cobranças; o boleto bancário normalmente é emitido depois, individualmente ou pelo link de pagamento — a emissão de boletos em massa na geração é opcional e costuma ficar desligada por custo.
TODO: VALIDATE— confirme com o suporte se a sua instalação emite boletos automaticamente na geração. - As mensalidades de uma matrícula também são geradas automaticamente quando a matrícula é confirmada — a geração mensal cobre quem entrou depois, mudanças de plano e meses futuros.
:::
Problemas comuns
- A pré-visualização mostra "Serão geradas: 0" — ou o mês já foi gerado (veja "Já geradas"), ou o mês está fora da cobertura dos planos (ex.: janeiro, quando os planos começam em fevereiro).
- Gerei duas vezes o mesmo mês — sem problema: a segunda execução ignora tudo o que já existe.
- O aluno novo não recebeu as mensalidades antigas — a janela começa no mês da matrícula; competências anteriores à matrícula não são geradas. Cobranças retroativas devem ser criadas caso a caso com o suporte.
- O botão Imprimir está desabilitado — selecione linhas pendentes que já tenham boleto emitido (coluna Boleto).