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
- Abra o menu de ações da tabela de alunos e clique em Importar CSV.
- Selecione o arquivo. A tela mostra quantos alunos foram lidos e uma prévia das primeiras linhas.
- Escolha o Plano dos alunos importados — o campo é obrigatório e o botão de confirmar fica desabilitado sem ele.
- 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
Unificar um aluno duplicado
Juntar duas fichas da mesma pessoa numa só, o que a prévia mostra antes de confirmar, por que o sistema às vezes recusa e o que acontece com a ficha antiga.
Configurar catracas e dispositivos
Cadastrar o equipamento, ler os estados do Conector OctaGym, sincronizar e reenviar cadastros, resolver catraca que não registra passagem, definir áreas restritas, limpar o parque herdado e ajustar a capacidade da Unidade.