SIGE Central de Ajuda
Manual do sistema

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.

Sistemas Customizados versão e027 atualizado em 28/10/2026

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

  1. Baixe o modelo de planilha na própria tela e preencha uma linha por cliente.
  2. Salve como CSV (separado por ponto e vírgula). Até 5.000 linhas e 5 MB por arquivo.
  3. Escolha o arquivo e clique em Conferir planilha.
  4. 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.
  5. 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.

Este conteúdo não resolveu?

Abra um chamado no Portal do Cliente informando o que você tentou — a equipe responde e o histórico fica registrado.