订单 CSV 列说明

订单 CSV 文件的列描述。

若要使用 Transporter 应用将订单导入 Shopify,您需要一个仅包含此记录类型的 CSV 文件。

CSV 示例文件

下载示例订单 CSV 文件:orders.csv

您可以使用 Transporter 命令行工具生成此 CSV 文件,也可以按照下文描述的格式自行创建。

列描述

下表介绍了 CSV 文件的列标头。

值区分大小写 值区分大小写

描述
Name
(必填)
您在 Shopify 后台看到的以及客户在其发票上看到的订单标识符。此标识符在您的商店内需要是唯一的。例如,#10011001-ASH1001。必须填写此列。
Email 客户的电子邮件地址。
Financial Status 与订单相关的付款状态。有效值:
  • pending - 付款待处理。在这种状态下,付款可能失败。再次检查以确认是否已成功付款。
  • authorized - 付款已获授权。
  • partially_paid - 订单已部分付款。
  • paid - 已付款。
  • partially_refunded - 付款已部分退款。
  • refunded - 付款已退款。
  • voided - 付款已作废。
Fulfillment Status 有关已发货的订单产品的订单状态。有效值:
  • fulfilled - 订单中的所有订单商品均已发货。
  • partial - 订单中至少有一件商品已发货。
  • restocked - 订单中的所有商品已重新入库,并且订单已取消。
Currency 用于支付的货币的三位字母代码(ISO 4217 格式)。例如,USDEUR
Cancel Reason 取消订单的原因。有效值:
  • customer - 客户已取消此订单。
  • fraud - 此订单具有欺诈性。
  • inventory - 此订单中的产品没有库存。
  • declined - 付款被拒。
  • other - 未包含在此列表中的原因。
