StriveFormats
Shopify变体导入阻断可自动修复

URL handle 无效

URL handle 包含 Shopify 可能拒绝的字符。

这是什么问题?

URL handle 包含 Shopify 可能拒绝的字符。

受影响字段:Handle
导入阻断: 在此问题解决之前,文件无法导入。

此问题可自动修复——上传 CSV 即可立即修复。

立即修复

Shopify 为何拒绝

无效的 handle 可能导致导入错误和商品网址失效。

Shopify 特别说明

Shopify按Handle列的值对变体行分组。Handle相同的所有行都属于同一商品。选项列(Option1 Name、Option1 Value等)在组内每个变体行中都必须保持一致。

示例

错误值正确值说明
填写了Option2,但Option1为空先填Option1,再填Option2
变体行出现在父行之前父行位于变体行的正上方

在 StriveFormats 中修复

此问题可以自动修复。上传您的CSV并点击“修复问题”,即可一次性应用所有安全的修正。

可自动修复:点击"修复问题"后,此问题将自动得到纠正。

在 Excel 中修复

  1. 1在Excel中按父级标识符列排序(Shopify为Handle,WooCommerce为父级SKU)。
  2. 2确认在排序结果中,父行位于其所有变体行之前。
  3. 3WooCommerce:父行应为Type = 'variable'。变体行应为Type = 'variation',并在Parent列中填写父商品的SKU。
  4. 4Shopify:同一商品组的所有行必须使用相同的Handle。确认Option1 Name在Option2 Name之前填写。
  5. 5另存为“CSV(逗号分隔)”。

在 Google 表格中修复

  1. 1在Google表格中选择“数据 > 对区域进行排序”,按父级标识符列(Handle或父级SKU)排序。
  2. 2确认父行紧挨在其变体行之前。
  3. 3WooCommerce:父行需要Type = 'variable'。变体行需要Type = 'variation',并且Parent = 父级SKU。
  4. 4Shopify:同一商品组的所有变体行必须使用相同的Handle。
  5. 5选择“文件 > 下载 > 逗号分隔值文件(.csv)”。

下次如何避免

  1. ✓始终将父商品行放在其所有变体行的正上方。
  2. ✓Shopify:同一商品组的所有行使用相同的Handle值。
  3. ✓WooCommerce:父行为Type = variable;子行为Type = variation,并且Parent = 父级SKU。
  4. ✓在导入完整商品目录之前,先用一个商品(一个父商品、两到三个变体)测试。

StriveFormats 如何检测

StriveFormats按父级标识符(Shopify为Handle)对行分组,并检查结构是否符合平台的变体模型。孤立的变体行、缺失的父行和重复的选项组合会分别标出。

►技术细节
Shopify按Handle列的值对商品行分组。Handle相同的所有行都被视为同一商品的变体。组的第一行必须包含商品级字段(Title、Body、Vendor)。同一Handle的后续行只需要变体级字段(选项值、Price、SKU)。如果组内的选项列不一致(例如各变体行的Option1 Name不同),Shopify会创建重复或损坏的变体,或者拒绝导入。