Importar clientes por planilha (CSV)
Como importar clientes de uma planilha CSV: modelo, conferência antes de gravar, relatório de erros e avisos e o que entra no cadastro.
O que é
Em Cadastros > Importar clientes dá para cadastrar muitos clientes de uma vez a partir de uma planilha. O sistema confere tudo e mostra um relatório antes de gravar qualquer coisa. Cada linha passa pelas mesmas regras do cadastro feito pela tela.
Passo a passo
- Baixe o modelo de planilha na própria tela e preencha uma linha por cliente.
- Salve como CSV (separado por ponto e vírgula). Até 5.000 linhas e 5 MB por arquivo.
- Escolha o arquivo e clique em Conferir planilha.
- Leia o Relatório da conferência: Linhas lidas, Prontas para importar (com quantas têm aviso) e Com erro (não entram). A tabela mostra cada linha com problema e o que corrigir.
- Se estiver certo, clique em Importar N cliente(s) e confirme. Aparece "Importação concluída: N cliente(s) criado(s) · N linha(s) com erro não importada(s)."
Colunas
- Obrigatórias: tipo (PF, PJ ou EX) e nome.
- Opcionais: nome fantasia, documento, e-mail, telefone, observações e o endereço (nome do local, CEP, logradouro, número, complemento, bairro, cidade, UF).
- Se a linha tiver endereço, o cliente já recebe um local atendido, marcado como endereço de cobrança. Sem nome de local, ele se chama "Principal".
Regras e limites
- Linha com erro nunca é gravada. Corrija na planilha e envie de novo, ou importe só as válidas.
- CPF/CNPJ inválido ou repetido (inclusive repetido dentro do próprio arquivo) é erro. A importação não aceita exceção de documento: esse cliente deve ser cadastrado pela tela.
- Telefone ou e-mail já usado em outro cliente vira aviso ("Telefone ou e-mail também usado em: ...") e a linha entra, a menos que a regra de duplicidade esteja em bloquear; aí é erro.
- Endereço incompleto aparece como erro começando por "Endereço:" (ex.: falta logradouro, cidade ou UF; CEP com menos de 8 dígitos).
- A importação cria só o cliente e o local. Contatos, tags e anexos são incluídos depois, pela ficha.
- Linhas em branco não contam. O relatório mostra até 500 linhas com problema.
- Aceita planilha salva pelo Excel e separador ponto e vírgula ou vírgula.
- Depois de conferir, há 2 horas para confirmar. Depois disso, ou se já tiver sido usada: "Esta importação expirou ou já foi usada. Envie o arquivo de novo."
Mensagens comuns sobre o arquivo
- "Selecione o arquivo CSV."
- "O arquivo está vazio."
- "O arquivo passa de 5 MB. Divida em partes menores."
- "O arquivo tem mais de 5000 linhas. Divida em partes menores."
- "O arquivo não é um CSV de texto. Salve a planilha como "CSV (separado por ponto e vírgula)"." Acontece quando se envia o arquivo do Excel sem salvar como CSV.
- "Cabeçalho inválido: faltam as colunas ... / colunas não reconhecidas: ... Use o modelo de planilha." Não renomeie nem acrescente colunas.
- "O arquivo não tem nenhuma linha de dados."
Com erro no arquivo, nada é gravado.
Quem pode
Só o Administrador, salvo permissão dada individualmente.