電商串接：Coupang 酷澎
目錄
一、使用情境
情境 1：串接酷澎電商平台
狀況：貨主在酷澎開設商店，希望訂單自動匯入倉庫系統。
怎麼做：
▸ 申請憑證與開通白名單
- 向酷澎申請 API 權限，取得企業代碼、訪問密鑰與密鑰
- 將設定頁面顯示的伺服器 IP 提供給酷澎開通白名單
▸ 建立帳號並測試連線
- 在「電商串接」頁面點擊「新增」
- 選擇此帳號所屬的貨主
- 「電商平台」選擇「Coupang 酷澎」，填寫「顯示名稱」並選擇「通路名稱」
- 填入酷澎提供的憑證
- 點擊「測試連線」，確認顯示「連線成功」
▸ 設定退貨地發貨地並完成功能設定
- 在右側「功能設定」的「退貨地 / 發貨地設定」選擇退貨地與發貨地
- 開啟「抓取訂單」並選擇「抓單時間」
- 點擊「儲存」
結果：系統會依設定時段自動抓取酷澎訂單，可在「訂單」列表查看。
情境 2：重選退貨地或發貨地
狀況：倉庫搬遷後，貨主在酷澎後台更新了退貨地與發貨地，系統需要同步更新選項。
怎麼做：
- 在「電商串接」列表找到該帳號並進入編輯
- 在「退貨地 / 發貨地設定」點擊「從酷澎載入退貨地清單」
- 從更新後的清單重新選擇退貨地與發貨地
- 點擊「儲存」
結果：後續訂單會使用新的退貨地與發貨地資訊。
二、功能介紹
酷澎（Coupang）是韓國大型電商平台，近年積極拓展台灣市場。完成串接後，系統會定時從酷澎抓取新訂單，出貨後自動將託運單號回傳給酷澎。酷澎以憑證方式串接，需要請酷澎開通 IP 白名單才能連線，並需設定不同物流方式使用的退貨地與發貨地。
2.1 連線資訊
| 欄位 | 說明 | 必填 |
|---|---|---|
| 貨主 | 此帳號所屬的貨主（新增時先選擇） | ✓ |
| 電商平台 | 選擇「Coupang 酷澎」，建立後無法變更 | ✓ |
| 顯示名稱 | 自訂帳號名稱，方便識別（如：酷澎官方店） | ✓ |
| 通路名稱 | 選擇對應的銷售通路，找不到選項請先到「銷售通路」新增 | ✓ |
2.2 憑證設定
前置作業：開通 IP 白名單
⚠️ 重要：酷澎 API 需要開通 IP 白名單才能連線。設定頁面會顯示需要加入白名單的伺服器 IP，請在設定前聯繫酷澎將該 IP 加入白名單。
如何取得酷澎 API 憑證
- 登入酷澎賣家後台（Wing）
- 前往「設定」→「API 管理」或聯繫酷澎客服
- 取得以下憑證資訊：
- 企業代碼（Vendor ID）
- 訪問密鑰（Access Key）
- 密鑰（Secret Key）
| 欄位 | 說明 | 必填 |
|---|---|---|
| 企業代碼 (Vendor ID) | 酷澎提供的企業識別碼 | ✓ |
| 訪問密鑰 (Access Key) | 酷澎提供的 Access Key | ✓ |
| 密鑰 (Secret Key) | 酷澎提供的 Secret Key | ✓ |
測試連線：輸入所有憑證後，點擊「測試連線」。顯示「連線成功」後，右側功能設定才會解鎖。
2.3 退貨地 / 發貨地設定
連線成功後，系統會自動從酷澎載入可選擇的退貨地和發貨地清單；如需更新清單，點擊「從酷澎載入退貨地清單」。
| 欄位 | 說明 | 用途 |
|---|---|---|
| 退貨地址代碼 (7-11) | 7-11 超商取貨的退貨地 | 7-11 超取必填 |
| 退貨地址代碼 (全家) | 全家超商取貨的退貨地 | 全家超取必填 |
| 發貨地址代碼 (宅配 - 嘉里大榮 / 新竹物流) | 宅配出貨的發貨地，嘉里大榮與新竹物流共用 | 宅配必填 |
2.4 功能設定
抓單設定
| 欄位 | 說明 |
|---|---|
| 抓取訂單 | 開啟後系統會自動抓取訂單 |
| 抓單時間 | 最多選 3 個時段；開啟抓取訂單時至少需設定 1 個 |
三、常見問題
3.1 FAQ
▪ 什麼是 IP 白名單？為什麼需要開通？
酷澎的 API 採用 IP 白名單機制保護，只有被授權的 IP 位址才能存取。您需要：
- 記下系統設定頁面顯示的伺服器 IP
- 聯繫酷澎客服或在後台申請將該 IP 加入白名單
- 等待酷澎審核通過後才能正常連線
▪ 測試連線失敗怎麼辦？
請依序檢查：
- IP 白名單是否已開通（最常見原因）
- 企業代碼（Vendor ID）是否正確
- 訪問密鑰（Access Key）與密鑰（Secret Key）是否正確
▪ 為什麼訂單沒有自動抓取？
請依序檢查：
- 「抓取訂單」是否開啟
- 是否有設定「抓單時間」
- 連線狀態是否為「已連線」，以及 IP 白名單是否仍有效
▪ 退貨地/發貨地清單是空的怎麼辦？
- 確認憑證正確且已開通 IP 白名單
- 確認已在酷澎後台設定好退貨地和發貨地
- 點擊「從酷澎載入退貨地清單」重新載入
▪ 7-11 和全家的退貨地要分開設定嗎？
是的。酷澎的超商取貨系統中，7-11 和全家是分開的物流通路，需要各自設定退貨地。如果只使用其中一種超商，只需設定該超商的退貨地即可。
▪ 可以設定多個酷澎商店嗎？
可以。如果貨主有多個酷澎商店，可以分別建立多個帳號，各自輸入不同的憑證資訊。
▪ 憑證會過期嗎？
酷澎的 API 憑證通常不會自動過期。但如果在酷澎後台重新產生金鑰，舊金鑰會失效，需要更新本系統中的設定並重新測試連線。
▪ 酷澎需要設定物流代碼對應嗎？
不需要。酷澎的物流方式由酷澎統一管理，系統會自動處理酷澎的物流資訊；您只需要完成退貨地與發貨地設定。
3.2 注意事項
⚠️ 重要提醒
- IP 白名單必須開通：這是最常被忽略的步驟，請務必確認
- 憑證安全：訪問密鑰和密鑰請妥善保管，不要分享給他人
- 退貨地/發貨地必須設定：根據使用的物流方式，設定對應的地址
- 測試後再啟用：建議先測試連線成功，再開啟抓取訂單
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 訂單列表 | 查看從酷澎抓取的訂單 | 前往 |
| 物流類型 | 設定倉庫使用的物流方式 | 前往 |
| 銷售通路 | 管理貨主的銷售通路設定 | 前往 |