物流方式
目錄
一、使用情境
情境 1：串接 API 建立訂單前確認物流代碼
狀況：您（或您的技術端）透過 API 自動建立訂單，訂單需要指定 shipping_type 欄位；代碼打錯，或用了倉庫還沒幫您開通的物流，建單就會失敗。
用這個功能：到物流方式查看倉庫目前已為您開通、啟用中的物流清單（見列表欄位），直接複製「代碼」欄的值填入建單參數。
結果：建單時用的代碼保證是倉庫認得、目前也能處理的物流，避免因代碼錯誤或物流尚未開通而建單失敗。
情境 2：上架新通路前先確認配送方式是否已開通
狀況：您準備上架新的銷售通路或串接新的訂單來源，這些訂單可能會用到特定的配送方式（例如某家物流商的冷鏈、或某電商平台的店到店）；上線前想先確認倉庫這邊有沒有開通，能不能代收貨款。
用這個功能：在物流方式清單裡查詢該配送方式是否存在，並確認它的來源與是否支援支援代收貨款。清單裡沒有，代表倉庫還沒開通，需要先聯繫倉庫。
結果：上線前就能確認可用的配送方式與代收貨款能力，避免訂單進來後才發現沒有對應的物流可用。
二、功能介紹
物流方式列出倉庫目前已經為您開通、且啟用中的所有配送方式。每一筆的「代碼」就是您透過 API 建立訂單時 shipping_type 欄位要傳的值；這份清單僅供查詢，您無法在這裡新增或修改配送方式，需要新增或調整請聯繫倉庫。
快速跳轉：列表欄位
2.1 列表欄位
| 欄位 | 說明 |
|---|---|
| 代碼 | 建立訂單時 API 的 shipping_type 欄位要傳的值。比對不區分大小寫，但仍建議直接複製這裡顯示的原始值；系統物流的代碼一律小寫（例如 tcat），倉庫自建的物流代碼一律有 custom_ 前綴 |
| 名稱 | 該物流在系統內顯示的名稱 |
| 來源 | 這筆物流的來源類別（見下方說明） |
| 支援代收貨款 | 顯示「是」代表此物流支援代收貨款。這是物流本身的能力，某張訂單實際是否代收貨款，由訂單本身的設定決定，不是看這裡 |
來源的類別：
- 物流商：系統直接對接的物流商，例如黑貓、新竹物流、宅配通
- 電商平台：透過您串接的電商平台（如蝦皮、MoMo）代收代付的物流
- 自建：倉庫依您的需求另外建立的配送方式，例如倉庫自取、司機直送；不對應任何物流商，代碼固定有
custom_前綴 - 無：沒有追蹤號碼的配送方式
這份清單只顯示目前啟用中的物流；已停用的物流不會出現在這裡。
三、常見問題
3.1 FAQ
▪ 我可以在這裡新增或修改物流方式嗎？
不行。這份清單唯讀，物流方式一律由倉庫建立與管理。需要新增配送方式（例如新的物流商、或倉庫自取這類自建物流），請聯繫倉庫。
▪ API 建立訂單時，shipping_type 一定要跟這裡顯示的代碼一模一樣嗎？
比對不區分大小寫，例如代碼是 tcat，傳 TCAT 一樣找得到。但仍建議直接複製這裡顯示的原始值，避免手動輸入打錯字。
▪ 代碼前面為什麼會有 custom_？
那是倉庫依您的需求另外建立的物流，不對應任何物流商（例如倉庫自取）。系統會自動幫這類代碼加上 custom_ 前綴，避免和系統物流代碼撞號，您不需要自己輸入。
▪ 「支援代收貨款」打勾，是不是代表這個物流的訂單都會代收貨款？
不是。這欄顯示的是「這個物流有沒有代收貨款的能力」，不代表每一筆用這個物流出貨的訂單都會代收。某張訂單實際是否代收貨款，是由訂單本身的設定決定的。
▪ 為什麼我在這裡看不到某個配送方式？
可能有兩種原因：倉庫還沒為您開通這個物流，或者這個物流目前是停用狀態——這份清單只顯示已開通且啟用中的物流。若您確定需要用到這個物流，請聯繫倉庫確認開通。
▪ 頁面上的「查看 API 文件」連結是做什麼的？
點擊後會另開新分頁，前往 API 文件，您可以在裡面查到 shipping_type 等欄位完整的建單參數說明。
3.2 注意事項
⚠️ 重要提醒
- 代碼比對雖不區分大小寫，但若手動輸入時打錯字元（缺字、多字），API 仍會因為找不到對應的物流而讓建單失敗
💡 提示：串接 API 建立訂單前，直接複製這裡顯示的「代碼」欄位值，不要手動輸入，可避免打錯字。
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 物流串接 | 系統物流與電商平台物流會在您串接物流帳號、串接電商平台時自動安裝進物流方式清單 | 前往 |
| 庫存類型設定 | 同樣是以「代碼」欄供 API 串接引用的唯讀清單 | 前往 |