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

# 置き配管理 ヘルプ

## 概要

置き配管理は、マンションや集合住宅向けの不在配達サポート機能です。居住者がQRコードで部屋を登録し、配達伝票番号を事前に登録しておくことで、配達員がスマートロックを使って安全に荷物を置き配できる仕組みを提供します。

管理者向けの操作は「置き配管理」ページ（5つのタブ）で行い、居住者・配達員向けの操作は専用Webアプリで行います。

## 主な機能

- 部屋の追加・一括追加・削除（部屋管理タブ）
- KEYVOXスマートロックを入口・部屋別に分類（エントランス設定タブ）
- 居住者の確認・退去処理（居住者管理タブ）
- 居住者登録用QRコードの生成・印刷（QRコードタブ）
- 配達履歴のログ確認（配達履歴タブ）

---

## タブ一覧

| タブ名 | 説明 |
|-------|------|
| 部屋管理 | 置き配対象の部屋を追加・削除します |
| エントランス設定 | KEYVOXスマートロックを「入口」または「部屋」として分類します |
| 居住者管理 | 登録済み居住者の一覧確認と退去処理を行います |
| QRコード | 居住者登録用QRコードを生成・印刷します |
| 配達履歴 | 配達員によるアクセス履歴を確認します |

---

## セットアップ手順

初めて置き配管理を使う場合は、以下の順序でセットアップを行ってください。

### ステップ1: 部屋を追加する

1. 「部屋管理」タブを開きます
2. 「追加」ボタンをクリックして部屋名を入力するか、「一括追加」ボタンで複数の部屋をまとめて登録します
3. 追加された部屋が一覧に表示されます

**一括追加の書式例:**
- `101, 102, 103` - カンマ区切りで列挙
- `101-110` - 範囲指定（101〜110号室）
- `101-105, 201-205` - 組み合わせ
- 最大200部屋まで一括登録可能

### ステップ2: KEYVOXスマートロックを分類する

1. 「エントランス設定」タブを開きます
2. KEYVOXに登録済みのスマートロックが一覧表示されます
3. 各スマートロックのラジオボタンで分類を設定します：
   - **入口**: 共用エントランスのスマートロック（施設に1台のみ設定可）
   - **部屋**: 各居室のスマートロック。選択後、対応する部屋名をドロップダウンで選択
   - **未分類**: 置き配に使用しないスマートロック

> 入口スマートロックが設定されていない場合、配達員の認証が機能しません。必ず1台を入口として設定してください。

### ステップ3: QRコードを印刷して居住者に配布する

1. 「QRコード」タブを開きます
2. 登録した各部屋のQRコード（および登録URL）が表示されます
3. 「全て印刷」ボタンをクリックして印刷し、各部屋のポスト等に貼付します
4. URLをコピーしてメールやメッセージで居住者に送ることも可能です

### ステップ4: 居住者がQRコードを読み取って登録する

居住者がQRコードを読み取ると、居住者向けWebアプリの「部屋登録」ページが開きます。居住者はメールアドレスを入力し、送られてくるマジックリンクをクリックすることで部屋に登録されます。

登録後は「居住者管理」タブで居住者の情報を確認できます。

### ステップ5: KEYVOX管理コンソールでWebhookを設定する

配達員が解錠すると、KEYVOXからUnlockOSへWebhookが送信され、配達履歴が自動的に「配達完了」として確定されます。このWebhookを有効にするには、KEYVOX管理コンソールで以下の設定を行ってください。

**設定を行わない場合、解錠しても配達履歴のステータスが「配達中」のままになります。**

#### KEYVOX管理コンソールでの設定手順

KEYVOX管理コンソールの「Webhook設定」ページで以下の値を入力します。

| 項目 | 設定値 |
|------|--------|
| Post URL | `https://api.unlockos.io/functions/v1/keyvox-webhook` |
| アクション | 解錠 |
| 解錠手段 | バーコード、暗証番号、オンラインQRコード |
| Webhookシークレット | UnlockOS サポートにお問い合わせください（セキュリティのため本マニュアルにはシークレット値を記載していません） |

> **Webhookシークレットについて**: シークレットの値は **UnlockOS サポート（サポートページまたは担当者）にお問い合わせ**ください。セキュリティのため本マニュアルにはシークレット値を記載していません。

設定後、KEYVOX側で「テスト送信」を行い、UnlockOSの配達履歴タブにイベントが記録されることを確認してください。

---

## 詳細機能

## 部屋管理タブ

### 部屋の追加

「追加」ボタンをクリックすると入力フォームが表示されます。部屋名を入力してEnterキーまたは「保存」ボタンで登録します。

### 部屋の一括追加

「一括追加」ボタンをクリックするとダイアログが開きます。カンマ区切りや範囲指定（例：`101-110`）で複数の部屋名を入力します。入力内容のプレビューが表示されるので確認して「作成」ボタンをクリックします。

