# Erros na importação de alunos e como corrigir

> Ler a caixa vermelha, achar a linha na sua planilha e resolver cada mensagem.

## O que você vai conseguir

Sair de uma importação recusada com a planilha corrigida. A boa notícia vem
antes de tudo:

**Quando dá erro, nada é gravado.** Nem os alunos das linhas boas. Não existe
importação pela metade, e você não precisa caçar quem entrou e quem não entrou.

## Como ler a caixa vermelha

Ela aparece no alto do segundo passo, e traz uma linha por problema.

![Caixa vermelha com o aviso de erros de validação e dois erros, um da linha 2 e outro da linha 3](/Apps/edupay/ajuda/importar-erros.png)
*O número é a linha do **arquivo**, contando o cabeçalho. "Linha 2" é o primeiro aluno da planilha — o mesmo número que aparece na lateral do Excel.*

Corrija tudo na planilha, salve, clique em **Escolher outro arquivo** e envie de
novo.

## As mensagens mais comuns

**É obrigatória a indicação de um valor para o campo e-mail**
A célula está vazia numa planilha em que a escola exige e-mail. Preencha, ou
tire a linha e cadastre esse aluno depois, na mão.

**O campo birth date não contém uma data válida**
A data está num formato que o sistema não reconhece. Ele aceita `2004-07-22`,
`22/07/2004` e `07/22/2004`. Qualquer outro jeito — mês por extenso, ano com
dois dígitos, ponto no lugar da barra — é recusado.

**CPF inválido**
Os dígitos verificadores não fecham. Confira o documento; se a sua escola
cadastra estrangeiros, a conferência pode ser desligada em **Configurações ›
Portal do Aluno**.

**Identificador de login duplicado no arquivo**
Duas linhas com o mesmo e-mail (ou o mesmo CPF, se o login for por documento).
Decida qual fica.

**Documento duplicado no arquivo**
Duas linhas com o mesmo CPF. Quase sempre é o mesmo aluno digitado duas vezes.

**O valor indicado para o campo document number já se encontra registrado**
Esse CPF já pertence a um aluno da sua escola. Se for a mesma pessoa, tire a
linha do arquivo: ela já está cadastrada.

## Quando a lista de erros é enorme

O sistema para de listar depois de **100 problemas**. Se a caixa veio cheia,
quase sempre é um erro só, repetido em todas as linhas — coluna mapeada errada,
ou formato de data que o arquivo inteiro usa.

Olhe o primeiro erro e conserte a causa, não as cem linhas.

## O erro que não aparece na caixa vermelha

**Aluno repetido não é erro.** Se a planilha traz gente que já está cadastrada,
a importação passa e o resumo verde conta quantos foram reconhecidos, em
**Já existentes preservados**. Ninguém é duplicado e nenhum cadastro existente é
sobrescrito.

Vale a pena saber: importar de novo a mesma planilha é seguro.

## Como saber que deu certo

> [certo]
> A tela volta para a lista de alunos com a faixa verde do resumo, no lugar da
> caixa vermelha. Se **Novos alunos** vier com o número que você esperava, acabou.

## Se algo der errado

> [erro]
> **Você corrigiu e o mesmo erro voltou.** Confira se salvou o arquivo certo — e
> se o programa de planilha não recriou o formato antigo ao salvar.
>
> **Um erro fala de um campo que você não mapeou.** O sistema valida os campos
> obrigatórios mesmo quando ficaram em **Ignorar campo**. Aponte a coluna certa.
>
> **Aparece um erro em uma linha que está em branco.** Linhas totalmente vazias
> são puladas. Se sobrou um espaço ou um ponto e vírgula solto, a linha deixa de
> ser vazia — apague a linha inteira.


---

https://edupay.estudiosite.com/pt/ajuda/dia-a-dia/erros-na-importacao-de-alunos
2026-08-05