Transporter 中的订单 CSV 列描述

订单 CSV 文件的列描述。

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

CSV 示例文件

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

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

列描述

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

订单 CSV 列标头
描述
Name (Required)
您在 Shopify 后台看到的以及客户在其发票上看到的订单标识符。此标识符在您的商店内需要是唯一的。例如,#10011001-ASH1001。必须填写此列。
Email 客户的电子邮件地址。
Financial Status 与订单相关的付款状态。有效值:
  • pending - 付款待处理。在这种状态下,付款可能失败。再次检查以确认是否已成功付款。
  • authorized - 付款已获授权。
  • partially_paid - 订单已部分付款。
  • paid - 已付款。
  • partially_refunded - 付款已部分退款。
  • refunded - 付款已退款。
  • voided - 付款已作废。
值区分大小写。
Fulfillment Status 有关已发货的订单产品的订单状态。有效值:
  • fulfilled - 订单中的所有订单商品均已发货。
  • partial - 订单中至少有一件商品已发货。
  • restocked - 订单中的所有商品已重新入库,并且订单已取消。
  • 将此列留空会导致订单状态为未发货。
值区分大小写。订单发货状态应基于单个订单项目的状态。有关详细信息,请参阅下面的订单发货状态
Currency 用于支付的货币的三位字母代码(ISO 4217 格式)。例如,USDEUR
Buyer Accepts Marketing 客户是否选择接受营销。有效值:
  • TRUE - 客户选择接受营销。
  • FALSE - 客户选择不接受营销。
Cancel Reason 取消订单的原因。有效值:
  • customer - 客户已取消此订单。
  • fraud - 此订单具有欺诈性。
  • inventory - 此订单中的产品没有库存。
  • declined - 付款被拒。
  • other - 未包含在此列表中的原因。
值区分大小写。
Cancelled At 订单取消的日期和时间(ISO 8601 格式)。
Closed At 订单结束的日期和时间(ISO 8601 格式)。
Tags 一串以逗号分隔的标签,用于筛选和搜索。每个以逗号分隔的标签最多可以包含 255 个字符。例如,“已评论、已装箱、已送达”
Note 附加到订单中的可选备注。客户可以查看此备注。例如,“客户改变了主意。”
Phone 客户的唯一电话号码(E.164 格式)。可以按不同格式输入电话号码,但每种格式都必须表示可以从世界上任何地方拨通的号码。以下格式均有效:
6135551212
+16135551212
(613)555-1212
+1 613-555-1212
Referring Site 客户在其中点击链接转到您商店的网站。例如,“http://www.anexample.com”
Processed At

最初在其他平台中创建订单时的日期和时间(ISO 8601 格式)。此值会显示在 Shopify 后台中的订单上,并且也是销售报告中使用的日期。默认值为导入订单时的日期和时间。

有关影响财务和付款分析的值,请参阅 Transaction Processed At

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 区域(例如国家/地区的州、省、县或领土)的细分代码 (ISO 3166-2)。当您将 Shipping Province 列包含在内时,必须填写此列。ISO3116-2 代码包含以下部分:
  • 2 个字符的国家/地区代码 - 请勿包含此部分。
  • 用于分隔代码两个部分的连字符 (-) - 请勿包括连字符。
  • 1 到 3 个字符的细分代码 - 仅包括此部分。
