コンテンツにスキップ
スマレジ・プラットフォームAPI 仕様書

店舗のメニュー一覧取得

GET
/stores/{store_id}/menus

店舗で取り扱うメニューの一覧を取得します

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
store_id
required
string

店舗ID

Query Parameters

Section titled “Query Parameters ”
type
string
default: all
Allowed values: all normal plan course

[フィルタ]メニュー種別

  • all: 全て
  • normal: 単品
  • plan: プラン
  • course: コース
Example
all
category_id
string

カテゴリーID

Example
1
with_custom_order
string
default: none
Allowed values: all none

お好みオーダー情報を含むかを指定します。

  • all: 全て含む
  • none: 含めない (キー customOrder を含めない)
Example
none
limit
integer
default: 20 >= 1 <= 100

取得件数

Example
20
sort
string
default: sort_no

ソート順

  • sort_no: ソート番号
  • id: メニューID
  • name: メニュー名
Example
sort_no
page
integer
default: 1 >= 1

ページ番号

Example
1

Responses

Section titled “ Responses ”

200

Section titled “200 ”

OK

Array
StoreMenu

店舗のメニュー

object
id
required

メニューID

string
name

メニュー名

string
kana

メニュー名（カナ）

string
type

メニュー種別

  • normal:単品
  • plan:プラン
  • course:コース
string
Allowed values: normal plan course
categoryId

カテゴリーID

string
note

メニュー説明

string
sortNo

ソート番号

integer
applyDatetime

適用開始日時[YYYY-MM-DDThh:mm:ssTZD]

string
nullable
customId

お好みオーダーID

string
nullable
customOrder

クエリパラメーターに with_custom_order=all を指定した場合、レスポンスに含まれます。

object
customId

お好みオーダーID

string
customName

お好みオーダー名

string
contents

お好みオーダー内容

Array
object
customContentId

お好みオーダー内容ID

string
customContentName

お好みオーダー内容名

string
sortNo

ソート番号

integer
isOpenPrice
  • true:注文時に価格決定する
  • false:設定価格で注文する
boolean
createdIn

作成元サービス

string
nullable
Allowed values: waiter pos headquarters
toppingGroupId

トッピンググループID
メニューが単品(type=normal)またはプラン(type=plan)の場合、レスポンスに含まれます。

string
nullable
prices
Array
PriceSetting
object
taxRate

税率

number
taxType

税種別

  • normal:標準
  • reduced:軽減
  • none:非課税
string
Allowed values: normal reduced none
amount

金額

string
tax

金額の税情報

  • include: 税込
  • exclude: 税抜
  • none: 非課税

※ 注文のリクエストボディで指定できる tax (金額の税情報)と単語が一致していませんのでご注意ください。

※ テーブル利用セクション、注文セクションのレスポンスに含まれる sellingPrice<NewOrderItemPrice> の tax (金額の税情報)と単語が一致していません。

string
Allowed values: include exclude none
primary

複数価格存在する場合の初期選択設定

  • true:初期選択値
  • false:初期選択でない
boolean
menus

プラン内メニュー
メニューがプラン(type=plan)の場合、レスポンスに含まれます。

Array<object>
MenuSimple

メニュー情報

object
id
required

メニューID

string
name

メニュー名

string
kana

メニュー名（カナ）

string
type

メニュー種別

  • normal:単品
  • plan:プラン
  • course:コース
string
Allowed values: normal plan course
categoryId

カテゴリーID

string
note

メニュー説明

string
sortNo

ソート番号

integer
applyDatetime

適用開始日時[YYYY-MM-DDThh:mm:ssTZD]

string
nullable
customId

お好みオーダーID

string
nullable
sections

セクションリスト
メニューがコース(type=course)の場合、レスポンスに含まれます。

Array<object>
object
name

セクション名

string
menus

セクション内メニュー

Array
object
id
required

メニューID

string
name

メニュー名

string
kana

メニュー名（カナ）

string
type

メニュー種別

  • normal:単品
  • plan:プラン
  • course:コース
string
Allowed values: normal plan course
categoryId

カテゴリーID

string
note

メニュー説明

string
sortNo

ソート番号

integer
applyDatetime

適用開始日時[YYYY-MM-DDThh:mm:ssTZD]

string
nullable
customId

お好みオーダーID

string
nullable
extraPrice

追加料金

string
Examples
[
  {
    "id": "1",
    "name": "サラダ",
    "kana": "サラダ",
    "type": "normal",
    "categoryId": "3",
    "note": "",
    "sortNo": 1,
    "applyDatetime": null,
    "customId": "1",
    "isOpenPrice": false,
    "createdIn": "waiter",
    "toppingGroupId": "14",
    "prices": [
      {
        "taxRate": 10,
        "taxType": "normal",
        "amount": "690",
        "tax": "include",
        "primary": true
      }
    ]
  },
  {
    "id": "2",
    "name": "スープ",
    "kana": "スープ",
    "type": "normal",
    "categoryId": "3",
    "note": "",
    "sortNo": 2,
    "applyDatetime": null,
    "customId": null,
    "isOpenPrice": false,
    "createdIn": "waiter",
    "toppingGroupId": null,
    "prices": [
      {
        "taxRate": 10,
        "taxType": "normal",
        "amount": "490",
        "tax": "include",
        "primary": true
      }
    ]
  }
]

Headers

Section titled “Headers ”
Link
string

<前のURI>; rel="prev", <次のURI>; rel="next"