Layout para importação de matrículas

Formato CSV

Arquivo separado por vírgulas (ou ponto e vírgula), pode ser gerado a partir do Google Planilhas ou Microsoft Excel.

Cada linha representa a matrícula de um aluno em uma turma. Apenas duas colunas são necessárias: o nome do aluno e o código da turma.

Títulos das colunas

  • Nome do aluno (alternativos: Nome, Aluno) - Obrigatório

  • Código da turma (alternativos: Turma, Código) - Obrigatório

Os títulos são reconhecidos independente de acentos ou caixa (maiúsculas/minúsculas).

Regras

  • O aluno já deve estar cadastrado no sistema — a importação localiza o aluno pelo nome exato (sem diferenciar maiúsculas/acentos), dentro da mesma academia/gestor. Se o nome não for encontrado, ou se houver mais de um aluno com o mesmo nome, a linha é pulada (não interrompe a importação);

  • Se a turma informada ainda não existir, ela é criada automaticamente, usando valores padrão definidos no momento da importação (professor, atividade, mensalidade, horário e dias da semana — os mesmos para todas as turmas novas criadas nesta importação). Se a turma já existir, ela é reaproveitada e os valores padrão são ignorados;

  • Se o aluno já estiver matriculado (ativo) na turma, a linha é ignorada silenciosamente — a importação pode ser executada mais de uma vez com o mesmo arquivo sem gerar matrículas duplicadas;

  • O código da turma é limitado a 20 caracteres; o excedente é descartado.

Exemplo mínimo

Nome,Turma
João da Silva,T01
Maria Souza,T01
Pedro Almeida,T02-A

Exemplo com ponto e vírgula e títulos alternativos

Nome do Aluno;Código da Turma
João da Silva;T01
Maria Souza;T01

Procedimento

Atualmente não há uma interface web para importação de matrículas, precisando ser realizada pelo suporte técnico. Antes de enviar a planilha ao suporte:

  • Garanta que os alunos já estejam cadastrados no sistema com o nome exatamente igual ao que consta na planilha (evita que a linha seja pulada por "aluno não encontrado");

  • Separe a planilha por turma (uma aba ou arquivo por turma) ou inclua a coluna de código da turma para todas as linhas;

  • Informe ao suporte, para cada turma nova a ser criada, os valores desejados de professor, atividade, mensalidade, horário e dias da semana — caso contrário serão usados valores padrão que podem não corresponder ao esperado.

O suporte recomenda uma execução de simulação (dry-run) antes da importação definitiva, para conferir quantos alunos serão encontrados, quantas turmas serão criadas e quantas linhas serão ignoradas.