Como organizar um catálogo de produtos em CSV

Um arquivo CSV pode facilitar a atualização de muitos produtos de uma vez, mas só funciona quando a estrutura corresponde ao sistema que vai recebê-lo. O formato do arquivo não define, por si só, quais colunas são obrigatórias, como representar variações ou onde informar imagens. Essas regras mudam entre lojas, marketplaces e ferramentas de gestão.

Por isso, comece pelo modelo e pelas instruções atuais do destino. O roteiro abaixo ajuda a preparar os dados e reduzir erros, mas não substitui o modelo oficial da plataforma escolhida.

1. Baixe o modelo da plataforma de destino

Antes de criar colunas por conta própria, procure a planilha ou o modelo de importação fornecido pelo sistema. Confira os nomes exatos dos campos, quais são obrigatórios, os valores permitidos e como o sistema representa categorias, variações, imagens e estoque. Não renomeie cabeçalhos nem acrescente colunas sem confirmar que o importador aceita isso.

Se você vende em mais de um canal, mantenha uma base principal organizada e gere uma cópia no formato exigido por cada canal. Não presuma que o mesmo arquivo, código de categoria ou padrão de variação servirá para todos. Como exemplo de procedimento específico de uma plataforma, o Mercado Livre orienta vendedores a usar sua ferramenta e planilha de anúncios em massa; siga sempre as instruções mais recentes do destino.

2. Defina uma coluna para cada informação

Uma linha de cabeçalho e uma linha por registro facilitam a leitura e a validação. Cada coluna deve guardar um tipo de dado, por exemplo: identificador, nome, preço, quantidade, marca ou URL de imagem. Evite colocar preço e estoque juntos na mesma célula ou juntar tamanho, cor e modelo num campo se o importador espera atributos separados.

O conjunto de colunas depende do modelo de dados da plataforma. Alguns importadores usam uma linha por variação; outros agrupam dados de produto e de variação em campos ou linhas diferentes. Represente pai, produto e variações exatamente como o modelo instruir — não force uma estrutura genérica.

Não inclua informações pessoais de clientes em um arquivo de catálogo. Mantenha apenas os dados de produto necessários para a operação.

3. Preserve identificadores e variações

Escolha um SKU ou outro identificador interno estável para cada item que você precisa controlar e mantenha a associação consistente entre estoque, pedidos e canais. Confira duplicatas e não recicle um código para outro produto sem considerar o histórico e as regras do seu sistema. O identificador não precisa ser uma descrição completa do produto.

Códigos com zeros à esquerda podem ser alterados quando uma planilha os interpreta como números. Se “00125” precisa continuar exatamente assim, configure a coluna como texto antes de abrir ou editar o arquivo, e confira o valor depois de exportar. Faça o mesmo com sequências longas que possam ser exibidas em notação científica.

Para produtos com cor, tamanho ou outros atributos, confira se cada combinação tem o identificador e a relação com o produto principal esperados pelo destino. Não coloque todas as opções numa única célula se o modelo exigir registros ou colunas próprios para as variações.

4. Padronize valores sem apagar diferenças importantes

Defina convenções para unidades, nomes de cores, categorias e atributos e aplique-as de modo consistente. “Azul-marinho”, “azul marinho” e “marinho” podem ser tratados como valores diferentes pelo sistema. Padronizar não significa apagar distinções que o comprador precisa para escolher o produto.

Confira também o formato de números e datas indicado no modelo. Em português, é comum escrever preços com vírgula decimal; um sistema pode, porém, exigir outro formato ou um separador de colunas diferente. Não altere a pontuação por suposição: consulte a instrução de importação e teste a interpretação do valor no destino.

Remova espaços extras e caracteres acidentais, mas preserve pontuação, acentos, símbolos e quebras que façam parte da descrição. O Limpador de Texto do Textify pode ajudar a limpar espaços em trechos de texto; confira os resultados para não modificar conteúdo válido.

5. Escolha o delimitador, as aspas e a codificação corretamente

CSV é texto tabular separado por delimitadores, mas diferentes programas podem esperar vírgulas, ponto e vírgula ou outra configuração regional. O nome “CSV” não garante que todos os importadores interpretem o arquivo da mesma maneira. Use o delimitador e a codificação descritos pela plataforma e mantenha o padrão consistente em todo o arquivo.

