訂單 CSV 欄說明

訂單 CSV 檔案的欄說明。

如要使用 Transporter App 將訂單匯入 Shopify,您需要僅含有這項記錄類型的 CSV 檔案。

CSV 範例檔案

下載範例訂單 CSV 檔案:orders.csv

您可以使用 Transporter 命令列工具來產生上述 CSV 檔案,或按照下方說明的格式自行建立。

欄說明

下表說明 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 個字元。範例:「Reviewed, Packed, Delivered」(已評論, 已包裝, 已到貨)。
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 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 運送地址所在城市名稱。此為運送地址的必填欄,例如 Ottawa (渥太華) 和 Sydney (雪梨)。
Shipping Province 客戶所在地區 (例如省、州、縣或領土) 的名稱。如果納入此欄,則 Shipping Province Code (運送省份代碼) 為必填。範例:Mexico city (墨西哥市)、Tasmania (塔斯馬尼亞州)、New South Wales (新南威爾斯州) 或 New York (紐約州)。
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 code)。例如加拿大是 CA。請指定 Shipping Country code (國家/地區代碼),即使您已指定 Shipping Country (國家/地區) 也一樣。
Shipping Zip 客戶地址的郵遞區號或郵政編碼,例如 K2P 1L490210110 012
Billing Company 帳單地址相關聯人員的公司。
Billing Name 與付款相關聯的客戶完整姓名。每個地址都必須有與之關聯的姓名。您可以使用 Billing Name (帳單姓名) 或使用 Billing First Name (帳單名字) 及 Billing Last Name (帳單姓氏) 來填寫。
Billing Phone 與帳單地址相關聯的電話號碼 (E.164 format)。電話號碼可設為不同格式,但每種格式代表的都必須是能從世界各地撥打的號碼。以下皆為有效格式:
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 運送地址所在城市名稱。此為運送地址的必填欄,例如 Ottawa (渥太華)、 Delhi (德里) 和 Auckland (奧克蘭)。
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 帳單地址所在國家/地區名稱。此為運送地址的必填欄,例如 Canada (加拿大)、India (印度) 和 Germany (德國)。
Billing Country Code 帳單地址在該國家/地區的雙字母代碼 (ISO 3166-1 alpha-2 code)。例如加拿大是 CA。請指定 Country code (國家/地區代碼),即使您已指定 Country (國家/地區) 也一樣。
Lineitem Name
(必填正在)
訂單中商品 (產品子類選項) 的名稱,例如「藍色襯衫」。此欄為必填。
Lineitem Variant ID 訂單中商品 (產品子類選項) 的 ID。使用此欄可將此訂單中的商品連結至商店中存在的產品子類選項。此欄的 ID 必須與商店中的產品子類選項 ID 相符,否則請將此欄留空。如果 Transporter App 無法在商店中找到與此欄 ID 相符的產品子類選項,則匯入項目不受影響,系統會忽略 ID,但存在問題時也不會向您傳送通知。範例:7513594
Lineitem Quantity 訂單中商品 (產品子類選項) 的數量。此欄需使用正值整數,預設值為 1。範例:3
Lineitem Price
(必填正在)
套用任何折扣前的商品 (產品子類選項) 價格 (十進位),例如 10.50.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 交易來源。範例值:web (網路)、pos (POS)、iphone (iPhone) 和 android (Android)。
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 (運送) - 用於提供免運費優惠;如果運送成本低於 amount (金額) 所設的值即可使用。舉例來說,如果 Discount amount (折扣金額) 為 30,而運送成本為 $30 美元,則折扣為 $30 美元。如果 Discount amount (折扣金額) 為 30,運送成本為 $100 美元,則不提供此折扣。
  4. 值區分大小寫
Metafield Namespace 可容納一組中繼欄位的容器。若要匯入中繼欄位,您必須納入 4 個中繼欄位欄中所有的值 (Metafield Namespace「中繼欄位命名空間」、Metafield Key「中繼欄位金鑰」、Metafield Value「中繼欄位值」以及 Metafield Value Type「中繼欄位值類型」)。您必須為中繼欄位定義自訂命名空間,才能區分應用程式和 Shopify 所個別使用命名空間的中繼欄位 (包括預設的 global「全域」)。長度上限:20 個字元。
Metafield Key 中繼欄位的名稱。長度上限:30 個字元。如果其他中繼欄位欄已填,則此欄為必填。
Metafield Value 要儲存為中繼資料的資訊。如果其他中繼欄位欄已填,則此欄為必填。
Metafield Value Type 中繼欄位的資訊類型。有效值:
  • string
  • integer
  • json_string
值需區分大小寫。如果其他中繼欄位欄已填,則此欄為必填。

備註

檔案名稱

您的 CSV 檔案名稱必須包括 order (檔案中包含的物件類型名稱),例如 myorders.csv。檔案必須為 UTF-8 格式。

地址

訂單中的運送地址會設為客戶的預設地址。如果您匯入的訂單有與其相關聯的客戶,Transporter App 會在 Shopify 商店中查詢該客戶:

  • 如果 Transporter 找到該客戶,訂單就會與該客戶建立關聯,訂單的運送地址就會設為客戶的預設地址。
  • 如果 Transporter 並未找到該客戶,則該客戶會加入訂單並與訂單建立關聯。

多筆交易

您可以為每筆交易建立不同的列,藉此在訂單中新增其他交易。每個列都必須加入 Order name (訂單名稱),才能將交易連結到訂單。

深入瞭解

準備好開始透過 Shopify 銷售商品了嗎?

免費試用