Get Store Sale Method Status

Description

取得門市各銷售方式當前接單狀態，供 mStore 或其他客戶端裝置載入各銷售方式目前接單狀態、暫停原因與倒數截止時間。 系統支援當前時間超過 resume_at 時動態判定自動恢復開啟。

Resource

GET /store//sale-method/status

Authorization

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

Path Parameters

Name	Type	Description
store_id	string	門市代碼

Response

{
  "devices": [
    {
      "client_device": "PWA",
      "sale_methods": [
        {
          "id": 1,
          "name": "內用",
          "is_paused": false,
          "suspend_reason": null,
          "suspend_reason_color": null,
          "resume_at": null
        },
        {
          "id": 2,
          "name": "外帶",
          "is_paused": true,
          "suspend_reason": "天候不佳，暫停接單",
          "suspend_reason_color": "#FF0000",
          "resume_at": "2026-08-12 18:30:00"
        },
        {
          "id": 3,
          "name": "外送",
          "is_paused": true,
          "suspend_reason": "門市忙碌中",
          "suspend_reason_color": "#F48C00",
          "resume_at": null
        }
      ]
    },
    {
      "client_device": "KIOSK",
      "sale_methods": [
        {
          "id": 1,
          "name": "內用",
          "is_paused": false,
          "suspend_reason": null,
          "suspend_reason_color": null,
          "resume_at": null
        },
        {
          "id": 2,
          "name": "外帶",
          "is_paused": false,
          "suspend_reason": null,
          "suspend_reason_color": null,
          "resume_at": null
        }
      ]
    }
  ]
}

Response Body Parameters

Name	Type	Description
devices	Device[]	裝置資訊陣列

Response Body Parameters - Device

Name	Type	Description
client_device	string	客戶端裝置 (例如: PWA, KIOSK)
sale_methods	Sale Method[]	該裝置的銷售方式清單

Response Body Parameters - Sale Method

Name	Type	Description
id	integer	銷售方式編號
name	string	銷售方式名稱
is_paused	boolean	當前是否暫停接單 (true 代表暫停, false 代表開啟)
suspend_reason	string	(optional) 停售原因描述文字
suspend_reason_color	string	(optional) 停售原因前端標籤色碼
resume_at	string	(optional) 預計自動恢復接單時間，格式：YYYY-MM-DD HH:mm:ss。若為 null 代表無限期暫停。