细分代码
ISO 3166-2 细分代码 省代码
MX-MEX(墨西哥城,墨西哥) MEX
NY-US(美国纽约) NY
Ar-B(阿根廷布宜诺斯艾利斯) B
FR-21(法国科尔多省) 21
Shipping Zip 客户地址的邮政编码。例如 K2P 1L490210110 012
Shipping Country 发货地址所在国家/地区的名称。此列是必填项,用于提供地址。例如,加拿大、印度或澳大利亚。
Shipping Country Code 表示客户地址所在国家/地区的两个字母(ISO 3166-1 alpha-2 代码)。例如,CA 表示加拿大。即使您指定了 Shipping Country,也请指定 Shipping Country code
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 列。例如,墨西哥城纽约努纳武特新南威尔士
Billing Province Code 区域(例如国家/地区的州、省、县或领土)的细分代码 (ISO 3166-2)。在指定 Billing Province 列时,必须填写此列。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 (Required)
订购的产品多属性的名称。例如,蓝色衬衫。必须填写此列。
Lineitem variant ID 订购的产品多属性的 ID。使用此列可将此订单中的产品连接到商店中存在的产品多属性。例如,7513594。您需要确保此列中的 ID 与商店中的产品多属性 ID 匹配,或者将此列留空。如果 Transporter 应用在您的商店中找不到与此列中的 ID 匹配的产品多属性,导入不会受到影响。产品仍将添加到订单中,但不会与您商店中的产品匹配以用于分析目的。
Lineitem quantity 订购的产品多属性的数量。此列仅接受正整数。默认值为 1。例如,3
Lineitem price (Required)
应用任何折扣之前的产品多属性价格。例如,10.50 0.2530。必须填写此列。
Lineitem variant title 特定产品多属性。例如小号
Lineitem compare at price 产品多属性的比较价格或建议价格。 例如,15
Lineitem sku 商品(产品多属性)的 SKU(货号)编号。
Lineitem requires shipping 产品多属性是否需要配送。有效值:
  • true - 产品需要配送。
  • false - 产品无需配送
值区分大小写。
Lineitem taxable 产品多属性是否应纳税。有效值:
  • true - 产品应纳税。
  • false - 产品不必纳税。
值区分大小写。
Lineitem fulfillment status 订单中单个订单项目的发货状态。有效值:
  • fulfilled - 订单项目中的所有产品均已发货。
  • 将此列留空会导致订单项目状态为未发货。
值区分大小写。应使用各个订单项目的发货状态来确定整个订单的状态。有关详细信息,请参阅下面的订单发货状态
Taxes Included 原始订单中是否包含税费。有效值:
  • 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 要对订单产品收取的税率。
Transaction Amount 交易所花费的金额(小数)。例如,50.00。当您进行部分付款或部分退款时,必须填写此列。
Transaction Kind 交易类型。包含任何交易列时,必须填写此列。有效值:
  • authorization - 客户同意支付的金额已获得授权,但尚未被捕获。授权期限可能介于 7 到 30 天之间(具体取决于您的支付服务提供商),商店将在此期间等待付款被捕获。
  • capture - 对授权期间预留的资金进行转账。
  • sale - 在一个步骤中完成付款的授权和捕获。
  • void - 取消待授权或待捕获的款项。
  • refund - 将捕获的款项部分或全部返还给客户。
值区分大小写。
Transaction Status 交易状态。有效值:
  • success - 交易已由支付网关成功完成。这是默认值。
  • pending - 网关已收到交易信息,但它已发回一个响应,指示它需要更多时间才能完成交易。
  • failure - 网关发送交易失败的响应(例如,因为银行卡被拒绝或者商店没有正确设置支付网关)。
  • error - 发生通信错误(例如,未收到网关发出的响应或网关未收到请求)。
值区分大小写。
Transaction Processed At

最初在其他平台中进行交易时的日期和时间(ISO 8601 格式)。此值会显示在 Shopify 后台中的订单上,并且也是财务报告中使用的日期。默认值为导入订单时的日期和时间。

如果您在创建订单的同时收到付款,则该订单的 Transaction Processed AtProcessed At 值应相同。

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 Source 货件的发货地。
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 匹配。如果类型为 percentage,请输入折扣的百分比值。如果类型为 fixed_amount,则输入折扣的总美元值。

Discount Type

折扣类型。有效值:

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

值区分大小写。折扣不能应用于订单中的特定项目。有关详细信息,请参阅导入折扣

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,以将交易链接到订单。

订单发货状态

订单的发货状态应根据组成该订单的订单项目的发货状态来确定:

  • 如果所有订单项目都未发货,则订单发货状态应留空,以指示订单未发货。
  • 如果订单项目有任何状态组合(fulfilledunfulfilled),则订单发货状态应为 partial
  • 如果所有订单项目都已发货,则订单发货状态应为 fulfilled

导入折扣

折扣只能在订单级别应用,而不能应用于订单中的特定项目。如果您的某个订单中对特定项目应用了折扣,请确定总折扣金额并将其应用于整个订单。这有助于确保销售报告的准确性。

了解详细信息

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

免费试用