キャンセル

PUT

/table_uses/{table_use_id}/cancel

const url = 'https://api.smaregi.dev/TARGET-CONTRACT-ID/waiter/table_uses/example/cancel';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request PUT \
  --url https://api.smaregi.dev/TARGET-CONTRACT-ID/waiter/table_uses/example/cancel \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

テーブル利用をキャンセルします

Authorizations

AppAccessToken
waiter.orders:write

Parameters

Path Parameters

table_use_id

required

string

テーブル利用ID（注文ヘッダーID）

Request Body

application/json

object

Example^generated

{}

Responses

200

application/json

object

required

テーブル利用ID（注文ヘッダーID）

string

storeId

店舗ID

string

tables

テーブル

Array<object>

object

テーブルID

string

nullable

name

テーブル名

string

number

人数

integer

status

ステータス

started: 利用中
ended: 利用終了
canceled: キャンセル済み
merged: 結合済み

string

Allowed values: started ended canceled merged

started

利用開始日時 (入店日時)[YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

ended

利用終了日時 (精算日時)[YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

nullable

customerGroups

客層

Array<object>

object

客層ID

string

name

客層名

string

quantity

合計注文点数

integer

tableChargePerPerson

一人当たりのテーブルチャージ額

string

serviceChargeRate

サービスチャージ率(%)

integer

totalPrice

合計金額（税込）

string

tempTransactionHeadId

仮販売ID（ウェイター管理画面 ver.2.23のリリース以降にチェックアウトされたテーブル利用のみ取得できます）

string

nullable

reservationId

予約ID（削除済みの予約IDもレスポンスに含みます）

string

nullable

uuid

テーブル利用UUID

テーブル利用作成時に付与される値です。
この項目は空の結果を返す場合があります。
テーブル利用IDと組み合わせて、テーブル利用の正当性を検証するために利用できます。
（例: 取引QRコードのURLにテーブル利用ID と uuid の両方を含めた場合など）

string

0 <= 36 characters

orders

Array<object>

GetOrder

注文モデル

object

orderId

注文ID

string

ordered

注文日時[YYYY-MM-DDThh:mm:ssTZD]

string format: string

items

required

Array<object>

OrderItem

注文レスポンス内の注文明細モデル

object

注文明細ID (明細ID)

string

name

注文内容

string

status

ステータス

waiting: 提供待ち (注文済)
provided: 提供済み (配膳済)
canceled: キャンセル済み

string

Allowed values: waiting provided canceled

servedAt

配膳日時 (RFC3339の日時形式)[YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

nullable

memo

メモ

string

menuId

メニューID

string

quantity

注文明細の数量

integer

>= 1

menuType

注文時のメニュー取扱種別

normal:単品
plan:プラン
inPlan:プラン内メニュー
course:コース

string

Allowed values: normal plan inPlan course

customContentId

お好みオーダー内容ID

string

nullable

customContentName

お好みオーダー内容

string

categoryId

カテゴリーID

string

sellingPrice

NewOrderItemPrice

販売価格

object

taxRate

required

税率の割合(税率10％の場合、10 。非課税のメニューの場合、指定がなければ標準の税率になります。)

number

<= 100

taxType

required

税種別

normal:標準
reduced:軽減
none:非課税

string

Allowed values: normal reduced none

amount

required

金額

string

<= 999999

tax

required

金額の税情報

included: 税込
excluded: 税抜
none: 非課税

string

Allowed values: included excluded none

discount

One of:

RateCoupon

object

rateCoupon

required

クーポン割引率

string

/^([1-9][\d]?|100)$/

amount

required

値引金額

string

/^[1-9][\d]*$/

timeLimit

制限時間設定（分）。0 の場合は制限時間通知の対象外となります。

integer

preTimeLimitMinutesLeft

制限時間事前通知設定（分）。0 の場合は事前通知の対象外となります。

integer

toppings

メニューのトッピング

Array<object>

object

注文明細ID (明細ID)

string

toppingId

トッピングID

string

name

トッピング名

string

quantity

親注文明細 1 件あたりのトッピング数量です。トッピング実個数を親注文明細の数量で除算した値です。

integer

>= 1

categoryId

カテゴリーID

string

sellingPrice

NewOrderItemPrice

販売価格

object

taxRate

required

税率の割合(税率10％の場合、10 。非課税のメニューの場合、指定がなければ標準の税率になります。)

number

<= 100

taxType

required

税種別

normal:標準
reduced:軽減
none:非課税

string

Allowed values: normal reduced none

amount

required

金額

string

<= 999999

tax

required

金額の税情報

included: 税込
excluded: 税抜
none: 非課税

string

Allowed values: included excluded none

courseItems

コース内容

Array<object>

object

注文明細ID (明細ID)

string

menuId

メニューID

string

name

メニュー名

string

quantity

コース内明細の実数量です。プラットフォームAPI 経由の注文では親注文明細の数量に連動して設定されますが、プラットフォームAPI 以外の経路で登録された注文では連動しない場合があるため、親注文明細の数量と常に一致するとは限りません。

integer

>= 1

categoryId

カテゴリーID

string

sellingPrice

NewOrderItemPrice

追加料金

object

taxRate

required

税率の割合(税率10％の場合、10 。非課税のメニューの場合、指定がなければ標準の税率になります。)

number

<= 100

taxType

required

税種別

normal:標準
reduced:軽減
none:非課税

string

Allowed values: normal reduced none

amount

required

金額

string

<= 999999

tax

required

金額の税情報

included: 税込
excluded: 税抜
none: 非課税

string

Allowed values: included excluded none

status

ステータス

string

Allowed values: waiting provided canceled

servedAt

配膳日時 (RFC3339の日時形式)[YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

nullable

timeLimit

制限時間設定（分）。0 の場合は制限時間通知の対象外となります。

integer

preTimeLimitMinutesLeft

制限時間事前通知設定（分）。0 の場合は事前通知の対象外となります。

integer

submenuItems

required

注文明細に紐づくサブメニュー明細です。
サブメニュー明細の有無にかかわらず常に返却され、存在しない場合は空配列を返却します。

Array

OrderSubmenuItem

サブメニュー明細（子階層）

object

注文明細ID (明細ID)

string

menuId

メニューID

string

name

メニュー名

string

quantity

サブメニュー明細の実数量です。
当該サブメニュー明細自身の数量を示します。
直近の親要素（1階層上の明細）の数量変更に伴う増減は isQuantitySyncedWithParent の値に従います。

integer

>= 1

categoryId

カテゴリーID

string

sellingPrice

NewOrderItemPrice

販売価格

object

taxRate

required

税率の割合(税率10％の場合、10 。非課税のメニューの場合、指定がなければ標準の税率になります。)

number

<= 100

taxType

required

税種別

normal:標準
reduced:軽減
none:非課税

string

Allowed values: normal reduced none

amount

required

金額

string

<= 999999

tax

required

金額の税情報

included: 税込
excluded: 税抜
none: 非課税

string

Allowed values: included excluded none

status

ステータス

waiting: 提供待ち (注文済)
provided: 提供済み (配膳済)
canceled: キャンセル済み

string

Allowed values: waiting provided canceled

servedAt

配膳日時 (RFC3339の日時形式)[YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

nullable

timeLimit

制限時間設定（分）。0 の場合は制限時間通知の対象外となります。

integer

preTimeLimitMinutesLeft

制限時間事前通知設定（分）。0 の場合は事前通知の対象外となります。

integer

isQuantitySyncedWithParent

required

直近の親要素（1階層上の明細）の数量変更時に、このサブメニュー明細の数量を連動更新するかを示します。

true: 直近の親要素の数量に応じて本明細の数量も増減します。
false: 直近の親要素の数量が変わっても本明細の数量は自動変更されません。

boolean

submenuItems

required

サブメニュー明細の子要素（孫階層）です。
孫階層の明細が存在しない場合は空配列を返却します。

Array

OrderSubmenuItemNested

サブメニュー明細（孫階層）。
孫階層の明細には submenuItems は返却されません。

object

注文明細ID (明細ID)

string

menuId

メニューID

string

name

メニュー名

string

quantity

integer

>= 1

categoryId

カテゴリーID

string

sellingPrice

NewOrderItemPrice

販売価格

object

taxRate

required

税率の割合(税率10％の場合、10 。非課税のメニューの場合、指定がなければ標準の税率になります。)

number

<= 100

taxType

required

税種別

normal:標準
reduced:軽減
none:非課税

string

Allowed values: normal reduced none

amount

required

金額

string

<= 999999

tax

required

金額の税情報

included: 税込
excluded: 税抜
none: 非課税

string

Allowed values: included excluded none

status

ステータス

waiting: 提供待ち (注文済)
provided: 提供済み (配膳済)
canceled: キャンセル済み

string

Allowed values: waiting provided canceled

servedAt

配膳日時 (RFC3339の日時形式)[YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

nullable

timeLimit

制限時間設定（分）。0 の場合は制限時間通知の対象外となります。

integer

preTimeLimitMinutesLeft

制限時間事前通知設定（分）。0 の場合は事前通知の対象外となります。

integer

isQuantitySyncedWithParent

required

直近の親要素（1階層上の明細）の数量変更時に、このサブメニュー明細の数量を連動更新するかを示します。

true: 直近の親要素の数量に応じて本明細の数量も増減します。
false: 直近の親要素の数量が変わっても本明細の数量は自動変更されません。

boolean

tableUseId

テーブル利用ID（注文ヘッダーID）

string

nullable

Examples

レスポンス例

{
  "id": "10001",
  "storeId": "1",
  "tables": [
    {
      "id": "1",
      "name": "T1"
    }
  ],
  "number": 2,
  "status": "canceled",
  "started": "2020-09-07T11:30:20+09:00",
  "ended": null,
  "customerGroups": [
    {
      "id": "1",
      "name": "女性"
    }
  ],
  "quantity": 0,
  "tableChargePerPerson": "0",
  "serviceChargeRate": 0,
  "totalPrice": "0",
  "tempTransactionHeadId": null,
  "reservationId": null,
  "uuid": "87416234-BA06-4B0E-9D82-3D40A68FFE0D",
  "orders": [
    {
      "orderId": "01ED3EV928A078J0TZAJQR69CK",
      "ordered": "2020-09-07T11:35:02+09:00",
      "items": [
        {
          "id": "50001",
          "name": "コーヒー",
          "status": "canceled",
          "servedAt": null,
          "memo": "",
          "menuId": "124",
          "quantity": 2,
          "menuType": "normal",
          "customContentId": "8",
          "customContentName": "微糖",
          "categoryId": "156",
          "sellingPrice": {
            "taxRate": 10,
            "taxType": "normal",
            "amount": "330",
            "tax": "included"
          },
          "discount": {
            "rateCoupon": "10",
            "amount": "33"
          },
          "timeLimit": 30,
          "preTimeLimitMinutesLeft": 10,
          "toppings": [],
          "courseItems": [],
          "submenuItems": []
        },
        {
          "id": "50003",
          "name": "チキンサラダ",
          "status": "canceled",
          "servedAt": null,
          "memo": "",
          "menuId": "125",
          "quantity": 2,
          "menuType": "normal",
          "customContentId": null,
          "customContentName": "",
          "categoryId": "156",
          "sellingPrice": {
            "taxRate": 10,
            "taxType": "normal",
            "amount": "330",
            "tax": "included"
          },
          "discount": null,
          "timeLimit": 0,
          "preTimeLimitMinutesLeft": 0,
          "toppings": [],
          "courseItems": [],
          "submenuItems": [
            {
              "id": "60001",
              "menuId": "401",
              "name": "和風ドレッシング",
              "quantity": 2,
              "categoryId": "156",
              "sellingPrice": {
                "taxRate": 10,
                "taxType": "normal",
                "amount": "100",
                "tax": "included"
              },
              "status": "canceled",
              "servedAt": null,
              "timeLimit": 0,
              "preTimeLimitMinutesLeft": 0,
              "isQuantitySyncedWithParent": true,
              "submenuItems": [
                {
                  "id": "60002",
                  "menuId": "402",
                  "name": "大盛り",
                  "quantity": 1,
                  "categoryId": "156",
                  "sellingPrice": {
                    "taxRate": 10,
                    "taxType": "normal",
                    "amount": "20",
                    "tax": "included"
                  },
                  "status": "canceled",
                  "servedAt": null,
                  "timeLimit": 0,
                  "preTimeLimitMinutesLeft": 0,
                  "isQuantitySyncedWithParent": false
                }
              ]
            }
          ]
        }
      ],
      "tableUseId": "10001"
    }
  ]
}

204

No Content

400

キャンセルに失敗した場合

application/json

object

title

required

string

type

required

string

status

integer

detail

string

Example^generated

{
  "title": "example",
  "type": "example",
  "status": 1,
  "detail": "example"
}

404

指定したデータが存在しない場合

application/json

object

title

required

string

type

required

string

status

integer

detail

string

Example^generated

{
  "title": "example",
  "type": "example",
  "status": 1,
  "detail": "example"
}

キャンセル

Authorizations

Parameters

Path Parameters

Request Body

Examplegenerated

Responses

200

Examples

204

400

Examplegenerated

404

Examplegenerated

Example^generated

Example^generated

Example^generated