Difference between revisions of "Nuki.io"

From Beds24 Wiki
Jump to navigation Jump to search
Line 9: Line 9:
 
For Beds24 the normal channel manger fees apply.
 
For Beds24 the normal channel manger fees apply.
  
== Capabilities ==
+
= Capabilities =
 
*Beds24 can send booking data to Nuki locks.
 
*Beds24 can send booking data to Nuki locks.
 
*Auto-Check-in: when a lock is first opened by the guest the info code "CHECKIN" will be added to the booking.
 
*Auto-Check-in: when a lock is first opened by the guest the info code "CHECKIN" will be added to the booking.
  
== Limitations ==
+
= Limitations =
 
*Currently only keypad authentication is supported.
 
*Currently only keypad authentication is supported.
  
== Set Up ==
+
= What you need =
 +
To use this service you will need:
 +
*A Nuki Smart Lock.
 +
*A Nuki Keypad.
 +
*A [https://nuki.io nuki.io] account.
 +
 
 +
= Set Up =
 
To use this service you will need:  
 
To use this service you will need:  
 
*A Nuki Smart Lock.
 
*A Nuki Smart Lock.
Line 38: Line 44:
 
[[Media:nuki_mapping.png|view large]]
 
[[Media:nuki_mapping.png|view large]]
  
== How it works ==
+
= How it works =
 
Bookings are sent to locks "Days in Advance" prior to check-in.  
 
Bookings are sent to locks "Days in Advance" prior to check-in.  
 
*An entry code/user named Booking:{booking number} is added to the lock, viewable at [https://web.nuki.io/#/pages/smartlocks web.nuki.io] or in the Nuki app.
 
*An entry code/user named Booking:{booking number} is added to the lock, viewable at [https://web.nuki.io/#/pages/smartlocks web.nuki.io] or in the Nuki app.
Line 45: Line 51:
 
If the keypad code, booking dates, or room changes, those details will be sent to locks.
 
If the keypad code, booking dates, or room changes, those details will be sent to locks.
  
If a booking is cancelled the associated entry code will be deleted from locks.
+
Entry codes/users can only be used during the booking period, they will not provide access before or after.
  
Entry codes/users can only be used during the booking period, they will not provide access before or after.
+
The associated entry code of bookings sent from Beds24 will be removed one day after check-out.
 +
 
 +
If a booking is cancelled the associated entry code will be deleted from locks.  
  
 
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span>  If a Nuki lock is offline when an update is sent, the entry code will not be added until the lock comes online again.
 
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span>  If a Nuki lock is offline when an update is sent, the entry code will not be added until the lock comes online again.
  
== Manually changing pins ==
+
= Manually changing pins =
 
# Navigate to Account, Preferences, Bookings, and add "NUKI_PIN" to your Booking Info Code Values.
 
# Navigate to Account, Preferences, Bookings, and add "NUKI_PIN" to your Booking Info Code Values.
 
# You can now manually add a NUKI_PIN info code to your bookings.
 
# You can now manually add a NUKI_PIN info code to your bookings.
 
[[Image:nuki_set_pin.png|x300px|link=]]
 
[[Image:nuki_set_pin.png|x300px|link=]]
 
[[Media:nuki_set_pin.png|view large]]
 
[[Media:nuki_set_pin.png|view large]]
=== Nuki pin limitations ===
+
== Nuki pin limitations ==
 
Nuki keypad codes must:
 
Nuki keypad codes must:
 
# Be exactly six digits long.
 
# Be exactly six digits long.
Line 62: Line 70:
 
# Not start with "12".
 
# Not start with "12".
  
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span>  If you manually set an invalid NUKI_PIN, it will be overwritten with a randomly generated pin the next time bookings are sent to locks.
+
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span>  If you manually set an invalid NUKI_PIN, it will be overwritten with a randomly generated pin the next time bookings are sent to locks. Each code can only be used once per lock. Before you can reuse a code it has to be removed from the lock.
 +
 
 +
= Information sent to guests =
 +
== Keypad codes ==
 +
For keypad entry code bookings, Nuki does not send any information to guests.
 +
 
 +
You can create an Auto Action in {{#fas:cog}} (SETTINGS) GUEST MANAGEMENT > AUTO ACTIONS.
 +
 
 +
The template variable for the pin is [BOOKINGINFOCODETEXT:NUKI_PIN].
  
== Information sent to guests ==
+
== App access ==
=== Keypad codes ===
 
* For keypad entry code bookings, Nuki does not send any information to guests.
 
=== App access ===
 
 
(not currently supported)
 
(not currently supported)
 
* For app access bookings, Nuki will automatically send an email to guests that provides access via the Nuki app.
 
* For app access bookings, Nuki will automatically send an email to guests that provides access via the Nuki app.
Line 76: Line 89:
 
[[Media:nuki_delete_user.png|view large]]
 
[[Media:nuki_delete_user.png|view large]]
  
== Disconnect==
+
= Disconnect=
 
Click on "Disconnect" to terminate the connection.
 
Click on "Disconnect" to terminate the connection.

Revision as of 10:02, 16 July 2020

Nuki COMING SOON!
 This page is about the menu  (SETTINGS) APPS & INTEGRATIONS > NUKI

Contact us if you want to participate in the beta test.

For Beds24 the normal channel manger fees apply.

1 Capabilities

  • Beds24 can send booking data to Nuki locks.
  • Auto-Check-in: when a lock is first opened by the guest the info code "CHECKIN" will be added to the booking.

2 Limitations

  • Currently only keypad authentication is supported.

3 What you need

To use this service you will need:

  • A Nuki Smart Lock.
  • A Nuki Keypad.
  • A nuki.io account.

4 Set Up

To use this service you will need:

  • A Nuki Smart Lock.
  • A Nuki Keypad.
  • A nuki.io account.


  • Click on "Connect to Nuki".
  • Sign in with your Nuki account if prompted.
  • Click "Allow" to let Beds24 view and manage your Nuki account and locks.

Nuki auth.png view large

  • The "Start Time" and "End Time" define the earliest Check-in time and latest Check-out time.
  • The "Days in Advance" sets the days before check-in that the booking is sent to the lock.
  • Click on "Get Codes"

You will see one identifier and name for each lock. Click on the name of the lock that is associated with the room.

Nuki mapping.png view large

5 How it works

Bookings are sent to locks "Days in Advance" prior to check-in.

  • An entry code/user named Booking:{booking number} is added to the lock, viewable at web.nuki.io or in the Nuki app.
  • A booking info code named NUKI_PIN is created which will show the pin number valid for the booking.

Updates are sent periodically. To instantly send updates, click "Send Bookings to Locks". If the keypad code, booking dates, or room changes, those details will be sent to locks.

Entry codes/users can only be used during the booking period, they will not provide access before or after.

The associated entry code of bookings sent from Beds24 will be removed one day after check-out.

If a booking is cancelled the associated entry code will be deleted from locks.

If a Nuki lock is offline when an update is sent, the entry code will not be added until the lock comes online again.

6 Manually changing pins

  1. Navigate to Account, Preferences, Bookings, and add "NUKI_PIN" to your Booking Info Code Values.
  2. You can now manually add a NUKI_PIN info code to your bookings.

Nuki set pin.png view large

6.1 Nuki pin limitations

Nuki keypad codes must:

  1. Be exactly six digits long.
  2. Not contain the number zero.
  3. Not start with "12".

If you manually set an invalid NUKI_PIN, it will be overwritten with a randomly generated pin the next time bookings are sent to locks. Each code can only be used once per lock. Before you can reuse a code it has to be removed from the lock.

7 Information sent to guests

7.1 Keypad codes

For keypad entry code bookings, Nuki does not send any information to guests.

You can create an Auto Action in (SETTINGS) GUEST MANAGEMENT > AUTO ACTIONS.

The template variable for the pin is [BOOKINGINFOCODETEXT:NUKI_PIN].

7.2 App access

(not currently supported)

  • For app access bookings, Nuki will automatically send an email to guests that provides access via the Nuki app.
  • Guests have 48 hours to accept the invitation.
  • There is no way to resend a Nuki app invitation if a guest does not accept it in time. However, you may go to web.nuki.io, select Devices, click the desired smartlock, go to the Users tab, then find the booking and click delete. You can then visit the Beds24 Nuki integration tool and click "Send bookings to Locks" to make Nuki send a new invitation to the guest.

Nuki delete user.png view large

8 Disconnect

Click on "Disconnect" to terminate the connection.