Resposta rápidapara a planilha de importação de produtos CSV funcionar de primeira, parta do modelo oficial da plataforma, mantenha os nomes das colunas, salve em UTF-8 com o delimitador pedido, remova linhas vazias e duplicadas, padronize preço e estoque e divida catálogos grandes em lotes com o cabeçalho repetido. Importe primeiro um lote de teste com 5 a 10 produtos.
Cadastrar 800 produtos um a um não é opção. A planilha existe para isso. O problema é que ela costuma falhar no pior momento: a importação roda, trava na linha 312 e devolve uma mensagem vaga como "formato inválido".
Quase sempre o erro não está nos dados do produto, e sim no arquivo. Este guia mostra como preparar a planilha de importação de produtos CSV antes de subir, para que a importação seja uma etapa, e não uma tarde de tentativa e erro.
Por que a importação de produtos falha
O CSV parece simples: texto, uma linha por produto, colunas separadas por um caractere. Essa simplicidade esconde várias armadilhas. O próprio formato tem uma especificação informal, a RFC 4180, mas cada programa interpreta detalhes de um jeito.
As causas mais comuns de falha:
| Problema | Como aparece | Causa típica |
|---|---|---|
| Acentos quebrados | "Calça" no lugar de "Calça" | Arquivo salvo numa codificação, lido em outra |
| Tudo numa coluna só | Plataforma não reconhece campos | Ponto e vírgula onde se esperava vírgula, ou o contrário |
| Coluna não reconhecida | "Campo obrigatório ausente" | Cabeçalho renomeado ou com espaço sobrando |
| Preço errado | R$ 1.299,90 vira 1,299 ou erro | Separador decimal trocado |
| Produto duplicado | Dois anúncios iguais | Linha repetida após copiar e colar |
| Importação interrompida | Para no meio | Linha vazia, aspas abertas ou arquivo grande demais |
Dois desses itens têm guias próprios: CSV com acentos errados e CSV com ponto e vírgula.
O caso clássico do Excel em português
Quem monta a planilha no Excel e usa "Salvar como CSV" costuma receber um arquivo separado por ponto e vírgula, porque no padrão brasileiro a vírgula é o separador decimal. Dependendo da versão e da opção escolhida, a codificação também pode não ser UTF-8. Para a planilha, está tudo certo. Para a loja virtual, o arquivo chega "torto".
Checklist antes de importar
Use esta lista toda vez, mesmo que a última importação tenha dado certo:
- Modelo oficial baixado da plataforma, com os nomes de coluna exatos.
- Encoding UTF-8, salvo que a plataforma diga outra coisa.
- Delimitador igual ao do modelo (vírgula ou ponto e vírgula).
- Cabeçalho na primeira linha, sem espaços extras no começo ou no fim dos nomes.
- Sem linhas vazias no meio ou no fim do arquivo.
- Sem linhas duplicadas e sem SKU repetido.
- Preço e estoque no formato numérico pedido, sem "R$" e sem texto.
- Fórmulas convertidas em valores: o CSV precisa do resultado, não da fórmula.
- Imagens por URL quando a plataforma pede link, e não arquivo.
- Lote de teste com poucos produtos antes do catálogo inteiro.
Pasta Mágica
Padronize o CSV antes de subir
Ajuste encoding, delimitador e espaços e tire linhas duplicadas ou vazias de uma vez, sem abrir o Excel.
Como preparar a planilha passo a passo
O roteiro abaixo segue a ordem em que os erros aparecem. Corrigir nessa sequência evita voltar duas casas.
- Baixe o modelo de importação da sua plataforma e copie os dados para ele, respeitando as colunas.
- Converta fórmulas em valores e confira se datas e números ficaram no formato esperado.
- Exporte de XLSX para CSV escolhendo a aba certa e o delimitador do modelo.
- Padronize o arquivo: UTF-8, espaços removidos, linhas vazias e duplicadas fora.
- Confira os SKUs, que costumam ser a chave de atualização. Um SKU repetido pode sobrescrever outro produto.
- Divida em lotes se o arquivo passar do limite da plataforma, repetindo o cabeçalho em cada parte.
- Importe um lote de teste com 5 a 10 produtos e confira na loja: título, preço, estoque, variações e foto.
- Importe o restante em ordem e guarde os arquivos usados, com data no nome.
Excel para CSV sem perder acentos
O passo 3 é onde a maioria dos problemas nasce. Se você converte com uma ferramenta que deixa escolher o delimitador e gravar o marcador de UTF-8 (o BOM), o arquivo abre certo tanto na plataforma quanto de volta no Excel. O guia de como converter Excel para CSV mostra as opções de cada caminho.
Dividir em lotes sem quebrar o arquivo
Planilhas grandes têm dois limites. O primeiro é o da plataforma, que pode aceitar só alguns milhares de linhas por vez. O segundo é o do próprio Excel: segundo a documentação da Microsoft, uma planilha comporta até 1.048.576 linhas. Um CSV exportado de um ERP pode passar disso.
Ao dividir, cada parte precisa do cabeçalho na primeira linha. Sem ele, a plataforma lê o primeiro produto como nome de coluna. O texto sobre como dividir CSV grande detalha a estratégia.
Exemplo: a loja com 2.400 produtos
Uma loja de roupas troca de plataforma e precisa importar 2.400 produtos exportados do sistema antigo, em XLSX com três abas. A nova plataforma aceita até 1.000 linhas por importação, em CSV separado por vírgula.
Antes, o processo foi assim: salvar a aba como CSV no Excel, importar, receber erro de acento, abrir no bloco de notas, trocar a codificação, importar de novo, descobrir 40 produtos duplicados, apagar à mão, dividir o arquivo copiando e colando linhas. No total, 2 dias, o arquivo aberto e salvo pelo menos 4 vezes e três importações parciais para limpar.
Depois, com o fluxo preparado: converter só a aba de produtos para CSV com vírgula, padronizar o arquivo removendo duplicados e linhas vazias, dividir em blocos de 1.000 linhas com cabeçalho repetido. Resultado: 3 arquivos, um lote de teste com 10 produtos e as três importações em sequência.
| Etapa | Manual | Com fluxo preparado |
|---|---|---|
| Converter XLSX em CSV | Salvar como, aba por aba | Conversão escolhendo aba e delimitador |
| Corrigir acentos | Bloco de notas, tentativa e erro | UTF-8 definido na saída |
| Remover duplicados | Filtro e exclusão manual | Remoção automática de linhas idênticas |
| Dividir em lotes | Copiar e colar linhas | Blocos de N linhas com cabeçalho |
| Risco de erro humano | Alto | Baixo |
Um cuidado: remover duplicados automaticamente tira linhas idênticas. Dois produtos com o mesmo SKU e preços diferentes não são idênticos e continuam lá. Esse caso pede revisão humana. O guia de como remover linhas duplicadas em CSV mostra como encontrá-los.
Perguntas frequentes
Os motivos mais comuns são encoding errado (acentos viram símbolos), delimitador diferente do esperado (vírgula em vez de ponto e vírgula), cabeçalho com nome de coluna fora do modelo, linhas vazias ou duplicadas e preço com separador decimal trocado. Confira cada item antes de reimportar.
A maioria das plataformas atuais espera UTF-8. Se o arquivo foi salvo pelo Excel no padrão regional do Windows, ele pode sair em outra codificação e os acentos quebram. Confira na documentação da sua plataforma e, na dúvida, use UTF-8.
Depende do que a plataforma pede. O padrão técnico usa vírgula, mas o Excel em português costuma salvar com ponto e vírgula porque a vírgula é o separador decimal. Use o delimitador do modelo de importação da sua loja.
Cada plataforma define o próprio limite, por linhas ou por tamanho do arquivo. Quando o catálogo passa desse limite, divida o CSV em lotes menores, repetindo o cabeçalho em cada parte, e importe um de cada vez.
Algumas plataformas aceitam XLSX, mas muitas só aceitam CSV. Converter para CSV com encoding e delimitador corretos evita a maioria dos erros. Se a planilha tiver várias abas, confira qual delas vai virar o arquivo de importação.
Como automatizar isso com a Pasta Mágica
Na Pasta Mágica, preparar a planilha é um pipeline de três etapas que você monta uma vez e reutiliza a cada atualização de catálogo. Tudo roda com bibliotecas de planilha tradicionais, sem IA lendo seus dados.
- Crie sua conta em pastamagica.com.br/cadastrar e teste com uma cópia da sua planilha.
- Comece por Excel para CSV: escolha a primeira aba ou todas, o delimitador, se quer o BOM de UTF-8 e se as datas saem em formato ISO ou brasileiro. Fórmulas saem com o resultado calculado.
- Encadeie Padronizar CSV: detecção automática do delimitador de entrada, delimitador de saída à sua escolha, espaços aparados e linhas duplicadas ou vazias removidas.
- Feche com Dividir CSV, definindo quantas linhas vão em cada arquivo, com o cabeçalho repetido.
- Solte a planilha, acompanhe cada etapa e baixe os lotes prontos para importar.
O custo em créditos aparece antes de rodar, e se uma etapa falhar a reserva volta sozinha. Os limites de cada plano estão na tabela de preços. Se você também cuida das fotos do catálogo, veja a Pasta Mágica para e-commerce.
Pasta Mágica
Catálogo e planilha prontos no mesmo lugar
Prepare o CSV de importação e as fotos dos produtos com fluxos salvos, sem instalar nada.
