常见合同 CSV 导入问题故障排除

如果您在导入合同逗号分隔值 (CSV) 文件时遇到问题,请检查您遇到的问题是否包含在以下解决方案中。如果问题仍然存在,请联系 Shopify 支持。

CSV 文件超过 10 MB

CSV 文件的最大上传大小为 10 MB。如果您的 CSV 文件大于 10 MB,您可以将该 CSV 拆分为不超过最大上传大小的多个文件,以便分别导入。

错误消息和解决方案

CSV 文件不包含任何合同信息

如果 CSV 文件各列中的值全部为空,则该 CSV 文件将无法导入。请在每一行中填写所需的合同信息。

CSV 文件仅包含重复的合同

如果 CSV 文件中的所有 handle 列均与现有合同名称匹配,则该 CSV 文件将无法导入,因为没有可导入的新合同。如果其中包含本应是新合同的合同,请将对应的名称更改为唯一的名称。

列错误

列不正确的 CSV 文件可能会生成以下任何错误:

  • 列不受支持
  • 列缺失
  • 列重复

请确保您 CSV 文件中的列与必需的列匹配,并且顺序正确。

cadence_interval_count 中描述的持续时间超过最大值

周期间隔计数最大值为 100 年。

具有相同名称的其他合同包含无效字段

对于包含多个订单项目的合同,仅可为以下列添加值:

  • handle
  • line_variant_id
  • line_quantity
  • line_current_price
  • 可选:line_selling_plan_id
  • 可选:line_selling_plan_name

合同重复

重复合同是指其名称与应用中现有合同的名称相匹配的合同。系统会忽略重复的合同。如果该合同应为新合同,请将合同名称更改为唯一值。

delivery_address_phone 包含无效的本地配送电话号码

delivery_address_phone 必须与有效的电话号码格式匹配。

delivery_pickup_method_location_id 包含无效的取货地点 ID

delivery_pickup_method_location_id 必须与您 Shopify 后台中的地点 ID 匹配。

合同包含无效的配送方式字段

每种配送方式都有特定的配送方式字段,这些字段的值必须为空。以下方式要求这些特定字段留空:

  • 采用发货配送方式的合同包含无效字段:delivery_local_delivery_phone、delivery_local_delivery_instructions、delivery_pickup_method_location_id 字段必须为空。
  • 采用本地配送方式的合同包含无效字段:delivery_pickup_method_location_id 字段必须为空。
  • 采用取货方式的合同包含无效字段:所有配送地址字段、delivery_local_delivery_phone 字段和 delivery_local_delivery_instructions 字段都必须为空。
  • 不含配送方式的合同包含无效字段:所有配送地址、本地配送和取货字段都必须为空。

列为空白

必填列必须包含值。请向该列添加缺失的值。

列包含非数值

请从指定列中删除所有非数字字符。

列的值低于可接受的最小值

该列中的值不能低于所述最小值。请将该值更改为更高的值。

列的值高于可接受的最大值

该列中的值不能高于所述最大值。请将该值更改为更低的值。

列的值过长

该列中的值不能超过所述的最大允许长度。请将该值缩短到可接受的长度范围内。

列存在格式错误

该列中提供的值的格式与所需格式不匹配。例如,cadence_interval_count 列的值必须为数字。

列的格式无效

line_current_price 和 delivery_price 中的所有值都必须采用有效的货币格式。

delivery_address_country_code 包含无效的国家/地区代码

delivery_address_country_code 必须是有效的国家/地区代码。国家/地区代码必须采用 ISO 3166-1 alpha-2 国家/地区代码 格式。

currency_code 包含无效的货币代码

currency_code 的值必须是有效的货币代码。

货币代码未启用

您 CSV 文件中使用的货币代码必须已在您的商店中激活。

列与任何预定义的可接受值都不匹配

cadence_interval、status 和 delivery_method_type 列中的所有值都必须是 CSV 描述中说明的特定值选项之一。

upcoming_billing_date 的日期时间格式无效

upcoming_billing_date 的值必须采用 ISO 8601 格式 YYYY-MM-DDTHH:MM:SSZ。时间采用 UTC(协调世界时)。

upcoming_billing_date 的后续账单日期无效

upcoming_billing_date 的值所设置的日期和时间必须晚于 CSV 文件导入日期和时间至少 24 小时。

delivery_address_zip 的邮政编码无效

delivery_address_zip 的值必须是有效的邮政编码。

customer_payment_method_id 与客户不匹配

customer_payment_method_id 必须与同一行中指定的 customer_id 匹配。

customer_id 的客户 ID 无效

customer_id 的值需要与您 Shopify 后台中的正确客户 ID 匹配。

customer_payment_method_id 的客户付款方式 ID 无效

customer_payment_method_id 的值需要与您 Shopify 后台中的正确付款方式 ID 匹配。

product_variant_id 的产品多属性 ID 无效

product_variant_id 的值需要与您 Shopify 后台中的正确多属性 ID 匹配。