居住者向け置き配サービス ヘルプ

概要

居住者向け置き配サービス（resident.unlockos.io）は、マンション・集合住宅にお住まいの方が不在時でも安全に荷物を受け取るための仕組みです。

サービスの流れ:

  1. QRコードをスキャンして部屋を登録する
  2. 荷物の配達伝票番号をアプリに事前登録する
  3. 配達員が伝票番号でエントランスを解錠して荷物を届ける
  4. 配達完了の履歴を確認する

このアプリは居住者向けです。管理者向けの操作については「置き配管理」ヘルプをご覧ください。

居住者登録の方法（/register）

はじめてご利用になる場合は、管理者から受け取ったQRコードまたはURLから登録を行います。登録URLは resident.unlockos.io/{施設スラッグ}/register?room=... の形式です。

登録の手順

  1. 部屋のポストやドアに貼付されているQRコードをスマートフォンのカメラで読み取ります
    • または、管理者からメール等で受け取った登録URLを直接開きます
  2. 登録ページが開くと、登録対象の部屋名が画面上部に大きく表示されます。正しい部屋であることを確認してください
  3. お名前（例: 山田 太郎）とメールアドレスを入力し、「認証コードを送信」をタップします
  4. 入力したメールアドレスに6桁の認証コードが届きます
  5. 画面に表示された6つの入力欄にコードを1桁ずつ入力します（コピー貼り付けも可能）
  6. 「認証する」をタップすると部屋への登録が完了し、ダッシュボード（ホーム画面）に自動で移動します

登録時の注意事項

  • 1部屋に登録できる居住者は1名です。既に別の方が登録済みの場合はエラーが表示されます
  • 登録リンクには施設スラッグと部屋IDが含まれています。管理者から受け取ったリンク以外では新規登録はできません
  • 認証コードのメールが届かない場合は迷惑メールフォルダをご確認ください
  • 認証コードを受け取れなかった場合は「再送する」をタップして再送できます

再ログインの方法（返宅後・ブラウザ変更時）

一度登録が完了した居住者は、QRコードを使わずに直接 resident.unlockos.io にアクセスしてログインできます。

ログインの手順

  1. ブラウザで resident.unlockos.io を開きます
  2. メールアドレスを入力し、「認証コードを送信」をタップします
  3. 届いた6桁のコードを入力して「認証する」をタップします
  4. ログイン完了後、ホーム画面に自動で移動します

登録済みの方がQRコードを再スキャンした場合

すでに部屋に登録済みの状態でQRコードを再スキャンすると、再登録フォームは表示されず、自動的にホーム画面に移動します。名前の再入力やOTP認証は不要です。

この動作はセッションが有効な場合に適用されます。セッションが切れている場合（ログアウト後など）は通常のログイン手順が必要です。

セッションの維持とログインが切れた場合の対処

セッションの仕組み

アプリのセッション（ログイン状態）は、強制リロードやPWAの再起動をまたいで自動的に復元されます。アプリを閉じて再び開いても、通常はログイン状態が維持されます。

重要: セッションが切れても、部屋の登録情報（登録した氏名・部屋・伝票番号など）は消えません。 セッション（ログイン認証）と登録データは別々に管理されています。セッションが切れた場合は、再ログインするだけで元の状態に戻ります。

セッションが切れる主な原因

  • Supabaseの認証トークンの有効期限切れ（長期間アクセスがなかった場合）
  • プライベートブラウジングモードの使用（セッションが保存されないため）
  • ブラウザのキャッシュ・Cookieを手動で削除した場合
  • 明示的にログアウトした場合

ログインが切れた場合の再ログイン手順

セッションが切れてログイン画面が表示されると、以下の動作が起きます。

  • 「おかえりなさい」メッセージが表示される — 以前にログインしたことのある方には、「おかえりなさい。再度ログインしてください。」というメッセージが表示されます
  • メールアドレスが自動入力される — 前回ログイン時のメールアドレスが入力欄に事前入力されているため、確認または修正してすぐに認証コードを送信できます

再ログインの手順:

  1. ログイン画面が表示されたら、メールアドレスが自動入力されていることを確認します（必要に応じて修正）
  2. 「認証コードを送信」をタップします
  3. 届いた6桁のコードを入力して「認証する」をタップします
  4. ホーム画面に自動で移動します。登録済みの伝票番号や履歴はそのまま残っています

ヘッダー

