Skip to content

Update Post Pay People Count

Description

WiXGo 掃碼後結:客人補填用餐人數。

  • 只在 POS 開桌時沒有填人數的情況下使用:門市開啟「需填寫人數」、且 Get Post Pay Table Status 的 people_count 為 null 時,由首位客人在按「開始點餐」時填寫(先加入同桌取得參與者編號)。
  • 每張單只能由客人補填一次;之後要修改人數請洽服務人員在 POS 修改。
  • 重送同一個人數視為成功(回 204)。
  • 已有不同的人數(POS 已填或其他客人先填)回 409:請重新取得桌狀態,直接讓客人進入點餐,不要停在填人數的畫面。
  • 訂單必須是用餐中,且 POS 尚未送出結帳。

重要提示: - 同步到 POS 的串接尚未開放;開放前只更新全通路的人數(Get Post Pay Table Status 會立即反映),仍回 204。

Resource

PATCH /v1/order/post-pay/{order_id}/people-count

Authorization

採用 OAuth 2.0 Bearer Token,詳細使用流程請參考 Auth Login。

Path Parameters

Name Type Description
order_id string 訂單編號

Request Body Parameters

Name Type Required Description
store_id string ✓ 門市代號
participant_id integer ✓ 填寫的參與者編號(加入同桌取得),正整數
people_count integer ✓ 用餐人數,1–99

Request Example

PATCH /v1/order/post-pay/11056-202610140001/people-count

{
  "store_id": "11056",
  "participant_id": 123,
  "people_count": 4
}

Response

HTTP-Status-Code: 204

HTTP-Status-Code: 409

{
  "message": "用餐人數已設定,如需修改請洽服務人員"
}

HTTP-Status-Code: 400

{
  "message": "訂單不是用餐中,無法填寫人數"
}
{
  "message": "已送出結帳,如需修改人數請洽服務人員"
}
{
  "message": "點餐人不屬於這張訂單,請重新加入點餐"
}