Resident Delivery Service Help
Overview
The Resident Delivery Service (resident.unlockos.io) lets apartment and condominium residents receive packages safely even when they are not home.
How it works:
- Scan a QR code to register your room
- Pre-register delivery slip numbers for expected packages
- The delivery person enters the slip number to unlock the building entrance
- Check your delivery history in the app
This app is for residents. For administrator operations, see the Delivery Management help page.
How to Register (/register)
First-time users must register using the QR code or URL provided by the property manager. Registration URLs take the form resident.unlockos.io/{facility-slug}/register?room=....
Registration Steps
- Scan the QR code posted at your mailbox or unit door with your smartphone camera
- Alternatively, open the registration URL shared by the property manager directly
- The registration page opens and prominently displays your room name at the top — verify that it matches your room before continuing
- Enter your name (e.g., Jane Smith) and email address, then tap "Send Verification Code"
- A 6-digit verification code is sent to the email address you entered
- Enter the code one digit per box in the six input fields on screen (paste from clipboard is also supported)
- Tap "Verify" to complete registration; you are automatically redirected to the dashboard (home screen)
Registration Notes
- Only one resident can be registered per room. If another person has already registered the room you will see an error
- The registration link contains your facility's slug and room ID. You cannot create a new registration using any other link
- If the verification code email does not arrive, check your spam or junk mail folder
- If you did not receive the code, tap "Resend" to request a new one
Returning User Login (after moving back or switching browsers)
Once registered, you can log back in at any time without a QR code by going directly to resident.unlockos.io.
Login Steps
- Open resident.unlockos.io in your browser
- Enter your email address and tap "Send Verification Code"
- Enter the 6-digit code you receive and tap "Verify"
- After login you are automatically redirected to the home screen
If you scan a QR code when already registered
If you scan your room's QR code while your session is still active, the registration form is skipped and you are taken directly to the home screen. You do not need to re-enter your name or complete OTP verification again.
This applies only when your session is active. If your session has expired (for example, after logging out), you will be prompted to log in first.
Session Persistence and Recovery
How sessions work
Your login session is automatically restored across forced reloads and PWA restarts. Closing and reopening the app normally keeps you signed in without any action required.
Important: Even if your session expires, your registration data — room, name, slip numbers, and delivery history — is not lost. Session state (authentication) and registration data are managed separately. If your session expires, simply log in again and everything will be exactly as you left it.
Common reasons a session may expire
- The Supabase authentication token reached its expiry after a long period of inactivity
- The app was opened in a private browsing (incognito) window — sessions are not saved in private mode
- Browser cookies or cache were manually cleared
- You explicitly tapped "Log out"
How to sign back in after a session expires
When your session has expired and the login screen appears, the app assists you in two ways:
- "Welcome back" message — If you have signed in before on this device, the message "Welcome back. Please sign in again." is displayed to let you know this is a re-login, not a first-time registration
- Email address pre-filled — The email you used last time is already entered in the field, so you can tap "Send Verification Code" immediately without retyping it
Steps to sign back in:
- When the login screen appears, confirm your email address is pre-filled (edit if needed)
- Tap "Send Verification Code"
- Enter the 6-digit code you receive and tap "Verify"
- You are redirected to the home screen. Your slip numbers, delivery history, and room registration are all intact
Header
After logging in, the header at the top of the screen displays:
- Facility Name (small text, top line) — the name of the property you are registered at
- Resident Services (bold text, bottom line) — the app title
- Language Selector — tap the globe icon to switch the display language
- Logout Button — tap to open the logout confirmation dialog; tap "Log out" to confirm or "Cancel" to return to the app
Bottom Navigation
After logging in, four tabs appear at the bottom of the screen.
| Tab | Page | Contents |
|---|---|---|
| Home | / |
Dashboard — room info and quick actions |
| Deliveries | /slips |
Register and manage delivery slip numbers |
| History | /history |
View past delivery records |
| My Page | /mypage |
Account info and move-out procedure |
Home Screen (/)
After logging in, the home screen shows the following information and actions.
Information Displayed
| Item | Description |
|---|---|
| Facility Name | Name of the facility where you live |
| Room Number | Your registered room number |
| Active Slips | Number of currently active slip numbers |
| Recent Deliveries | Your 5 most recent delivery records |
Quick Actions
- Register Slip — Go to the slip management page to add a new slip number
- View History — Go to the delivery history page to review past deliveries
The quick action buttons on the home screen navigate to the correct facility-scoped pages for your building.
Registering and Managing Delivery Slips (/slips)
Pre-registering your delivery slip numbers allows delivery personnel to unlock the building entrance when your package arrives.
How to Add a Slip
- Tap "Deliveries" in the bottom navigation to open the slip management page
- Enter the delivery slip number in the "Slip Number" field
- Example:
1234-5678-9012 - Alphanumeric characters and hyphens are accepted
- The slip number must contain a sufficient number of digits (if not enough digits are present, "This slip cannot be registered." is displayed)
- Example:
- Select the carrier
- Yamato Transport / Sagawa Express / Japan Post / Amazon / Other
- Set the expected arrival date
- Choose a date from the calendar
- Then tap a duration button to extend the validity window: "1 day", "2 days", or "3 days" (for example, selecting March 28 with "2 days" means the slip is valid until March 30)
- Tap "Register"
Slip Number Validation
The slip number must contain a sufficient number of digits. This is because the digit portion of the slip number is used to generate the entrance PIN.
- If the digit count is insufficient, the message "This slip cannot be registered." is displayed
- The "Register" button remains disabled (grayed out) until a valid slip number is entered
Viewing and Deleting Registered Slips
- All registered slips are listed with their slip number, carrier, and expiration date
- To remove a slip, tap the "Delete" button next to it
- Confirm the action in the confirmation dialog to complete deletion
The Delivery Flow (from slip registration to delivery)
- Resident registers the slip number — After placing an order, register the slip number and expected arrival date in the app
- Delivery person arrives at the building — They scan the QR code posted at the entrance or navigate to the delivery verification page (
/deliver) - Delivery person enters the slip number — They type the slip number from the package and tap "Verify"
- Entrance PIN code is displayed — If the slip is valid, a PIN code valid for 3 minutes is shown on screen
- Delivery person enters the PIN to unlock the entrance — They type the PIN on the entrance keypad
- Package is delivered — The delivery person places the package at the designated spot
- Delivery is recorded in history — After delivery, a record is added to your delivery history in the app
The PIN code is valid for 3 minutes only. If it is not used within that time it expires automatically.
Viewing Delivery History (/history)
You can review a complete record of past deliveries.
Tap "History" in the bottom navigation to open the history page.
Information Displayed
| Column | Description |
|---|---|
| Date/Time | When the event occurred (delivery confirmation time, or authentication time if not yet confirmed). Timestamps are shown in the facility's local timezone (for example, Asia/Tokyo) |
| Slip Number | The delivery slip number that was used |
| Carrier | Yamato / Sagawa / Japan Post / Amazon / Other |
| Status | One of the five statuses below |
Delivery Status Types
Each history entry displays a status badge with a color-coded icon:
| Status | Icon | Color | Meaning |
|---|---|---|---|
| Delivered | package | Green | The delivery person authenticated with the slip number and unlocked the entrance |
| Confirmed | checkmark | Green | The delivery was confirmed automatically via the KEYVOX lock sensor (the package was placed and the door was closed) |
| Likely delivered | package | Yellow | Another slip's PIN was used to unlock the entrance at the same facility on the same day, so this package was likely delivered at the same time |
| Cancelled | trash | Gray | The slip number was cancelled before delivery |
| Expired | clock | Red | The slip number reached its expiration date without being used |
Note: "Confirmed" status is set automatically when the building's KEYVOX smart lock detects that the delivery door was opened and closed after the delivery. You do not need to take any action — the system updates the status for you.
About "Likely delivered": When a delivery person uses one slip's PIN to unlock the entrance, other active slips at the same facility on the same day may also have been delivered at the same time. Those slips are automatically marked as "Likely delivered". If the carrier's system later sends a webhook confirming the exact slip, the status is automatically upgraded to "Confirmed".
My Page (/mypage)
Tap "My Page" in the bottom navigation to open your account information page.
Information Displayed
| Item | Description |
|---|---|
| Email Address | The email address used to log in |
| Name | The name entered at registration (editable) |
| Facility Name | Name of the facility where you live |
| Room Name | Your registered room name |
| Registration Date | When you registered for the room |
Changing Your Name
- Tap the pencil icon (✏️) shown next to your name
- The name field becomes editable
- Enter your new name and tap "Save"
- Tap "✕" to cancel without saving
Move-Out Procedure
To deregister from your room, tap the "Move Out" button on My Page.
Steps to move out:
- Tap the "Move Out" button (the capsule-shaped button near the bottom of the page)
- A confirmation modal appears — please read it carefully:
- All registered slip numbers will be invalidated immediately
- Re-registering for the same room in the future will require the property manager's approval
- To confirm, tap "Move Out" (the red button)
- To cancel, tap "Cancel"
- After move-out is processed you are signed out and redirected to the registration page
Note: After moving out, re-registering for the same room requires the property manager to reset the room registration. Please contact the manager before proceeding.
Installing as an App (PWA)
This service supports PWA (Progressive Web App) installation. You can add it to your smartphone's home screen and launch it like a native app from that point on.
Android
After logging in, an install banner appears at the bottom of the screen.
- Tap "Install"
- Tap "Install" or "Add" in your browser's confirmation dialog
- An app icon is added to your home screen
iOS (Safari)
On iOS, tapping "Install" on the banner shows step-by-step instructions.
- Tap the share button at the bottom of Safari (the box with an upward arrow)
- Select "Add to Home Screen"
- Tap "Add" in the top-right corner to finish
On iOS, you must use the Safari browser. Other browsers such as Chrome may not support adding to the home screen.
FAQ
Q: I see "Facility not found"
A: This message appears when the URL you opened does not match any registered facility. Please check the following:
- Make sure you are using the latest QR code. If the property manager changed the facility slug, any older QR codes are no longer valid.
- If you typed the URL manually, verify that the slug part is spelled correctly.
- Contact the property manager and ask them to resend the correct QR code or registration URL.
Q: I did not receive the verification code email
A: Please check the following:
- Look in your spam or junk mail folder
- Verify that you entered your email address correctly
- Wait a moment and tap "Resend" to request a new code
Q: I see "This room is already registered"
A: Another resident has already registered this room. Please contact the property manager and ask them to process the previous resident's move-out, then try registering again.
Q: I entered a slip number but see "This slip cannot be registered."
A: The slip number you entered does not contain enough digits. The delivery service requires a sufficient number of digits in the slip number to generate an entrance PIN. Only the digit characters are counted — hyphens and other separators are ignored (for example, 1234-5678-9012 contains 12 digits and is valid). If your slip number has very few digits, please verify the correct slip number with your carrier.
Q: A delivery was completed but it does not appear in my history
A: History records are created when a delivery person authenticates using a slip number (entrance unlock). If the delivery person entered via a different route without using the slip number, no record is created. Please contact the property manager if you believe a delivery occurred without a record.
Q: My history shows "Delivered" but not "Confirmed" — is something wrong?
A: No, this is normal. "Delivered" means the delivery person successfully authenticated and unlocked the entrance. "Confirmed" is an additional status that appears when the building's KEYVOX smart lock sensor automatically detects the completion of the delivery (the delivery door being opened and closed). If your building does not have this sensor feature enabled, entries will remain as "Delivered".
Q: My history shows "Likely delivered" — what does that mean?
A: "Likely delivered" means that on the same day, a delivery person used another resident's slip PIN to unlock the entrance at your building, so your package was probably delivered at the same time. This happens when a delivery person brings multiple packages in one trip and only enters a single slip number.
Please check whether your package has actually arrived. If the carrier's system later sends a formal delivery confirmation for your slip, the status will be automatically upgraded to "Confirmed".
Q: Why does my history show "Expired" entries?
A: "Expired" entries appear when a slip number reached its expiration date without being used by a delivery person. If you still expect the package, register a new slip number with an updated expiration date.
Q: What if I get logged out?
A: If your session expires and the login screen appears, your registration data (room, slip numbers, delivery history) is not lost. On a device where you have signed in before, the screen shows a "Welcome back" message and your email address is already pre-filled. Simply tap "Send Verification Code", enter the code you receive, and you will be back on the home screen with everything intact.
Q: I restarted the app and my session was gone
A: In normal use the app restores your session automatically on restart. However, if you are using private browsing (incognito) mode, sessions are not saved and you will need to log in every time. If you cleared your browser cookies or cache manually, the same applies.
We recommend installing the app as a PWA in a normal browser window to keep sessions persistent. Even if your session expires, your registration data is never affected — the "Welcome back" screen means you just need to verify your email again.
Q: After logging back in, are my slip numbers and delivery history still there?
A: Yes. Session state (authentication) and your stored data are completely separate. Slip numbers, delivery history, and room information are all saved on the server and are not affected by a session expiry. Everything will be exactly as you left it as soon as you log back in.
Q: I scanned the QR code again and was taken straight to the home screen — is that correct?
A: Yes, that is the expected behavior. If you are already registered in a room and your session is active, scanning the QR code again skips re-registration and takes you directly to the home screen. If you scan a QR code for a different room or facility, you will be shown the normal registration flow.
Q: My old room registration is still showing after I moved out
A: Please use the "Move Out" button on My Page to deregister, or ask the property manager to process your move-out. Once processed, all registered slip numbers are invalidated and the room registration is removed.
Q: What happens to slip numbers after their expiration date?
A: Expired slip numbers are automatically invalidated. Delivery personnel will not be able to use them. If a package has not yet arrived, re-register the slip number with a new expiration date.
Q: I have multiple packages arriving. Do I need to register each one?
A: Yes. If each package has a different slip number, each must be registered separately. Even if multiple packages come from the same carrier, they each have their own slip number and must be added individually.
Q: I moved out and then moved back in. Can I re-register?
A: After moving out, re-registering for the same room requires the property manager to reset the room registration. Please contact the manager and ask them to issue a new registration QR code or URL.
Related Pages
- Delivery Management - Administrator guide for room setup, QR code generation, and delivery history review