ログイン後、画面上部のヘッダーには以下が表示されます。

  • 施設名（小さい文字、上段）— 登録している施設の名称
  • 居住者サービス（太字、下段）— アプリのタイトル
  • 言語切替ボタン（地球儀アイコン）— タップすると表示言語を切り替えられます
  • ログアウトボタン — タップするとログアウト確認ダイアログが表示されます。「ログアウト」で確定、「キャンセル」でアプリに戻ります

ボトムナビゲーション

ログイン後の画面下部には4つのタブが表示されます。

タブ ページ 内容
ホーム / ダッシュボード（部屋情報・クイック操作）
置き配 /slips 伝票番号の登録・管理
履歴 /history 配達履歴の確認
マイページ /mypage アカウント情報・退去手続き

ホーム画面（/）

ログイン後のホーム画面では、以下の情報と操作が利用できます。

表示される情報

項目 内容
施設名 居住している施設の名称
部屋番号 登録している部屋の番号
登録中の伝票数 現在アクティブな伝票番号の件数
最近の配達 直近5件の配達履歴

クイック操作

  • 伝票番号を登録 — 伝票管理ページに移動して新しい伝票番号を登録します
  • 配達履歴 — 配達履歴ページに移動して過去の配達記録を確認します

ホーム画面のクイック操作ボタンは、お使いの施設のURLに合わせた正しいページに移動します。

伝票番号の登録・管理（/slips）

配達伝票番号を事前に登録することで、配達員がエントランスを解錠できるようになります。

伝票番号を登録する

  1. ボトムナビの「置き配」をタップして伝票管理ページを開きます
  2. 「伝票番号」欄に配達伝票番号を入力します
    • 入力例: 1234-5678-9012
    • 英数字とハイフンが使用できます
    • 伝票番号に含まれる数字が十分な桁数である必要があります（桁数が不足している場合は「この伝票は登録できません。」と表示されます）
  3. 「運送会社」を選択します
    • ヤマト運輸 / 佐川急便 / 日本郵便 / Amazon / その他
  4. 到着予定日を設定します
    • カレンダーから到着予定の日付を選択します
    • さらに「1日間」「2日間」「3日間」のボタンで有効期間を追加します（例: 3月28日を選択して「2日間」なら3月30日まで有効）
  5. 「登録する」ボタンをタップします

伝票番号のバリデーション

伝票番号には十分な桁数の数字が含まれている必要があります。これは、伝票番号の数字部分がエントランスPINの生成に使用されるためです。

  • 桁数が不足している場合は「この伝票は登録できません。」と表示されます
  • 「登録する」ボタンは有効な伝票番号が入力されるまで無効（グレーアウト）のままです

登録済み伝票の確認と削除

  • 登録した伝票番号は一覧で表示されます（伝票番号・運送会社・有効期限）
  • 不要になった伝票は右側の「削除」ボタンをタップして削除できます
  • 削除確認ダイアログが表示されるので「OK」をタップして完了です

配達の流れ（伝票登録から配達完了まで）

  1. 居住者が伝票番号を登録する — 注文後に伝票番号と到着予定日をアプリに登録します
  2. 配達員が施設に到着する — 施設入口に掲示されているQRコードを読み取るか、配達確認ページ（/deliver）にアクセスします
  3. 配達員が伝票番号を入力する — 荷物に貼付された伝票番号を入力して「確認」をタップします
  4. エントランスのPINコードが表示される — 有効な伝票番号の場合、3分間有効なPINコードが表示されます
  5. 配達員がPINを入力して入館する — エントランスのキーパッドにPINを入力して解錠します
  6. 荷物が届く — 配達員が荷物を指定の場所に置き配します
  7. 配達履歴に記録される — 配達完了後、居住者のアプリの配達履歴に記録が追加されます

PINコードは3分間のみ有効です。時間内に使用されなかった場合は自動的に無効になります。

配達履歴の確認（/history）

過去に行われた配達の記録を確認できます。

ボトムナビの「履歴」をタップすると履歴ページが開きます。

表示される情報

項目 内容
日時 イベントが発生した日時（配達確認済みの場合はその時刻、それ以外は認証時刻）。施設が設定しているタイムゾーンで表示されます（例: Asia/Tokyo）
伝票番号 使用された配達伝票番号
運送会社 ヤマト運輸・佐川急便・日本郵便・Amazon・その他
ステータス 以下の5種類のいずれか

配達ステータスの種類

各履歴には、色分けされたアイコンとステータスバッジが表示されます。

