<!-- https://unlockos.io/ja/manual/okihai-locker-settings -->

# ロッカー設定 ヘルプ（管理者向け）

## 概要

ロッカー設定は、物件の居住者向けロッカーレンタルサービスを設定・管理するための管理画面です。ロッカータイプ、料金プラン、KEYVOX スマートロック連携を定義して、柔軟な保管オプションを居住者に提供します。

メインナビゲーションから **ロッカー設定** を選択すると、設定パネルにアクセスできます。

---

## 主な概念

### 3つの支払いプランタイプ

ロッカーサービスは3つの課金モデルをサポート：

| プランタイプ | 仕組み | 最適な用途 |
|-----------|--------|---------|
| **保管日数課金** | 居住者は保管日数に応じて1日単位で支払う（最低利用期間なし） | 短期・柔軟な保管 |
| **月額制** | 居住者は月額固定料金を支払い、その月は無制限にアクセス可 | 長期・予測可能な費用 |
| **ハイブリッド制** | 月額 + 契約期間を超える日数の追加日額 | 長期利用 + 時々の超過 |

### ロッカーサイズ

ロッカーを物理的サイズで整理して、異なる保管ニーズに対応：

| サイズ | 典型的な用途 | 容量 |
|--------|------------|------|
| **小（S）** | 書類、小荷物、小物 | 0.5～2立方フィート |
| **中（M）** | スーツケース、スポーツ用品、季節用衣類 | 2～8立方フィート |
| **大（L）** | 複数スーツケース、大型家具、長期保管 | 8立方フィート以上 |

建物の実際の寸法と在庫により、提供するサイズが決まります。

---

## 詳細機能

## 機能1: ロッカー設定ダッシュボード

ロッカー設定メインページから、すべてのロッカー設定を表示・管理できます。

### 表示情報

設定一覧に表示される項目：

| カラム | 説明 |
|--------|------|
| 設定名 | ロッカーセットの内部識別子 |
| プランタイプ | 保管日数課金 / 月額制 / ハイブリッド |
| ステータス | 有効 / 無効 |
| ロッカー数 | この設定内のロッカー台数 |
| 提供サイズ | 利用可能なサイズ（小、中、大） |
| 最終更新 | 設定が最後に変更された日付 |

### アクションボタン

| ボタン | 説明 |
|--------|------|
| 編集（ペンシル） | 設定を修正するためのフォームを開く |
| 有効化/無効化 | 居住者がこの設定にアクセスできるかを切り替え |
| 削除 | 設定を削除（アクティブなレンタルがない場合のみ） |

---

## 機能2: ロッカー設定の作成と編集

### ステップ1: 基本設定

| フィールド | 説明 | 必須 |
|-----------|------|------|
| 設定名 | 内部識別名（例：「タワーAロッカー」「季節保管2026」） | ○ |
| 説明 | この設定に関するメモ（管理者用） | × |
| 有効ステータス | 新規居住者予約を有効にするかどうか | — |
| 通貨 | JPY、USD、EURなど | ○ |
| タイムゾーン | 日時計算に使用（デフォルト：Asia/Tokyo） | ○ |

### ステップ2: プランタイプ選択

この設定に対して **1つのプランタイプのみ** を選択してください。後から変更することはできません。

#### オプションA: 保管日数課金

居住者は **日額 × 保管日数** で支払い。

| フィールド | 説明 | 必須 |
|-----------|------|------|
| 基本日額 | すべてのサイズのデフォルト1日あたり料金 | ○ |
| 曜日別料金 | 平日と週末・祝日で異なる料金 | × |

**セットアップ例：**
- 平日：300円/日
- 週末：500円/日
- 月～金に予約すれば300円/日、週末予約は500円/日

#### オプションB: 月額制

居住者は **月額固定料金** を支払い、その月は無制限にアクセス可。

| フィールド | 説明 | 必須 |
|-----------|------|------|
| 月額料金 | 1ヶ月あたりの固定費用 | ○ |
| 請求開始日 | 月次サイクルをリセットする日（デフォルト：1日） | × |

**セットアップ例：**
- 月額：3,000円
- 居住者は月3,000円を支払い、その月は何度アクセスしても同じ料金

#### オプションC: ハイブリッド制

居住者は **月額 + 超過日額** を支払い。

| フィールド | 説明 | 必須 |
|-----------|------|------|
| 月額料金 | 1ヶ月あたりの固定費用 | ○ |
| 超過日額 | 月額契約を超える日数の1日あたり料金 | ○ |
| 請求開始日 | 月次サイクルをリセットする日（デフォルト：1日） | × |

**セットアップ例：**
- 月額：4,000円
- 超過日額：200円/日
- 45日間のレンタル（1ヶ月 + 15日）= 4,000円 + 200円 × 15 = 7,000円

