Transporter 中的订单 CSV 列描述
订单 CSV 文件的列描述。
若要使用 Transporter 应用将订单导入 Shopify,您需要一个仅包含此记录类型的 CSV 文件。
CSV 示例文件
下载示例订单 CSV 文件:orders.csv
您可以使用 Transporter 命令行工具生成此 CSV 文件,也可以按照下文描述的格式自行创建。
列描述
下表介绍了 CSV 文件的列标头。
列 | 描述 | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Name (Required) |
您在 Shopify 后台看到的以及客户在其发票上看到的订单标识符。此标识符在您的商店内需要是唯一的。例如,#1001 、1001-A 和 SH1001 。必须填写此列。 |
||||||||||
客户的电子邮件地址。 | |||||||||||
Financial Status | 与订单相关的付款状态。有效值:
|
||||||||||
Fulfillment Status | 有关已发货的订单项的订单状态。有效值:
|
||||||||||
Currency | 用于支付的货币的三位字母代码(ISO 4217 格式)。例如,USD 或 EUR 。 |
||||||||||
Buyer Accepts Marketing | 客户是否选择接受营销。有效值:
|
||||||||||
Cancel Reason | 取消订单的原因。有效值:
|
||||||||||
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 后台中的订单上,并且也是销售报告中使用的日期。默认值为导入订单时的日期和时间。 有关影响财务和付款分析的值,请参阅 |
||||||||||
Source name | 订单的来源(例如平台名称)。导入后将无法编辑此值。例如 Transporter 。 |
||||||||||
Total weight | 所有订单项目重量的总和(采用整数格式),以克为单位。例如 11 。 |
||||||||||
Total Tax | 应用于订单的所有税金(含税价格 1、......、运费税 1)的总和(必须是正数)。当在订单中收取任何税金时(例如,当“含税价格 1”列中有值时),则必须填写此列。如果此列中没有值,则订单中的总价不包含任何税费。 | ||||||||||
Shipping Company | 公司名称(若存在与收货地址关联的公司名称)。 | ||||||||||
Shipping Name | 与收货地址相关联的人员的全名。地址需要有与之关联的姓名。您可以使用 Shipping Name 或使用 Shipping First Name 和 Shipping Last Name 来满足此要求。 |
||||||||||
Shipping Phone | 与收货地址相关联的电话号码(E.164 格式)。可以按不同格式输入电话号码,但每种格式都必须表示可以从世界上任何地方拨通的号码。以下格式均有效:6135551212 +16135551212 (613)555-1212 +1 613-555-1212
|
||||||||||
Shipping First Name | 与收货地址相关联的人员的名字。地址需要带有关联的姓名。您可通过使用 Shipping First Name 和 Shipping Last Name 或通过使用 Shipping Name 来执行此操作。 |
||||||||||
Shipping Last Name | 与收货地址相关联的人员的姓氏。地址需要带有关联的姓名。您可通过使用 Shipping First Name 和 Shipping 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 代码包含以下部分:
|
||||||||||
Shipping Zip | 客户地址的邮政编码。例如 K2P 1L4 、90210 或 110 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 Name 和 Billing Last Name 来填写此内容。 |
||||||||||
Billing Phone | 与账单地址关联的电话号码(E.164 格式)。可以按不同格式输入电话号码,但每种格式都必须表示可以从世界上任何地方拨通的号码。以下格式有效:6135551212 +16135551212 (613)555-1212 +1 613-555-1212
|
||||||||||
Billing First Name | 与付款方式相关联的人员的名字。地址需要有与之关联的姓名。您可通过使用 Billing First Name 和 Billing Last Name 或通过使用 Billing Name 来执行此操作。 |
||||||||||
Billing Last Name | 与付款方式相关联的人员的姓氏。地址需要有与之关联的姓名。您可通过使用 Billing First Name 和 Billing 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 代码包含以下部分:
|
||||||||||
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.25 和 30 。必须填写此列。 |
||||||||||
Lineitem variant title | 特定产品多属性。例如小号 。 |
||||||||||
Lineitem compare at price | 产品多属性的比较价格或建议价格。 例如,15 。 |
||||||||||
Lineitem sku | 商品(产品多属性)的 SKU(货号)编号。 | ||||||||||
Lineitem requires shipping | 产品多属性是否需要发货。有效值:
|
||||||||||
Lineitem taxable | 产品多属性是否应纳税。有效值:
|
||||||||||
Lineitem fulfillment status | 订单中单个订单项目的发货状态。有效值:
|
||||||||||
Taxes Included | 原始订单中是否包含税费。有效值:
|
||||||||||
Tax 1 Title | 收取的第一个税种的名称。例如 HST 或 VAT 。 |
||||||||||
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 | 交易类型。包含任何交易列时,必须填写此列。有效值:
|
||||||||||
Transaction Status | 交易状态。有效值:
|
||||||||||
Transaction Processed At |
最初在其他平台中进行交易时的日期和时间(ISO 8601 格式)。此值会显示在 Shopify 后台中的订单上,并且也是财务报告中使用的日期。默认值为导入订单时的日期和时间。 如果您在创建订单的同时收到付款,则该订单的 |
||||||||||
Transaction Gateway | 发布交易的网关的名称。可以在 Shopify 的支付网关页面上找到网关列表。 | ||||||||||
Transaction Location ID | 进行交易的地点的标识符。此 ID 需要与您商店中设置的地点 ID 匹配。不会导入与商店中的交易地点 ID 不匹配的值 | ||||||||||
Transaction Source Name | 交易来源。示例值:web 、pos 、iphone 和 android 。 |
||||||||||
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 1 Price | 要对发货的订单项目收取的税费金额(ISO 4217 格式)。当此列中有值时,您还必须包括 Total Tax 列。例如 1.50 。 |
||||||||||
Discount Code | 折扣码。如果您包括 Discount type 列,则需要此列。 |
||||||||||
Discount Amount |
从订单中扣除的折扣价值(以商店中的货币为单位)。如果您包括 确保输入的值与 |
||||||||||
Discount Type |
折扣类型。有效值:
值区分大小写。折扣不能应用于订单中的特定项目。有关详细信息,请参阅导入折扣。 |
||||||||||
Metafield Namespace | 一组元字段的容器。若要导入元字段,您需要包括所有 4 个元字段列中的值:Metafield Namespace 、Metafield Key 、Metafield Value 和 Metafield Type 。为元字段定义自定义命名空间以区分应用和 Shopify 使用的应用(包括默认的 global )。最大长度:20 个字符。 |
||||||||||
Metafield Key | 元字段的名称。最大长度:30 个字符。如果包含其他元字段列,则必须填写此列。 | ||||||||||
Metafield Value | 要存储为元数据的信息。如果包含其他元字段列,则必须填写此列。 | ||||||||||
Metafield Type | 元字段的信息类型。有效值:
|
文件名
CSV 文件的名称需要包含 order
一词(其所包含对象类型的名称)。例如,myorders.csv。该文件需要采用 UTF-8 格式。
地址
订单中的邮寄地址将成为客户的默认地址。当您导入与客户相关联的订单时,Transporter 应用会在您的 Shopify 商店中查找此客户:
- 如果 Transporter 找到了客户,则订单与客户关联,订单中的收货地址将设置为客户的默认地址。
- 如果 Transporter 找不到客户,则将添加客户并将订单与客户相关联。
多笔交易
通过为每笔交易创建单独的行,可以将其他交易添加到订单中。每一行中需要包含 Order name
,以将交易链接到订单。
订单发货状态
订单的发货状态应根据组成该订单的订单项目的发货状态来确定:
- 如果所有订单项目都未发货,则订单发货状态应留空,以说明订单未发货。
- 如果订单项目有任何状态组合(
fulfilled
或unfulfilled
),则订单发货状态应为partial
。 - 如果所有订单项目都已发货,则订单发货状态应为
fulfilled
。
导入折扣
折扣只能在订单级别应用,而不能应用于订单中的特定项目。如果您的某个订单中对特定项目应用了折扣,请确定总折扣金额并将其应用于整个订单。这有助于确保销售报告的准确性。