電商串接：MOMO
目錄
一、使用情境
快速連結：串接 MOMO 商店 ｜ 密碼變更後更新
情境 1：串接 MOMO 購物平台
狀況：貨主在 MOMO 開設商店，希望訂單自動匯入倉庫系統。
怎麼做：
▸ 申請憑證與開通白名單
- 向 MOMO 申請 API 整合權限，取得統一編號、商店編號、商店密碼與回傳 OTP 碼
- 將設定頁面顯示的伺服器 IP 提供給 MOMO 開通白名單
▸ 建立帳號並測試連線
- 在「電商串接」頁面點擊「新增」
- 選擇此帳號所屬的貨主
- 「電商平台」選擇「MOMO」，填寫「顯示名稱」並選擇「通路名稱」
- 填入 MOMO 提供的憑證
- 點擊「測試連線」，確認顯示「連線成功」
▸ 完成功能設定
- 在右側「功能設定」開啟「抓取訂單」並選擇「抓單時間」
- 點擊「儲存」
結果：系統會依設定時段自動抓取 MOMO 訂單，可在「訂單」列表查看。
情境 2：MOMO 商店密碼變更，更新設定
狀況：MOMO 後台變更了商店密碼，系統連線異常導致訂單停止匯入。
怎麼做：
- 在「電商串接」列表找到該帳號並進入編輯
- 在「商店密碼 (Entp Pwd)」填入新密碼
- 點擊「測試連線」確認連線成功
- 點擊「儲存」
結果：連線恢復正常，訂單恢復自動抓取。
二、功能介紹
MOMO（富邦媒體）是台灣大型綜合電商購物平台。完成串接後，系統會定時從 MOMO 抓取新訂單，出貨後自動將託運單號和貨態回傳給 MOMO。MOMO 以商店帳號密碼方式串接，需要向 MOMO 申請 API 整合憑證，並請 MOMO 將本系統的伺服器 IP 加入白名單。
2.1 連線資訊
| 欄位 | 說明 | 必填 |
|---|---|---|
| 貨主 | 此帳號所屬的貨主（新增時先選擇） | ✓ |
| 電商平台 | 選擇「MOMO」，建立後無法變更 | ✓ |
| 顯示名稱 | 自訂帳號名稱，方便識別（如：MOMO 官方店） | ✓ |
| 通路名稱 | 選擇對應的銷售通路，找不到選項請先到「銷售通路」新增 | ✓ |
2.2 憑證設定
前置作業：開通 IP 白名單
⚠️ 重要：MOMO API 需要開通來源 IP 白名單才能連線。設定頁面會顯示需要加入白名單的伺服器 IP，請在設定前將該 IP 提供給 MOMO 開通。
如何取得 MOMO API 憑證
- 聯繫 MOMO 商務窗口，申請 API 整合權限
- MOMO 會提供以下憑證資訊：
- 統一編號（Entp ID）
- 商店編號（Entp Code）
- 商店密碼（Entp Pwd）
- 回傳 OTP 碼（OTP Back No）
| 欄位 | 說明 | 必填 |
|---|---|---|
| 統一編號 (Entp ID) | 貴公司的統一編號 | ✓ |
| 商店編號 (Entp Code) | MOMO 提供的商店編號 | ✓ |
| 商店密碼 (Entp Pwd) | MOMO 提供的商店密碼 | ✓ |
| 回傳OTP碼 (OTP Back No) | MOMO 提供的 OTP 回傳碼（後三碼） | ✓ |
| PDF 密碼 | 標籤 PDF 的開啟密碼（選填） | - |
測試連線：輸入所有憑證後，點擊「測試連線」。顯示「連線成功」後，右側功能設定才會解鎖。
2.3 功能設定
抓單設定
| 欄位 | 說明 |
|---|---|
| 抓取訂單 | 開啟後系統會自動抓取訂單 |
| 抓單時間 | 最多選 3 個時段；開啟抓取訂單時至少需設定 1 個 |
物流代碼對應
MOMO 訂單的物流由 MOMO 統一管理，您只需要建立「廠商配送」這一筆對應：畫面會提示建議補充的對應，點擊加入後，在「倉庫端物流對應」選擇倉庫實際使用的物流方式即可。
三、常見問題
3.1 FAQ
▪ 如何取得 MOMO API 憑證？
- 聯繫 MOMO 商務窗口或客服
- 說明需要進行系統串接
- MOMO 會協助申請並提供必要的憑證資訊
- 憑證包含：統一編號、商店編號、商店密碼、OTP 回傳碼
▪ 什麼是 OTP 回傳碼？
OTP 回傳碼是 MOMO 系統的安全驗證機制，回傳物流資訊時需要使用此碼進行身分驗證。請向 MOMO 索取，填寫時注意是後三碼。
▪ 測試連線失敗怎麼辦？
請依序檢查：
- IP 白名單是否已請 MOMO 開通
- 統一編號、商店編號、商店密碼是否正確
- OTP 回傳碼是否正確（注意是後三碼）
▪ 為什麼訂單沒有自動抓取？
請依序檢查：
- 「抓取訂單」是否開啟
- 是否有設定「抓單時間」
- 連線狀態是否為「已連線」
▪ PDF 密碼是什麼？
部分 MOMO 訂單的物流標籤 PDF 檔案會加密保護。如果您下載的標籤需要輸入密碼才能開啟，請在此欄位填入該密碼。此欄位為選填。
▪ 可以設定多個 MOMO 商店嗎？
可以。如果貨主有多個 MOMO 商店，可以分別建立多個帳號，各自輸入不同的憑證資訊。
▪ MOMO 的物流對應需要手動設定嗎？
只需要一筆：將「廠商配送」對應到倉庫端的物流方式。畫面會提示建議補充的對應，點擊即可加入。
▪ 憑證會過期嗎？
MOMO 的憑證通常不會自動過期。但如果 MOMO 後台進行密碼變更，需要同步更新本系統中的設定並重新測試連線。
3.2 注意事項
⚠️ 重要提醒
- IP 白名單必須開通：請先將設定頁顯示的伺服器 IP 提供給 MOMO
- 憑證安全：商店密碼等憑證請妥善保管，不要分享給他人
- 測試後再啟用：建議先測試連線成功，再開啟抓取訂單
- 聯繫 MOMO 申請：API 憑證需要向 MOMO 官方申請，無法自行取得
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 訂單列表 | 查看從 MOMO 抓取的訂單 | 前往 |
| 物流類型 | 設定倉庫使用的物流方式 | 前往 |
| 銷售通路 | 管理貨主的銷售通路設定 | 前往 |