開放應用程式介面 Open API
開放API功能及涵蓋範疇
讓商戶自家系統連接 HKTVmall MMS 進行信息交換
4 大層面助您掌握網店營運情況
更大彈性管理網店及處理顧客訂單
產品詳情 - API應用
A. 檢視現有產品資訊:
MMS 系統中所有產品資料
基本資料:如 SKU ID、售價、尺寸...
深入資料:如佣金率、最後更新日期...
應用例子:商户如計劃轉換物流公司,可使用API索取產品長闊高尺寸、重量,計算 CBM,從而估算未來運費成本
B. 更改現有產品資訊:
不能夠 以API 新增產品
必須跟從 MMS 系統的規則
例:產品的 售價 (selling price) 不可以高於 原價 (original price)
庫存情況 - API應用
A. 檢視庫存
不包括 保險產品
可售存貨 (Available to Sell)
已售出、待出貨 (In Process)
B. 更新庫存:
增加 (Add) / 減少 (Deduct) / 設置 (Set)
相同批次最多同時處理 100 個SKU
多過 100 個 SKU 需分批次更新
不包括 保險產品、電子優惠劵、寄賣產品
不能夠 更改庫存狀態:
強制售罄 (Force out of stock)
有貨 (Available)
店面資料 - API應用
A. 取得商店資料
商店名稱、商店編號、商户派送的送貨運費
B. 更改商店資料
不能更改商店編號
送貨最低金額要求 (只適用 商户派送 Merchant Delivery)
送貨運費 (只適用 商户派送 Merchant Delivery)
訂單資訊 - API應用
A. 查看訂單
包含所有運送模式的訂單
按 (1) 購買日期 (Order Date) 或 (2) 入倉日期 (Pick Up Date) 篩選
查看指定日期範圍內的訂單號碼
應用例子:以Pick Up Date 篩選所有指定日期所有需要入倉的訂單
B. 擷取訂單明細
產品編號、產品名稱 及 訂購數量
訂單狀態
C. 更新訂單狀態
可以更改訂單狀態至“PICKED” 或 “ACKNOWLEDGED”
不能夠 取消訂單
不能夠 分拆運單
應用例子:
使用自家系統完成執貨程序並更新大批訂單狀態至 “PICKED”
開放API 編碼模本
所有 開放API 的編碼模本可透過以下連結擷取:
https://drive.google.com/file/d/1r_TQc8pJUlvchP7ArpYN3nsX3P-pHmWn/view?usp=sharing
設定授權通行證前的準備工作
進行授權通行證設定前,請前往MMS啟用Open API 功能,並索取以下兩項資料:
UUID
private key
位置:MMS > E-Commerce > Merchant > Merchant Store Status
按 “Search”,剔選商店後,再按 “Edit”
“Enable Open API” 欄目中選擇 “Yes”,同時複製 UUID 及 Private Key,然後 “Save”
授權通行證設定步驟 (供技術人員參考)
技術支援
如商戶於使用 Open API 功能時遇到困難或有疑問,請提供以下資料向我們查詢:
Trigger time
Request Body
Request Result