Importar usuários por planilha
Cadastre ou atualize muitas pessoas de uma vez com um arquivo .csv, e entenda as colunas e os erros mais comuns.
AdministradorAtualizado em 15/10/20262 min de leitura
A importação por planilha cria pessoas novas e atualiza as que já existem, tudo de uma vez. Só o perfil Administrador importa usuários.
Passo a passo
- No menu lateral, abra Administrativo e clique em Usuários.
- Clique em Importar usuários via .csv.
- Clique em baixar template aqui para baixar o modelo.
- Preencha um usuário por linha, no Excel, no Google Sheets ou no sistema do seu RH, e salve como .csv.
- Arraste o arquivo para a área de envio ou clique em Selecionar arquivo.
- Acompanhe o resultado: quantos usuários foram criados, quantos foram atualizados e quais linhas foram ignoradas, com o motivo de cada uma.
- Para enviar outro arquivo, clique em Limpar e enviar outro.
Colunas da planilha
A primeira linha traz os cabeçalhos. A ordem das colunas não importa.
| Coluna | Obrigatória | O que preencher |
|---|---|---|
nome | Sim | Nome completo. |
cpf | Sim | CPF com 11 dígitos. |
papeis | Sim | administrador, gestor, especialista ou aluno. |
email | Não | E-mail de login. |
idioma | Não | BR, EN ou ES. Em branco, vale BR. |
data_nascimento | Não | DD/MM/AAAA. |
data_admissao | Não | DD/MM/AAAA. |
cargo | Não | O nome do cargo. |
unidades | Para gestor | As unidades da pessoa. |
unidades_gestor | Para gestor | As unidades que o gestor gerencia. |
matricula | Não | O código da pessoa no sistema da sua empresa. |
Para colocar mais de um valor na mesma célula (por exemplo, duas unidades ou dois perfis), escreva entre aspas e separe por vírgula: "Financeiro,Faturamento".
O que a importação faz
- Pessoa nova: é criada como Ativo, com senha inicial igual aos 6 primeiros dígitos do CPF. A importação não envia e-mail de boas-vindas.
- Pessoa que já existe (mesmo e-mail ou mesmo CPF): o cadastro é atualizado com os dados da linha. Datas em branco não apagam as que já existem.
- Cargo ou unidade que não existe: é criado automaticamente com o nome da planilha. Confira a grafia para não criar duplicados.
- Linha com problema: é pulada e aparece no resultado como "Linha N", sem impedir as outras.
Erros comuns
- CPF com 10 dígitos: o Excel apagou o zero à esquerda. Formate a coluna
cpfcomo Texto antes de salvar. - O dígito verificador não confere: o CPF está errado. A coluna precisa ter um CPF válido.
- Perfil que não existe: use só
administrador,gestor,especialistaoualuno. - Gestor sem unidades: quem tem o perfil gestor precisa das colunas
unidadeseunidades_gestorpreenchidas. - E-mail de uma pessoa e CPF de outra: a linha é recusada, porque juntaria dois cadastros. Corrija o cadastro antes de reenviar.
- E-mail ou CPF repetido no próprio arquivo: a segunda linha é pulada.
Este artigo ajudou?
Artigos relacionados
Ainda com dúvida?
O assistente já abre sabendo que você está neste artigo. Se preferir uma pessoa, o suporte responde em até 8 horas úteis.