值区分大小写
Cancelled At 订单取消的日期和时间(ISO 8601 格式)。
Closed At 订单结束的日期和时间(ISO 8601 格式)。
Note 附加到订单中的可选备注。客户可以查看此备注。例如,“客户改变了主意。”
Tags 一串以逗号分隔的标签,用于筛选和搜索。每个以逗号分隔的标签最多可以包含 255 个字符。例如,“已评论、已装箱、已送达”
Phone 客户的唯一电话号码格式为 ([E.164](https://en.wikipedia.org/wiki/E.164)。电话号码可以设置为不同的格式,但每种格式都必须表示可以从世界上任何地方拨通的号码。以下格式均有效:
6135551212
+16135551212
(613)555-1212
+1 613-555-1212
Referring site 客户在其中点击链接转到您商店的网站。例如,“http://www.anexample.com”
Processed At 最初在其他平台中创建订单时的日期和时间(ISO 8601 格式)。此值会显示在 Shopify 后台中的订单上,并且也是分析报告中使用的日期。默认值为导入订单时的日期和时间。
Source Name 订单的来源(例如平台名称)。导入后将无法编辑此值。例如 Transporter
Total Weight 所有订单商品重量的总和(采用整数格式),以克为单位。例如 11
Total Tax 当在订单中收取任何税金时(例如,当“含税价格 1”列中有值时),则必须填写此列。应用于订单的所有税金(含税价格 1、......、运费税 1)的总和(必须是正数)。如果此列中没有值,则订单中的总价不包含任何税费。
Shipping Company 公司名称(若存在与发货地址关联的公司名称)。
Shipping Name 与收货地址相关联的人员的全名。地址需要有与之关联的姓名。您可以使用 Shipping Name 或使用 Shipping First NameShipping Last Name 来满足此要求。
Shipping Phone 与收货地址相关联的电话号码(E.164 格式)。电话号码可以设置为不同的格式,但每种格式都必须表示可以从世界上任何地方拨通的号码。以下格式均有效:
6135551212
+16135551212
(613)555-1212
+1 613-555-1212
Shipping First Name 与收货地址相关联的人员的名字。地址需要带有关联的姓名。您可通过使用 Shipping First NameShipping Last Name 或通过使用 Shipping Name 来执行此操作。
Shipping Last Name 与收货地址相关联的人员的姓氏。地址需要带有关联的姓名。您可通过使用 Shipping First NameShipping Last Name 或通过使用 Shipping Name 来执行此操作。
Shipping Address1 邮寄地址的第一个地址行。需要使用此列来提供地址。例如,150 Elgin St
Shipping Address2 邮寄地址的可选地址行。例如 Unit 202
Shipping City 邮寄地址所在的城市名称。需要使用此列来提供邮寄地址。例如,渥太华悉尼
Shipping Province 客户所在区域(例如省、州、辖区或领地)的名称。如果您包括此列,则需要填写 Shipping Province Code 列。例如,墨西哥城塔斯马尼亚新南威尔士纽约
Shipping Province Code 当您将 Shipping Province 列包含在内时,必须填写此列。区域(例如国家/地区的州、省、县或领土)的细分代码 (ISO 3166-2)。ISO3116-2 代码包含以下部分:
  • 2 个字符的国家/地区代码 - 请勿包含此部分。
  • 用于分隔代码两个部分的连字符 (-) - 请勿包括连字符。
  • 1 到 3 个字符的细分代码 - 仅包括此部分。
ISO 3166-2 细分代码 省代码
MX-MEX(墨西哥城,墨西哥) MEX
NY-US(美国纽约) NY
Ar-B(阿根廷布宜诺斯艾利斯) B
FR-21(法国科尔多省) 21
Shipping Country 发货地址所在国家/地区的名称。此列是必填项,用于提供地址。例如,加拿大、印度或澳大利亚。
Shipping Country Code 表示客户地址所在国家/地区的两个字母(ISO 3166-1 alpha-2 代码)。例如,CA 表示加拿大。即使您指定了 Shipping Country,也请指定 Shipping Country code
Shipping Zip 客户地址的邮政编码。例如 K2P 1L490210110 012
Billing Company 与账单地址关联的人员所在的公司。
Billing Name 与此付款相关联的客户的全名。地址需要有与之关联的姓名。您可以使用 Billing Name 或使用 Billing First NameBilling Last Name 来填写此内容。
Billing Phone 与账单地址关联的电话号码(E.164 格式)。电话号码可以设置为不同的格式,但每种格式都必须表示可以从世界上任何地方拨通的号码。以下格式均有效:
6135551212
+16135551212
(613)555-1212
+1 613-555-1212
Billing First Name 与付款方式相关联的人员的名字。地址需要有与之关联的姓名。您可通过使用 Billing First NameBilling Last Name 或通过使用 Billing Name 来执行此操作。
Billing Last Name 与付款方式相关联的人员的姓氏。地址需要有与之关联的姓名。您可通过使用 Billing First NameBilling Last Name 或通过使用 Billing Name 来执行此操作。
Billing Address1 账单地址的第一个地址行。例如,150 Elgin St。此列是必填项,用于提供账单地址。
Billing Address2 账单地址的可选填地址行。例如 Unit 202
Billing City 账单地址所在城市的名称。此列是必填项,用于提供账单地址。例如,渥太华德里奥克兰
Billing Province 账单地址所在的区域(例如省、州、辖区或领地)的名称。如果您包括此列,则需要 Shipping Province Code 列。例如,Mexico city(墨西哥城)、New York(纽约)、Nunavut(努纳武特)和 New South Wales(新南威尔士)。
Billing Province Code 在指定 Billing Province 列时,必须填写此列。区域(例如国家/地区的州、省、县或领土)的细分代码 (ISO 3166-2)。ISO3116-2 代码包含以下部分:
  • 2 个字符的国家/地区代码 - 请勿包含此部分。
  • 用于分隔代码两个部分的连字符 (-) - 请勿包括连字符。
  • 1 到 3 个字符的细分代码 - 仅包括此部分。
ISO 3166-2 细分代码 省代码
MX-MEX(墨西哥城,墨西哥) MEX
US-NY(美国纽约) NY
AR-B(阿根廷布宜诺斯艾利斯) B
FR-21(法国科尔多省) 21

Billing Zip 帐单地址的邮政编码。例如,K2P 1L4
Billing Country 账单地址所在国家/地区的名称。需要使用此列来提供账单地址。例如,加拿大印度德国
Billing Country Code 账单地址所在国家/地区的两个字母(ISO 3166-1 alpha-2 代码)。例如,加拿大的代码为 CA。即使您指定了 Country,也请指定 Country code
Lineitem Name
(必填)
已下单的产品名称(产品多属性)。例如,蓝色衬衫。必须填写此列。
Lineitem Variant ID 已订购产品(产品多属性)的 ID。使用此列可将此订单中的产品连接到商店中存在的产品多属性。您需要确保此列中的 ID 与商店中的产品多属性 ID 匹配,或者将此列留空。如果 Transporter 应用在您的商店中找不到与此列中的 ID 匹配的产品多属性,则导入不会受到影响。该 ID 将被忽略,但不会通知您存在问题。例如,7513594
Lineitem Quantity 订购的产品(产品多属性)数量。此列接受正整数。默认值为 1。例如,3
Lineitem Price
(必填)
应用任何折扣之前的产品(产品多属性)价格(小数)。例如,10.50 0.2530
Lineitem Compare At Price 产品的比较价格或建议价格(产品多属性)。例如,15
Lineitem SKU 商品(产品多属性)的 SKU(货号)编号。
Lineitem Requires Shipping 产品(产品多属性)是否需要配送。有效值:
  • true - 需要配送的产品。
  • false - 无需配送的产品
值区分大小写
Lineitem Taxable 产品(产品多属性)是否应纳税。有效值:
  • true - 应纳税的产品。
  • false - 不必纳税的产品。
值区分大小写
Lineitem Fulfillment Status 订单的发货进度。有效值:
  • fulfilled
  • partial
值区分大小写
含税费 原始订单中是否包含税费。有效值:
  • true - 小计中包含税费。当此值设置为 true 时,所有税费都包含在价格中,包括订单商品税和运费税。
  • false - 小计中不包含税费。此为默认值。
值区分大小写
Tax 1 Title 收取的第一个税种的名称。例如 HSTVAT
Tax 1 Price 要对订单商品收取的税费金额 (ISO 4217)。例如 1.50。当此列中有值时,您还必须包括 Total Tax 列。
Tax 1 Rate 要对订单商品收取的税费税率(小数)。例如,.07 代表 7% 的税率。
Tax 2 Title 收取的第二个税种的名称。
Tax 2 Price 要收取的税金金额 (ISO 4217)。当该列中有值时,还必须包括 Total Tax 列。
Tax 2 Rate 要对订单产品收取的税率。
Tax 3 Title 收取的第三个税种的名称。
Tax 3 Price 要对订单产品收取的税金金额 (ISO 4217)。当该列中有值时,还必须包括 Total Tax 列。
Tax 3 Rate 要对订单产品收取的税率。
交易处理时间 最初在其他平台中进行交易时的日期和时间(ISO 8601 格式)。此值会显示在 Shopify 后台中的订单上,并且也是 Shopify 分析中使用的日期。默认值为导入订单时的日期和时间。
Transaction amount 交易所花费的金额(小数)。例如,50.00。当您进行部分付款或部分退款时,必须填写此列。
Transaction kind 交易类型。包含任何交易列时,必须填写此列。有效值:
    • authorization - 客户同意支付的金额已获得授权,但尚未被捕获。授权期限可能介于 7 到 30 天之间(具体取决于您的支付服务提供商),商店将在此期间等待付款被捕获。
    • capture - 对授权期间预留的资金进行转账。
    • sale - 在一个步骤中完成付款的授权和捕获。
    • void - 取消待授权或待捕获的款项。
    • refund - 将捕获的款项部分或全部返还给客户。
    值区分大小写
交易状态 交易状态。有效值:
  • success - 交易已由支付网关成功完成。这是默认值。
  • pending - 网关已收到交易信息,但它已发回一个响应,指示它需要更多时间才能完成交易。
  • failure - 网关发送交易失败的响应(例如,因为银行卡被拒绝或者商店没有正确设置支付网关)。
  • error - 发生通信错误(例如,未收到网关发出的响应或网关未收到请求)。
值区分大小写
Transaction gateway 发布交易的网关的名称。可以在 Shopify 的支付网关页面上找到网关列表。
Transaction location ID 进行交易的位置的标识符。此 ID 需要与您商店中设置的位置 ID 匹配(不会导入与商店中的交易位置 ID 不匹配的值)。
Transaction Source Name 交易来源。示例值:webposiphoneandroid
Shipping line code 对发货方式的引用。默认值为 Shipping line title
Shipping line price 发货方式的值。如果包含 Shipping line title 列,则必须填写此列。
Shipping line title 发货方式的标题。如果包含 Shipping line price 列,则必须填写此列。
Shipping line carrier identifier 提供运费的承运人服务的识别码。通常在使用第三方承运人服务时需要此值。
Shipping line requested fulfillment service ID 请求发货方式的发货平台标识符。当发货方式需要由第三方发货平台处理时,通常需要此值。
Shipping Tax 1 Title 对发货的订单商品收取的税费名称。例如,HST
Shipping Tax 1 Rate 对配送的订单产品收取的税率(小数)。例如,0.15 代表 15%(百分比)的运费税率。
Shipping Tax Price 要对发货的订单商品收取的税费金额(ISO 4217 格式)。当此列中有值时,您还必须包括 Total Tax 列。例如 1.50
Discount code 折扣码。如果您包括 Discount type 列,则需要此列。
Discount amount 从订单中扣除的折扣价值(以商店中的货币为单位)。如果您包括 Discount type 列,则必须填写此列。
Discount type

折扣类型。有效值:

  1. fixed_amount - 此折扣码对应的是一个特定金额。此为默认值。
  2. percentage - 折扣码对应的是百分比值。
  3. shipping - 只要运费低于金额中设定的值,折扣优惠就是免运费。例如,如果 Discount amount 为 30,而运费为 30 美元,则折扣为 30 美元。如果 Discount amount 为 30,而运费为 100 美元,则不享受折扣。
  4. 值区分大小写

Metafield Namespace 一组元字段的容器。若要导入元字段,您需要包括所有 4 个元字段列(Metafield NamespaceMetafield KeyMetafield ValueMetafield Value Type)中的值。您应该为元字段定义自定义命名空间,以区别于应用和 Shopify 使用的命名空间(包括默认的 global)。最大长度:20 个字符。
Metafield Key 元字段的名称。最大长度:30 个字符。如果包含其他元字段列,则必须填写此列。
Metafield Value 要存储为元数据的信息。如果包含其他元字段列,则必须填写此列。
Metafield Value Type 元字段的信息类型。有效值:
  • string
  • integer
  • json_string
值区分大小写。如果包含其他元字段列,则必须填写此列。

附注

文件名

CSV 文件的名称需要包含 order 一词(其所包含对象类型的名称)。例如,myorders.csv。该文件需要采用 UTF-8 格式。

地址

订单中的邮寄地址将成为客户的默认地址。当您导入与客户相关联的订单时,Transporter 应用会在您的 Shopify 商店中查找此客户:

  • 如果 Transporter 找到了客户,则订单与客户关联,订单中的发货地址将设置为客户的默认地址。
  • 如果 Transporter 找不到客户,则将添加客户并将订单与客户相关联。

多笔交易

通过为每笔交易创建单独的行,可以将其他交易添加到订单中。每一行中需要包含 Order name,以将交易链接到订单。

了解详细信息

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

免费试用