<!-- https://unlockos.io/ja/manual/reservation -->

# 予約作成・編集 ヘルプ

## 概要

予約作成・編集フォームは、ゲストの直接予約を管理者が手動で作成または編集するための画面です。カレンダーの空きセルをクリックすると右側にドロワー（スライドインパネル）として表示されます。予約一覧の予約カードをクリックした場合は詳細・編集モードで表示されます。

このフォームでできること：

- カレンダーから日付・部屋・時刻を自動入力して予約を作成
- 宿泊または時間貸しの予約タイプを選択
- 部屋タイプとプランを選択
- ゲスト情報の入力
- 作成後に決済リンク・鍵リンクを送付

---

## アクセス方法

予約管理ダッシュボード → **カレンダー** タブ → 空きセル（または[+]ボタン）をクリック

または

予約管理ダッシュボード → **予約一覧** タブ → 予約カードをクリック → **編集** ボタン

---

## 詳細機能

## 機能1: カレンダーからの予約作成（作成モード）

カレンダーの表示モードに応じて、クリックした場所から日付・部屋・時刻が自動入力されます。

### 表示モードごとの自動入力

| 表示モード | 操作 | 自動入力される情報 |
|-----------|------|-----------------|
| 月表示 | 日付セルの **[+]** ボタンをクリック | チェックイン日 |
| 週表示 | 空きセルをクリック | チェックイン日 + 部屋 |
| タイムライン表示 | 空きエリアをクリック | チェックイン日 + 部屋 + 時刻 |

### 入力項目

| 項目 | 説明 | 必須 |
|------|------|------|
| チェックイン日時 | 宿泊の開始日時 | はい |
| チェックアウト日時 | 宿泊の終了日時 | はい |
| 滞在タイプ | **宿泊**（泊単位）または **時間貸し**（時間単位）を切り替え | はい |
| 部屋タイプ | 予約する部屋タイプを選択 | はい |
| プラン | 選択した部屋タイプに対応するプランを選択 | はい |
| ゲスト名 | 予約者の氏名 | いいえ |
| ゲストメール | 予約者のメールアドレス（決済リンク・鍵リンク送付に使用） | いいえ |
| メモ | 管理者向けの備考（ゲストには表示されない） | いいえ |

---

## 機能2: 予約作成後のアクション

予約を作成すると、続けて2種類のリンクカードが表示されます。

| リンク | 説明 |
|--------|------|
| 未決済の予約リンク | ゲストが決済とチェックインを行うためのリンク |
| 支払い済みの予約リンク | すでに決済済みのゲスト向けに鍵の受け渡しのみを行うリンク |

各カードには「リンクをコピー」ボタンと「メールで送る」ボタン（ゲストメールを入力した場合のみ）が表示されます。

生成されるURLの形式（施設スラッグが設定済みの場合）：

```
https://checkin.unlockos.io/{スラッグ}?reservationId=...&reservationType=...
```

スラッグが未設定の場合は旧来の `?facilityId=...` 形式が使用されます。

---

## 機能3: 予約詳細モード

予約一覧または予約カレンダーで既存の予約をクリックすると、詳細モードでドロワーが開きます。

| 表示項目 | 説明 |
|---------|------|
| ゲスト情報 | 氏名・メールアドレス |
| 日程 | チェックイン〜チェックアウト日時 |
| 金額・支払い状況 | 合計金額と未払い / 支払い済みの状態 |
| アクセスコード | ゲスト向けの鍵コード（発行済みの場合） |
| ソースバッジ | 予約の流入元（直接 / iCal / OTA） |
| 決済リンクを送る | ゲストに支払いリンクをメール送信 |
| 鍵リンクを送る | ゲストにアクセスコードリンクをメール送信 |
| 編集ボタン | 編集モードに切り替え |
| 解錠アクティビティ | 予約コードの下に表示される、実際の解錠/施錠履歴（下記参照） |

### 解錠アクティビティ

