Matricular um aluno

Onde: menu lateral Acadêmico → atalho Matrículas.

Quem pode usar: perfis com acesso a Matrículas. Cada ação sensível tem permissão própria: Criar, Editar, Excluir, Gerar Mensalidades, Cancelar Matrícula, Reativar Matrícula, Transferência, além dos documentos (Requerimento, Ficha, Contrato, Boletim, Histórico Escolar, Declaração de Pagamentos) e das ações do Portal da Família.

Para que serve

É a tela central da secretaria: cria e mantém a matrícula do aluno em um ano letivo, controla o checklist de documentos, gera as mensalidades, emite os documentos da matrícula e registra transferências, cancelamento e reativação.

A lista

Colunas: Foto, Nome (com o responsável logo abaixo), Matrícula (o número sequencial), Turma e Situação. Há filtro por ano, série e turno, filtro por situação, exportação para Excel e paginação.

Campos

O formulário abre em abas. Numa matrícula nova, todos os campos são editáveis; depois de salva, Unidade, Aluno, Ano Acadêmico, Turma e Turno viram texto fixo — turma e unidade só mudam pela ação Transferência (que registra histórico), e aluno e ano não mudam nunca.

Aba Matrícula

Campo	O que é	Obrigatório	Observações
Matrícula	O número sequencial	—	Gerado pelo sistema; aparece só na edição
Situação	O status atual	—	Calculado pelo sistema (veja o checklist)
Unidade	A unidade escolar da matrícula	Sim	Fixa após salvar; muda só por Transferência de Unidade
Aluno	O aluno, buscado no cadastro de Pessoas	Sim	Fixo após salvar; alunos desativados não aparecem
Ano Acadêmico	O ano letivo	Sim	Fixo após salvar
Turma	A turma	Sim	A busca respeita o ano escolhido; fixa após salvar (muda por Transferência)
Turno	O turno	Sim	Fixo após salvar; nas transferências, passa a acompanhar sempre o turno da turma

Aba Dados Adicionais

Campo	O que é	Obrigatório	Observações
Escola de Origem	De onde o aluno veio (texto livre)	Não	Sai na ficha de matrícula
Checklist	Os documentos entregues	Não	Marque cada item conforme a família entrega; os itens vêm do cadastro de checklist do catálogo acadêmico

Aba Financeiro

Campo	O que é	Obrigatório	Observações
Responsável	O responsável financeiro (pagador)	Sim	Buscado entre os responsáveis ativos
Plano	O plano de pagamento	Sim	Define valores, número de parcelas e o texto do contrato
Dia Vencimento	Dia do mês para vencer as mensalidades	Não	De 1 a 31; use quando a família quer um vencimento diferente do padrão do plano
Forma de Pagamento	Boleto Bancário ou Cartão de Crédito	Sim	Boleto é o padrão
Cartão de Crédito	O cartão do responsável para cobrança recorrente	Sim, se a forma for cartão	Vem dos cartões cadastrados na ficha do responsável
Dia Cobrança	Dia do mês da cobrança no cartão	Sim, se a forma for cartão	De 1 a 31

Na edição, a aba Financeiro também mostra a grade de mensalidades e cobranças da matrícula (vencimento, pagador, histórico, valor, atraso, valor atualizado, status e boleto), com os botões Gerar Mensalidades, Imprimir (boletos selecionados) e Imprimir Carnê.

Aba Registros

O histórico da matrícula: cada acontecimento com data, hora e descrição — "Cadastro de matrícula", "Mensalidades Geradas: …", "Transferência de Turma — …", "Transferência de Unidade — …", "Matrícula cancelada", "Matrícula reativada". É a memória oficial da matrícula.

Aba Portal da Família

Disponível após salvar: mostra quem pode acessar o Portal da Família para este aluno, quem é o responsável financeiro, convites pendentes e as autorizações de retirada. Permite conceder e revogar acessos (revogação sempre com motivo registrado). O detalhe desse fluxo está em Portal da família.

Ações

