Gestão Escolar

Cadastro e importação de alunos

Matricular alunos um a um ou por planilha CSV, conferir o resultado e completar dados pendentes.

Perfil recomendado: Escola e Secretaria

Pré-requisitos

Ser gestor(a) da escola ou Secretaria de Educação responsável pela rede.
A turma do aluno já deve existir — o aluno sempre é matriculado em uma turma.
Ter o nome completo, o CPF ou a matrícula e a data de nascimento do aluno.

Passo a passo

Acessar — Gestor(a): no Painel da Escola, clique no indicador “Alunos”; abre o quadro “Alunos” com o cartão “Matricular aluno(a)”. Secretaria: no painel da Secretaria, clique em “+ Novo cadastro” e use o cartão “Aluno(a)”.
Cadastro individual: preencha “Nome completo”, “CPF ou matrícula”, “Data de nascimento (obrigatória)” e escolha a “Turma”. Se quiser, marque em “Necessidades de inclusão (opcional)”: “TEA — apoio autista”, “LIBRAS” ou “Baixa visão”. Clique em “Matricular”.
Campos obrigatórios: nome, CPF ou matrícula, data de nascimento e turma. Opcionais: as três necessidades de inclusão (podem ser ajustadas depois na ficha do aluno).
Ao concluir, aparece “Aluno(a) cadastrado(a) e matriculado(a)” (aluno novo) ou “Aluno(a) matriculado(a)” (aluno que já existia). Para aluno novo, o quadro “Acesso do aluno” mostra a “Matrícula/login” e a “Senha inicial” — anote e repasse ao aluno ou responsável, pois ela não é mostrada de novo.
Importação: no mesmo cartão, clique em “Importar planilha”. Na janela “Importar alunos por planilha”, clique em “Baixar modelo CSV” para obter o arquivo de exemplo e depois em “Selecionar arquivo”. Somente arquivos .csv são aceitos (separados por vírgula ou ponto e vírgula; a primeira linha deve ser o cabeçalho).
Colunas reconhecidas pelo modelo: nome, cpf_ou_matricula, turma, nascimento, tea, libras, baixa_visao. “nome” e “cpf_ou_matricula” são indispensáveis. “nascimento” aceita AAAA-MM-DD ou DD/MM/AAAA. Em tea, libras e baixa_visao, escreva sim, 1 ou x para marcar.
Exemplo de cabeçalho e linha (igual ao modelo): nome,cpf_ou_matricula,turma,nascimento,tea,libras,baixa_visao — João da Silva,12345678900,3º ano A,2015-03-12,,,
Confira a prévia: a tabela mostra Nome, CPF/Matrícula, Turma, TEA, LIBRAS e B. Visão. Campos vazios aparecem como “(vazio)”. Turma não reconhecida aparece com “?” e o texto da planilha; linha sem turma mostra “usa turma padrão”. Escolha a “Turma padrão (usada quando a linha não trouxer turma reconhecida)” se necessário.
Se houver o aviso “aluno(s) sem data de nascimento válida”, ele lista cada linha. Use “Baixar lista de pendentes” para corrigir a planilha. Alunos novos sem data válida não são cadastrados; os demais seguem normalmente.
Clique em “Importar … aluno(s)”. Em “Resultados”, veja quantos deram sucesso e quantos deram erro e clique em “Baixar CSV com senhas”. O arquivo traz, por linha: status, mensagem (“criado”, “vinculado” ou o motivo do erro), matrícula e senha inicial dos alunos criados. Guarde esse arquivo em local seguro.
Conferir: use “Ver alunos →” (Secretaria) ou a lista de alunos do painel da escola para confirmar que o aluno aparece na turma. Alunos sem data de nascimento aparecem no aviso “Alunos sem data de nascimento”, nos painéis da Secretaria e da Escola, onde a data pode ser completada.
Primeiro acesso: entregue ao aluno o CPF ou a matrícula e o código da turma. Ele entra pela página inicial em “Sou aluno(a)”, conforme o tutorial “Primeiro acesso do aluno”.

Resultado esperado

O aluno fica matriculado na turma escolhida e na escola dessa turma, aparece nas listas da escola e da Secretaria e pode fazer o primeiro acesso.

Dúvidas frequentes

Como o sistema trata CPF e matrícula?

Comprovado no código: o que for digitado em “CPF ou matrícula” é analisado; se tiver exatamente 11 dígitos, é tratado como CPF; caso contrário, como matrícula. Não há verificação dos dígitos verificadores do CPF — confira o número antes de salvar.

E se o aluno já estiver cadastrado?

O sistema reconhece pelo mesmo CPF/matrícula e não cria outra conta: apenas matricula na turma indicada (mensagem “vinculado” ou “Aluno(a) matriculado(a)”). Dados já existentes, como CPF, matrícula e escola principal, não são substituídos. Nesse caso, nenhuma senha nova é gerada.

Qual é a senha inicial?

Uma senha temporária aleatória, gerada pelo sistema. Ela aparece só uma vez, na tela ou no CSV de resultados, e deve ser entregue pessoalmente ao aluno ou responsável. A troca é obrigatória no primeiro acesso. CPFs com dígitos verificadores inválidos são recusados, com a linha indicada na importação.

Como a data de nascimento é validada?

Aceita AAAA-MM-DD ou DD/MM/AAAA. Datas inexistentes, no futuro ou anteriores a 1900 são recusadas. Ela é obrigatória para alunos novos, mas não é chave de identificação nem precisa ser única, e não é usada para o aluno entrar.

Como a turma da planilha é reconhecida?

Pelo nome da turma (sem diferenciar acentos e maiúsculas) ou pela série e letra, como “3º ano A”. Se não houver correspondência única, a linha usa a “Turma padrão”. Sem turma padrão, a importação é interrompida com a mensagem “linha(s) sem turma”.

Quais as diferenças entre Secretaria e gestor(a)?

A Secretaria pode matricular em turmas de qualquer escola da sua rede; o(a) gestor(a), apenas nas turmas da sua escola. O servidor recusa turmas de fora com “Forbidden: turma fora da sua rede”. A Secretaria também vê, no cartão de alunos, um botão extra para senhas de alunos sem CPF, que não faz parte deste tutorial.

Erros comuns

“Planilha vazia” (arquivo sem linhas de dados); falta da coluna de nome ou de CPF/matrícula no cabeçalho; arquivo .xlsx (não é aceito — salve como CSV); vírgulas dentro do nome em CSV separado por vírgula (use ponto e vírgula); “Turma ausente”, “Nome ausente”, “CPF/matrícula ausente”, “Data de nascimento inválida” e “Sem data de nascimento — aluno novo não foi cadastrado” no CSV de resultados.

Funciona no ambiente de demonstração?

Não. Cadastro e importação de alunos ficam bloqueados na demonstração.

O que ainda está pendente de validação?

Este tutorial foi escrito a partir da análise do código, sem testes clicando nas telas. Falta conferir na interface: o cadastro individual e a importação completos com Secretaria e gestor(a); a leitura de CSV salvo pelo Excel (acentos e codificação); o reconhecimento automático da turma; a correção pelo aviso “Alunos sem data de nascimento”; e o primeiro acesso com a senha inicial. Observação: o texto de ajuda do campo de data ainda diz que ela é usada no primeiro acesso, o que não corresponde ao fluxo atual de entrada do aluno.

Última revisão: 11/10/2026