Importar arquivo CSV (Contatos)
5 min
Criado por Lucas Aparecido Cursiol em 19/01/2026 15:47
Atualizado por Raphael Borba em 04/09/2026 09:55
Tags: Contatos

Importação de Contatos via CSV


Nesse artigo você vai aprender

Você vai aprender o que é um arquivo CSV, a acessar a tela de importação de contatos e a preencher o arquivo no layout correto para importar contatos em massa no sistema.




Descrição

O arquivo CSV (valores separados por vírgulas) é um arquivo de texto com formato específico para possibilitar o salvamento dos dados em um formato estruturado de tabela.

É possível importar um arquivo CSV para cadastrar contatos em massa no sistema, informando para cada linha do arquivo o tipo/perfil do contato cadastrado (cliente, fornecedor, parceiro, transportadora ou representante).




Sumário

Utilize os links abaixo para ir diretamente à seção desejada:




Pré-requisito

Para importar contatos via CSV, o usuário precisa ter permissão de acesso ao módulo Administrativo e às telas relacionadas a Contato liberadas em seu papel de colaborador.

Consulte também: Editar permissões do papel de colaborador




Vídeo de orientação





Acessando a tela de importação

    1 - No módulo Administrativo.

    2 - Acesse a aba Contato.

    3 - Clique em Importar Arquivo CSV.

    4 - Selecione a opção "BAIXAR MODELO DE EXEMPLO", para conseguir uma planilha de exemplo, que pode estar preenchendo com os dados desejados.

    5 - Importeo arquivo CSV preenchido no layout correto (veja a seção abaixo) para importá-lo.




Layout do arquivo CSV

O arquivo CSV para importação precisa seguir o layout de colunas abaixo, nesta ordem:


  • NOME
  • NOME DA EMPRESA
  • DOCUMENTO (CPF/CNPJ)
  • EMAIL
  • TELEFONE
  • TELEFONE 2
  • CEP
  • LOGRADOURO
  • COMPLEMENTO
  • NÚMERO
  • CIDADE
  • ESTADO
  • BAIRRO
  • TIPO (COMPANY/PERSON)
  • FORNECEDOR (CUSTOMER/SUPPLIER/PARTNER/CARRIER/AGENT)


Atenção: a primeira linha do arquivo, com os nomes das colunas, serve apenas de referência para preenchimento e precisa ser removida antes de importar o arquivo.


Atenção: Customer => Cliente

                Supplier => Fornecedor

                Partner => Parceiro

                Carrier = transportadores

                Agent  => Representantes





Dúvidas mais comuns

Quais campos do arquivo são obrigatórios?

Os campos NOME, TIPO e FORNECEDOR são obrigatórios em todas as linhas. Os demais campos podem ficar em branco.


E recomendado utilizar algum programa de planilha eletrônica especifico?

Sim, recomendamos estar utilizando o LibreOffice Calc.


O arquivo pode usar ponto e vírgula como separador em vez de vírgula?

Não. O sistema só reconhece a vírgula como separador de colunas; um arquivo salvo com ponto e vírgula não é importado corretamente.


Importar o arquivo novamente atualiza os contatos que já existem no sistema?

Não. A importação sempre cria novos cadastros; ela não atualiza contatos já existentes, mesmo que os dados coincidam.


Preciso remover a linha com os títulos das colunas antes de importar?

Sim. A primeira linha do arquivo serve apenas de referência durante o preenchimento e precisa ser excluída antes de importar.


Ao preencher os campos numéricos, os zeros a esquerda (iniciais) estão sendo removidos. O que pode ser ?

Provavelmente isso está sendo causado devido a formatação da planilha. O recomendado é que toda a planilha esteja formatada como texto para garantir que os valores numéricos fiquem corretos e os zeros a esquerda sejam considerados.



Este artigo foi útil para você?
Últimos artigos visitados