# 予約作成・編集 ヘルプ ## 概要 予約作成・編集フォームは、ゲストの直接予約を管理者が手動で作成または編集するための画面です。カレンダーの空きセルをクリックすると右側にドロワー（スライドインパネル）として表示されます。予約一覧の予約カードをクリックした場合は詳細・編集モードで表示されます。 このフォームでできること： - カレンダーから日付・部屋・時刻を自動入力して予約を作成 - 宿泊または時間貸しの予約タイプを選択 - 部屋タイプとプランを選択 - ゲスト情報の入力 - 作成後に決済リンク・鍵リンクを送付 --- ## アクセス方法 予約管理ダッシュボード → **カレンダー** タブ → 空きセル（または[+]ボタン）をクリック または 予約管理ダッシュボード → **予約一覧** タブ → 予約カードをクリック → **編集** ボタン --- ## 詳細機能 ## 機能1: カレンダーからの予約作成（作成モード） カレンダーの表示モードに応じて、クリックした場所から日付・部屋・時刻が自動入力されます。 ### 表示モードごとの自動入力 | 表示モード | 操作 | 自動入力される情報 | |-----------|------|-----------------| | 月表示 | 日付セルの **[+]** ボタンをクリック | チェックイン日 | | 週表示 | 空きセルをクリック | チェックイン日 + 部屋 | | タイムライン表示 | 空きエリアをクリック | チェックイン日 + 部屋 + 時刻 | ### 入力項目 | 項目 | 説明 | 必須 | |------|------|------| | チェックイン日時 | 宿泊の開始日時 | はい | | チェックアウト日時 | 宿泊の終了日時 | はい | | 滞在タイプ | **宿泊**（泊単位）または **時間貸し**（時間単位）を切り替え | はい | | 部屋タイプ | 予約する部屋タイプを選択 | はい | | プラン | 選択した部屋タイプに対応するプランを選択 | はい | | ゲスト名 | 予約者の氏名 | いいえ | | ゲストメール | 予約者のメールアドレス（決済リンク・鍵リンク送付に使用） | いいえ | | メモ | 管理者向けの備考（ゲストには表示されない） | いいえ | --- ## 機能2: 予約作成後のアクション 予約を作成すると、続けてゲスト用のリンクカードが1枚表示されます。 カードには「リンクをコピー」ボタンと「メールで送る」ボタン（ゲストメールを入力した場合のみ）が表示されます。 **リンクの行き先は施設の設定によって変わります。** | 施設の状態 | リンク | ゲストの操作 | |---|---|---| | チェックイン設定がある | チェックイン用リンク | チェックイン（必要に応じてお支払い） | | チェックイン設定がない | 予約確認用リンク | 予約の確認（未払いの場合はお支払い） | 生成されるURLの形式（施設スラッグが設定済みの場合）： ``` # チェックイン設定がある施設 https://checkin.unlockos.io/{スラッグ}?reservationId=...&reservationType=... # チェックイン設定がない施設（予約アプリ側で完結） https://booking.unlockos.io/{スラッグ}?reservationId=... ``` スラッグが未設定の場合は旧来の `?facilityId=...` 形式が使用されます。 --- ## 機能3: 予約詳細モード 予約一覧または予約カレンダーで既存の予約をクリックすると、詳細モードでドロワーが開きます。 | 表示項目 | 説明 | |---------|------| | ゲスト情報 | 氏名・メールアドレス | | 日程 | チェックイン〜チェックアウト日時 | | 金額・支払い状況 | 合計金額と未払い / 支払い済みの状態 | | アクセスコード | ゲスト向けの鍵コード（発行済みの場合） | | ソースバッジ | 予約の流入元（直接 / iCal / OTA） | | ゲスト用リンク | ゲストに渡すリンク（コピー / メール送信）。行き先は施設の設定で変わります | | 編集ボタン | 編集モードに切り替え | | 解錠アクティビティ | 予約コードの下に表示される、実際の解錠/施錠履歴（下記参照） | ### 現地払いの受領を記録する（現地で受け取った） 支払い方法が **現地払い（オンライン決済なし）** かつ **未払い** の予約では、金額・支払い状況の表示欄の下に **「現地で受け取った」** ボタンが表示されます。 | 条件 | 挙動 | |---|---| | 現地払い ＋ 未払い ＋ 金額が0円より大きい ＋ キャンセルされていない | ボタンが表示される | | オンライン決済（クレジットカード決済）の予約 | ボタンは表示されません。オンライン予約はStripe側で自動的に精算されるため、ここで現金として記録すると二重計上になります | | 支払い済み・キャンセル済みの予約 | ボタンは表示されません | 1. ボタンをクリックすると受領モーダルが開きます 2. 受領額（既定は請求額そのまま）・受領手段（現金／銀行振込／その他）・受領日時・メモ（任意）を入力します 3. **「受領を記録する」** をクリックすると受領が記録され、**その場で鍵が発行されます**（確定メールでゲストにも届きます） > **受領を記録するまで鍵は発行されません。** 現地払いの予約は、この操作が唯一の精算手段です。予約詳細の支払い状況ドロップダウンで「支払済」に直接変更しても、金額・手段・受領者が記録に残らないため、このボタンからの記録が正しい手順です（ドロップダウンは修正用に残していますが、通常はこのボタンを使ってください）。 > **予約は全額一致でしか記録できません。** 請求額と異なる金額を入力すると「受領額がご請求額と一致しません」というエラーになります。値引きが必要な場合は、先に予約の金額を編集してから記録してください（後払いの滞在残高を部分的に消し込みたい場合は、予約ではなく[チェックイン履歴](checkin-history.md)側の受領を使ってください）。 > **「受領は記録したが鍵が発行されなかった」と表示された場合。** 受領そのものは記録済みなので、二重に受け取る必要はありません。もう一度同じボタンを押すと、同じ受領を重複させずに鍵の発行だけを再試行します。 > **キャンセル済みの予約にはボタンが出ません。** 一度キャンセルされた現地払い・未払いの予約は、鍵を発行できないため受領を記録できません。 ### 解錠アクティビティ 予約詳細モードの予約コード欄の下に、KEYVOX の解錠/施錠イベントを時系列で表示する「解錠アクティビティ」欄があります。予約の**意図**（誰がいつ利用する予定か）だけでなく、**実際に何が起きたか**を確認できます。 | 表示項目 | 内容 | |---------|------| | サマリ（解錠回数・初回解錠・最終解錠） | 解錠が1件以上ある場合のみ表示されます | | チェックアウト予定時刻より後の解錠の警告 | 予定チェックアウト時刻を過ぎてから解錠があった場合、黄色の注意バーが表示されます（オーバーステイの可能性） | | タイムライン | 時刻（日本時間）・種別（解錠🔓 / 施錠🔒 / 解錠失敗⚠️ / 同期🔄）・入室/退出・手段（PIN・QR・カード・リモート・手動・オートロック）・ロック名 | | 「推定」バッジ | 予約コードから確実に紐付けられた解錠（バッジ無し）ではなく、鍵と時間帯から推定して紐付けた解錠に付きます | > **解錠失敗は見逃せない兆候として強調表示されます。** アイコンだけでなく「解錠失敗」というラベルが常時表示され、赤系の背景色が付きます。 > **0件のときの表示に注意してください。** 「解錠記録はありません」と表示されますが、これは「使われていない」ことの確定的な証拠ではありません。記録開始前の予約や、ロック連携が未設定の場合も同じく0件になります。 > **共用ロックを使う施設では、一部の解錠が表示されないことがあります。** 複数の予約・複数の施設で同じ入口ロックを共有している場合、その解錠を特定の予約に安全に紐付けられないため、誤った予約に表示するよりも**あえて表示しません**（未帰属より誤帰属を避ける設計）。 このセクションは予約詳細モードのみに表示され、作成・編集モードでは表示されません。ゲスト向け画面にも表示されません（施設スタッフ・オーナー向けの内部情報です）。 --- ### 承認待ちの予約を承認・却下する プランで[予約の承認](plan-form.md)をオンにしている場合、そのプランの予約は「承認待ち」で入ります。承認待ちの予約を開くと、詳細パネルに承認プロンプトが表示されます。 | 操作 | 挙動 | |---|---| | 承認する | その場で予約が確定します | | 却下する | **却下理由の入力が必須**です。理由を入れるまで却下ボタンは押せません | 却下理由はゲストへの通知に使われます。 > **フォーム回答タブとの違い**: 同じ承認・却下は[フォーム画面の回答タブ](reservation-approvals.md)からもできますが、そちらは**申込フォームの回答がある予約しか一覧に出ません**。フォームを設定していないプランの承認待ち予約は、この予約詳細パネルからのみ処理できます。 --- ## 機能4: 予約編集モード 詳細モードの **編集** ボタンをクリックすると編集モードに切り替わります。既存の予約情報が入力済みのフォームが表示され、変更して保存できます。 ### 編集可能な項目 | 項目 | 説明 | |------|------| | チェックイン日時 | 滞在開始日時 | | チェックアウト日時 | 滞在終了日時 | | 滞在タイプ | 宿泊 / 時間貸し | | 部屋タイプ | 予約対象の部屋タイプ | | プラン | 適用するプラン | | ゲスト名 | 予約者の氏名 | | ゲストメール | 予約者のメールアドレス | | メモ | 管理者向けの備考 | ### 日時変更と鍵の有効期限 **部屋を変更せずに** チェックイン日時・チェックアウト日時だけを変更した場合、発行済みのゲスト鍵（PIN・QR）は再発行されません。**同じ鍵の有効期限だけ**が新しい時刻に合わせて更新されます。延長・短縮のどちらの方向に時間を動かした場合も対象です。部屋も同時に変更した場合はこの限りではなく、従来通り鍵が再発行されます。 チェックイン・チェックアウト時刻を変更すると、カレンダーの下に次の注記が表示されます。 > 利用時間を変更すると鍵の有効期限も新しい時間に合わせて更新されます。料金が変わる場合、差額は自動では決済されません。 **料金の差額は自動で決済されません。** 変更後の合計金額は再計算されて画面に表示されますが、Stripe への追加請求は行われないため、差額の請求が必要な場合は施設側で別途対応してください。 保存すると、鍵の有効期限が実際に更新されたことを確認したうえで完了として扱われます。更新を確認できなかった場合は、保存後に次の警告が表示されます。 > 利用時間を変更しましたが、鍵の有効期限を更新できませんでした。ゲストの鍵は元の終了時刻で失効します。鍵の状態を確認してください。 この警告が出た場合、鍵は元の時刻のまま失効します。次回この予約を保存すると自動的に再試行されるため、多くの場合は改めて保存するだけで解消します。解消しない場合は鍵の状態を確認してください。 ### キャンセル済み・完了済みの予約は対象外 予約のステータスが「確定済み」以外（キャンセル済み・完了済みなど）の場合、時間を変更して保存しても鍵の有効期限は更新されません（上記と同じ警告が表示されます）。これは、過去に発行された鍵情報が残っている予約に対して、誤って新しい有効期限を与えてしまわないための保護です。この予約の鍵は失効済みとして扱い、時間変更で有効化しようとしないでください。 --- ## 機能5: 電話番号のSMS確認状況 施設で電話番号のSMS確認を利用している場合、予約詳細ドロワーの電話番号欄には確認状況が表示されます。 | 表示 | 意味 | |------|------| | ✓ SMS確認済み（緑色のバッジ） | この番号はSMSのワンタイムコードで確認済みです。バッジにカーソルを合わせると確認日時が表示されます | | 何も表示なし | 未確認です | ### フロントで確認済みにする（SMSが届かないゲストへの対応） 未確認の番号が入力されている予約（新規作成中を除く）では、電話番号欄の下に **「フロントで確認済みにする」** というリンクが表示されます。電波の届かない場所にいる、番号を変更した、海外SIMを使っているなど、SMSが届かないゲストに対面で本人確認できた場合に、SMSを送らずに確認済みの状態にする操作です。 1. リンクをクリックすると確認メッセージが展開されます 2. 注意文を確認したうえで「確認済みにする」をクリックします 3. 実行するとその場でバッジが「✓ SMS確認済み」に切り替わります > **この操作はSMSを経由せずに確認済みの属性を作成します。** 誰が実行したかは記録されるため、対面で本人確認（身分証の提示など）を行った場合にのみ使用してください。 設定方法や確認の仕組み全体は[SMS電話番号確認のヘルプ](sms-verification.md)を参照してください。 --- ## ソースカラーコーディング 予約の流入元はカラーバッジで識別されます： | 色 | ソース | 説明 | |----|--------|------| | 青 | 直接予約 | ダッシュボードから手動作成、または直接予約URLからの予約 | | スカイブルー | iCal / Airbnb | iCalフィードからインポートされた予約（Airbnb等） | | コーラル | OTA | その他のOTA（旅行代理店）からの予約 | --- ## よくある質問 ### Q: カレンダーから予約を作成するとき、部屋タイプとプランはどう決まりますか？ カレンダーから開いた場合、クリックした位置の部屋に基づいて部屋タイプが自動選択されます。プランは選択した部屋タイプに紐付くプランの中から選択してください。 ### Q: 宿泊と時間貸しの違いは何ですか？ 宿泊は泊単位（1泊〜複数泊）の予約です。時間貸しは時間単位の予約で、コワーキングスペースや時間貸しの設備に適しています。 ### Q: ゲストメールを入力しなかった場合、あとから決済リンクを送れますか？ はい。予約作成後に予約詳細モードを開き、メールを追加してから「ゲスト用リンク」の「メールで送る」ボタンをクリックしてください。 ### Q: iCalからインポートされた予約を編集できますか？ iCal（Airbnb等）からインポートされた予約は読み取り専用です。日程の変更はもとの予約プラットフォーム側で行ってください。変更はiCal同期によって自動的に反映されます。 ### Q: ゲストフォームに氏名や住所などの詳細情報を収集したい場合はどうすればいいですか？ ゲストが自分でチェックインする場合は、ゲストフォーム設定でフォームフィールドを追加できます。管理者が手動作成する場合は、予約に対してゲスト情報を直接入力してください。 ### Q: 予約の時間を変更しても鍵の有効期限が更新されないことがあります。なぜですか？ その予約のステータスが「確定済み」以外（キャンセル済み・完了済みなど）になっている可能性があります。そのステータスの予約は、時間を変更しても鍵に新しい有効期限を設定できない仕様です。この鍵は失効済みとして扱ってください。 ### Q: 現地払いの予約で「現地で受け取った」ボタンが表示されません 支払い方法が「現地払い」に設定されているか、支払い状況が「未払い」になっているかを確認してください。オンライン決済（クレジットカード）の予約や、既に支払い済み・キャンセル済みの予約にはボタンが表示されません。金額が0円のプランも対象外です。 ### Q: 現地払いの受領額を値引きして記録できますか？ いいえ。予約の受領は請求額と完全に一致する金額でしか記録できません。値引きたい場合は、先に予約を編集して合計金額そのものを変更してから受領を記録してください。 --- ## 関連ページ - [予約管理ダッシュボード](booking.md) - [フォーム管理](forms.md) - [プラン一覧](plan-list.md) - [チェックイン設定](checkin-config-form.md) - [SMS電話番号確認](sms-verification.md) - [チェックイン履歴](checkin-history.md)