Skip to content

Lock Group

Description

收單鎖定。 此 API 讓已登入的團主鎖定一個「團購主訂單」,鎖定後無法再加入或修改訂單,但稍後可視需要重新開啟。

Resource

POST /v1/order/group/{group_order_id}/lock

Authorization

採用 OAuth 2.0 Bearer Token,需帶入會員 Token (acckey) 以識別團主身分。 詳細使用流程請參考 Auth Login

Path Parameters

Name Type Description
group_order_id string 團主訂單編號

Request Body Parameters

Name Type Description
store Store 門市
customer Customer 訂購人資訊
(Ocard 會員驗證身分必填)

Request Body Parameters - Store

Name Type Description
id string 門市代碼

Request Body Parameters - Customer

Name Type Description
id string 會員編號
(optional)
name string 姓名
mobile string 手機號碼
(optional)
address string 地址,銷售方式為外送時必填 (order.type is DELIVERY)
(optional)
vip_group_id string vip群組代碼
(optional)

Request Example

{
  "store": {
    "id": "A01"
  },
  "customer": {
    "name": "小明"
    "mobile": "0912345678"
  }
}

Response Body Parameters

Name Type Description
id string 訂單編號

Response

{
  "id": "A012601090001"
}

Notes

  • 必須是該團購單的擁有者 (團主) 才能執行鎖定操作,否則會回傳 403 Forbidden。
  • 若為 Ocard 會員,需於 Request Body customer 提供手機號碼以驗證身分。
  • 鎖定後狀態將變更為 LOCK ('1')。