Shopify 迁移与导入

订阅合同导入报 customer_id 无效怎么处理

现象#

从第三方订阅应用导出 640 条活跃订阅,整理成合同 CSV 后导入,后台提示 customer_id 无效,成功条数为 0。

原因#

  • 合同里的 customer_id 必须是新店已有客户的数字 ID,旧应用的客户编号无效
  • upcoming_billing_date 要求 UTC 的 YYYY-MM-DDTHH:MM:SSZ,且须晚于导入时间 24 小时
  • 多行项目合同要按 Handle 分组,后续行只能填 line 相关列,其余列留空
  • 合同 CSV 单文件上限 10MB,且不同订阅应用之间的合同互相不可见

处理步骤#

  1. 先把客户导完,导出客户列表拿到每个邮箱对应的新 customer_id
  2. 账单日期统一成 2026-12-01T03:00:00Z,整体推后至少 24 小时
  3. 同一合同的多个 line item 用相同 Handle,第二行起只填 line_variant_id 与 line_quantity
  4. status 只填 Active 或 Paused,currency_code 必须是店铺已启用的币种
  5. 先导 20 条测试合同,确认首个扣款日与支付方式无误后再导全量

验收标准#

合同总数等于源应用活跃订阅数,随机 5 条的首个 upcoming_billing_date 与源系统一致。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。