匯入訂單
目錄
一、使用情境
情境 1：貨主一次丟來一批訂單
狀況：貨主辦了一檔活動，把這檔要出的幾百張訂單整理成一個 Excel 寄給倉庫，要您今天全部建進系統準備出貨。一張一張手動新增根本來不及。
用這個功能：把貨主的檔案整理成系統範本格式後，用匯入功能一次把整批訂單建進來。流程與欄位見流程總覽與欄位說明。
結果：幾百張訂單一次建好、一起進入配貨流程，省下逐筆輸入的工，當天就能開始揀貨出貨。
情境 2：貨主檔案欄位名稱跟系統不一樣
狀況：某個貨主每次給的檔案欄位都用自己的叫法（「訂單號」「收件人」「品號」…），跟系統範本的欄位名稱對不上，每次匯入前都要手動改欄位很費工。
用這個功能：先為這個貨主建一個匯入模板，把他們的欄位名稱對應到系統欄位；之後匯入時選這個模板，系統就會照對應關係讀檔，不必每次改格式。模板的用途見流程總覽。
結果：固定合作的貨主只要設定一次模板，往後每次都能直接用他們原本的檔案匯入，不再手動轉欄位。
二、功能介紹
匯入訂單讓您用一個 Excel 檔一次建立大量訂單，適合貨主整批提供訂單、或從外部系統匯出訂單再轉進來的情況。匯入從訂單列表右上角的「匯入」按鈕開啟，是一個彈出視窗的流程：選貨主、選檔案、上傳，系統就會逐張把訂單與商品建進來，並回報每一列的成功或失敗。
2.1 流程總覽
整個匯入流程是：開啟匯入視窗 → 下載範本、填好資料 → 選貨主並上傳檔案 → 系統逐列建立 → 到匯入列表看結果。其中兩個概念先說明：
- 匯入範本：系統提供的標準 Excel 格式，欄位齊全、有正確的欄位名稱。建議第一次就先下載範本照著填。
- 匯入模板：針對固定貨主的「欄位對應表」。當貨主的檔案欄位名稱和系統範本不一樣時，事先建立模板把他們的欄位對應到系統欄位，之後選模板就能直接讀他們的原始檔案，不必每次手動改欄位。沒有特殊格式需求時不需要選。
匯入時還可附帶上傳檔案（如出貨證明、發票掃描）。這些附件會掛在這批匯入上，並顯示在這批匯入建立的每張訂單詳情頁中。
2.2 操作步驟
▸ 步驟 1：下載範本、填好資料
在匯入視窗點「下載範本」取得標準格式，依欄位說明把訂單與商品填進去。標示 * 的欄位為必填。一張訂單有多個商品時，第一列填訂單欄位＋第一個商品，後續商品另起一列、訂單編號欄留空即可。
▸ 步驟 2：選貨主、選檔案
在視窗中選這批訂單所屬的貨主（單一貨主的倉庫會自動帶入），需要時選匯入模板，再用「選擇檔案」選好填好的檔案。檔案限 Excel（.xlsx / .xls），單檔上限 10MB。
▸ 步驟 3：決定是否覆蓋既有訂單
「覆蓋現有資料」決定碰到「訂單編號已存在」時的處理方式：
- 勾選：更新既有訂單。但若該訂單已出貨或已取消則無法更新，那一列會回報失敗；且更新時收件人姓名須與既有訂單一致。
- 不勾選：碰到重複編號的那一列直接回報失敗，不覆蓋。
▸ 步驟 4：上傳、看結果
按「上傳」送出。匯入採逐張建立，單列出錯只會讓那一列失敗，其餘訂單照常建立。完成後到「匯入列表」查看這批匯入的狀態、成功 / 失敗筆數，以及每一列的錯誤原因。
2.3 欄位說明
標示 * 的欄位為必填項目。
訂單欄位（填在每張單的第一列）
| 欄位 | 如何填寫 | 注意事項 |
|---|---|---|
| *訂單編號 | 這張訂單的單號 | 同一貨主下不可重複 |
| *收件人 | 收件人完整姓名 | 必填 |
| *電話 | 收件人電話 | 必填 |
| *地址 | 收件地址 | 必填 |
| *銷售通路 | 銷售通路名稱 | 須與該貨主啟用的通路名稱一致，否則該列失敗 |
| *物流類型 | 物流方式名稱 | 須與系統設定的物流名稱一致 |
| 代收金額 | 代收金額（數字） | 非代收留空 |
其餘訂單欄位（其他單號、Email、地址細項、訂單金額、幣別、急單、備註、配送 / 預約日期、超商代碼）依欄位名稱填寫即可。
商品明細欄位（每一列都要填）
| 欄位 | 如何填寫 | 注意事項 |
|---|---|---|
| *品號 | 商品 SKU | 建議用系統已存在的品項；填到系統沒有的品號會依貨主設定建為未知商品或讓該列失敗 |
| *庫存類型代碼 | 庫存類型名稱 | 須與該貨主的庫存類型一致 |
| *應出數量 | 訂購數量 | 必須大於 0 |
其餘商品欄位（價格、批號、效期、製造日期、備註）依需要填寫，日期格式為 YYYY-MM-DD。
三、常見問題
3.1 常見錯誤
到「匯入列表」的匯入詳情可以看到每一列的錯誤原因，常見幾類：
▪ 必填欄位未填
收件人、電話、地址、品號、數量、庫存類型代碼任一沒填，該列會失敗。對照欄位說明補齊必填欄位。
▪ 資料對不上系統設定
銷售通路、物流方式、庫存類型代碼填的名稱在系統裡找不到。請確認名稱與該貨主的設定完全一致（建議直接複製設定頁上的名稱）。
▪ 資料衝突
訂單編號已存在。未勾「覆蓋現有資料」時該列會失敗；勾了但訂單已出貨 / 已取消、或收件人姓名與既有訂單不一致時也會失敗。
▪ 數量或日期格式錯誤
數量須為大於 0 的數字；日期欄位須為 YYYY-MM-DD。格式不符的那一列會失敗。
3.2 注意事項
⚠️ 重要提醒
- 匯入逐列建立，單列出錯只影響那一列，其餘訂單仍會建立；務必到「匯入列表」確認失敗筆數與原因，補正後再重匯失敗的列。
- 勾選「覆蓋現有資料」會更新既有訂單；已出貨 / 已取消的訂單無法更新，更新時收件人姓名須與既有訂單一致。
- 一張訂單有多個商品時，只有第一列填訂單欄位，後續商品列的訂單編號欄要留空，否則會被當成多張不同的訂單。
💡 提示：第一次匯入先用「下載範本」下載標準格式照著填，欄位名稱與順序最不容易出錯。固定合作的貨主再考慮建匯入模板。
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 訂單列表 | 回到訂單列表 | 前往 |
| 新增訂單 | 改為手動建立單張訂單 | 前往 |
| 自定義樣板 | 管理匯入用的自定義樣板 | 前往 |