### 部屋の削除

居住者が登録されていない（空室）部屋のみ削除できます。在室中の部屋は削除ボタンが無効化されます。

### 一覧の表示項目

| 項目名 | 説明 |
|-------|------|
| 部屋名 | 登録した部屋の名前 |
| KEYVOXスマートロック | 紐付けられたスマートロックID |
| 居住者 | 登録している居住者の名前またはメールアドレス |
| 状態 | 在室 / 空室 |

## エントランス設定タブ

KEYVOXに登録済みのスマートロックを、置き配システムにおける役割別に分類します。

### 分類の種類

| 分類 | 説明 |
|-----|------|
| 入口 | 共用エントランスのスマートロック。配達員が伝票番号で認証後に開錠されます（施設に1台のみ） |
| 部屋 | 各居室のスマートロック。部屋名と紐付けることで、対象居住者の伝票番号が使用された場合に開錠されます |
| 未分類 | 置き配に使用しないスマートロック |

### 注意事項

- 入口スマートロックは施設全体で1台のみ設定できます
- 部屋スマートロックには必ず対応する部屋名を選択してください
- 分類変更は即座に反映されます

詳しい操作手順やトラブルシューティングは「[エントランス設定](okihai-unit-classification.md)」ヘルプを参照してください。

## 居住者管理タブ

QRコード経由で部屋登録した居住者の一覧が表示されます。

### 一覧の表示項目

| 項目名 | 説明 |
|-------|------|
| 部屋 | 居住者が登録した部屋名 |
| 名前 | 居住者の氏名（登録時に入力した場合） |
| メールアドレス | 居住者のメールアドレス |
| 登録日 | 部屋登録を行った日付 |

### 退去処理

居住者が退去する場合は「退去」ボタンをクリックします。確認ダイアログが表示されるので「退去」をクリックして完了します。退去処理を行うと、その居住者の伝票番号は無効化され、部屋は空室状態に戻ります。

## QRコードタブ

登録した全部屋の居住者登録用QRコード・登録URLを確認できます。

### 操作

| 操作 | 説明 |
|-----|------|
| URL コピー | 各部屋の登録URLをクリップボードにコピーします |
| 全て印刷 | 全部屋のQRカードを印刷用レイアウトで出力します |

### 登録URLの仕組み

QRコードには `https://resident.unlockos.io/{施設スラッグ}/register?room={部屋ID}` の形式のURLが埋め込まれています。居住者はこのURLにアクセスしてメールアドレスを入力し、認証コードを使って部屋に登録します。

施設スラッグは「基本設定」の「各種アプリURL」で設定します。スラッグが未設定の場合、QRコードは生成されません。

> スラッグを変更した場合は、新しいQRコードを再印刷して居住者に配布してください。旧スラッグのQRコードは使用できなくなります。

## 配達履歴タブ

配達員が伝票番号を使って開錠した記録が表示されます。

### フィルター

日付範囲（開始日・終了日）を指定して「検索」ボタンをクリックすると、期間を絞り込んで表示できます。

### 一覧の表示項目

| 項目名 | 説明 |
|-------|------|
| 日時 | 開錠が行われた日時 |
| 部屋 | 対象の部屋名 |
| 伝票番号 | 使用された配達伝票番号 |
| 配送会社 | ヤマト運輸・佐川急便・日本郵便・Amazon・その他 |
| ステータス | 配達完了 / 配達中 |

---

## 家族メンバー管理（管理者向け）

部屋に複数の居住者を登録できるようになりました。世帯主（最初に登録した居住者）が1部屋あたり最大5名の家族メンバーを招待できます（合計6名）。施設管理者には追加の管理ツールが提供されます。

### 家族メンバーの仕組み

- 部屋を最初に登録した居住者が**世帯主**になります
- 世帯主がマイページから家族メンバーを招待できます
- 家族メンバーは自分のメールアドレスでログインし、部屋の配達伝票・履歴・ロッカー割り当てを共有します
- 各家族メンバーは独立したログインセッションを持ちます

### 管理者向け操作

#### 家族メンバーの確認

**居住者管理**タブで、複数のメンバーが登録されている部屋はすべての居住者が表示されます。世帯主には「世帯主」バッジが表示されます。

#### メンバーの無効化

施設管理者は任意の部屋メンバー（世帯主・家族メンバーとも）を無効化できます。

1. **居住者管理**タブを開きます
2. 無効化したいメンバーを見つけます
3. エントリー横の「無効化」ボタンをクリックします
4. 確認ダイアログで操作を確定します

**世帯主**を管理者が無効化した場合、すべての家族メンバーも自動的に削除され、部屋は空室になります。

**家族メンバー**を無効化した場合、そのメンバーのみアクセスを失います。世帯主や他の家族メンバーには影響ありません。

### よくある質問: 家族メンバー（管理者向け）

