匯入訂單
目錄
一、使用情境
情境 1:貨主一次丟來一批訂單
狀況:貨主辦了一檔活動,把這檔要出的幾百張訂單整理成一個 Excel 寄給倉庫,要您今天全部建進系統準備出貨。一張一張手動新增根本來不及。
用這個功能:把貨主的檔案整理成系統範本格式後,用匯入功能一次把整批訂單建進來。流程與欄位見流程總覽與欄位說明。
結果:幾百張訂單一次建好、一起進入配貨流程,省下逐筆輸入的工,當天就能開始揀貨出貨。
情境 2:貨主檔案欄位名稱跟系統不一樣
狀況:某個貨主每次給的檔案欄位都用自己的叫法(「訂單號」「收件人」「品號」…),跟系統範本的欄位名稱對不上,每次匯入前都要手動改欄位很費工。
用這個功能:先為這個貨主建一個匯入模板,把他們的欄位名稱對應到系統欄位;之後匯入時選這個模板,系統就會照對應關係讀檔,不必每次改格式。模板的用途見流程總覽。
結果:固定合作的貨主只要設定一次模板,往後每次都能直接用他們原本的檔案匯入,不再手動轉欄位。
情境 3:貨主固定出貨給幾個門市或經銷商
狀況:貨主每週都要補貨到同一批門市,每張單的收件人、電話、地址都一樣,每次匯入都要整段貼一次,偶爾還會貼錯門市地址。
用這個功能:把這些門市建進貨主的地址簿,匯入檔只要在「地址簿代碼」填門市代碼,收件資料就由地址簿帶入。帶入規則見用地址簿代碼帶入收件資料。
結果:匯入檔只需填品項與代碼,收件資料以地址簿為準,不再每張單重貼地址。
二、功能介紹
匯入訂單讓您用一個 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(也接受 YYYY/MM/DD)。這四欄都可以留空,但一旦填了就必須是系統看得懂的日期:填「無」「N/A」這類文字會在驗證階段被擋下,整份檔案都不會匯入。
⚠️ 系統不會猜日期。「01/02/2026」「01-02-2026」這類日、月順序不明的寫法,以及「8-Jul-29」「8-Jul」這類兩位數年份或月份縮寫的寫法,一律不接受:該列會回報日期格式錯誤,整份檔案都不會匯入。這是為了避免系統自行猜測而讓訂單帶著錯的日期進到出貨流程。
三、常見問題
3.1 常見錯誤
到「匯入列表」的匯入詳情可以看到每一列的錯誤原因,常見幾類:
▪ 必填欄位未填
收件人姓名、電話、地址、通路代碼、物流類型、品號、數量、庫存類型代碼任一沒填,整份檔案都不會匯入(有填地址簿代碼時,前四欄可由地址簿帶入,見用地址簿代碼帶入收件資料)。通路代碼留空的訊息是「通路為必填」。對照欄位說明補齊必填欄位。訂單編號另有一條規則:整份檔案的第一筆資料列一定要填訂單編號,沒填時系統不知道這列該歸到哪張單,同樣整份中止;但第二張之後的訂單如果首列漏填訂單編號,系統不會報錯,而是把那幾列的商品靜默併進上一張訂單——這種錯不會出現在失敗清單裡,請自行核對每張新訂單的第一列都有填訂單編號。
▪ 資料對不上系統設定
通路代碼、物流類型、庫存類型代碼在系統裡找不到。請確認填的值與該貨主的設定一致(建議直接從範本的對照分頁複製;通路欄填代碼或通路名稱都認得,大小寫不影響)。地址簿代碼在這個貨主的地址簿裡找不到時,訊息是「找不到地址簿代碼」並列出代碼;通路留空、而那筆地址簿設定的預設通路已不能用(例如通路已刪除)時,訊息是「地址簿代碼 … 設定的預設通路已無法使用」,請到地址簿更新預設通路,或在檔案填入通路代碼。這一類錯誤都在驗證階段,會讓整份檔案都不匯入。
▪ 資料衝突
訂單編號已存在。未勾「覆蓋現有資料」時會失敗;勾了但訂單已出貨、或收件人姓名與既有訂單不一致時也會失敗。這些情況都在驗證階段,整份檔案都不會匯入。已取消的訂單不在此列——它可以被覆蓋更新。
▪ 數量或日期格式錯誤
數量須為大於 0 的數字。日期欄填了系統看不懂的文字(例如「無」「N/A」)時,整份檔案都不會匯入;日、月順序不明或兩位數年份的寫法同樣會被擋下(系統不會猜),詳見日期欄位。
3.2 注意事項
⚠️ 重要提醒
- 匯入是「先整份驗證、再逐張建立」:驗證階段只要有任何一列有誤,整份檔案就中止、一張訂單都不會建立。請到「匯入列表」把列出的錯誤一次改完,再整份重傳,不要只重傳失敗的列。
- 勾選「覆蓋現有資料」會更新既有訂單;已出貨的訂單無法更新,已取消的訂單則仍可被覆蓋(狀態維持已取消),更新時收件人姓名須與既有訂單一致。
- 一張訂單有多個商品時,只有第一列填訂單欄位,後續商品列的訂單編號欄留空。反過來說,每張新訂單的第一列一定要填訂單編號:漏填時系統不會報錯,而是把那張單的商品靜默併進上一張訂單。
💡 提示:第一次匯入先用「下載範本」下載標準格式照著填,欄位名稱與順序最不容易出錯。固定合作的貨主再考慮建匯入模板。
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 訂單列表 | 回到訂單列表 | 前往 |
| 新增訂單 | 改為手動建立單張訂單 | 前往 |
| 列印模板 | 管理出貨明細等單據的列印模板 | 前往 |