物流串接
目錄
一、使用情境
快速連結：串接宅配業者直接印單 ｜ 大材包裹自動走專屬帳號 ｜ 指定帳號只給特定貨主使用
情境 1：串接宅配業者，讓系統直接列印託運單
狀況：倉庫和新竹物流簽了月結合約，物流公司給了一組客戶代號和密碼。出貨時，您不想再手動登入物流商網站一張一張打單，希望出貨單一鍵就能印出有單號的託運標籤。
用這個功能：在這個頁面新增一筆物流帳號，選好物流商、填入物流公司給的客代資訊（見 2.1 新增與編輯物流帳號）。串接完成後，這組帳號就能在出貨流程中被選用，自動向物流商要單號、印標籤。
結果：出貨時系統直接呼叫物流商產生託運單號，不必再到物流商後台手動建單，出貨速度大幅提升。
情境 2：同一家物流商開兩個帳號，大材包裹自動走專屬帳號
狀況：您和黑貓宅急便同時簽了「一般件」與「大材件」兩種運價合約，輕的包裹該走便宜的一般件、重的包裹該走大材件。您不想讓人員每次出貨都自己判斷該用哪個帳號。
用這個功能：把兩組合約分別建成兩筆物流帳號，在一般帳號的重量門檻留空、大材帳號填入門檻重量（例如 5）。系統出貨時會依包裹重量自動挑選對應帳號。
結果：3 公斤的包裹自動走一般帳號、8 公斤的包裹自動走大材帳號，不必人工分流，也避免用錯運價帳號被多收費用。
情境 3：把某組帳號只開放給特定貨主使用
狀況：倉庫同時服務多個貨主，其中一個貨主有自己專屬的物流合約與客代，這組帳號不能讓其他貨主拿去用。
用這個功能：新增帳號時在貨主欄位指定授權的貨主，只有被選到的貨主在出貨時才能用到這組帳號。
結果：各貨主的物流合約彼此隔離，出貨時只會選到自己被授權的帳號，帳務歸屬清楚不會混淆。
二、功能介紹
物流串接是您把倉庫和物流公司「接起來」的地方。一筆物流帳號記錄的是一組與物流商對接的合約資訊（客戶代號、密碼等），有了它，系統才能在出貨時直接向物流商索取託運單號、列印標籤，省去人工到物流商網站逐張打單。這個頁面是您管理所有已串接帳號的入口：新增帳號、修改合約資訊、暫時停用，或刪除不再使用的帳號。
2.1 搜尋與篩選
- 搜尋：輸入關鍵字搜尋帳號的顯示名稱。
- 物流商：依物流商篩選，例如只看新竹物流或黑貓宅急便的帳號，支援多選。
- 貨主：依授權的貨主篩選，找出某個貨主可用的帳號，支援多選。
2.2 列表欄位
| 欄位名稱 | 說明 |
|---|---|
| 顯示名稱 | 您為這組帳號取的識別名稱，用來區分不同的合約帳號 |
| 物流商 | 這組帳號對接的物流商，例如新竹物流、黑貓宅急便、綠界物流等 |
| 倉庫 | 帳號所屬的倉庫，您只會看到目前所在倉庫的帳號 |
| 貨主 | 被授權使用這組帳號的貨主；顯示「-」代表尚未指定貨主授權，出貨時還無法被選用 |
| 啟用 | 顯示這組帳號目前是啟用還是停用，停用中的帳號不會被出貨流程選到 |
| 重量門檻 | 此帳號適用的最低包裹重量（公斤），用於依重量自動分流；顯示「-」代表無門檻 |
2.3 新增與編輯物流帳號
點擊右上角「新增」會開啟設定視窗；在列表每一列點「編輯」則開啟同一個視窗修改既有帳號。視窗分成左右兩區：左側填一般設定，右側依您選的物流商顯示該物流商專屬的串接欄位。
標示 * 的欄位為必填項目
▸ 左側：一般設定
| 欄位名稱 | 如何填寫 | 注意事項 |
|---|---|---|
| *物流商 | 從清單選擇要串接的物流商 | 建立後無法修改；要換物流商請重新建立一筆帳號 |
| *顯示名稱 | 輸入好辨識的名稱，例如「新竹-台北倉」或「黑貓-大材」 | 最多 100 個字 |
| 啟用物流類型 | 勾選這組帳號要開放的物流類型，選好物流商後才會出現 | 預設全部勾選，可依需要取消；儲存時系統會自動把勾選的類型開通給授權貨主 |
| 貨主 | 選擇可使用這組帳號的貨主，可多選 | 留空代表此帳號暫無貨主授權，出貨時還不會被選到，需之後補上 |
| 重量門檻 | 填入此帳號適用的最低包裹重量（公斤），用於同物流商多帳號時依重量分流 | 留空代表無門檻（一般件帳號） |
▸ 右側：物流商串接設定
選好物流商後，右側會出現該物流商要求的串接欄位（例如客戶代號、密碼、HashKey 等），這些欄位都是必填，內容請依物流公司提供的合約或文件填寫。不同物流商需要的欄位不同：
- 新竹物流（HCT）：客戶代號、客代帳號、密碼、客代類型（計價方式）。
- 黑貓宅急便（T-Cat）：契客代號、契客授權碼；另可設定預設品名、是否接受信用卡。
- 宅配通（Pelican）：客戶代號；另可設定是否接受信用卡。
- 嘉里大榮（Kerry TJ）：客戶編號、客代帳號、密碼、配號起點與終點。
- 通盈物流（Tong-Ying）：客戶代號。
- 綠界物流（ECPay）：廠商編號、HashKey、HashIV、物流類型（B2C／C2C）；另可設定預設品名。
- 統一數網（Presco）：母代號、子廠商代號、配號起點與終點、FTP 連線資訊。
- 日翊全家（Reyi）：母代碼、子廠商代號、廠商公私鑰、大物流代碼、代收代號、退貨週期與方式、配號與 FTP 資訊。
- 順豐速運（SF Express）：客戶編號、App Key、App Secret、AES Key、月結卡號；簽名密鑰選填（未填不同步貨態）。
- DHL：Account Number、API Username、API Password。
填完後點「儲存」即完成串接。
2.4 停用、啟用與刪除
每一列右側都有「編輯」「停用／啟用」「刪除」三個操作。
| 操作 | 作用 | 是否可逆 |
|---|---|---|
| 停用 | 把帳號暫時關閉，出貨流程不會再選到它，但合約資訊全部保留 | 可逆，隨時可再「啟用」回來 |
| 啟用 | 把已停用的帳號重新開啟，恢復可被出貨選用 | 可逆 |
| 刪除 | 把帳號從列表永久移除 | 不可逆，無法復原 |
「刪除」只有在這組帳號從未產生過任何託運單時才能執行；只要曾經用它出過貨（即使已軟刪除的紀錄），刪除按鈕會變灰無法點擊，避免歷史出貨與帳務紀錄斷鏈。這種情況請改用「停用」停用。
三、常見問題
3.1 FAQ
▪ 哪些物流商可以串接？
目前支援新竹物流、黑貓宅急便、宅配通、嘉里大榮、通盈物流、綠界物流、統一數網、日翊全家、順豐速運、DHL。每家所需的串接欄位不同，詳見 2.3 右側：物流商串接設定。
▪ 為什麼建立後不能改物流商？
物流商決定了整組串接欄位的格式與對接方式，中途更換等於是另一組完全不同的合約。若要改用別家物流商，請重新建立一筆帳號，舊的帳號可停用或刪除。
▪ 串接欄位（客戶代號、密碼等）要去哪裡拿？
這些資訊由物流公司在簽約時提供，請參考物流商的合約或 API 文件。系統不會幫您產生這些代號，必須向物流公司索取後填入。
▪ 為什麼某個帳號的「貨主」顯示「-」？
代表這組帳號還沒指定任何貨主授權。此時出貨流程不會選到它，請編輯帳號、在貨主欄位補上要授權的貨主。
▪ 為什麼有些帳號的「刪除」按鈕是灰色、按不下去？
因為這組帳號已經用來出過貨。為了保留出貨與帳務的歷史紀錄，已使用過的帳號無法刪除，請改用「停用」停用，詳見 2.4 停用、啟用與刪除。
▪ 同一家物流商可以建立多個帳號嗎？
可以。常見做法是同一家物流商分別建立「一般件」與「大材件」帳號，並透過重量門檻讓系統依包裹重量自動分流，詳見情境 2。
▪ 為什麼我看不到別人建立的某些物流帳號？
這個頁面只顯示您目前所在倉庫的物流帳號。其他倉庫的帳號、或貨主後台自行建立的帳號不會出現在這裡。
3.2 注意事項
⚠️ 重要提醒
- 「刪除」為永久移除且無法復原；已出過貨的帳號無法刪除，只能停用。
- 物流商建立後無法修改，新增前請確認選對物流商。
- 串接欄位的客戶代號、密碼等資訊請依物流公司提供的合約填寫，填錯會導致出貨時無法取得單號。
💡 提示：若只是想暫時不讓某組帳號被出貨選用，用「停用」停用即可，合約資訊會完整保留，日後隨時可重新啟用，不必刪掉再重建。
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 物流類型 | 管理倉庫提供的物流類型，物流帳號啟用的類型會在此呈現 | 前往 |
| 運費價目表 | 設定各物流類型的運費計算方式 | 前往 |
| 託運單列表 | 查看依物流帳號產生的託運單與出貨狀態 | 前往 |