ステータス アイコン 色 意味
配達完了 荷物 緑 配達員が伝票番号で認証しエントランスを解錠した
配達確認済み チェックマーク 緑 KEYVOXロックセンサーにより配達が自動確認された（荷物が置かれドアが閉まったことを検知）
配達推定 荷物 黄 同日・同施設の別の伝票のPINで解錠が行われたため、この荷物も同時に配達された可能性がある
キャンセル済み ゴミ箱 グレー 配達前に伝票番号がキャンセルされた
期限切れ 時計 赤 伝票番号が使用されないまま有効期限を過ぎた

補足: 「配達確認済み」ステータスは、建物のKEYVOXスマートロックが配達用ドアの開閉を検知したときに自動的に設定されます。居住者が操作する必要はなく、システムが自動でステータスを更新します。

配達推定について: 配達員が1枚の伝票番号のPINを使ってエントランスを解錠した際、同日・同施設にアクティブな他の伝票も同時に配達された可能性があります。このような伝票には「配達推定」ステータスが自動的に付与されます。後日、配達会社のWebhookで正式な配達確認が届いた場合は「配達確認済み」に自動アップグレードされます。

マイページ（/mypage）

ボトムナビの「マイページ」をタップするとアカウント情報ページが開きます。

表示される情報

項目 内容
メールアドレス ログイン中のメールアドレス
名前 登録時に入力した名前（編集可能）
施設名 居住している施設の名称
部屋名 登録している部屋の名称
登録日時 部屋に登録した日時

名前を変更する

  1. 名前の横に表示されている鉛筆アイコン（✏️）をタップします
  2. 名前の入力欄が編集可能になります
  3. 新しい名前を入力して「保存」をタップします
  4. 「✕」をタップするとキャンセルできます

退去手続き

部屋の登録を解除する際は、マイページの「退去する」ボタンをタップします。

退去の手順:

  1. 「退去する」ボタン（画面下部のカプセル型ボタン）をタップします
  2. 確認モーダルが表示されます。内容をよく読んでください
    • 登録済みの伝票番号がすべて無効になります
    • 再度この部屋に入居する場合は、管理者の承認が必要です
  3. 退去を確定する場合は「退去する」（赤いボタン）をタップします
  4. キャンセルする場合は「キャンセル」をタップします
  5. 退去が完了するとログアウトされ、登録ページに移動します

注意: 退去処理後に同じ部屋へ再登録するには、管理者がその部屋の登録リセットを行う必要があります。退去前に管理者にご連絡ください。

アプリをホーム画面に追加する（PWAインストール）

本サービスはPWA（Progressive Web App）に対応しており、スマートフォンのホーム画面にアプリとして追加することができます。アプリとしてインストールすると、次回以降はホーム画面のアイコンからすぐに起動できます。

Androidの場合

ログイン後にホーム画面への追加を促すバナーが画面下部に表示されます。

  1. 「インストール」をタップします
  2. ブラウザの確認ダイアログで「インストール」または「追加」をタップします
  3. ホーム画面にアプリアイコンが追加されます

iOSの場合（Safari使用）

iOSでは、バナーの「インストール」をタップするとインストール手順が表示されます。

  1. Safari下部の共有ボタン（四角から矢印が出たアイコン）をタップします
  2. 「ホーム画面に追加」を選択します
  3. 右上の「追加」をタップして完了です

iOSでは必ずSafariブラウザをご使用ください。Chrome等の他のブラウザではホーム画面への追加ができない場合があります。

よくある質問

Q: 「施設が見つかりません」と表示されます

A: アクセスしたURLに対応する施設が見つからない場合に表示されます。以下をご確認ください。

  • QRコードが最新のものかどうか確認する（管理者がスラッグを変更した場合、古いQRコードは無効になります）
  • URLを直接入力した場合は、スラッグ部分のスペルが正しいか確認する
  • 管理者に連絡し、正しいQRコードまたはURLを再送してもらう

Q: 認証コードのメールが届きません

A: 以下をご確認ください。

  • 迷惑メールフォルダに振り分けられていないか確認する
  • メールアドレスが正しく入力されているか確認する
  • しばらく待ってから「再送する」をタップする

Q: 「この部屋は既に登録されています」と表示されます

A: 別の居住者が既に同じ部屋に登録されています。管理者にお問い合わせいただき、前の居住者の退去処理を行ってもらってから再度登録してください。

Q: 伝票番号を入力しても「この伝票は登録できません。」と表示されます

A: 入力した伝票番号に含まれる数字の桁数が不足しています。置き配サービスでは、PINコードの生成のために伝票番号に十分な桁数の数字が含まれている必要があります。ハイフン等の記号を含む伝票番号の場合、数字部分のみがカウントされます（例: 1234-5678-9012 は数字12桁のため登録可能）。桁数が少ない伝票番号の場合は、運送会社に正式な伝票番号をご確認ください。

