Catalog Precheck
Guias
V001

Shopify CSV “Falha na validação: as opções não são exclusivas”: como consertar

Procure duas linhas variantes com a mesma combinação de valores Option1–3 em um identificador de produto. Não altere cada identificador repetido: variantes de um produto normalmente o compartilham.

Definição da regra

Variantes sob um mesmo identificador repetem a mesma combinação de opções.

Crítico

Limites da correção automática: Esta regra exige revisão manual; os dados comerciais não são alterados automaticamente.

Não invente um novo valor de opção
Se este CSV atualizar um produto existente, a alteração de um valor de opção poderá criar novos IDs de variante e afetar aplicativos que dependem deles. Confirme a variante pretendida em sua loja antes de editar.

O que o erro significa

Shopify diz que o arquivo pode conter opções duplicadas para um produto ou o mesmo produto pode aparecer em outro lugar sob o mesmo identificador. Compare a combinação completa de opções, não apenas uma célula de Tamanho ou Cor. Identificadores repetidos são esperados em linhas de variantes genuínas.

Duas linhas, um valor de tamanho

Ambas as linhas abaixo pertencem ao identificador tee e resolvem a combinação de opções Tamanho: M. Em uma tela estreita, role o bloco de código lateralmente para visualizar todas as colunas.

Inválido: combinação de opções duplicada
Title,URL handle,Option1 name,Option1 value
Tee,tee,Size,M
,tee,,M

A regra V001 sinaliza ambas as linhas de negócios. Um nome Title e Option1 em branco em uma linha de continuação não torna M uma variante diferente.

Correção ilustrativa: dois tamanhos distintos
Title,URL handle,Option1 name,Option1 value
Tee,tee,Size,M
,tee,,L

Use L somente se a segunda linha realmente descrever o tamanho L. Caso contrário, remova uma linha realmente duplicada ou corrija o mapeamento do produto após verificar os dados de origem.

Como investigar com segurança

  1. 01

    Mantenha o CSV original. Agrupe linhas por identificador de URL e compare cada valor Option1, Option2 e Option3 não vazio em cada produto.

  2. 02

    Verifique se as linhas repetidas são variantes pretendidas distintas, linhas de produtos duplicadas acidentalmente ou linhas de continuação somente de imagem. Um identificador repetido por si só não é motivo para renomear um produto.

  3. 03

    Corrija o erro de origem real: forneça a uma variante real seu verdadeiro valor de opção, remova apenas uma duplicata confirmada ou use o identificador correto se ela pertencer a outro produto.

  4. 04

    Execute a verificação local novamente, revise outras descobertas e verifique quaisquer alterações nas variantes existentes no Shopify antes da importação.

Encontre combinações duplicadas localmente

A regra de pré-verificação de catálogo V001 relata combinações Option1–3 não vazias repetidas sob o mesmo identificador. Ele ignora linhas somente de imagem. Ele não pode decidir qual linha está correta ou ver as variantes que já estão em sua loja. O retorno abre um novo validador; o arquivo selecionado anteriormente não é preservado.
Verifique meu CSVVer regra V001
O que permanece incerto
Uma varredura limpa em nível de arquivo não prova que o CSV corresponde às variantes Shopify existentes ou que a importação será bem-sucedida. Revise os IDs do produto pretendido e da variante antes de alterar as opções de um produto existente.

Fontes verificadas: 28 de setembro de 2026. Shopify: problemas comuns de importação · Shopify: opções do produto CSV e IDs de variantes

Catalog Precheck é uma ferramenta independente e não é afiliada ao Shopify.