把通路代碼接到自家 ERP
目錄
一、情境是什麼
貨主自己有一套 ERP，而 ERP 裡的每個銷售管道都有自己的編碼——常見的是「客戶代碼」，例如 C00123。倉庫這邊的通路名稱是給人看的（「蝦皮官方店」），兩邊對不起來，於是每次要把出貨或計費資料匯進 ERP，都得有人手動把通路名稱換成 ERP 的代碼。
通路代碼就是為了讓這件事不用人工做：每個銷售通路除了給人看的通路名稱之外，另外掛一個對外的代碼，各種匯出檔都會把它帶出去，貨主自己就組得出 ERP 要的匯入格式。
| 業務情境 | 卡在哪裡 | 通路代碼怎麼解 |
|---|---|---|
| 出貨明細要匯進 ERP | ERP 認的是客戶代碼，匯出檔只有通路名稱 | 通路代碼填成 ERP 的客戶代碼，訂單匯出直接帶出該欄 |
| 每月帳單要進 ERP 的應付帳款 | 計費匯出的「通路代號」欄實際填的是名稱 | 該欄改為輸出真正的代碼，欄位數與表頭都不變 |
| 貨主用自家系統產生匯入檔 | 檔案裡只能填通路名稱，改名就整批失效 | 匯入以代碼為主、通路名稱仍然認得，兩種寫法都收 |
二、在系統怎麼落地
2.1 先對出代碼對照表
動系統之前，先把 ERP 那一側的編碼跟倉庫這邊的通路列成一張對照表。這一步決定後面所有匯出檔的內容，中途再改會讓已經送進 ERP 的資料對不起來。
代碼有三個限制要一起考慮：同一個貨主底下不可重複、大小寫視為相同（SHOPEE 與 shopee 是同一個），長度上限 50 個字。內容沒有字元限制，中文也可以，但既然是要給 ERP 用，通常會直接沿用 ERP 的編碼規則。
有一種組合值得留意：代碼填成同一個貨主底下「另一個通路的名稱」。系統不會擋，匯入時的解讀也是確定的——先比代碼、找不到才退回比名稱，所以這個字串一定會對到代碼那一個通路。但若您手上還有填該名稱的舊匯入檔，它從此就會改指到代碼那一個通路，取名時避開會單純一些。
2.2 填寫通路代碼
功能上線時，每個既有通路的代碼會自動先填成它的通路名稱，所以在您動手改之前，所有匯入匯出的行為都跟以前完全一樣。
貨主端到 「貨主設定」 → 「銷售通路」，倉庫端到 「銷售通路」，逐一把代碼改成對照表上的值。欄位位置與其他設定請看銷售通路設定。
一次改一個通路、改完立刻驗一份匯出檔，比整批改完才發現對照表有錯要好處理得多。
2.3 更新匯出模板
如果貨主已經存了訂單匯出模板，既有模板不會自動長出「通路代碼」這一欄——模板的欄位與表頭在建立當下就固定下來，這是為了不讓系統改版動到貨主與 ERP 之間談好的檔案格式。
要讓匯出檔帶出代碼，請進模板編輯頁把該欄勾選進去，或另外建一份給 ERP 專用的模板。
2.4 換掉手上的匯入檔
代碼改掉之後，手上的舊匯入檔仍然可以用（通路名稱還是認得），但建議趁這次一併換成代碼：往後只要通路改名，填名稱的檔案就會失效，填代碼的不會。
新的匯入範本請從系統下載，通路欄的表頭已經是「通路代碼」，而且範本會多一個對照分頁列出所有可用的代碼，通路欄的下拉直接從那裡取值，填表的人不用另外查。
三、日常營運長什麼樣
3.1 匯入時系統怎麼認通路
訂單匯入與收件地址匯入的通路欄，系統會先拿填的值比對通路代碼，找不到才退回比對通路名稱，兩者都不分大小寫。所以下面三種寫法都收：
| 檔案裡填的 | 結果 |
|---|---|
通路代碼（例如 C00123） | 對到該通路 |
| 通路名稱（例如「蝦皮官方店」） | 對到該通路 |
| 上線前的舊檔，表頭寫「指定通路」 | 舊表頭仍然認得，值照上面兩種規則解讀 |
兩者都對不到時該列會失敗，錯誤訊息會指向銷售通路設定頁。收件地址匯入的通路欄維持選填，留空不影響匯入。
3.2 哪些匯出檔會帶出代碼
| 匯出 | 代碼欄 | 能不能關掉 |
|---|---|---|
| 訂單匯出、配貨細目匯出 | 新增一欄，另有一欄是通路名稱 | 可以，透過匯出模板勾選 |
| 揀貨單匯出 | 新增一欄，跨多通路時逗號並列、順序與名稱欄一致 | 固定出現 |
| 收件地址匯出 | 新增「預設通路代碼」欄，未設定預設通路的地址留空 | 固定出現 |
| 計費匯出（出庫費／退貨費） | 既有的「通路代號」欄改為輸出代碼 | 欄位數與表頭不變 |
訂單匯出原本的「指定通路」表頭已改名為「通路名稱」，內容不變。
3.3 改過代碼之後
代碼是即時讀取的，不是出帳當下的快照。所以把某個通路的代碼改掉之後，重新匯出過去月份的帳單，「通路代號」欄會顯示改過的新代碼，不是當時的舊值。這與匯出檔裡其他的參照資訊（收件人、物流類型）行為一致——只有金額與數量是快照。
如果 ERP 那邊已經用舊代碼建了資料，改代碼前請先跟財務確認對帳方式。
四、邊界與相關功能
這個功能不做什麼
- 不產生 ERP 的匯入格式本身。系統只負責把代碼帶進匯出檔，實際的檔案欄位順序、編碼、檔名規則仍需貨主自行組裝。
- API 的通路辨識與匯入不完全一致。舊版 API 建單時，通路欄會先比代碼、再比通路名稱（與匯入同一條規則），所以串接方改送 ERP 編碼也認得。但訂單查詢的通路篩選仍然只吃通路名稱。已經串好 API 的貨主改代碼不會打斷建單；改通路名稱仍然會影響查詢，這一點與過去相同。
- 揀貨單、收件地址、計費三種匯出沒有欄位勾選功能，代碼欄固定出現。這三種匯出目前不在匯出模板的涵蓋範圍內。
- 不會自動幫既有的匯出模板加欄位，需要貨主自行編輯。
相關功能