create_reservation
エキテンのネット予約を登録する。事前に get_availability(予約在庫状況取得ツール)で店舗の予約可能な空き枠(reservationType・空席スロット・メニュー・スタッフ・クーポン・人数設定等)を取得してから使用すること。tableUnit(グルメ向け)かつ headcountBreakdownEnabled: true(内訳あり)の場合、headcountBreakdown の合計人数は get_availability の該当 slots[].headcountBreakdownMax を上限とする。予約方法は2通り。(1)ログインして予約する場合: email を付けずに呼び出す。未ログインなら 401 認証要求が返るので start_login を呼び、返されたloginUrlをユーザーに提示してログインを完了してもらい、完了後に再実行する(ログインすると会員情報が反映され、予約後のキャンセルも可能)。(2)ログインせず予約する場合: email(メールアドレス)を指定する。予約後に認証メールが送信される(キャンセル不可)。ユーザーにどちらで進めるか確認し、実行前に予約内容の最終確認を求めること。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | お店へのご要望。省略可(上限2000文字) | |
| No | メールアドレス。未ログイン時は必須。ログイン済みの場合は省略可(会員登録済みアドレスを使用) | ||
| phone | Yes | 電話番号。必須。ハイフンなし。携帯・IP電話(070/080/090/050等)は11桁、固定電話(03/06等)は10桁。形式: ^(0[5-9]0[0-9]{8}|0[1-9][1-9][0-9]{7})$ | |
| menuId | No | メニューID。予約在庫状況取得ツール(get_availability)で取得した menus[] から選択したメニューの menuId を指定する。同ツールの menuSelectionRequired が true の場合は必須(false の場合は省略可) | |
| shopId | Yes | エキテン店舗ID。必須。 | |
| staffId | No | スタッフID。reservationType が timeUnit(全ジャンル向け)のみ有効。省略可(指名なし)。tableUnit(グルメ向け)の場合はトルツメ | |
| couponId | No | クーポンID。省略可 | |
| lastName | Yes | 予約者の姓。必須。 | |
| firstName | Yes | 予約者の名。必須。 | |
| headcount | No | 予約人数。tableUnit(グルメ向け)かつ headcountBreakdownEnabled: false(内訳なし)の場合のみ必須。それ以外(timeUnit、または内訳ありの場合)はトルツメ | |
| lastNameKana | Yes | 予約者の姓(ふりがな)。必須。 | |
| firstNameKana | Yes | 予約者の名(ふりがな)。必須。 | |
| reservationDate | Yes | 予約日。必須。YYYY-MM-DD 形式。 | |
| reservationTime | Yes | 予約時間。必須。HH:MM 形式。 | |
| smokingPreference | No | 禁煙/喫煙希望。reservationType が tableUnit(グルメ向け)かつ smokingSetting が separate(分煙)の場合のみ有効・必須。それ以外の場合はトルツメ | |
| headcountBreakdown | No | 来店人数の内訳。tableUnit かつ headcountBreakdownEnabled: true(内訳あり)の場合のみ必須。キーは headcountBreakdownItems[].itemKey、値は各内訳の人数(integer)。合計人数は get_availability の headcountBreakdownMax が上限。それ以外はトルツメ。例:{"adult": 2, "child": 1} |