### ステップ3: ロッカーサイズの定義

各設定には最低1つのロッカーサイズが必要。複数追加して、居住者に選択肢を提供できます。

| フィールド | 説明 | 必須 |
|-----------|------|------|
| サイズ | プリセット（小 / 中 / 大）またはカスタム名 | ○ |
| 表示名 | 居住者に表示されるラベル（例：「小 – 書類用」） | ○ |
| 料金（プランタイプによる） | 日額、月額、または両方 | ○ |
| ロッカー台数 | このサイズのロッカー数 | ○ |
| 物理的な場所 | 建物エリアまたはフロア（例：「1Fエントランス」） | × |
| メモ | 内部向けメモ（容量、寸法、機能） | × |

**ボタン：**
- **サイズを追加** — 新しいサイズ行を作成
- **削除**（×ボタン） — サイズ行を削除（最低1つのサイズは必須）

### ステップ4: KEYVOX連携（オプション）

建物がKEYVOXスマートロックを使用している場合、デバイス接続を設定します。

| フィールド | 説明 | 必須 |
|-----------|------|------|
| KEYVOX APIキー | KEYVOXダッシュボードから取得した認証トークン | ○（連携する場合） |
| デバイス選択 | 登録されたKEYVOXデバイスのドロップダウンリスト | ○（連携する場合） |
| 空室情報の同期 | KEYVOXからボックス在庫をリアルタイム取得 | — |

**セットアップ手順：**
1. KEYVOXダッシュボードからAPIキーを取得（詳細は[ロック接続](lock-connection.md)を参照）
2. APIキーをフィールドに入力
3. **デバイス同期** をクリックしてすべてのロッカーを取得
4. ドロップダウンから建物に対応するデバイスを選択
5. ロッカー在庫（サイズ・台数）が自動入力されます

**注：** KEYVOXを連携しない場合、または在庫を手動管理する場合は、手動入力モードが利用可能です。

### ステップ5: 確認して保存

1. すべての設定を確認：
   - プランタイプと料金
   - ロッカーサイズと台数
   - KEYVOX連携（設定する場合）
2. **設定を保存** をクリック
3. **キャンセル** をクリックして変更を破棄

---

## 機能3: 監視と分析

### ロッカー利用状況ダッシュボード

設定を作成後、**利用分析** タブにアクセスして活動を監視します。

| メトリクス | 説明 |
|-----------|------|
| 合計ロッカーレンタル数 | アクティブおよび完了したレンタルの累積数 |
| アクティブレンタル | 現在使用中のロッカー数 |
| 収益（今月） | 当月の支払い済みレンタルからの収入 |
| 収益（累計） | 設定作成以来の総収入 |
| 占有率 | 現在レンタル中のロッカー占有率（%） |

### レポート

**日付範囲フィルター：**
- カスタム日付範囲でデータを表示（例：「過去30日」「会計年度」）
- 季節的な需要追跡に有用

**エクスポートオプション：**
- 居住者予約データ（名前、メール、ロッカーサイズ、日程、支払い額）をCSVでエクスポート（会計・レポート用）

---

## 機能4: 居住者アクセスと権限

### ロッカーを見・借りられるのは誰？

ロッカーは以下の者が利用可能：
- **すべての登録居住者** — 施設内
- **ゲスト** — 施設でゲスト向け居住者アプリにログイン可能な場合

居住者は居住者アプリの **ロッカー** タブからロッカーサービスにアクセスします。

### PINコードの発行

居住者が予約と支払いを完了後：
1. PINコードが自動生成される
2. コードは確認画面に表示される
3. コードはメールでも居住者に送付される

---

## セットアップガイド（ステップバイステップ）

### シナリオ: 日額制ロッカーサービスのセットアップ

**目標：** 短期保管用に小型10台、中型8台のロッカーを提供。

**ステップ1:** 設定を作成
- 名前：「短期保管サービス」
- プランタイプ：**保管日数課金**
- 基本日額：500円

**ステップ2:** サイズを定義
- **サイズ1:** 小型ロッカー
  - 表示名：「小」
  - 料金：300円/日
  - 台数：10
  - 場所：「1Fエントランス」
  
- **サイズ2:** 中型ロッカー
  - 表示名：「中」
  - 料金：500円/日
  - 台数：8
  - 場所：「1Fエントランス」

**ステップ3:** KEYVOX連携（オプション）
- 使用する場合：建物デバイスを選択
- 手動の場合：追加セットアップ不要

**ステップ4:** 保存して有効化
- **設定を保存** をクリック
- **有効** トグルをオンにして居住者予約を有効化

**ステップ5:** 居住者に告知
- すべての居住者にロッカーサービスの開始を通知
- 居住者アプリのロッカータブで予約するよう指示

---

## APIインテグレーション理解

### 居住者が支払いを行う方法

