导入和导出合同 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 是每个合同的唯一识别码。handle 可以包含字母和数字,并且通常是包含字母和/或数字的组合字符串。每个合同必须具有唯一的 handle。
upcoming_billing_date 合同的下个账单日期。时间采用 UTC(协调世界时)格式,格式必须为 YYYY-MM-DDTHH:MM:SSZ。例如,2019 年 9 月 7 日下午 3:50(UTC 时区(协调世界时)表示为 2019-09-07T15:50:00Z
customer_id 客户 ID。ID 必须与 Shopify 后台中现有客户的 ID 相匹配。
currency_code 合同的货币代码。货币代码必须与商店中的有效货币相匹配。
status 合同的状态。合同可能具有以下一种状态:
  • 活跃
  • 已暂停
cadence_interval 订阅的配送频率。合同可以具有以下一种频率间隔:
cadence_interval_count 订阅在整体时间间隔内的配送频率。例如,每月的频率间隔计数为 1,每两周的频率间隔为 2。
customer_payment_method_id 客户用于合同的付款方式 ID。
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 配送地址所在省或州。只有发货本地配送方式要求填写此字段。
delivery_address_country_code 配送地址的国家/地区代码。只有发货本地配送方式要求填写此字段。
delivery_address_company 配送地址的公司名称。只有当订单面向企业并且配送方式为发货本地配送时,此字段才必填。
delivery_address_zip 配送地址相应的邮政编码。只有发货本地配送方式要求填写此字段。
delivery_address_phone 配送地址中的电话号码。只有发货本地配送方式要求填写此字段。
delivery_local_delivery_phone 配送地址中的电话号码。采用本地配送方式的订阅需要填写此字段。
delivery_local_delivery_instructions 本地配送说明。只有在为采用本地配送方式的订阅提供说明时,才需要包含此字段。
delivery_pickup_method_location_id 取货方式的地点 ID。采用当地取货方式的订阅需要填写此字段。
line_variant_id 订阅中包含的每个订单项目的 ID。如果订阅中包含多个订单项目,则必须将每个订单项目添加为具有唯一多属性 ID 的新项目。
line_quantity 订阅中包含的每个订单项目的数量。如果订阅中包含多个订单项目,则添加的数量应为该特定商品的数量,而不是包含的所有商品的总数量。
line_current_price 采用正确货币格式的订阅订单项目的价格。
line_selling_plan_id 订阅套餐的 ID。这是选填字段。
line_selling_plan_name 订阅套餐的名称。这是选填字段。

使用 CSV 文件导入合同

您可以使用 CSV 文件将现有合同从 Shopify 应用商店或其他 Shopify 商店的第三方订阅应用中导入 Shopify 订阅应用。CSV 文件无法用于编辑或覆盖现有合同。导入时会忽略现有合同副本。

步骤:

  1. 在 Shopify 后台中,转至订阅 > 合同
  2. 点击导入
  3. 点击添加文件,然后选择要导入的 CSV 文件。
  4. 点击上传文件

上传 CSV 文件后,您将在您用于设置 Shopify 商店的邮箱中收到来自 Shopify 的确认电子邮件。阅读常见导入错误的解决方案,以帮助解决任何导入问题。

使用 CSV 文件导出合同

您可以导出合同以用于记录,或将其导入到已安装 Shopify Subscriptions 应用的其他 Shopify 商店。

步骤:

  1. 在 Shopify 后台中,转至订阅 > 合同
  2. 点击导出

准备好开始使用 Shopify 进行销售了吗?

免费试用