No formato de referência descrito pela RFC 4180, valores que contêm vírgula, aspas ou quebras de linha são colocados entre aspas duplas; uma aspa dentro do campo é duplicada. Porém, o próprio documento observa que há variações de implementação. O modelo e o importador de destino têm prioridade para a sua operação.

Confira acentos depois de exportar e abrir o arquivo. UTF-8 costuma ser uma opção disponível, mas a aceitação de codificação e de marca BOM depende do programa que vai importar. Se houver uma exigência específica, siga-a e valide uma pequena amostra no sistema receptor.

Exemplo simples de estrutura

O exemplo abaixo usa ponto e vírgula como separador e vírgula no preço apenas para ilustrar uma exportação localizada. Não é um modelo universal nem deve ser enviado a uma plataforma sem confirmar o delimitador, cabeçalhos e formato exigidos por ela.

sku;nome;preco;estoque
CAM-001-AZ-P;"Camiseta azul, tamanho P";79,90;12
CAM-001-VD-M;"Camiseta verde, tamanho M";79,90;8

Nesse exemplo, cada linha representa um item vendável diferente. Um importador real pode exigir outros campos — como categoria, identificador do produto, condição, imagem ou relação entre variações — ou organizar os itens de outra forma. Use o modelo oficial antes de ampliar a planilha.

6. Trate imagens e descrições conforme as regras do destino

O CSV guarda texto e valores tabulares; ele não incorpora automaticamente os arquivos de imagem do computador. Se o sistema pedir imagens, normalmente haverá um campo ou procedimento específico, como URLs públicas, códigos de imagem ou envio separado. Confira o formato de URL, quantidade, ordem, dimensões e hospedagem aceitos antes de preencher a coluna.

Revise títulos e descrições para corrigir erros, remover informações que pertencem a outro campo e manter afirmações compatíveis com o produto real. Não copie dados de outro item só para preencher um campo obrigatório. Quando uma informação estiver faltando, consulte a fonte interna do catálogo em vez de inventá-la.

7. Valide o arquivo antes de importar

Faça uma revisão automática ou manual dos pontos que mais costumam quebrar a estrutura:

• os cabeçalhos correspondem ao modelo e aparecem uma única vez;
• cada linha tem a mesma quantidade de campos esperada;
• campos obrigatórios estão preenchidos e seguem os valores aceitos;
• SKUs e identificadores estão consistentes e sem duplicatas indevidas;
• preços, quantidades, unidades e datas têm o formato correto;
• aspas, separadores, acentos e quebras de linha foram preservados;
• URLs ou referências de imagem estão válidas, quando exigidas.

Abra o arquivo num editor de texto simples ou importe-o em uma cópia da planilha para confirmar como o separador foi interpretado. Não confie apenas na aparência do arquivo numa planilha: algumas aplicações corrigem automaticamente zeros, datas e números.

8. Faça um teste pequeno e confira o resultado

Antes de enviar centenas ou milhares de registros, teste uma amostra representativa com produto simples, produto com descrição contendo pontuação e, se houver, uma variação. Verifique mensagens de erro e confira no destino se nome, preço, estoque, imagens e variações apareceram nos campos certos.

Se a importação estiver correta, amplie em lotes que você consiga conferir e mantenha uma cópia original antes de qualquer transformação. Se houver erro, corrija primeiro a estrutura ou o dado apontado e repita o teste. Esse processo reduz o risco de replicar o mesmo problema por todo o catálogo.

Checklist antes de enviar

• Estou usando o modelo mais recente do sistema que receberá o arquivo?
• Os cabeçalhos e os valores seguem as instruções específicas desse destino?
• Os identificadores, zeros à esquerda e variações foram preservados?
• Delimitador, codificação, aspas e formato de preço foram testados?
• Conferi descrições, unidades, estoque e imagens sem inventar dados faltantes?
• Testei uma pequena amostra e conferi o resultado após a importação?
• Guardei uma cópia intacta do arquivo de origem?

Uma planilha bem organizada reduz retrabalho, mas não substitui as regras do sistema de destino. Mantenha os dados de origem, valide a exportação e consulte o modelo oficial sempre que mudar de canal ou de tipo de produto.

Referências e ferramentas

• RFC 4180: formato comum de arquivos CSV (em inglês).
• Mercado Livre: guia para anunciar vários produtos em massa.
• Conversor CSV para JSON do Textify — útil para transformar dados tabulares em JSON; a conversão não valida o modelo do marketplace.