**Q: 居住者が家族メンバーを招待できないと言っています。何を確認すべきですか？**
A: 家族メンバーの招待ができるのは世帯主（最初に部屋を登録した方）のみです。家族メンバーが他のメンバーを招待しようとしている場合はエラーが表示されます。また、部屋のメンバー数が上限（6名）に達していないか確認してください。

**Q: 世帯主を別の家族メンバーに変更できますか？**
A: 直接の変更はできません。現在の世帯主が退去（全メンバー削除）した後、新しい世帯主がQRコードで部屋を再登録し、家族メンバーを再招待する必要があります。

**Q: 家族メンバーの招待リンクが期限切れになりました。どうすればよいですか？**
A: 世帯主にマイページから新しい招待を送ってもらうようお伝えください。招待リンクの有効期限は7日間です。

---

## 居住者向けアプリの使い方

居住者は `https://resident.unlockos.io/{施設スラッグ}/` にアクセスして操作を行います。施設スラッグは「基本設定」ページで確認・設定できます。

詳細な操作方法は「[居住者向け置き配サービス](okihai-resident.md)」ヘルプをご覧ください。

---

## 配達員の入館の仕組み（伝票番号PIN）

配達員は専用ページやアプリを使いません。居住者が伝票を登録した時点で、**伝票番号の末尾6桁**がエントランスの解錠PINとして自動登録されます。

1. 居住者が伝票番号と到着予定日を登録します
2. システムが伝票番号の末尾6桁を、配達期間中だけ有効なエントランス解錠PINとしてKEYVOXに登録します
3. 配達員は荷物の伝票番号の末尾6桁をエントランスのキーパッドに入力して入館します
4. エントランスが解錠されると、配達完了として居住者の配達履歴に記録されます

> エントランス設定で入口（KEYVOXユニット）を1台指定していないと、伝票登録時に解錠PINが発行されません。必ず入口を設定してください。

---

## よくある質問

### Q: 一括追加で部屋番号を4桁表示にするにはどうすればよいですか？
A: `0101-0110` のように先頭に0を付けた形式で入力すると、ゼロ埋めされた番号（0101, 0102 ...）が生成されます。

### Q: 居住者が入れ替わった場合はどうすればよいですか？
A: 「居住者管理」タブで旧居住者の「退去」ボタンをクリックして退去処理を行います。その後「QRコード」タブから新しいQRコードを発行し、新居住者に渡してください。退去処理後は旧居住者の伝票は即座に無効化されます。

### Q: 同じ部屋に複数の居住者を登録できますか？
A: はい。世帯主（最初に登録した居住者）がマイページから最大5名の家族メンバーを招待でき、1部屋あたり合計6名まで登録可能です。家族メンバーは配達伝票・履歴・ロッカー割り当てを共有します。招待されていない方が同じQRコードから登録しようとした場合はエラーが表示されます。

### Q: エントランス設定で入口が設定されていない場合はどうなりますか？
A: 居住者が伝票を登録しても解錠PINが発行されず、配達員が入館できません。必ずエントランス設定で1台を入口として設定してください。

### Q: 配達員はどうやって入館しますか？
A: 居住者が登録した伝票番号の**末尾6桁**が、配達期間中だけ有効なエントランス解錠PINとして自動登録されます。配達員は荷物の伝票番号の末尾6桁を入口のキーパッドに入力して入館します。専用ページやアプリは不要です。

### Q: 居住者から「配達員が入館できない」と連絡がありました。
A: 伝票登録時のエントランスPIN発行が KEYVOX 側のエラーで失敗した可能性があります（システムは登録時に数回自動リトライします）。PIN発行に失敗すると、居住者の画面に「施設管理者にご連絡ください」という警告が表示されます。KEYVOX 連携の接続状態とエントランス設定を確認してください。一時的な障害の場合は、居住者に伝票を再登録してもらうと再度PINが発行されます。

### Q: 伝票番号の有効期限はどう設定すればよいですか？
A: 居住者がダッシュボードで伝票を登録する際に有効期限を指定します。デフォルトは登録日から7日後です。期待する配達日より少し余裕を持たせた日付を設定することを推奨します。

### Q: 配達履歴のステータス「配達中」とはどういう意味ですか？
A: 配達員が入口を開錠したが、まだ最終的な配達完了が記録されていない状態です。「配達完了」は配達が完了した後に記録されます。

---

## 関連ページ

- [エントランス設定](okihai-unit-classification.md) - KEYVOXスマートロックの役割分類（入口・部屋・未分類）の詳細手順
- [居住者向け置き配サービス](okihai-resident.md) - 居住者が使うアプリの操作方法（登録・伝票管理・配達履歴）
- [基本設定](base-settings.md) - 各種アプリURL（施設スラッグ）の設定
- ロック接続（KEYVOXスマートロックの登録）
- 権限設定