Ferramenta de desenvolvedor / 30

Validador de CSV de Produtos para Importação da Shopify

Verifique um CSV de produtos pelas regras do importador da Shopify e baixe uma cópia corrigida.

Validador de CSV de Produtos para Importação da Shopify: O importador da Shopify relata um problema por vez, depois do envio, o que transforma uma exportação ruim em uma tarde inteira. Este aqui lê o arquivo inteiro primeiro e lista tudo de uma vez: um handle usado por dois produtos, um preço com símbolo de moeda, uma inventory policy que não seja deny ou continue, uma URL de imagem sem esquema, uma linha de produto sem título. Ele reconhece os dois esquemas de colunas em circulação — o modelo atual da Shopify escreve URL handle e Price, enquanto a maioria das exportações de terceiros ainda escreve Handle e Variant Price. Roda 100% localmente no seu navegador, sem enviar nenhum arquivo para o servidor.

Execuções
No seu navegador
Custo
Grátis · sem cadastro
Disponibilidade
Pronto para usar

O arquivo é lido no seu navegador. Nada é enviado e nada do seu catálogo sai desta página.

Como o Shopify lê as linhas de variantes

Um produto com variantes ocupa várias linhas que compartilham o mesmo handle. A primeira linha contém os campos do produto: título, descrição, fornecedor, tipo e tags. As linhas seguintes contêm apenas campos da variante, como valores das opções, SKU, preço e estoque, além de quaisquer URLs de imagens extras. Repetir o título nessas linhas não causa problema, mas atribuir a elas um handle diferente, mesmo que por um único caractere, faz com que sejam separadas como outro produto.

Importando com segurança

A tela de importação do Shopify pode substituir produtos cujos handles já existem na loja. Com essa opção ativada, uma coluna presente, mas deixada em branco, pode apagar o valor armazenado; assim, uma edição descuidada pode eliminar descrições ou imagens. Importe primeiro alguns produtos e verifique-os no painel de administração antes de enviar o arquivo completo.

Salve o arquivo como CSV UTF-8; o Shopify espera essa codificação. Quando o catálogo está em uma planilha, Excel para CSV faz a exportação sem os problemas de codificação que transformam nomes de produtos com acentos em caracteres ilegíveis.

Como usar

  1. Escolha ou cole seu CSV de produtos.
  2. Leia os erros, listados por linha e coluna.
  3. Baixe a cópia corrigida ou corrija as linhas que exigem decisão e verifique novamente.

Privacidade e limitações

Seu catálogo é lido no seu navegador e nunca é enviado. Preços, SKUs e nomes de fornecedores não são enviados a lugar nenhum, o que aqui importa mais do que na maioria das ferramentas: uma exportação de produtos é um retrato bastante completo de um negócio.

Ferramentas relacionadas

Perguntas frequentes

Um resultado limpo garante que a importação vai funcionar?

Não, e vale deixar isso claro. Esta verificação checa as regras estruturais — colunas obrigatórias, formatos de valores, unicidade de handle, aspas. Ela não tem como verificar se uma categoria de produto corresponde exatamente à taxonomia da Shopify, se uma URL de imagem é acessível a partir dos servidores da Shopify ou se você está abaixo dos limites de variantes do seu plano. Ela captura as falhas que vêm do próprio arquivo.

O que a cópia corrigida altera?

Apenas formatações que têm uma forma correta óbvia: handles reescritos como minúsculas e hifens, TRUE e FALSE em maiúsculas, a inventory policy em minúsculas, símbolos de moeda e separadores de milhar removidos dos preços, um fulfillment service em branco definido como manual, linhas curtas ajustadas ao cabeçalho, o byte-order mark removido. Qualquer coisa que exija decisão fica como está — um preço em branco, um status de "live", uma inventory policy de "restock". Adivinhar nesses casos transformaria uma importação com falha em um catálogo errado, o que é pior.

Por que não sinaliza aspas curvas?

Porque elas geralmente não dão problema. O template de produto da própria Shopify inclui um título que as contém. O erro que as pessoas encontram é uma aspa curva no lugar onde uma aspa reta deveria fazer a citação, e isso aparece como uma aspa não fechada ou solta — o que aqui é reportado.

Quais nomes de coluna devo usar?

Qualquer um funciona. O template para download da Shopify agora usa URL handle, Price e Inventory quantity; o formato que a documentação de importação cita, e que a maioria dos apps e exportações ainda emite, usa Handle, Variant Price e Variant Inventory Qty. Escolha um e mantenha-se nele — um arquivo com algumas colunas de cada um costuma ser dois exports colados, e isso será indicado.

Ferramenta grátis · no seu navegador execuções · não precisa de conta