×

Rental Ninja Help Center Help

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

  1. Navigate to Settings > Devices.

  2. 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., Smart Lock, Opener for Nuki devices).

Status

Indicates if the device is currently online or offline.

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 open or closed. This is distinct from the lock's state (locked/unlocked).

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 View Actions button will provide details on these errors.

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 or unlocked (or unlatched).

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:

  1. Permanent Authorizations: Designed for your team members.

  2. 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.

  1. Navigate to Authorizations: Go to Authorizations in your Rental Ninja dashboard.

  2. Create New Authorization: Click the New Authorization button.

  3. Select User: Choose the team member or individual for whom you are creating the access.

    ![Permanent Authorizations for Cleaners or Maintenance Staff](https://public.rental-ninja.com/content/help-center/videos/2025/06/17/8b114fe8e72b40fd8720c81d1abddb11/key_point_at_18917s_so_for_example_you_may_wish_to_create_an_access_for_a_person_who_is_a_cleaner_or_189.167.jpg?w=640 Description: Screenshot showing the selection of a user for a permanent authorization, emphasizing its use for staff like cleaners or maintenance.

  4. Set Timeframe: Define the start and end date and time for the authorization. For a "permanent" authorization, you can set a very distant end date.

  5. Create Access: Click Create.

The authorization will be created and automatically synchronized with your smart lock provider (e.g., Nuki). You will see it listed within your smart lock provider's web interface.

Viewing Your Authorizations

To view authorizations assigned to you:

  1. Go to the My Authorizations section.

  2. 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.

![Keypad Authorization Code vs. App Authorization](https://public.rental-ninja.com/content/help-center/videos/2025/06/17/8b114fe8e72b40fd8720c81d1abddb11/key_point_at_37833s_so_thats_why_you_have_here_the_code_and_you_have_it_says_apple_authorization_no__378.333.jpg?w=640 Description: Screenshot illustrating the authorization code field, distinguishing between 'Keypad authorization' and 'App authorization' (referred to as 'Apple authorization' in the UI for Nuki).

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.

  1. 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.

  2. Automated Email Delivery: Once the configured payment threshold is met, Rental Ninja will automatically email the access instructions to the guest.

  3. 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.

  1. Locate Booking: Go to the specific booking.

  2. Access Device Section: In the booking details, navigate to the Devices section.

  3. 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.

  1. Locate Booking: Go to the specific booking.

  2. Access Device Section: In the booking details, navigate to the Devices section.

  3. 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 the Alerts 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.

04 July 2025