Ação	O que faz
Salvar	Grava a matrícula e recalcula o status pelo checklist
Gerar Mensalidades	Cria as parcelas do ano conforme o plano (veja abaixo)
Boletim / Histórico Escolar / Declaração de Pagamentos	Emitem os documentos em PDF
Requerimento / Ficha / Nomas de Conduta / Contrato	Documentos da matrícula (aparecem só em matrículas Pendentes ou Matriculadas)
Transferência → Turma / Unidade	Move a matrícula, com registro na aba Registros
Cancelar Matrícula	Encerra a matrícula (pede a senha do operador para confirmar)
Reativar Matrícula	Devolve uma matrícula Cancelada para Pendente (também confirma com senha)
Excluir (na lista)	Apaga fisicamente — só matrículas sem nenhuma movimentação

Passo a passo

Criar a matrícula

1. Em Acadêmico → Matrículas, clique em NOVO.
2. Na aba Matrícula: escolha Unidade, Aluno, Ano Acadêmico, Turma e Turno.
3. Na aba Dados Adicionais: informe a escola de origem e marque os documentos já entregues no Checklist.
4. Na aba Financeiro: escolha o Responsável (pagador), o Plano, o dia de vencimento e a forma de pagamento (para cartão, selecione o cartão e o dia de cobrança).
5. Clique em Salvar. A matrícula nasce Pendente e o registro "Cadastro de matrícula" entra na aba Registros.

:::info Regra do sistema Matrícula duplicada é bloqueada. Um aluno não pode ter duas matrículas vivas no mesmo ano letivo. Ao tentar criar a segunda, o sistema recusa com a mensagem "O aluno NOME já possui a matrícula NÚMERO (Situação) para o ano ANO." Se a matrícula existente estiver cancelada ou transferida, mas com movimentação (mensalidades, notas ou histórico), a recusa vem completa: "…com movimentação registrada (mensalidades, notas ou histórico escolar). Para trocar de turma use Reativar Matrícula e depois Transferência — uma segunda matrícula no mesmo ano duplicaria o ano no histórico escolar do aluno." Uma matrícula cancelada sem nenhuma movimentação não bloqueia — dá para matricular de novo normalmente. :::

O checklist e o status Pendente → Matriculado

:::info Regra do sistema O status é calculado a cada salvamento: a matrícula fica Matriculado quando todos os itens obrigatórios do checklist estão marcados; faltando qualquer um, volta a Pendente. Itens opcionais não interferem. Os estados finais (Cancelado, Transferido, Concluído) nunca são alterados por essa conta — editar uma matrícula cancelada não a "revive". :::

Na prática: conforme a família entrega os documentos, abra a matrícula, marque os itens na aba Dados Adicionais e salve — quando o último obrigatório for marcado, a situação muda sozinha para Matriculado.

Gerar as mensalidades

1. Abra a matrícula, aba Financeiro.
2. Clique em Gerar Mensalidades.
3. As parcelas criadas aparecem na grade, e a aba Registros ganha a linha "Mensalidades Geradas: (competências)".

:::info Regra do sistema A geração segue o plano da matrícula e é segura contra duplicação:

• só gera parcelas dentro da janela do plano — do mês de início de cobrança (ou do mês da matrícula, o que vier depois) até completar o número de parcelas;
• se uma competência já tem parcela não cancelada, ela é pulada — clicar duas vezes não duplica nada;
• o vencimento usa o Dia Vencimento da matrícula (na primeira parcela, vale o maior entre ele e o dia definido no plano para o primeiro mês), sempre ajustado a meses mais curtos;
• o desconto do aluno é aplicado ao valor; um desconto igual ou maior que a mensalidade impede a geração — nenhuma parcela nasce com valor zero ou negativo;
• a matrícula precisa de plano e o valor de mensalidade do plano precisa ser maior que zero.

:::

Emitir os documentos

Com a matrícula aberta, a barra de botões emite em PDF: Requerimento de matrícula, Ficha de matrícula, Contrato (usa o texto do contrato ligado ao plano, com responsável, pai e mãe como contratantes), Nomas de Conduta (o documento de direitos e deveres configurado pela escola), Declaração de Pagamentos (as parcelas quitadas), Boletim e Histórico Escolar. Os quatro primeiros só aparecem em matrículas Pendentes ou Matriculadas.

