# 宅配ロッカー設定 ## 概要 宅配ロッカー設定は、施設のKEYVOX宅配ロッカーを設定する管理者向けの画面です。課金プラン（無料ティア・有料ティア・両方）の選択、料金・利用上限の設定、KEYVOXロッカーデバイスの選択を行います。設定を保存すると、荷物の預け入れ通知（Webhook）を受け取るためのAPIキーが自動生成されます。 置き配管理ページの **ロッカー** タブから設定画面を開きます。 --- ## セットアップ手順 ### ステップ1: プランタイプを選択する 居住者に適用する課金プランを選択します。 | プランタイプ | 説明 | |------------|------| | 保管日数 | ロッカーに保管した日数に応じて課金されます | | 利用回数 | 月あたりの受取回数に応じて課金されます | | 両方 | 保管日数と利用回数の両方で課金されます | > どのプランを使うか迷った場合は、**保管日数** から始めることをお勧めします。集合住宅で最も一般的な設定です。 ### ステップ2: 料金と利用上限を設定する プランタイプを選択したら、対応する課金パラメータを入力します。 #### 保管日数プラン | 項目 | 説明 | |------|------| | 無料日数 | 課金が発生するまでの無料保管日数。0に設定すると無料期間なし | | 1日あたりの料金 | 無料期間終了後の1日あたりの保管料金（施設の通貨単位） | | 月間上限 | 居住者1人あたりの月間無料受取回数上限。空欄で無制限 | | 超過時のポリシー | 月間上限を超えた場合の処理：**ブロック**（新規預け入れを拒否）または**課金**（引き続き受け付けて超過分を課金） | #### 利用回数プラン | 項目 | 説明 | |------|------| | 月間無料利用回数 | 月あたりの無料受取回数 | | 1回あたりの料金 | 無料利用回数を超えた場合の1回あたりの料金 | | 超過時のポリシー | 月間無料利用回数を超えた場合：**ブロック**または**課金** | > **注意:** ロッカーが稼働中にプランタイプや料金を変更した場合、変更後に預け入れられた荷物から新しい設定が適用されます。既に作成済みの預け入れ記録は遡及して変更されません（設定は預け入れ時にスナップショットされます）。 ### ステップ3: KEYVOXロッカーデバイスを選択する 1. **デバイス取得** ボタンをクリックして、施設に登録済みのKEYVOXロッカーを一覧表示します 2. ドロップダウンからロッカーを選択します 3. 選択したデバイスのIDが保存され、KEYVOXから荷物到着Webhookが届いた際の識別子として使われます > デバイスが一覧に表示されない場合は、**基本設定** → KEYVOX連携でAPIキーが正しく設定されているか確認してください。 ### ステップ4: 設定を保存する **保存** ボタンをクリックして設定を適用します。 保存後、KEYVOXから届くWebhookの認証に使用するAPIキー（Webhookシークレット）が自動生成されます。このキーはシステム内部でのみ使用されるため、居住者と共有する必要はありません。 > このシークレットは保存のたびに更新されます。WebhookのURLを変更する必要がある場合はKEYVOXサポートにご連絡ください。 --- ## 詳細機能 ## 機能1: プランタイプの選択 プランタイプは居住者への課金方法を決定します。施設の課金ポリシーに合ったモデルを選択してください。 - **保管日数**: 保管期間が居住者によって異なるマンションに最適 - **利用回数**: 月間定額回数（例：月5回無料）を提供する建物に最適 - **両方**: 保管日数と月間回数の両方で課金 — 1回の荷物について日数課金と回数カウントが両方発生する場合に使用 ## 機能2: 無料ティアの設定 すべてのプランで無料ティアを設定できます。すぐに受け取る居住者への課金を防ぐために使用します。 - **無料日数** を1〜2日に設定すると、素早く受け取った居住者には課金されません - **月間無料利用回数** は施設の無料サービス回数に合わせて設定します - 両方を0に設定すると、初日から全ての利用が課金対象になります ## 機能3: KEYVOXデバイス連携 デバイスドロップダウンには、施設に登録済みのKEYVOXスマートロックが表示されます。選択することで、ロッカー設定がそのデバイスに紐付けられます。 KEYVOXから荷物預け入れのWebhookが届いた際: - システムはKEYVOXデバイスIDでロッカー設定を検索します - ボックス/部屋の割り当てから対象居住者を特定します - 現在のプラン設定に基づいて無料か有料かを判定します ## 機能4: APIキーの管理 APIキー（Webhookシークレット）は設定保存後に自動生成されます。受信するWebhookイベントがKEYVOXから送信されたものかを検証するために使用します。 - キーは安全に保管され、居住者には公開されません - キーが漏洩した疑いがある場合は、設定を再保存することでキーをローテーションできます --- ## よくある質問 ### Q: ロッカー稼働後にプランタイプを変更するには？ いつでもプランタイプを変更して保存できます。新しい設定は変更後に預け入れられた荷物から適用されます。すでに保管中の荷物は、預け入れ時の設定でそのまま課金されます（設定はスナップショットとして記録されます）。 ### Q: 居住者の月間利用上限を超えた場合はどうなりますか？ **超過時のポリシー** 設定によって異なります： | ポリシー | 結果 | |---------|------| | ブロック | 次の課金サイクルまで、その居住者の新規預け入れがWebhookで拒否される | | 課金 | 引き続き預け入れを受け付け、超過分の料金が課金される | ### Q: 無料日数を0にして即時課金にすることはできますか？ はい。**無料日数** を `0` に設定してください。この場合、居住者は当日受け取りでも支払いが必要になります。 ### Q: Stripeを設定しなくてもロッカーは使えますか？ ロッカーは無料ティアのみであればStripeなしで動作します。ただし、有料の受取を含むプランの場合、Stripeが設定されていないと居住者が支払いを完了できません。Stripeなしでは、支払いが必要な荷物は支払いステップでブロックされます。 --- ## トラブルシューティング ### KEYVOXデバイスがドロップダウンに表示されない 1. **基本設定** → KEYVOX連携を開き、APIキーが正しく保存されているか確認します 2. KEYVOXの管理ポータルでデバイスが登録・有効になっているか確認します 3. 上記を確認後、**デバイス取得** を再度クリックします ### 設定の保存に失敗する 1. 必須項目がすべて入力されているか確認します（プランタイプの選択必須、料金は0以上の数値） 2. KEYVOXデバイスが未選択でも設定は保存できます — デバイスが選択されるまで荷物の預け入れは拒否されます 3. エラーが続く場合は、画面に表示されているエラーメッセージと共にサポートまでご連絡ください ### 居住者が預け入れ直後から「支払いが必要」と表示される **無料日数** が `0` に設定されているか、**月間無料利用回数** が `0` になっている可能性があります。無料期間を設けたい場合は、無料ティアの設定を更新してください。 --- ## 関連ページ - [置き配管理](okihai-manager.md) - 部屋管理、QRコード生成、配達履歴 - [居住者向け置き配サービス](okihai-resident.md) - 居住者向け登録・管理ガイド - [基本設定](base-settings.md) - KEYVOX APIキーと施設設定 - [請求](billing.md) - 請求・Stripe設定