電商串接：Shopline
目錄
一、使用情境
情境 1：串接 Shopline 品牌官網
狀況：貨主使用 Shopline 架設品牌官網，希望官網訂單自動匯入倉庫系統。
怎麼做：
▸ 建立帳號並測試連線
- 請貨主在 Shopline 後台取得 API 金鑰
- 在「電商串接」頁面點擊「新增」
- 選擇此帳號所屬的貨主
- 「電商平台」選擇「Shopline」，填寫「顯示名稱」並選擇「通路名稱」
- 在「貨主金鑰」貼上金鑰
- 點擊「測試連線」，確認顯示「連線成功」
▸ 完成功能設定
- 在右側「功能設定」開啟「抓取訂單」並選擇「抓單時間」
- 設定「物流代碼對應」
- 點擊「儲存」
結果：系統會依設定時段自動抓取 Shopline 訂單，可在「訂單」列表查看。
情境 2：貨主更換金鑰，更新設定
狀況：貨主在 Shopline 後台重新產生了金鑰，舊金鑰失效導致訂單停止匯入。
怎麼做：
- 在「電商串接」列表找到該帳號並進入編輯
- 在「貨主金鑰」貼上新金鑰
- 點擊「測試連線」確認連線成功
- 點擊「儲存」
結果：連線恢復正常，訂單恢復自動抓取。
二、功能介紹
Shopline 是獨立電商開店平台，貨主可用它快速建立品牌官網。完成串接後，系統會定時從 Shopline 商店抓取新訂單，出貨後自動將託運單號回傳給 Shopline，也可選擇在入庫完成時將庫存推送至商店。Shopline 以金鑰方式串接，需要先在 Shopline 後台取得金鑰。
2.1 連線資訊
| 欄位 | 說明 | 必填 |
|---|---|---|
| 貨主 | 此帳號所屬的貨主（新增時先選擇） | ✓ |
| 電商平台 | 選擇「Shopline」，建立後無法變更 | ✓ |
| 顯示名稱 | 自訂帳號名稱，方便識別（如：品牌官網） | ✓ |
| 通路名稱 | 選擇對應的銷售通路，找不到選項請先到「銷售通路」新增 | ✓ |
2.2 金鑰設定
如何取得 Shopline API 金鑰
- 登入 Shopline 商店後台
- 前往「設定」→「整合管理」或「API 設定」
- 找到或建立 API 金鑰
- 複製金鑰備用；如找不到設定位置，請聯繫 Shopline 客服
| 欄位 | 說明 | 必填 |
|---|---|---|
| 貨主金鑰 | Shopline 後台取得的 API 金鑰 | ✓ |
測試連線：輸入金鑰後，點擊「測試連線」。顯示「連線成功」後，右側功能設定才會解鎖。
2.3 功能設定
抓單設定
| 欄位 | 說明 |
|---|---|
| 抓取訂單 | 開啟後系統會自動抓取訂單 |
| 抓單時間 | 最多選 3 個時段；開啟抓取訂單時至少需設定 1 個 |
庫存推送
| 欄位 | 說明 |
|---|---|
| 入庫推送 | 開啟後，入庫完成時將庫存推送至 Shopline 商店 |
| 推送比例 | 入庫完成時，推送至電商平台的庫存百分比（0–100%） |
物流代碼對應
Shopline 的物流代碼需要對應到倉庫端的物流方式：
- 點擊「新增對應」
- 在「平台物流代碼」輸入 Shopline 端的物流代碼
- 在「倉庫端物流對應」選擇倉庫使用的物流方式
請依貨主在 Shopline 設定的物流選項逐一建立對應；未設定對應的物流方式會導致訂單無法正確處理。
三、常見問題
3.1 FAQ
▪ 如何在 Shopline 後台取得 API 金鑰？
- 登入 Shopline 商店後台
- 前往「設定」→「整合管理」或「應用程式」
- 找到 API 設定區塊，建立或查看現有金鑰
- 複製金鑰貼到本系統
如找不到設定，請聯繫 Shopline 客服確認。
▪ 測試連線失敗怎麼辦？
請依序檢查：
- 金鑰是否正確複製（注意前後空白）
- 金鑰是否已啟用
- Shopline 商店是否正常運作
畫面上的「連線失敗」提示會顯示失敗原因，可作為排查依據。
▪ 為什麼訂單沒有自動抓取？
請依序檢查：
- 「抓取訂單」是否開啟
- 是否有設定「抓單時間」
- 連線狀態是否為「已連線」
▪ 物流對應要怎麼設定？
Shopline 的每種物流方式都需要對應到倉庫端的物流方式：
- 根據貨主在 Shopline 設定的物流選項
- 在「物流代碼對應」逐一建立對應
- 未設定對應的物流方式會導致訂單無法正確處理
▪ 可以設定多個 Shopline 商店嗎？
可以。如果貨主有多個 Shopline 商店，可以分別建立多個帳號，各自輸入不同的金鑰。
▪ 金鑰會過期嗎？
Shopline 金鑰通常不會自動過期。但如果在 Shopline 後台重新產生金鑰，舊金鑰會失效，需要更新本系統中的設定並重新測試連線。
▪ 如何把庫存推送到 Shopline？
在「功能設定」開啟「入庫推送」並設定「推送比例」。開啟後，入庫完成時系統會將庫存推送到 Shopline 商品。
3.2 注意事項
⚠️ 重要提醒
- 金鑰安全：金鑰請妥善保管，不要分享給他人
- 物流對應必須完整：所有 Shopline 使用的物流方式都需要設定對應
- 測試後再啟用：建議先測試連線成功，再開啟抓取訂單
- 推送比例留意超賣：多個平台合計推送比例達 100% 以上時，系統會提醒可能有超賣風險
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 訂單列表 | 查看從 Shopline 抓取的訂單 | 前往 |
| 物流類型 | 設定倉庫使用的物流方式 | 前往 |
| 銷售通路 | 管理貨主的銷售通路設定 | 前往 |