予約詳細モードの予約コード欄の下に、KEYVOX の解錠/施錠イベントを時系列で表示する「解錠アクティビティ」欄があります。予約の**意図**（誰がいつ利用する予定か）だけでなく、**実際に何が起きたか**を確認できます。

| 表示項目 | 内容 |
|---------|------|
| サマリ（解錠回数・初回解錠・最終解錠） | 解錠が1件以上ある場合のみ表示されます |
| チェックアウト予定時刻より後の解錠の警告 | 予定チェックアウト時刻を過ぎてから解錠があった場合、黄色の注意バーが表示されます（オーバーステイの可能性） |
| タイムライン | 時刻（日本時間）・種別（解錠🔓 / 施錠🔒 / 解錠失敗⚠️ / 同期🔄）・入室/退出・手段（PIN・QR・カード・リモート・手動・オートロック）・ロック名 |
| 「推定」バッジ | 予約コードから確実に紐付けられた解錠（バッジ無し）ではなく、鍵と時間帯から推定して紐付けた解錠に付きます |

> **解錠失敗は見逃せない兆候として強調表示されます。** アイコンだけでなく「解錠失敗」というラベルが常時表示され、赤系の背景色が付きます。

> **0件のときの表示に注意してください。** 「解錠記録はありません」と表示されますが、これは「使われていない」ことの確定的な証拠ではありません。記録開始前の予約や、ロック連携が未設定の場合も同じく0件になります。

> **共用ロックを使う施設では、一部の解錠が表示されないことがあります。** 複数の予約・複数の施設で同じ入口ロックを共有している場合、その解錠を特定の予約に安全に紐付けられないため、誤った予約に表示するよりも**あえて表示しません**（未帰属より誤帰属を避ける設計）。

このセクションは予約詳細モードのみに表示され、作成・編集モードでは表示されません。ゲスト向け画面にも表示されません（施設スタッフ・オーナー向けの内部情報です）。

---

### 承認待ちの予約を承認・却下する

プランで[予約の承認](plan-form.md)をオンにしている場合、そのプランの予約は「承認待ち」で入ります。承認待ちの予約を開くと、詳細パネルに承認プロンプトが表示されます。

| 操作 | 挙動 |
|---|---|
| 承認する | その場で予約が確定します |
| 却下する | **却下理由の入力が必須**です。理由を入れるまで却下ボタンは押せません |

却下理由はゲストへの通知に使われます。

> **フォーム回答タブとの違い**: 同じ承認・却下は[フォーム画面の回答タブ](reservation-approvals.md)からもできますが、そちらは**申込フォームの回答がある予約しか一覧に出ません**。フォームを設定していないプランの承認待ち予約は、この予約詳細パネルからのみ処理できます。

---

## 機能4: 予約編集モード

詳細モードの **編集** ボタンをクリックすると編集モードに切り替わります。既存の予約情報が入力済みのフォームが表示され、変更して保存できます。

### 編集可能な項目

| 項目 | 説明 |
|------|------|
| チェックイン日時 | 滞在開始日時 |
| チェックアウト日時 | 滞在終了日時 |
| 滞在タイプ | 宿泊 / 時間貸し |
| 部屋タイプ | 予約対象の部屋タイプ |
| プラン | 適用するプラン |
| ゲスト名 | 予約者の氏名 |
| ゲストメール | 予約者のメールアドレス |
| メモ | 管理者向けの備考 |

---

## 機能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: ゲストフォームに氏名や住所などの詳細情報を収集したい場合はどうすればいいですか？

ゲストが自分でチェックインする場合は、ゲストフォーム設定でフォームフィールドを追加できます。管理者が手動作成する場合は、予約に対してゲスト情報を直接入力してください。

---

## 関連ページ

- [予約管理ダッシュボード](booking.md)
- [フォーム管理](forms.md)
- [プラン一覧](plan-list.md)
- [チェックイン設定](checkin-config-form.md)
- [SMS電話番号確認](sms-verification.md)