1. 居住者がロッカーの **予約** をクリック
2. 日程とプランを選択
3. **Stripe** で支払い完了
4. UnlockOSがロッカーデータベースを更新

### PINコードが生成される仕組み

PINコードは以下から導出：
- ロッカーID
- 居住者情報
- レンタル開始日/終了日

PINコードは一意であり、レンタル期間終了時に自動的に無効になります。

### KEYVOX同期の動き

KEYVOX連携が有効な場合：
- **ボックス空室状態：** リアルタイムで KEYVOX から取得。居住者は利用可能なボックスのみ表示
- **アクセスログ：** 居住者がロッカーを開くと、KEYVOX がアクセスイベント（タイムスタンプ、ボックス番号、利用時間）を記録
- **管理者レポート：** KEYVOX ダッシュボードでアクセスログを確認し、ロッカー利用を検証可能

---

## よくある質問

### Q: プランタイプの違いは？

A: **保管日数課金** は利用日数に応じて課金 — 変動期間のレンタルに最適。**月額制** は月額固定で無制限アクセス — 頻繁なアクセスが必要な長期利用向け。**ハイブリッド** は両者を組み合わせて柔軟性を提供。

### Q: 後でプランタイプを変更できますか？

A: いいえ。新しいプランタイプで新しい設定を作成してください。古い設定の既存居住者は影響を受けません。

### Q: ハイブリッド課金では居住者にどう課金しますか？

A: 月額料金を先に請求。契約月を超える場合、追加日数に超過日額を課金。

例：
- 月額：4,000円
- 超過日額：200円/日
- 45日間レンタル（1ヶ月 + 15日）
- 請求：4,000円 + （200円 × 15日）= 7,000円

### Q: ロッカーサイズを居住者はどうやって知る？

A: 設定した表示名（例：「小 – 書類用」「中 – スーツケース用」）が予約時に表示されます。容量情報を表示名に含めると有用です。

### Q: 居住者が支払わない場合は？

A: 予約は **未支払い** としてマーク。PINコードは発行されません。以下の対応が可能：
1. 支払い後、手動でPINコードを発行
2. 予約をキャンセルしてロッカーを解放

### Q: Stripe以外の決済サービスに対応していますか？

A: 現在、Stripeのみサポート。別の決済方法が必要な場合は、UnlockOSサポートに連絡してください。

### Q: PINコード紛失やアクセスロック時の対応？

A: 居住者は居住者アプリで **PINをリセット** をタップするとメールで新しいコードを受け取ります。別途、管理ダッシュボードから一時的にPINを発行することも可能（バージョンによる）。

### Q: 居住者がレンタル期間を延長したら？

A: 居住者アプリで **期間を延長** をタップして新しい終了日を選択。システムが追加費用を計算して新規支払いを処理。既存PINは有効なまま；新しいPINの発行は不要。

### Q: KEYVOX が接続されていない場合は？

A: **手動モード** でロッカーサービスを運営可能：
1. 設定時に **手動入力に切り替え** をクリック
2. ロッカー在庫（サイズ、台数、ボックスID）を手動入力
3. 居住者は通常通り予約；PINコードは自動発行

### Q: 複数のロッカー設定を持つことはできますか？

A: はい。異なる建物、フロア、または料金階層ごとに別々の設定を作成。各設定は独立（居住者、料金、在庫が独立）。

### Q: どのロッカーが使用中かをモニタリング？

A: **利用分析** ダッシュボードを使用：
- アクティブレンタル数
- 占有率（%）
- 収益追跡
- 居住者予約履歴（CSVでエクスポート可）

### Q: ロッカーが満杯（全サイズ予約済）の場合は？

A: 居住者に「空室がありません」と表示。ロッカーが利用可能になるまで（レンタル期間終了）予約不可。

### Q: 居住者は複数のロッカーを予約できますか？

A: はい。各ロッカーは別の予約。居住者は複数のアクティブな予約を同時に持つ可能。

### Q: キャンセルと返金はどう処理？

A: キャンセルポリシー（例：開始48時間以上前のキャンセルは全額返金）を設定可能。居住者は居住者アプリでキャンセル；返金は Stripe ダッシュボードで手動処理。

### Q: PINコードはいつまで有効？

A: 予約の開始日から終了日の23:59:59まで有効。その後自動的に無効になります。

### Q: ロッカー設定を削除できますか？

A: はい、ただし **アクティブなレンタルがない場合のみ**。すべての居住者がチェックアウト後に削除可能。

---

## 関連ページ

- [ロック接続](lock-connection.md) - KEYVOX連携とスマートロック設定
- [基本設定](base-settings.md) - 施設全般設定
- [ロッカー管理](locker-management.md) - ゲスト向けロッカー予約サービス（別機能）

---

最終更新：2026-04-02
