Voltar ao glossário
Tecnologia & Integrações

CSV

Arquivo de texto puro em que cada linha representa um registro e os campos são separados por um caractere, quase sempre vírgula ou ponto e vírgula.

Também conhecido como: arquivo csv · o que é csv · abrir csv · importar csv

Testar o CRPRO grátis por 7 dias

CSV (comma-separated values) é um arquivo de texto puro em que cada linha é um registro e os campos são separados por um caractere — vírgula no padrão internacional, ponto e vírgula no Brasil. Não é planilha: é o formato mais simples e mais universal de mover uma tabela de um sistema para outro.

Como é por dentro

Abra um CSV no bloco de notas e você vê exatamente isto:

nome;telefone;etiqueta
Ana Souza;5531999998888;lead quente
Bruno Lima;5511988887777;orçamento enviado

A primeira linha é o cabeçalho, e é ela que o sistema usa para mapear as colunas. Cabeçalho errado, ausente ou com nome fora do padrão é a causa número um de importação que "não reconhece os campos".

Por que o Excel brasileiro usa ponto e vírgula

Porque no Brasil a vírgula já é o separador decimal. Se o Excel usasse vírgula também entre colunas, 1,50 viraria duas células. Resultado prático: um CSV exportado nos Estados Unidos abre embaralhado aqui, e vice-versa — o arquivo está correto, o separador é que é outro.

Os quatro erros que quebram uma importação de contatos

  1. Acento virando José. O arquivo foi salvo em um formato de caracteres e lido em outro. Salve como CSV UTF-8.
  2. Telefone virando 5,53199E+12. A coluna estava formatada como número. Formate como texto antes de digitar ou colar.
  3. Zero à esquerda sumindo. Mesmo motivo do item anterior, e some sem avisar.
  4. Falta do DDI. 31999998888 não é um número válido para o WhatsApp; 5531999998888 é.

O que o CSV não guarda

Fórmula, formatação, cor, aba, imagem, tipo de dado e relação entre tabelas. Tudo vira texto. Por isso ele serve para migrar cadastro, não para ser o sistema — planilha compartilhada como base de clientes quebra no dia em que duas pessoas editam ao mesmo tempo e ninguém sabe qual versão vale.

Perguntas frequentes

O que é um arquivo CSV?

É um arquivo de texto que representa uma tabela: cada linha é um registro e cada campo é separado por vírgula ou ponto e vírgula. Qualquer programa de planilha abre, e praticamente todo sistema importa e exporta nesse formato. É o formato padrão para levar uma lista de contatos de um lugar para outro.

Como abrir CSV sem bagunçar as colunas?

No Excel, em vez de dar duplo clique, use Dados e depois Obter dados de texto ou CSV, escolhendo o separador e a codificação UTF-8 na tela de importação. No Google Planilhas, importe pelo menu Arquivo e selecione a detecção automática de separador. O duplo clique é o que costuma jogar tudo em uma coluna só.

Por que meus acentos aparecem errados?

Porque o arquivo foi salvo em uma codificação e está sendo lido em outra, normalmente UTF-8 lido como ANSI. Reexporte marcando a opção CSV UTF-8 ou reimporte informando a codificação correta. É um problema de leitura, não de dado corrompido.

Qual a diferença entre CSV e Excel?

O CSV guarda apenas texto separado por um caractere; o arquivo do Excel guarda fórmulas, formatação, abas, gráficos e tipos de dado. Por isso o CSV é universal e o XLSX é rico. Para importar contatos em um sistema, o CSV quase sempre é o exigido.

Páginas relacionadas

Termos relacionados no glossário

Continue por aqui