Importar alunos

Subir a base por planilha, as colunas aceitas, o limite por arquivo e por que migrar de outro sistema não deve ser feito por CSV.

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

Quando usar a importação por planilha

Use para trazer uma lista de contatos ou uma base pequena. Para migrar de outro sistema de academia (com planos, mensalidades vigentes e histórico financeiro), fale com o time antes — existe uma migração assistida que preserva vigência e financeiro. → Checklist de implantação

O arquivo

Formato CSV, separador vírgula ou ponto-e-vírgula, encoding UTF-8.
Máximo de 500 linhas por importação. Divida arquivos maiores.
Colunas aceitas: nome, email, telefone, celular, cpf, nascimento, sexo, nivel, dias por semana.

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

Como importar

Clique em Importar Alunos (CSV) e selecione o arquivo.
Confira a prévia — cada linha mostra nome, e-mail, CPF e telefone lidos.
Opcionalmente selecione um plano para vincular a todos os importados.
Confirme.

Ao final o sistema informa quantos foram Criados, Ignorados (já existiam) e quantos deram Erro, linha a linha.

Importar com plano dispara a régua de boas-vindas

Vincular plano na importação cria matrícula de verdade: isso pode disparar e-mail de boas-vindas e notificações para toda a lista. Se você está apenas trazendo a base, importe sem plano e matricule depois.

Duplicidade

O sistema compara CPF e e-mail. Linha que bate com alguém já cadastrado entra como ignorada — não sobrescreve o cadastro existente 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 em XLSX ou CSV, 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 é encoding: salve o arquivo como CSV UTF-8.
"O telefone entrou errado." Use DDD + número. O sistema normaliza para o formato internacional.
"Importei mas não viraram alunos." Sem plano, o registro é contato. É o comportamento esperado.