Smart Lock Management and Access Control
Overview
This documentation provides a comprehensive guide to managing smart lock devices and controlling access within Rental Ninja. It covers both the automatic processes facilitated by Rental Ninja's system and the manual actions available for specific scenarios. While much of the smart lock operation is automated ("Rental Ninja's magic"), understanding the underlying mechanisms and available controls is crucial for effective property management.
Prerequisites
Before proceeding, ensure you have:
A connected smart lock provider account (e.g., Nuki).
Completed the initial smart lock setup and device mapping within Rental Ninja.
Note: These setup procedures are covered in separate tutorial sections.
Managing Smart Lock Devices
Your smart lock devices are visible and manageable within Rental Ninja, allowing you to monitor their status and identify any issues.
Viewing Device Status
Navigate to Settings > Devices.
Here, you will find a list of all your connected smart lock devices.
Each device entry displays the following information:
Field | Description |
---|---|
Name | The name of the device as registered with your smart lock provider. This is not the public-facing name. |
Provider Type | The type of device (e.g., |
Status | Indicates if the device is currently |
Battery Level | If supported by the device, this shows the current battery percentage. |
Door State | For devices with a door sensor, this indicates if the door is |
Mapping | Shows the rental unit to which the device is mapped. (Covered in a separate setup tutorial). |
Errors | The number of errors associated with the device. Clicking the |
Understanding Door State vs. Device Lock State
It is important to distinguish between:
Door State: Whether the physical door is open or closed, as detected by a separate sensor (if installed).
Device Lock State: Whether the smart lock mechanism itself is
locked
orunlocked
(orunlatched
).
Understanding Authorizations
Authorizations are the means by which access is granted to your smart locks, allowing users to operate them (open or close). Rental Ninja supports two primary types of authorizations:
Permanent Authorizations: Designed for your team members.
Booking Accesses: Designed for your guests.
Creating Permanent Authorizations
Permanent authorizations are ideal for granting access to recurring personnel, such as cleaners, maintenance staff, or property managers.
Navigate to Authorizations: Go to
Authorizations
in your Rental Ninja dashboard.Create New Authorization: Click the
New Authorization
button.Select User: Choose the team member or individual for whom you are creating the access.
. You will see it listed within your smart lock provider's web interface.
Viewing Your Authorizations
To view authorizations assigned to you:
Go to the
My Authorizations
section.You will only see authorizations explicitly assigned to your user account. Other team members will only see authorizations assigned to them.
Authorization Types and Access Methods
Depending on your smart lock device's capabilities and accessories, authorizations can support different access methods:
Keypad Authorization:
If your device is synchronized with a keypad (e.g., Nuki Keypad), a unique code will be generated.
Users can open the device by entering this code directly on the keypad.
App/Bluetooth Authorization:
If no keypad is present, or in addition to it, access can be granted via the smart lock provider's mobile application using Bluetooth.
The
URL
field in the authorization details will typically link to instructions for downloading the app and syncing with the device.
.
Managing Booking Accesses (Automatic)
Booking accesses are automatically created and managed by Rental Ninja for your guests, ensuring seamless check-ins and check-outs. This is a core part of the "Rental Ninja Magic."
Automatic Access Creation and Management
Once a smart lock device is mapped to a rental unit, Rental Ninja automates the following:
Access Creation: Booking accesses are created approximately two days before the guest's checking time (adjusting for time zones to ensure readiness).
Dynamic Adaptation:
Check-in/Check-out Time Changes: If you modify the checking or checkout times for a booking, the authorization times will automatically adapt.
Booking Date Modifications: If booking dates are changed (e.g., moved forward or backward), Rental Ninja will intelligently manage the accesses:
If a booking is moved to a later date, existing accesses for the old dates will be removed.
If a booking is moved to an earlier date (closer to today), new accesses will be created as needed.
Cancellation Management: If a booking is canceled, Rental Ninja will automatically attempt to remove the associated accesses from the smart lock.
Automatic Guest Information Delivery
Rental Ninja also automates the delivery of access information to your guests, subject to configurable payment thresholds.
Payment Threshold Configuration: You can configure the guest app settings to control when access information is revealed to the guest.
Navigate to Rental > Settings > Guest App.
Look for the setting that controls displaying codes and door information, typically based on a percentage of the booking payment.
Example: If set to
Do not show the code and door information unless 90% of the booking is paid
, the access details will only be emailed once this condition is met.Do not show the code and door information unless X% of the booking is paid.
Automated Email Delivery: Once the configured payment threshold is met, Rental Ninja will automatically email the access instructions to the guest.
Guest Portal Access: After the payment is fulfilled and the email is sent, the guest will be able to access the guest portal and view the detailed instructions for their smart lock access.
Note: Rental Ninja can combine multiple access types (e.g., smart lock and a fixed lockbox code) into a single, unified view for the guest.
Manual Authorization Management (Troubleshooting & Exceptions)
While Rental Ninja handles most authorization processes automatically, there are specific situations where manual intervention may be required.
Manually Deleting an Access
You may need to manually delete an access, for example, if a guest's trustworthiness is compromised or a booking requires special handling.
Locate Booking: Go to the specific booking.
Access Device Section: In the booking details, navigate to the
Devices
section.Delete Access: Identify the access you wish to delete and select the option to
Remove
it.
Important: If you manually delete a booking access, Rental Ninja will recognize this action and will not attempt to re-create that specific access for the same booking, even if the booking is still active and approaching. This is to respect your explicit decision to deny access.
Manually Creating or Resending Accesses
This action is useful in rare cases where an access was not automatically created or if a guest requires the access information to be resent.
Locate Booking: Go to the specific booking.
Access Device Section: In the booking details, navigate to the
Devices
section.Click
Create/Resend Accesses
Button: Locate and click the button designed for creating or resending accesses.
When to use this:
If an access that should have been created automatically is missing. This button will attempt to create all necessary accesses for the booking.
If the guest has lost the access information email or cannot find it in their guest portal, and you need to resend it. This will re-email all currently created accesses for that booking.
Note: In normal operation, you should not need to use this button as Rental Ninja performs these actions automatically.
Common Issues and Troubleshooting
Rental Ninja monitors smart lock devices and booking access creation, providing alerts for potential issues.
Device Offline
The most common reason for failed authorization creation is an offline device.
Behavior: If Rental Ninja attempts to create an authorization for an offline device, it will recognize the offline state, stop further attempts for that device, and mark it as offline.
Resolution: Rental Ninja cannot bring a device back online. You must physically ensure the device is online (e.g., check power, internet connection, or smart lock bridge status).
Reconnection: Once the device comes back online, Rental Ninja will automatically detect this and resume its operations, including creating any missing accesses or removing accesses for canceled bookings.
Alerts
Rental Ninja generates alerts to notify you of critical issues.
Missing Authorizations Alert:
Trigger: If Rental Ninja fails to create booking accesses by the day before check-in (e.g., due to an extended device offline state), an alert will be created.
Visibility: You can view bookings with alerts in your main dashboard view or filter for
missing authorizations
in theAlerts
section.
Low Battery Alarm:
Trigger: When a smart lock device's battery level drops to a low state.
Action: An alert will be created to warn you to replace or recharge the device's batteries.
Mobile Push Notifications: All alerts generated in Rental Ninja are also linked to push notifications on your mobile app, ensuring you are promptly informed.