ロッカー管理 ヘルプ
概要
ロッカー管理は、施設でKEYVOX連携スマートロッカーの短期レンタルサービスを運営するための管理画面です。ロッカーのサイズ・料金・割り当てユニットを「ロッカー設定」として定義し、ゲスト向けの予約URLを発行します。注文一覧では稼働状況をリアルタイムで確認でき、個別の注文詳細からアクセスコードの確認やキャンセル操作が行えます。
メインナビゲーションから ロッカー管理 を選択するとロッカーダッシュボードが開きます。
ゲストの予約フロー（全体像）
ゲストは施設から共有されたURLにアクセスし、次の4ステップで予約を完了します。
| ステップ | 画面 | 内容 |
|---|---|---|
| 1 | サイズ選択 | 利用可能なサイズをKEYVOX在庫からリアルタイム表示 |
| 2 | 期間・モード選択 | ボックスモードと利用日程を選択、料金が自動計算される |
| 3 | 確認・決済 | ゲスト情報入力 → Stripe決済 |
| 4 | 完了 | PINコード・QRコード・ボックス番号が表示される |
詳細機能
機能1: ロッカーダッシュボード（注文一覧）
ダッシュボードは /locker にあり、施設のロッカー注文を一覧表示します。
統計バー
画面上部に3つの集計カードが表示されます：
| カード | 説明 |
|---|---|
| 利用中 | 現在利用中（checked_in）の注文件数 |
| 本日の収益 | 本日作成された支払い済み注文の合計金額 |
| 合計収益 | 表示期間内の支払い済み注文の合計金額 |
ステータスフィルター
| フィルター | 表示内容 |
|---|---|
| 全て | ステータスに関わらずすべての注文 |
| 確定済 | 予約確定済みで利用開始前の注文 |
| 利用中 | 現在ロッカーを利用中の注文 |
| 完了 | レンタル期間が終了した注文 |
| キャンセル | キャンセルされた注文 |
「全て」表示時は各ステータスの件数バッジが表示されます。
検索・日付フィルター
- テキスト検索: ゲスト名・注文番号の一部を入力すると400ミリ秒のデバウンスを経て自動的に絞り込まれます
- 日付範囲: デフォルトは30日前〜90日後。DateRangePickerで期間を変更できます
- リセット: すべてのフィルターをデフォルト状態に戻します
注文カードの表示項目
| 項目 | 説明 |
|---|---|
| ゲスト名 / メール | 予約したゲストの氏名またはメールアドレス |
| ステータスバッジ | 現在のステータス |
| 金額 | 注文の合計金額（未払いの場合は「未払」バッジが表示） |
| サイズ | ロッカーのサイズと名称 |
| レンタル期間 | 開始〜終了日時 |
| 予約番号 | 内部の予約ID |
| メール | ゲストのメールアドレス |
注文カードをクリックすると注文詳細ページに移動します。
機能2: ロッカー設定一覧
ロッカーダッシュボード右上の ロッカー設定 ボタン、またはサイドナビから /locker/config にアクセスします。
各設定カードには設定名・有効/無効ステータス・通貨が表示されます。
操作ボタン
| ボタン | 説明 |
|---|---|
| URLコピーアイコン | ゲスト向けロッカー予約URLをクリップボードにコピー |
| 編集アイコン | ロッカー設定編集フォームを開く |
| 削除アイコン | 確認後にロッカー設定を削除 |
注意：設定を削除すると以後そのURLでの新規予約は受け付けられなくなります。既存の注文には影響しません。
機能3: ロッカー設定の作成・編集
設定一覧右上の 新規ロッカー設定 をクリック、または既存設定の編集アイコンをクリックするとフォームが開きます。
基本項目
| 項目 | 説明 | 必須 |
|---|---|---|
| 設定名 | 管理用の名称（例:「1Fロッカー 2026年夏」） | 必須 |
| 有効 / 無効 | ゲスト向け予約の受付可否を切り替えるトグル | — |
| 説明 | 任意の補足説明 | 任意 |
| 通貨 | JPY / USD / EUR から選択 | — |
| タイムゾーン | 日付計算に使用するタイムゾーン（デフォルト: Asia/Tokyo） | — |
KEYVOXデバイス連携（推奨）
KEYVOXと連携している施設では、デバイス情報を自動取得してサイズ定義を自動入力できます。
- デバイス取得 ボタンをクリックします
- KEYVOXに登録されたロッカーデバイスの一覧が表示されます
- ドロップダウンからデバイスを選択すると、ボックスサイズ・ボックス番号が自動入力されます
- 各サイズ行で料金のみ入力すれば設定が完了します
KEYVOXが未接続の場合やエラーが発生した場合は、右上の 手動入力に切替 ボタンで手動入力モードに切り替えられます。
サイズ定義
1つの設定に複数のサイズ（S / M / L / カスタム）を定義できます。各サイズ行に以下を入力します：
| 項目 | 説明 |
|---|---|
| サイズ | S / M / L / カスタム から選択 |
| 表示名 | ゲストに表示されるロッカー名称（例:「S（小）」） |
| 長期日額 | 長期レンタルモード（出し入れ自由）の1日あたり料金 |
| 一回預け日額 | 一回預けモード（1回開閉のみ）の1日あたり料金 |
| KEYVOX Unit IDs | 手動入力時のみ。該当サイズのKEYVOXユニットIDをカンマ区切りで入力 |
2つの料金について: ゲストは予約時に「一回預け」（1回開閉のみ・安価）か「長期預け」（期間中出し入れ自由・通常料金）かを選択します。それぞれ異なる日額を設定してください。
- サイズを追加 ボタンで行を追加できます
- 行の削除は各行右下の削除ボタン（×）をクリックします
共有URL（編集モードのみ）
設定を保存後、ゲスト向けロッカー予約URLが表示されます：
https://locker.unlockos.io?configId=<設定ID>
URLをコピー ボタンをクリックするとクリップボードにコピーされます。このURLをゲストに共有することでロッカーの予約受付が可能になります。
保存と移動
- 保存: 設定を保存してロッカー設定一覧に戻ります
- キャンセル: 変更を破棄してロッカー設定一覧に戻ります
機能4: 注文詳細
注文一覧のカードをクリックすると注文詳細ページ（/locker/order/:id）が開きます。
表示セクション
| セクション | 表示内容 |
|---|---|
| ゲスト情報 | 名前・メールアドレス・電話番号 |
| ロッカー情報 | 予約ID・サイズ・ボックス名・ボックス番号・ボックスモード・レンタル期間・備考 |
| 決済情報 | 金額・決済状態（paid / unpaid） |
| アクセスコード | PINコードと有効期限（発行済みの場合のみ） |
| キャンセル情報 | キャンセル日時と理由（キャンセル済みの場合のみ） |
| タイムスタンプ | 作成日時・更新日時 |
キャンセル操作
注文が「完了」または「キャンセル済み」でない場合、キャンセル ボタンが表示されます。
- キャンセル ボタンをクリックします
- 確認ダイアログが表示されます
- キャンセルする をクリックして確定します — この操作は取り消せません
ロッカー運用の設定手順（ステップバイステップ）
ステップ1: ロッカー設定を作成する
ロッカー設定 一覧から 新規ロッカー設定 をクリックし、設定名・通貨・タイムゾーンを入力します。
ステップ2: KEYVOXデバイスを選択してサイズを定義する
KEYVOXから取得（推奨）:
- デバイス取得 をクリックしてKEYVOXに登録されたデバイスを読み込みます
- ドロップダウンからデバイスを選択するとボックスサイズ・番号が自動入力されます
- 各サイズ行に「長期日額」と「一回預け日額」を入力します
手動入力（KEYVOXが未接続の場合）:
- 手動入力に切替 をクリックします
- 各サイズ行にサイズ・表示名・両方の日額料金・KEYVOXユニットIDを入力します
- サイズを追加 で複数サイズを定義できます
ステップ3: URLをゲストに共有する
設定を保存すると共有URLが生成されます。URLをコピー をクリックしてゲストにメール・Webサイト・QRコードなどで共有します。
よくある質問
Q: 料金はどのように計算されますか？
レンタル期間の日数 × ボックスモードに対応する日額料金で計算されます。ゲストが「一回預け」を選択した場合は一回預け日額、「長期預け」を選択した場合は長期日額が適用されます。
Q: 「一回預け」と「長期預け」の違いは何ですか？
| モード | 開閉 | 用途 | 料金 |
|---|---|---|---|
| 一回預け（ボックスモード 1） | 1回のみ（取り出したら終了） | 短時間の荷物預け | 一回預け日額 × 日数 |
| 長期預け（ボックスモード 2） | 期間中出し入れ自由 | 複数日にわたる保管 | 長期日額 × 日数 |
ゲストは予約のステップ2でモードを選択します。
Q: PINコードはいつ発行されますか？
ゲストが予約を完了し、決済が確認された後に自動で発行されます。PINコードは注文詳細の「アクセスコード」セクションで確認できます。
Q: PINコードの有効期限はいつまでですか？
アクセスコードの有効期限は注文詳細の「アクセスコード」セクションに表示されます。通常はレンタル期間の終了時刻に設定されます。
Q: ロッカー設定を無効にするとどうなりますか？
設定を無効にすると、そのURLでの新規予約は受け付けられなくなります。既存の注文には影響しません。
Q: キャンセルした注文の料金は返金されますか？
キャンセル操作はステータスを「キャンセル」に変更するだけです。返金処理はお使いの決済サービスに応じて別途行ってください。
Q: 同じ設定に複数のサイズを追加できますか？
はい。1つのロッカー設定にS・M・Lなど複数のサイズを定義できます。ゲストは予約時にサイズを選択します。
Q: KEYVOXデバイス取得でエラーが出る
施設にKEYVOX APIキーが設定されているか確認してください（基本設定 → KEYVOX連携）。APIキーが正しく設定されていれば 手動入力に切替 を使用して設定を続けることもできます。
Q: ロッカーが表示されない・予約できない
以下を確認してください：
- ロッカー設定が 有効 になっているか
- サイズ定義にKEYVOX Unit IDが正しく入力されているか（手動モードの場合）
- URLのconfigIdが正しい設定を参照しているか
- 対象サイズの在庫（利用可能なボックス数）が0になっていないか
関連ページ
最終更新: 2026-03-31 - KEYVOXデバイス自動取得、ボックスモード（一回預け/長期預け）、二段階料金設定を追記