在 Transporter 中的訂單 CSV 欄說明

訂單 CSV 檔案的欄說明。

如要使用 Transporter App 將訂單匯入 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 個字元。範例:「Reviewed, Packed, Delivered」(已評論, 已包裝, 已到貨)。
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 運送地址所在城市名稱。此為運送地址的必填欄,例如 Ottawa (渥太華) 和 Sydney (雪梨)。
Shipping Province 客戶所在地區 (例如省、州、縣或領土) 的名稱。如果納入此欄,則 Shipping Province Code (運送省份代碼) 為必填。範例:Mexico city (墨西哥市)、Tasmania (塔斯馬尼亞州)、New South Wales (新南威爾斯州) 或 New York (紐約州)。
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 code)。例如加拿大是 CA。請指定 Shipping Country code (國家/地區代碼),即使您已指定 Shipping Country (國家/地區) 也一樣。
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 內容是國家/地區為州、省、縣或領土等區域的行政區劃代碼 (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 帳單地址所在國家/地區名稱。此為運送地址的必填欄,例如 Canada (加拿大)、India (印度) 和 Germany (德國)。
Billing Country Code 帳單地址在該國家/地區的雙字母代碼 (ISO 3166-1 alpha-2 code)。例如加拿大是 CA。請指定 Country code (國家/地區代碼),即使您已指定 Country (國家/地區) 也一樣。
Lineitem name (Required)
訂單中產品子類選項的名稱,例如「藍色襯衫。此欄為必填。
Lineitem variant ID 已訂購的產品子類選項 ID。使用此欄可將此訂單中的商品連結至您商店中現存產品子類選項 (例如 7513594)。您需要確保此欄的 ID 與商店中的產品子類選項的 ID 相符,或將此欄保留空白。如果 Transporter 應用程式在您的商店中,找不到任何與此欄 ID 相符的產品子類選項,則匯入項目將不受影響。系統仍會將產品新增至訂單中,但不會為了分析的目的與商店中的產品配對。
Lineitem quantity 訂單中產品子類選項的數量。此欄需使用正整數,預設值為 1。範例:3
Lineitem price (Required)
套用折扣前的產品子類選項價格。例如 10.50.2530。此欄為必填。
Lineitem variant title 特定產品子類選項,例如 S 號
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 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 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 (運送) - 用於提供免運費優惠;如果運送成本低於 amount (金額) 所設的值即可使用。舉例來說,如果 Discount amount (折扣金額) 為 30,而運送成本為 $30 美元,則折扣為 $30 美元。如果 Discount amount (折扣金額) 為 30,運送成本為 $100 美元,則不提供此折扣。

值需區分大小寫,且折扣不能套用至訂單內的特定品項。如需深入瞭解,請參閱匯入折扣

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 (訂單名稱),才能將交易連結到訂單。

訂單出貨狀態

根據訂單中的商品項目出貨狀態判斷訂單的出貨狀態:

  • 如果未出貨任何商品項目,則訂單的出貨狀態應保留空白,藉此表示訂單尚未出貨。
  • 如果商品項目中有任何以下狀態的組合 (fulfilledunfulfilled),則訂單的出貨狀態應該為 partial
  • 如果已出貨所有商品項目,則訂單的出貨狀態應為 fulfilled

匯入折扣

折扣只能套用至訂單層級,並不能套用至訂單內的特定品項。如果您的訂單中有折扣套用至特定品項,請判斷總折扣金額,然後將其套用至整筆訂單。這麼做有助於確保您的銷售報告正確無誤。

深入瞭解

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

免費試用