Q: 配達が完了したのに履歴に表示されません

A: 履歴に記録されるのは、配達員が伝票番号で認証（エントランス解錠）を行った時点です。配達員が伝票番号を使用しなかった場合（別のルートで入館した場合など）は記録されないことがあります。管理者にご相談ください。

Q: 履歴が「配達完了」のままで「配達確認済み」にならない — 問題ですか？

A: 問題ありません。「配達完了」は配達員がエントランスの解錠に成功したことを意味します。「配達確認済み」は、建物のKEYVOXスマートロックセンサーが配達の完了（配達用ドアの開閉）を自動検知した場合に追加で付与されるステータスです。建物にこのセンサー機能が設定されていない場合は、「配達完了」のままとなります。

Q: 履歴に「配達推定」と表示されています。これは何ですか？

A: 「配達推定」は、同日・同施設で別の居住者の伝票番号のPINが使われてエントランスが解錠された際に、この荷物も同時に届いた可能性があることを示します。配達員が複数の荷物を一度に届ける際、1枚の伝票番号のみで入館することがあるため、このステータスが付与されます。

荷物が実際に届いているかご確認ください。後日、配達会社のシステムから正式な配達完了通知が届いた場合は、自動的に「配達確認済み」にアップグレードされます。

Q: 履歴に「期限切れ」のエントリーが表示されます

A: 「期限切れ」は、登録した伝票番号が配達員に使用されないまま有効期限を過ぎた場合に表示されます。まだ荷物が届いていない場合は、新しい有効期限で伝票番号を再登録してください。

Q: ログインが切れた場合はどうすればいいですか？

A: セッションが切れてログイン画面が表示された場合でも、登録情報（部屋・伝票番号・配達履歴）は失われていません。以前ログインしたことのある端末では「おかえりなさい」というメッセージが表示され、メールアドレスが自動入力されています。そのまま「認証コードを送信」をタップし、届いたコードで再ログインしてください。ログイン完了後、ホーム画面に自動で戻ります。

Q: アプリを再起動したらログインが切れていました

A: 通常、アプリを再起動してもセッションは自動で復元されます。ただし、以下の場合はセッションが保存されないため、毎回ログインが必要になります。

  • プライベートブラウジング（シークレットモード）でアプリを開いている
  • ブラウザのCookieやキャッシュを手動で削除した

通常のブラウザモードでPWAとしてインストールして使用することをお勧めします。セッションが切れた場合も、登録データは消えていません。「おかえりなさい」の表示が出たらメールアドレスを確認して再ログインしてください。

Q: 再ログイン後、登録した伝票番号や履歴は消えていませんか？

A: 消えていません。セッション（ログイン状態）と登録データは別々に管理されています。伝票番号、配達履歴、部屋情報などのデータはサーバーに保存されており、セッションが切れても影響を受けません。再ログインすれば、すべてのデータがそのまま表示されます。

Q: QRコードを再スキャンしたら登録画面ではなくホーム画面に移動しました

A: 正常な動作です。すでに部屋に登録済みの場合、QRコードを再スキャンしても再登録は必要ありません。セッションが有効であれば、自動的にホーム画面に移動します。別の部屋や施設のQRコードをスキャンした場合は、通常の登録フローが表示されます。

Q: 引っ越し後も前の部屋のアカウントが残っています

A: ご退去の際はマイページの「退去する」ボタンから手続きを行うか、管理者にお申し出ください。管理者が退去処理を行うと、登録済みの伝票番号がすべて無効化され、部屋の登録が解除されます。

Q: 有効期限が切れた伝票番号はどうなりますか？

A: 有効期限が過ぎた伝票番号は自動的に無効になり、配達員が使用することができなくなります。必要に応じて、新しい有効期限で再登録してください。

Q: 複数の荷物がある場合はどうすればよいですか？

A: 荷物ごとに伝票番号が異なる場合は、それぞれ個別に登録してください。同じ運送会社から複数の荷物が届く場合でも、伝票番号が異なれば個別に登録が必要です。

Q: 退去後に同じ部屋に戻ってきた場合、再登録できますか？

A: 退去処理後に同じ部屋へ再登録するには、管理者がその部屋の登録リセットを行う必要があります。管理者にご連絡の上、新しいQRコードまたは登録URLを発行してもらってください。

関連ページ

  • 置き配管理 - 管理者向けの設定・操作方法（部屋管理・QRコード発行・配達履歴確認）