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": "點餐人不屬於這張訂單,請重新加入點餐"
}