Transferir de turma ou de unidade

1. Abra a matrícula (Pendente ou Matriculada) e clique em Transferência, escolhendo Turma ou Unidade.
2. Para unidade: selecione a unidade de destino e a turma de destino; para turma: só a turma.
3. Clique em Transferir. A mudança entra na aba Registros com o antes e o depois.

:::info Regra do sistema Validações da transferência (com as mensagens reais):

• a turma de destino é obrigatória — "Selecione a turma de destino.";
• só matrícula viva transfere — "Só matrículas ativas ou pendentes podem ser transferidas.";
• a turma de destino precisa ser do mesmo ano letivo — "A turma de destino não pertence ao ano letivo da matrícula.";
• e da mesma série — "A transferência só é permitida entre turmas da mesma série.";
• a turma de destino precisa ter turno definido — "A turma de destino não possui turno definido.";
• transferir para a mesma turma ou a mesma unidade é recusado — "A matrícula já pertence a esta turma." / "A matrícula já pertence a esta unidade — use a transferência de turma."

Não existe "transferência de turno": o turno da matrícula sempre acompanha a turma escolhida. Na transferência de unidade, o acesso da família ao portal passa a valer na unidade nova automaticamente. :::

O sistema também prevê a saída do aluno para outra escola (fora da rede), que encerra a matrícula com a situação Transferido e cancela as parcelas futuras. TODO: VALIDATE — confirmar em qual tela fica o botão dessa ação.

Cancelar a matrícula

1. Abra a matrícula e clique em Cancelar Matrícula.
2. Confirme digitando sua senha (a ação é irreversível sem reativação).

O que acontece:

• a situação vira Cancelado;
• as parcelas pendentes com vencimento futuro são canceladas — as vencidas e as pagas ficam como estão;
• a aba Registros ganha "Matrícula cancelada";
• se o aluno ficar sem nenhuma matrícula ativa, o acesso da família ao portal é revogado.

Reativar a matrícula

1. Abra a matrícula Cancelada e clique em Reativar Matrícula; confirme com a senha.
2. A situação volta para Pendente (nunca direto para Matriculado — o checklist decide de novo no próximo salvamento) e a aba Registros ganha "Matrícula reativada".
3. Se o aluno vai para outra turma, use em seguida a Transferência — assim notas, mensalidades e histórico se preservam.

Excluir a matrícula

Na lista, o botão de excluir primeiro inspeciona a matrícula:

• sem movimentação nenhuma (caso típico: criada na turma errada e percebida na hora), o sistema confirma e apaga em definitivo, junto com a aba Registros;
• com qualquer movimentação — mensalidades ou cobranças, gerações de mensalidade, notas, médias, frequência, classificações, fechamentos de etapa, anos no histórico escolar, documentos emitidos ou solicitações de serviço — a exclusão é bloqueada com a mensagem "A matrícula NÚMERO de ALUNO não pode ser excluída — possui: (lista). Use o cancelamento: o registro e o histórico permanecem."

Problemas comuns

• "O aluno NOME já possui a matrícula NÚMERO (…) para o ano ANO." — matrícula duplicada; veja a regra acima. Para troca de turma, o caminho é Reativar + Transferência.
• "Informe o Cartão de Crédito para débitos recorrentes das mensalidades" — a forma de pagamento é cartão, mas nenhum cartão foi selecionado; cadastre o cartão na ficha do responsável e selecione-o.
• A situação não muda para Matriculado — algum item obrigatório do checklist está desmarcado; confira em Dados Adicionais e salve.
• Gerar Mensalidades não criou nada — as competências do plano já tinham parcelas (nada a criar) ou a matrícula está fora da janela do plano; confira o plano e a grade de cobranças.
• Campos de turma/ano bloqueados na edição — é o comportamento esperado: turma e unidade mudam pela Transferência; aluno e ano não mudam (se errou, exclua ou cancele e matricule de novo).