Catalog Precheck
Guias
Shopify

Erros de importação Shopify CSV: encontre a correção certa

Comece com o erro no relatório de importação do Shopify. Use os guias de cotação, cabeçalho e opções verificados abaixo e revise o que uma varredura CSV local pode ou não detectar.
Orientação oficial verificada: 1º de outubro de 2026. O texto do erro permanece em inglês; a entrada da linha ignorada mostra um trecho sem os números das linhas variáveis.

Erros de arquivo e cabeçalho

Resolva problemas de codificação, cotação e coluna antes de diagnosticar produtos individuais.

Illegal quoting on line

Verifique a codificação UTF-8 e aspas diretas não fechadas ou perdidas em torno do registro relatado.

F002 verifica a codificação e F003 verifica a cotação; citações ambíguas requerem revisão manual.

F002F003Veja a causa e exemplos verificados de CSV

Invalid CSV header: missing headers

Combine a primeira linha com os campos obrigatórios para criar produtos, atualizar produtos ou adicionar variantes.

H001 verifica Title e H002 verifica requisitos de manipulação de URL; colunas desconhecidas são revisadas separadamente.

H001H002Veja a causa e exemplos verificados de CSV

Linhas ignoradas

Verifique por que Shopify ignorou uma linha. Dados de produto ausentes e um identificador de loja existente exigem decisões diferentes; a verificação local não consegue ver os produtos existentes ou suas configurações de substituição.

…did not contain product data

Inspecione a primeira linha de um produto em busca de um Title ausente antes de tratar as linhas de continuação como produtos separados.

P001 detecta um Title ausente na primeira linha e exclui continuações somente de imagem; ele não prevê que cada linha que o Shopify irá pular.

P001Ver regras

Product e validação de variante

Revise o produto relatado e sua combinação completa de opções antes de alterar os valores comerciais.

Validation failed: options are not unique

Dentro de um identificador, compare os valores Option1–3 completos para combinações de variantes repetidas.

V001 verifica duplicatas dentro deste arquivo; ele não pode inspecionar variantes de loja existentes ou decidir qual linha está correta.

V001Veja a causa e exemplos verificados de CSV
Shopify CSV “Price não pode ficar em branco”: o que verificar
Se Shopify relatar um preço ausente, inspecione o produto exato ou a linha da variante antes de editar. Um Price vazio nem sempre é rejeitado: o guia de formato atual descreve um padrão de preço zero.
Shopify CSV “Quantidade em estoque não é um número”: como consertar
Inspecione a célula Quantidade de estoque na linha relatada em busca de erros de texto ou planilha. Primeiro confirme se você precisa do produto CSV ou de um inventário separado CSV.
Shopify CSV “Title padrão já existe”: investigue as variantes
A mensagem “Validação falhou: A variante 'Default Title' já existe” pode apontar para conflitos de dados de variante padrão ou de opção. Revise todo o grupo de produtos e as variantes de loja existentes antes de alterar as opções.

Processamento Image

Os campos de imagem CSV podem passar por uma verificação de sintaxe enquanto o Shopify ainda não consegue recuperar ou processar o arquivo remoto.

Incorrect header check

Revise a imagem na linha relatada e tente um host diferente se a remoção dessa imagem resolver o erro de importação.

I001 verifica apenas a sintaxe do URL da imagem; ele não detecta esse erro de imagem remota, não baixa imagens nem verifica suas dimensões.

I001Veja a causa e exemplos verificados de CSV

Verifique os problemas detectáveis antes de tentar outra importação

Mantenha o CSV original, escolha o modo de criação ou atualização e revise o relatório local. Valores comerciais e cotações ambíguas precisam de correção manual. Teste um pequeno lote no Shopify após a edição; uma varredura limpa não garante aceitação. O retorno abre um novo validador; os arquivos selecionados não são preservados.
Verificar um CSV

Fontes oficiais: Shopify: problemas comuns de importação · Shopify: opções do produto CSV e IDs de variantes