匯入訂單
目錄
一、使用情境
情境 1：貨主一次丟來一批訂單
狀況：貨主辦了一檔活動，把這檔要出的幾百張訂單整理成一個 Excel 寄給倉庫，要您今天全部建進系統準備出貨。一張一張手動新增根本來不及。
用這個功能：把貨主的檔案整理成系統範本格式後，用匯入功能一次把整批訂單建進來。流程與欄位見流程總覽與欄位說明。
結果：幾百張訂單一次建好、一起進入配貨流程，省下逐筆輸入的工，當天就能開始揀貨出貨。
情境 2：貨主檔案欄位名稱跟系統不一樣
狀況：某個貨主每次給的檔案欄位都用自己的叫法（「訂單號」「收件人」「品號」…），跟系統範本的欄位名稱對不上，每次匯入前都要手動改欄位很費工。
用這個功能：先為這個貨主建一個匯入模板，把他們的欄位名稱對應到系統欄位；之後匯入時選這個模板，系統就會照對應關係讀檔，不必每次改格式。模板的用途見流程總覽。
結果：固定合作的貨主只要設定一次模板，往後每次都能直接用他們原本的檔案匯入，不再手動轉欄位。
二、功能介紹
匯入訂單讓您用一個 Excel 檔一次建立大量訂單，適合貨主整批提供訂單、或從外部系統匯出訂單再轉進來的情況。匯入從訂單列表右上角的「匯入」按鈕開啟，是一個彈出視窗的流程：選貨主、選檔案、上傳，系統會先把整份檔案檢查一遍，全部通過才逐張把訂單與商品建進來，並在匯入紀錄逐列回報結果。
2.1 流程總覽
整個匯入流程是：開啟匯入視窗 → 下載範本、填好資料 → 選貨主並上傳檔案 → 系統整份驗證後逐張建立 → 到匯入列表看結果。其中兩個概念先說明：
- 匯入範本：系統提供的標準 Excel 格式，欄位齊全、有正確的欄位名稱。建議第一次就先下載範本照著填。
- 匯入模板：針對固定貨主的「欄位對應表」。當貨主的檔案欄位名稱和系統範本不一樣時，事先建立模板把他們的欄位對應到系統欄位，之後選模板就能直接讀他們的原始檔案，不必每次手動改欄位。沒有特殊格式需求時不需要選。
匯入時還可附帶上傳檔案（如出貨證明、發票掃描）。這些附件會掛在這批匯入上，並顯示在這批匯入建立的每張訂單詳情頁中。
2.2 操作步驟
▸ 步驟 1：下載範本、填好資料
在匯入視窗點「下載範本」取得標準格式，依欄位說明把訂單與商品填進去。標示 * 的欄位為必填。一張訂單有多個商品時，第一列填訂單欄位＋第一個商品，後續商品另起一列、訂單編號欄留空即可。
建議用 Excel 開啟範本。
▸ 步驟 2：選貨主、選檔案
在視窗中選這批訂單所屬的貨主（單一貨主的倉庫會自動帶入），需要時選匯入模板，再用「選擇檔案」選好填好的檔案。檔案限 Excel（.xlsx / .xls），單檔上限 10MB。
▸ 步驟 3：決定是否覆蓋既有訂單
「覆蓋現有資料」決定碰到「訂單編號已存在」時的處理方式：
- 勾選：更新既有訂單。但若該訂單已出貨則無法更新，這次匯入會整份中止；更新時收件人姓名也須與既有訂單一致，不一致同樣整份中止。已取消的訂單仍可被覆蓋更新，且更新後狀態維持已取消——請留意不要誤覆蓋。原本卡在未知商品的訂單若被覆蓋成系統已有的品號，該未知商品在沒有其他訂單使用時會自動從清單移除。
- 不勾選：檔案裡只要有任何一個編號已存在，這次匯入就整份中止，不覆蓋。
▸ 步驟 4：上傳、看結果
按「上傳」送出。匯入分兩個階段：系統先把整份檔案檢查一遍，只要有任何一列不合格（必填未填、格式錯誤、找不到通路／物流／庫存類型、單號重複…），這份檔案就整份中止，一張訂單都不會建立，匯入紀錄會一次列出所有出問題的列——請一次改完所有錯誤再整份重傳。全部通過後才逐張建立訂單，這個階段若有單張在寫入時失敗（最典型是品號不存在、且該貨主設定為找不到品號就退單），其餘訂單仍會建立完成。完成後到「匯入列表」查看這批匯入的狀態、成功 / 失敗筆數，以及每一列的錯誤原因。
2.3 欄位說明
以下欄位名稱為 Excel 範本中的欄位標題。標示 * 的欄位為必填項目，這些欄位不可從範本中刪除。即使某些列可以留空（例如同一張單的後續商品列不填訂單編號），欄位本身仍必須保留；整欄被刪掉時系統會在第 1 列回報缺少必要欄位，整份檔案都不會匯入。唯一的例外是已在匯入模板為該欄設好預設值，並在匯入時的「匯入模板」選用該模板——這種情況該欄可以不出現在檔案裡，系統會自動帶入模板的預設值；設了模板卻沒在匯入時選用，等同沒有預設值，該欄仍會被判缺少必要欄位。
訂單欄位（填在每張單的第一列）
| 欄位 | 如何填寫 | 注意事項 |
|---|---|---|
| *訂單編號 | 這張訂單的單號 | 同一貨主下不可重複 |
| *收件人姓名 | 收件人完整姓名 | 必填 |
| *電話 | 收件人電話 | 必填 |
| *地址 | 收件地址 | 必填 |
| *通路代碼 | 通路代碼 | 範本會附一個對照分頁列出所有可用代碼。填通路名稱也認得，兩者都對不上才算失敗，且會讓整份檔案都不匯入；舊表頭「指定通路」的檔案仍可正常匯入 |
| *物流類型 | 物流類型名稱 | 只能填此貨主已開通、且非電商平台代收代付的物流類型，對不上會讓整份檔案都不匯入 |
| 代收金額 | 代收金額（數字） | 非代收留空 |
其餘訂單欄位（其他單號、電子郵件、郵遞區號、城市、區域、國家代碼、州/省、電商平台、訂單金額、幣別、急單、訂單備註、到貨日期、預約出貨日、配達時段、超商門市店號）依欄位名稱填寫即可；其中「到貨日期」與「預約出貨日」是日期欄，填法見下方日期欄位。「急單」是填 Y／N 的欄位：填 Y／N 才會變更，該格留空或範本完全沒這一欄都保留原值。
商品明細欄位（每一列都要填）
| 欄位 | 如何填寫 | 注意事項 |
|---|---|---|
| *品號 | 商品 SKU | 建議用系統已存在的品項；填到系統沒有的品號會依貨主設定建為未知商品，或讓那一張訂單建立失敗（其餘訂單仍會建立） |
| *庫存類型代碼 | 庫存類型的代碼 | 須是該貨主已啟用的代碼 |
| *數量 | 訂購數量 | 必須大於 0 |
其餘商品欄位（單位、單位數量、單價、單品備註、批號、效期、製造日期、內部備註）依需要填寫；其中「效期」與「製造日期」是日期欄，填法見下方日期欄位。
「供貨單價」填入貨主向平台約定的每件供貨金額，使用訂單幣別，可留空，0 代表免費供貨；不得填負數。它與單價分開匯入、匯出，填寫規則見供貨單價。
日期欄位
到貨日期、預約出貨日、效期、製造日期四欄請填 YYYY-MM-DD。這四欄都可以留空，但一旦填了就必須是系統看得懂的日期：填「無」「N/A」這類文字會在驗證階段被擋下，整份檔案都不會匯入。
⚠️ 請勿填「01/02/2026」「01-02-2026」這類日、月順序不明的寫法：系統一律當成日在前，會靜默存成 2026 年 2 月 1 日且不報錯——這種錯不會出現在失敗清單裡，只會讓訂單帶著錯的日期進到出貨流程。
三、常見問題
3.1 常見錯誤
到「匯入列表」的匯入詳情可以看到每一列的錯誤原因，常見幾類：
▪ 必填欄位未填
收件人姓名、電話、地址、物流類型、品號、數量、庫存類型代碼任一沒填，整份檔案都不會匯入。對照欄位說明補齊必填欄位。訂單編號另有一條規則：整份檔案的第一筆資料列一定要填訂單編號，沒填時系統不知道這列該歸到哪張單，同樣整份中止；但第二張之後的訂單如果首列漏填訂單編號，系統不會報錯，而是把那幾列的商品靜默併進上一張訂單——這種錯不會出現在失敗清單裡，請自行核對每張新訂單的第一列都有填訂單編號。
▪ 資料對不上系統設定
通路代碼、物流類型、庫存類型代碼在系統裡找不到。請確認填的值與該貨主的設定一致（建議直接從範本的對照分頁複製；通路欄填代碼或通路名稱都認得，大小寫不影響）。通路代碼留空也歸在這一類，訊息是「找不到這個通路」而不是「未填」。這一類錯誤都在驗證階段，會讓整份檔案都不匯入。
▪ 資料衝突
訂單編號已存在。未勾「覆蓋現有資料」時會失敗；勾了但訂單已出貨、或收件人姓名與既有訂單不一致時也會失敗。這些情況都在驗證階段，整份檔案都不會匯入。已取消的訂單不在此列——它可以被覆蓋更新。
▪ 數量或日期格式錯誤
數量須為大於 0 的數字。日期欄填了系統看不懂的文字（例如「無」「N/A」）時，整份檔案都不會匯入；但日、月順序不明的寫法不會失敗，而是被靜默存成錯的日期，詳見日期欄位。
3.2 注意事項
⚠️ 重要提醒
- 匯入是「先整份驗證、再逐張建立」：驗證階段只要有任何一列有誤，整份檔案就中止、一張訂單都不會建立。請到「匯入列表」把列出的錯誤一次改完，再整份重傳，不要只重傳失敗的列。
- 勾選「覆蓋現有資料」會更新既有訂單；已出貨的訂單無法更新，已取消的訂單則仍可被覆蓋（狀態維持已取消），更新時收件人姓名須與既有訂單一致。
- 一張訂單有多個商品時，只有第一列填訂單欄位，後續商品列的訂單編號欄留空。反過來說，每張新訂單的第一列一定要填訂單編號：漏填時系統不會報錯，而是把那張單的商品靜默併進上一張訂單。
💡 提示：第一次匯入先用「下載範本」下載標準格式照著填，欄位名稱與順序最不容易出錯。固定合作的貨主再考慮建匯入模板。
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 訂單列表 | 回到訂單列表 | 前往 |
| 新增訂單 | 改為手動建立單張訂單 | 前往 |
| 列印模板 | 管理出貨明細等單據的列印模板 | 前往 |