StriveFormats
Corretor CSV
ShopifyVariantesBloqueador de importaçãoCorreção automática

URL handle ausente

URL handle está vazio em pelo menos uma linha.

O que é este problema?

URL handle está vazio em pelo menos uma linha.

Campo afetado:Handle
Bloqueador de importação: seu arquivo não poderá ser importado até que isso seja resolvido.

Este problema é corrigido automaticamente — envie seu CSV para resolvê-lo agora.

Corrigir agora

Por que o Shopify rejeita isso

O Shopify agrupa variantes e imagens pelo URL handle e o usa para atualizar produtos existentes. Sem handle, o agrupamento e as atualizações deixam de funcionar.

Observação específica do Shopify

O Shopify agrupa as linhas de variante pelo valor da coluna Handle. Todas as linhas com o mesmo Handle pertencem ao mesmo produto. As colunas de opção (Option1 Name, Option1 Value etc.) precisam ser consistentes em todas as linhas de variante do grupo.

Exemplos

Valor incorretoValor corretoObservação
Option2 preenchida, mas Option1 vaziaPrimeiro Option1, depois Option2
A linha da variante aparece antes da linha principalA linha principal aparece logo acima das linhas de variante

Corrigir no StriveFormats

Este problema tem correção automática. Envie seu CSV e clique em "Corrigir problemas" para aplicar de uma vez todas as correções seguras.

Autocorrigível: este problema é corrigido automaticamente ao clicar em Corrigir Problemas.
Abrir corretor CSVVer modeloGuia do corretor do Shopify

Corrigir no Excel

  1. 1No Excel, classifique as linhas pela coluna do identificador principal (Handle no Shopify, SKU principal no WooCommerce).
  2. 2Confira se, no resultado classificado, a linha principal aparece antes de todas as suas linhas de variante.
  3. 3No WooCommerce: as linhas principais devem ter Type = 'variable'. As linhas de variação devem ter Type = 'variation' e a coluna Parent com o SKU do produto principal.
  4. 4No Shopify: todas as linhas de um grupo de produto precisam ter o mesmo Handle. Confira se Option1 Name está preenchida antes de Option2 Name.
  5. 5Salve como "CSV (separado por vírgulas)".

Corrigir no Planilhas Google

  1. 1No Google Planilhas, vá em Dados > Classificar intervalo e classifique pela coluna do identificador principal (Handle ou SKU principal).
  2. 2Confira se as linhas principais aparecem logo antes das suas linhas de variante.
  3. 3No WooCommerce: as linhas principais precisam de Type = 'variable'. As linhas de variação precisam de Type = 'variation' e Parent = o SKU principal.
  4. 4No Shopify: todas as linhas de variante de um grupo de produto precisam ter o mesmo Handle.
  5. 5Vá em Arquivo > Fazer download > Valores separados por vírgula (.csv).

Evite da próxima vez

  1. ✓Mantenha sempre as linhas do produto principal logo acima de todas as suas linhas de variante.
  2. ✓No Shopify: use o mesmo Handle em todas as linhas de um grupo de produto.
  3. ✓No WooCommerce: as linhas principais têm Type = variable; as linhas filhas têm Type = variation com Parent = SKU principal.
  4. ✓Teste com um único produto (um principal e duas ou três variantes) antes de importar o catálogo inteiro.

Como o StriveFormats detecta isso

O StriveFormats agrupa as linhas pelo identificador principal (Handle no Shopify) e confere se a estrutura corresponde ao modelo de variantes da plataforma. Linhas de variação órfãs, linhas principais ausentes e combinações de opções duplicadas são marcadas separadamente.

►Detalhe técnico
O Shopify agrupa as linhas de produto pelo valor da coluna Handle. Todas as linhas com o mesmo Handle são tratadas como variantes do mesmo produto. A primeira linha do grupo precisa ter os campos do produto (Title, Body, Vendor). As linhas seguintes com o mesmo Handle só precisam dos campos da variante (valores de opção, Price, SKU). Se as colunas de opção forem inconsistentes dentro de um grupo (por exemplo, se Option1 Name mudar entre linhas de variante), o Shopify cria variantes duplicadas ou quebradas, ou rejeita a importação.