Alunos e matrículas

Operação · Gerente · Proprietário

Importar alunos

Subir a base por planilha, o plano obrigatório que cada linha recebe, as colunas aceitas, o limite por arquivo e por que migrar de outro sistema não se faz por CSV.

Onde fica: Operação → Alunos → menu de ações da tabela → Importar CSV

Quando usar a importação por planilha

Use para trazer uma base pequena que já é de alunos pagantes. Para migrar de outro sistema de academia — com planos, mensalidades vigentes e histórico financeiro —, fale com a equipe antes: existe uma migração assistida que preserva vigência e financeiro. → Migrar de outro sistema

Toda importação cria matrícula. Não existe importar só contatos

O plano é obrigatório: cada linha do arquivo vira um aluno com mensalidade ativa de pagamento manual no plano escolhido. Não há como importar uma lista de interessados por aqui — contatos entram pelo funil comercial.

O arquivo

  • Formato CSV, separador vírgula ou ponto-e-vírgula, codificação UTF-8.
  • Máximo de 500 linhas por importação. Divida arquivos maiores.
  • Colunas reconhecidas na tela: nome, email, telefone, celular, cpf, nascimento, sexo, nivel, dias por semana.
  • O endereço também é aceito e, quando vem preenchido, completa o cadastro: cep, rua, numero, complemento, bairro, cidade, uf.

O cabeçalho é reconhecido por variações comuns (nome completo, e-mail, logradouro, estado). Colunas fora da lista são ignoradas.

Como importar

  1. Abra o menu de ações da tabela de alunos e clique em Importar CSV.
  2. Selecione o arquivo. A tela mostra quantos alunos foram lidos e uma prévia das primeiras linhas.
  3. Escolha o Plano dos alunos importados — o campo é obrigatório e o botão de confirmar fica desabilitado sem ele.
  4. Clique em Importar N aluno(s).

Ao final, três números: Criados, Ignorados (já existiam) e Erros, com a lista linha a linha e o motivo de cada uma.

Importar dispara a comunicação para a lista inteira

Como cada linha vira matrícula de verdade, a importação pode disparar e-mail de boas-vindas e notificações para todo mundo de uma vez. Importe em lotes pequenos e confira o resultado do primeiro antes de seguir.

Academia ainda em pré-venda

Antes de "Iniciar Operação", as mensalidades importadas nascem agendadas e só passam a valer na abertura — o aluno não aparece como ativo antes da hora.

Duplicidade

O sistema compara o CPF com quem já está cadastrado. Linha que bate com alguém existente entra como ignorada — não sobrescreve o cadastro nem cria um segundo. Corrija a planilha e reimporte apenas as linhas que faltaram.

E-mail repetido na família

Duas pessoas com o mesmo e-mail causam problema real: o e-mail é a chave de acesso ao app. Dê um e-mail próprio a cada aluno antes de importar.

Exportar a base

O mesmo menu tem Exportar → CSV ou XLSX, respeitando os filtros aplicados na lista. Útil para conferência antes e depois da importação.

Problemas comuns

  • "Todas as linhas deram erro." Quase sempre é a codificação: salve o arquivo como CSV UTF-8.
  • "O telefone entrou errado." Use DDD + número. O sistema normaliza para o formato internacional.
  • "O arquivo inteiro foi recusado por limite do plano." A mensagem diz quantos alunos você já tem, quantos está importando e qual é o limite da sua assinatura. Nenhuma linha é criada nesse caso — reduza o arquivo ou fale com a equipe comercial.
  • "O item Importar CSV não aparece." A importação é restrita a administradores da Empresa.

Relacionado

On this page