> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.easystore.co/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 【訂單管理】批量訂單匯入

![](https://storage.crisp.chat/users/helpdesk/website/-/b/3/4/7/b34797d9594d3000/6ygp55so5ywo6yoo5pa55qgi_1woz70a.png)

以透過匯入 Excel 檔案，將歷史訂單資料（舊平台資料）加入系統中，方便集中管理與計算顧客累積消費。請下載範本檔案，依照格式填寫資料後匯入。

---

# 注意：

* 最多支援遷移 1 年的歷史訂單數據
* 匯入訂單時填寫的編號不能重復


---

# ${color}[#9a1d1d](目錄：)

### [▶️步驟一：安裝擴充](#3-5q2l6amf5lia77ya5a6j6kod5po05ywf)
### [▶️步驟二：下載 Excel 範例表單](#3-excel)
### [▶️表格結構](#2-6kgo5qc857wq5qel77ya5lia5yix5luj6kgo5lia5ycl5zwg5zob)
### [▶️步驟三：填寫 Excel 表單](#3-excel)
### [▶️匯入前檢查資料 / 匯入後的訂單資料](#2-5yyv5ywl5ymn5qqi5pl6loh5paz)
### [▶️步驟四：上傳 Excel 表單](#3-excel)
### [▶️常見問題](#2-5bi46kal5zwp6agm)
---


### 步驟一：安裝擴充

1. 前往 EasyStore 後台 > 安裝擴充 > 更多擴充 > 搜尋「Order Importer 訂單匯入」擴充 > 安裝


![](https://storage.crisp.chat/users/helpdesk/website/-/b/3/4/7/b34797d9594d3000/image_1kcdszw.png)

### 步驟二：下載 Excel 範例表單

1. 前往「Order Importer 訂單匯入」擴充 > 下載範例表單


![](https://storage.crisp.chat/users/helpdesk/website/-/b/3/4/7/b34797d9594d3000/image_xp89r0.png)


---

## 表格結構：一列代表一個商品

匯入範本中，**每一列代表一個商品，而不是一張訂單**。
例如，一張訂單包含 3 個商品，就需要使用 3 列填寫，並將這 3 列的 **Order Number 填寫為相同編號**，系統就會將它們合併為同一張訂單。

![](https://storage.crisp.chat/users/helpdesk/website/-/b/3/4/7/b34797d9594d3000/image_5w3mcm.png)


**重要：訂單層級的資料只需填寫在該訂單的第一列。**

例如訂單折扣、顧客資料、付款資料等，只需填寫在第一列；第二列之後即使填寫，系統也不會採用。

| 訂單層級（只需填寫第一列） | 商品層級（每個商品皆需分別填寫） |
| ---- |
| Order Number | Item Type |
| Customer Code | Item Name |
| Customer Name | Item Sku |
| Customer Phone | Item Price |
| Location Code | Quantity |
| Date | Item Voucher Code / Amount 1–5 |
| Currency | Item Other Discount Amount |
| Remark | Item Points Used / Discount Amount |
| Order Voucher Code / Amount 1–5 | Item Is Reward Points |
| Order Other Discount Amount |  |
| Order Points Used / Discount Amount |  |
| Transaction Gateway / Number / Amount 1–2 |  |

---

### 步驟三：填寫 Excel 表單

你可參考以下關於 Excel 表單的說明：

### ${color}[#2a1c97](__必填欄位說明__)

**M：必填**
匯入時必須填寫，不可留空。

**C：條件必填**
依匯入需求而定。例如需要將訂單連結至會員時，部分欄位必須填寫，詳細條件請參考欄位說明。

**空白：選填**
可依需求填寫；填寫後，資料可能顯示於後台或用於資料驗證。


| 欄位英文名稱 | 詳細說明 | 必填 |
| ---- |
| Order Number | 每張訂單皆須填寫 Order Number，留空將不會匯入。相同 Order Number 的多列資料會合併為同一張訂單，因此**不同訂單或不同顧客請勿使用重複的 Order Number**，以免造成訂單資料錯亂。已匯入的 Order Number 也無法重複匯入或用於更新資料。 | M |
| Customer Code | 可直接使用舊平台的 Customer Code。建議填寫與【匯入顧客】Excel 相同的 Customer Code，避免訂單對應到錯誤的顧客或建立重複顧客。 | M |
| Customer Name | 填寫顧客姓名。姓名中有空格時，系統會自動拆分姓氏與名字；若留空，顧客名稱將顯示為 `Customer`。 | C |
| Customer Phone | 填寫顧客電話，用於識別及匹配顧客。若後續需要匯入會員等級，建議與【匯入顧客】Excel 填寫相同的電話號碼。 | C |
| Location Code | 需要填寫 EasyStore 已建立地點的區域碼（可在地點設定獲得）；會反映在分析報表 |  |
| Sales Person Code | 填寫負責此訂單的業務員代碼。欄位標題須使用 `Sales Person Code`（Sales 須包含 s），否則系統將無法正確匯入業務員資料。 |  |
| Date | 填寫訂單建立日期及時間，建議格式為 2026-05-01 13:00 或  2026/05/01 13:00 。若留空，系統會以匯入當天作為訂單日期。請避免使用 16/07/2026 等日期格式，以免匯入失敗。 | C |
| Currency | 填寫訂單使用的幣別代碼，例如 \`TWD\`。建議每張訂單皆填寫。 | M |
| Total Amount | 留空 |  |
| Subtotal | 留空 |  |
| Total Discount | 留空 |  |
| Total Tax | 留空 |  |
| Order Discount | 留空 |  |
| Order Voucher Code1 | 建議留空；填寫套用於整張訂單的優惠代碼。若有填寫優惠代碼，請務必同時填寫對應的 \`Order Voucher Amount1\`，否則將導致匯入失敗。 |  |
| Order Voucher Amount1 | 建議留空；填寫 \`Order Voucher Code1\` 對應的折扣金額。優惠代碼與折扣金額需一起填寫 |  |
| Order Voucher Code2 | 留空 |  |
| Order Voucher Amount2 | 留空 |  |
| Order Voucher Code3 | 留空 |  |
| Order Voucher Amount3 | 留空 |  |
| Order Voucher Code4 | 留空 |  |
| Order Voucher Amount4 | 留空 |  |
| Order Voucher Code5 | 留空 |  |
| Order Voucher Amount5 | 留空 |  |
| Order Other Discount Amount | 填寫沒有優惠代碼的其他訂單折扣金額。金額須大於 0。 |  |
| Order Points Used | 填寫此訂單使用的點數數量。若需要套用點數折抵，須同時填寫 \`Order Points Discount Amount\`。 |  |
| Order Points Discount Amount | 填寫訂單使用點數所折抵的金額。金額須大於 0 才會套用 |  |
| Remark | 填寫訂單備註。備註內容請避免直接使用半形逗號 \`,\`，以免造成資料格式錯誤而無法匯入。 |  |
| Item Type | 商品類型，預設使用 Purchase。一般歷史訂單匯入請勿使用 Return，因為系統會將其視為退款處理。 |  |
| Item Name | 填寫商品名稱。只有填寫才會建立該筆訂單商品；若整張訂單皆未填寫，將產生沒有商品的訂單。 | M |
| Item Sku | 填寫商品 SKU，僅作為訂單資料記錄，不會自動匹配商店商品或扣除庫存。欄位名稱必須使用 \`Item Sku\`，請勿改成 \`Item SKU\`。 |  |
| Item Price | 填寫商品單價。若已填寫 Item Name，此欄也必須填寫，否則將導致匯入失敗。 | M |
| Quantity | 填寫商品數量。若留空，系統會視為 0，可能導致訂單金額為 0。 | M |
| Item Discount | 留空 |  |
| Item Tax | 留空 |  |
| Item Voucher Code1 | 填寫套用於此商品的優惠代碼。若需要套用折扣，請同時填寫對應的 \`Item Voucher Amount 1\`。 |  |
| Item Voucher Amount1 | 填寫 \`Item Voucher Code1\` 對應的商品折扣金額，金額須大於 0 才會套用。 |  |
| Item Voucher Code2 | 同 Code1 規則 |  |
| Item Voucher Amount2 | 同 Amount1 規則 |  |
| Item Voucher Code3 | 同 Code1 規則 |  |
| Item Voucher Amount3 | 同 Amount1 規則 |  |
| Item Voucher Code4 | 同 Code1 規則 |  |
| Item Voucher Amount4 | 同 Amount1 規則 |  |
| Item Voucher Code5 | 同 Code1 規則 |  |
| Item Voucher Amount5 | 同 Amount1 規則 |  |
| Item Other Discount Amount | 填寫沒有優惠代碼的其他商品折扣金額。金額須大於 0。 |  |
| Item Points Used | 填寫此商品使用的點數數量。若需要套用點數折抵，須搭配 \`Item Points Discount Amount\`。 |  |
| Item Points Discount Amount | 填寫商品使用點數所折抵的金額。金額須大於 0 才會套用。 |  |
| Item Is Reward Points | \*\*建議留空。\*\* 若填寫 \`yes\`，系統會實際發放可使用的紅利點數給顧客。 |  |
| Transaction gateway1 | 填寫付款方式，例如 \`Cash\`、\`Visa\`。若留空，系統不會建立付款紀錄，訂單將顯示為未付款，並不會計入顧客累積消費。 | C |
| Transaction number1 | 填寫交易編號，主要作為交易資料記錄及顯示使用。 |  |
| Transaction amount1 | 填寫實際記錄的付款金額。若已填寫付款方式，此欄也必須填寫，否則將導致匯入失敗。付款總額須至少等於系統計算的訂單總額，訂單才會顯示為已付款。 | C |
| Transaction gateway2 | 如一張訂單有第二種付款方式，可填寫於此。規則與 \`Transaction gateway1\` 相同。 |  |
| Transaction number2 | 第二筆付款的交易編號，規則與 \`Transaction number1\` 相同。 |  |
| Transaction amount2 | 第二筆付款金額。若有填寫 \`Transaction gateway2\`，此欄也必須填寫。多筆付款的金額會合併計算。 |  |
| Transaction gateway3 | 如一張訂單有第三種付款方式，可填寫於此。規則與 \`Transaction gateway1\` 相同。 |  |
| Transaction number3 | 第三筆付款的交易編號，規則與 \`Transaction number1\` 相同。 |  |
| Transaction amount3 | 第三筆付款金額，規則與 \`Transaction amount1\` 相同。 |  |


###### 💡如果你只需要保留基本的歷史訂單資料，而不需要匯入其他非必要資訊，建議只填寫以下欄位，以簡化匯入資料並降低因欄位填寫錯誤而導致匯入失敗的機率：

* `Order Number`
* `Customer Code`
* `Customer Name`
* `Customer Phone`
* `Date`
* `Currency`
* `Order Other Discount Amount`（如有）
* `Item Name`
* `Item Price`
* `Quantity`
* `Item Other Discount Amount`（如有）
* `Transaction Gateway 1`
* `Transaction Amount 1`

---
## 匯入前檢查資料

上傳檔案前，建議先確認以下項目，避免訂單或顧客資料匯入錯誤：
1. 同一個電話號碼是否對應到多個 Customer Code
2. 同一個 Customer Code 是否被不同顧客重複使用
3. Customer Phone 是否有填寫
4. Customer Code 是否包含 `ES` 開頭或 `CU` 結尾
5. 商品名稱及訂單備註是否包含半形逗號 `,`（全形逗號 `，` 不受影響）
前四項可能會造成**訂單對應到錯誤的顧客**；若商品名稱或備註包含半形逗號，則可能導致**該列資料無法匯入**。
建議在正式匯入前先完成以上檢查，避免匯入後需要逐筆調整。

## 匯入後的訂單資料

匯入完成後，訂單會有以下處理方式：
* **不會扣除商品庫存**
匯入歷史訂單不會影響商店目前的商品庫存。
* **訂單會自動標記為已送達**
匯入後，訂單內的商品會自動標記為已出貨，且不會發送相關通知給顧客。
* **匯入的商品不會與現有商品連結**
`Item Sku` 僅作為訂單資料記錄，不會自動對應至商店內的現有商品，因此不會影響商品庫存及商品銷售統計。
* **資料格式錯誤的列可能無法匯入**
若某一列的資料格式或欄位數量與標題列不一致，系統將略過該列，且處理進度中的成功／失敗數量可能不會顯示此筆資料。
* **不重複建立相同的訂單**
每張訂單應使用唯一的 Order Number。若再次匯入相同 Order Number 且訂單內容相同，系統會略過該筆資料；若使用相同 Order Number 但訂單內容不同，則可能造成訂單資料錯亂。因此，不同訂單請勿使用相同的 Order Number。

---
### 步驟四：上傳 Excel 表單

1. 完成編輯 Excel 表單後，請匯入 Excel 表單以匯入訂單

目前僅支援 **.csv 格式**，檔案大小上限為 **10 MB**。使用 Excel 儲存檔案時，請選擇 **「CSV UTF-8」** 格式。

⚠️ 請勿修改欄位標題，若欄位名稱不正確，可能會導致匯入失敗。


![](https://storage.crisp.chat/users/helpdesk/website/-/b/3/4/7/b34797d9594d3000/image_h5aip4.png)



![](https://storage.crisp.chat/users/helpdesk/website/-/b/3/4/7/b34797d9594d3000/image_9dupnz.png)

2. 上傳後，可在同一頁面的【處理進度】查看匯入進度、成功及失敗的訂單數量。


![](https://storage.crisp.chat/users/helpdesk/website/-/b/3/4/7/b34797d9594d3000/image_tmfaxn.png)

3. 已匯入的訂單會根據日期顯示在【訂單管理】內
![](https://storage.crisp.chat/users/helpdesk/website/-/b/3/4/7/b34797d9594d3000/image_t1q44m.png)

1. 已匯入的訂單會顯示在顧客資料頁面內（有專屬圖示）


![](https://storage.crisp.chat/users/helpdesk/website/-/b/3/4/7/b34797d9594d3000/image_1hi8vk.png)

4. 匯入的訂單會依現有訂單編號順序繼續編號。例如：若目前最新訂單編號為 **#1780**，則匯入的訂單將從 **#1781** 開始編號。

![](https://storage.crisp.chat/users/helpdesk/website/-/b/3/4/7/b34797d9594d3000/image_11mz45n.png)

5. 匯入的訂單也會一起計入顧客的總消費金額和消費次數，和 EasyStore 訂單同步顯示在顧客資料頁


![](https://storage.crisp.chat/users/helpdesk/website/-/b/3/4/7/b34797d9594d3000/image_1jn11t7.png)

---

# 常見問題

**Q：為什麼匯入後的訂單總金額，跟 Total Amount 填寫的金額不一樣？**
A：`Total Amount` 的金額不會直接帶入訂單。系統會根據**商品單價 × 數量 − 折扣**重新計算訂單總金額，因此請確認商品單價、數量及折扣是否填寫正確。

**Q：訂單已成功匯入，為什麼顯示為未付款？**
A：請檢查 `Transaction Gateway` 及 `Transaction Amount` 是否正確填寫。若未填寫付款方式，系統不會建立付款紀錄；若付款金額低於訂單總金額，訂單則會顯示為部分付款。

**Q：匯入進度停住，也沒有顯示錯誤訊息，怎麼辦？**
A：請先檢查日期格式及必須搭配填寫的欄位是否正確。例如填寫優惠代碼或付款方式後，對應的金額欄位也需要填寫。修正資料後，可重新上傳檔案。

**Q：可以分批匯入訂單嗎？**
A：可以，不需要一次匯入所有訂單。分批匯入時，請確保**每張不同的訂單皆使用唯一的 Order Number**，避免不同訂單使用相同編號而造成資料錯亂。

**Q：訂單的運費怎麼匯入？**
A：目前匯入表單沒有提供運費欄位，因此無法直接匯入訂單運費。如有需要，可將運費**新增為一個商品項目**，並將運費金額填寫為該商品的價格。

**Q：匯入的訂單會產生分析報表嗎？**
A：匯入的訂單會反映在 EasyStore 的**總銷售額及訂單數**等部分分析數據中。
不過，由於不同平台的數據計算方式可能不同，加上匯入訂單時並不會帶入原平台的所有訂單資料，因此 EasyStore 顯示的分析數據可能與舊平台有所差異。
如需查看舊平台訂單的完整歷史分析數據，建議直接從**原平台取得相關分析報表**，數據會較為準確。