导入和导出合同 CSV
您可以使用 CSV(逗号分隔值)文件将第三方订阅应用中的合同导入 Shopify Subscriptions 应用或从 Shopify Subscriptions 应用导出合同。
若要详细了解如何使用 CSV 文件,请参阅打开和编辑 CSV 文件。
下载示例 CSV 文件
您可以下载和查看要用作模板的示例合同 CSV 文件。
合同 CSV 文件的注意事项
使用合同 CSV 文件导入合同之前,请查看以下注意事项。
设置 CSV 文件的格式
为正确导入合同 CSV 文件,请验证该文件是否符合以下条件:
- 合同 CSV 文件的第一行必须是合同 CSV 描述表中指定的列标头。
- 每列必须用逗号分隔。
- CSV 文件的最大大小为 10 MB。
了解 handle 列
handle 用于唯一地标识每种产品。handle 用于通过以下方式管理数据:
- 将具有多个订单项目的合同分组:包含多个订单项目的合同将按共享的 handle 进行分组。
- 避免重复合同:导入时将忽略重复的合同。如果之前已成功导入具有相同 handle 的行,则新导入过程中会跳过该行。此机制有助于避免重复数据。
多个订单项目合同
包含多个订单项目的合同的每个订单项目都需要位于单独一行,并且会与 handle 列组合在一起。
例如,如果合同有三个订单项目,则必须将每个订单项目添加为单独的行。第一行包含所有合同信息,后两行仅在以下列中包含值:
- handle
- line_variant_id
- line_quantity
- line_current_price
- 可选:line_selling_plan_id
- 可选:line_selling_plan_name
所有三列的 handle 必须相同。第 2 行和第 3 行中的所有其他列必须为空。您可以下载示例 CSV 模板来查看多订单项目合同的示例。
CSV 文件描述
合同 CSV 中使用的信息分为以下类别:* 合同名称 * 客户信息和账单信息 * 配送方式和配送信息 * 订阅中包含的商品
必须将所有列添加到 CSV 文件中才能正确导入,并且所有字段都是必填项,除非另有说明。
列 | 描述 |
---|---|
Handle | handle 是每个合同的唯一识别码。例如,red-shirt。handle 可以包含字母和数字,并且通常是包含字母和/或数字的组合字符串。每个合同必须具有唯一的 handle。 |
upcoming_billing_date | 合同的下个账单日期。 时间采用 UTC(协调世界时),格式必须为 YYYY-MM-DDTHH:MM:SSZ。 例如,UTC 时区(协调世界时)2019 年 9 月 7 日下午 3:50 表示为 2019-09-07T15:50:00Z。 必须将下个账单日期值至少设置为导入 CSV 文件的 24 小时后的日期和时间。 |
customer_id | 客户 ID。ID 必须与 Shopify 后台中现有客户的 ID 匹配,并且应是数字字符串。例如 6320530986896。 |
currency_code | 合同的货币代码。货币代码必须与商店中的有效货币相匹配。 |
status | 合同的状态。合同可能具有以下一种状态:
|
cadence_interval | 订阅的配送频率。合同可以具有以下一种频率间隔:
|
cadence_interval_count | 订阅在整体时间间隔内的配送频率。例如,每月的频率间隔计数为 1,每两周的频率间隔为 2。 |
customer_payment_method_id | 客户用于合同的付款方式 ID。ID 是唯一的字母数字代码。例如,24e8c839c47ef47d30ad28346d130e74。 |
delivery_price | 采用正确货币格式的配送价格。 |
delivery_method_type | 订阅的配送方式。配送方式必须为以下类型之一:
|
delivery_address_first_name | 配送地址中收件人的名字。只有发货和本地配送方式要求填写此字段。 |
delivery_address_last_name | 配送地址中收件人的姓氏。 只有发货和本地配送方式要求填写此字段。 |
delivery_address_address1 | 配送地址的第一行。 只有发货和本地配送方式要求填写此字段。 |
delivery_address_address2 | 配送地址的第二行。 只有当地址有第二个字段并且配送方式为发货或本地配送时,此字段才必填。 |
delivery_address_city | 配送地址所在城市。 只有发货和本地配送方式要求填写此字段。 |
delivery_address_province_code | 配送地址的省或州 ISO 代码。 只有发货和本地配送方式要求填写此字段。 |
delivery_address_country_code | 配送地址的国家/地区 ISO 代码。 只有发货和本地配送方式要求填写此字段。 |
delivery_address_company | 配送地址的公司名称。 只有当订单面向企业并且配送方式为发货或本地配送时,此字段才必填。 |
delivery_address_zip | 配送地址相应的邮政编码。 只有发货和本地配送方式要求填写此字段。 |
delivery_address_phone | 配送地址的电话号码 -- 例如 +1 (613) 555-5555。 只有发货和本地配送方式要求填写此字段。 |
delivery_local_delivery_phone | 配送地址中的电话号码。 采用本地配送方式的订阅需要填写此字段。 |
delivery_local_delivery_instructions | 本地配送说明。 只有在为采用本地配送方式的订阅提供说明时,才需要包含此字段。 |
delivery_pickup_method_location_id | 取货方式的地点 ID。 采用当地取货方式的订阅需要填写此字段。 |
line_variant_id | 订阅中包含的每个订单项目的 ID -- 例如 53154087005812。 如果订阅中包含多个订单项目,则必须将每个订单项目添加为具有唯一多属性 ID 的新项目。 |
line_quantity | 订阅中包含的每个订单项目的数量。 如果订阅中包含多个订单项目,则添加的数量应为该特定商品的数量,而不是包含的所有商品的总数量。 |
line_current_price | 采用正确货币格式的订阅订单项目的价格。 |
line_selling_plan_id | 订阅套餐的 ID -- 例如 3607724288。 这是选填字段。 |
line_selling_plan_name | 订阅套餐的名称。 这是选填字段。 |
使用 CSV 文件导入合同
您可以使用 CSV 文件从 Shopify 应用商店中符合条件的第三方订阅应用导入现有合同,或从其他商店的 Shopify Subscription 应用进行导入。
CSV 文件无法用于编辑或覆盖现有合同。导入时会忽略现有合同副本。
从第三方订阅应用导入合同
您可能可从第三方订阅应用导入合同。从第三方应用导入时,请考虑以下行为:
- 如果您的第三方订阅应用未集成 Shopify Checkout,您便无法导入合同。
- 无法直接从第三方应用导入数据。您需要以正确格式将第三方应用中的合同数据添加到 Shopify Subscriptions 应用兼容的 CSV,然后才可导入。
- 如果您的第三方订阅应用没有导出功能,或者导出的数据不包含所有必需数据,请联系应用开发人员以获取支持。
步骤:
- 在 Shopify 后台中,转至订阅 > 合同。
- 点击导入。
- 点击添加文件,然后选择要导入的 CSV 文件。
- 点击上传文件。
上传 CSV 文件后,您将在您用于设置 Shopify 商店的邮箱中收到来自 Shopify 的确认电子邮件。阅读常见导入错误的解决方案,以帮助解决任何导入问题。
使用 CSV 文件导出合同
您可以导出合同以用于记录,或将其导入到已安装 Shopify Subscriptions 应用的其他 Shopify 商店。
步骤:
- 在 Shopify 后台中,转至订阅 > 合同。
- 点击导出。