Open Group

Description

開團 (建立團購主訂單)。 此 API 讓已登入的團主建立一個「團購主訂單」，後續成員可透過參與此團購進行點餐。

Resource

POST /v1/order/group/open

Authorization

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

Request Body Parameters

Name	Type	Description
id	string	訂單編號，開團時不用帶 (optional)
store	Store	開團門市
placed_at	string	提交時間 EXAMPLE "2026-01-09 14:00:00"
client_device	string	客戶端裝置代碼
special_instructions	string	開團名稱或備註 (optional) 例如: "週五飲料團"
external_id	string	外部編號 (optional)
customer	Customer	訂購人資訊 (Ocard 會員必填)

Request Body Parameters - Store

Name	Type	Description
id	string	門市代碼
name	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",
    "name": "台北總店"
  },
  "customer": {
    "name": "王小明",
    "mobile": "0912345678"
  },
  "placed_at": "2026-01-09 14:00:00",
  "client_device": "WIXGO",
  "special_instructions": "302會議室飲料團"
}

Response Body Parameters

Name	Type	Description
id	string	訂單編號

Response

{
  "id": "A012601090001"
}

Notes

• 團主資訊 (vip_id, name, mobile, email) 預設從 Authorization Token 中讀取。
• 若為 Ocard 會員，將使用 customer 中的資訊 (mobile 作為 vip_id)。
• storefrom 欄位會根據 client_device 參數自動對應。