Dormakaba E-Codes | How to Connect

The Dormakaba E-codes integration lets Duve generate a numeric access code for each reservation, straight from your Dormakaba e-code site, and deliver it to the guest without any front desk handover.

Here is what the integration does:

• Duve pulls the full door list from your Dormakaba site and saves each door as a key in Duve.
• You categorize each door (guest door, entrance, common door) and assign the guest doors to the matching rooms or rentals in Duve.
• When the key release automation fires for a reservation, Duve asks Dormakaba for a code for that room's door, using the reservation's check-in and check-out dates.
• The room code is written to the reservation's primary access code field, and a common door code, when Dormakaba returns one, is written to the secondary access code field.
• The guest sees the codes in the Guest app and in any message that includes the access code placeholders, once the codes are released.

This integration supports Dormakaba wireless e-code locks, Oracode versions 480i to 660. Hardware outside that range is not supported.

Two further points are worth knowing up front, because they are the most common source of confusion:

• Duve sends Dormakaba the stay dates only. The hours a code is valid on those dates come from the time frames configured per door in your Dormakaba account, not from Duve's check-in and check-out hours.
• Dormakaba E-codes issues codes only. It does not issue mobile keys or wallet keys. Those run through the separate Dormakaba (Ambiance) and Dormakaba Wallet integrations.

Use cases

• Give every guest a room code automatically, so arrivals work with no key collection and no front desk queue.
• Give guests a second code for a shared entrance, lobby or other common door, either for everyone or only for specific rentals.
• Sell early check-in and late checkout in Duve and have the access code reissued with the matching Dormakaba user level, so the code actually opens the door at the earlier or later hour.
• Keep codes correct when operations change a reservation, since Duve reissues the code after a room move or a change of stay dates.
• Let the front desk release or revoke a single reservation's code manually from the Tasks page.

Before you start

• Make sure your locks are in the supported Oracode range listed above.
• Open your Dormakaba account and copy your Site Name and your username from the top right corner.
• Email support@duve.com with those details. Duve coordinates the connection with Dormakaba and confirms when your site is ready. Do not add the key provider in Duve before you get that confirmation, because the credentials check will fail.
• In Dormakaba, review the time frames set for your doors. These time frames decide the hours a generated code works, including for early check-in and late checkout, so they must be wide enough to cover the earliest arrival and the latest departure you sell.
• Make sure every door in Dormakaba has a clear, final name. Duve identifies each door by its Dormakaba door name, so renaming a door later creates a new key in Duve and breaks the room that was mapped to the old name.

How to set it up

1. Add the key provider in Duve

• Go to Settings, open the Connections tab, and open the Key providers sub tab.
• Add a new key provider and choose Dormakaba E-codes from the provider list.
• Enter your Site Name in the single credentials field. This connection does not use a username, so no user field is shown.
• Optionally rename the connection so it is easy to recognize if you manage several sites.
• Click Add. Duve verifies the credentials by requesting the door list from Dormakaba, so a successful save also means your site is reachable and has doors.

2. Sync your doors

• Open the saved connection to reach its key provider page.
• Open the actions menu at the top of the keys grid and choose Sync locks.
• Duve creates one key per door returned by Dormakaba, with the door name used as both the key name and the door ID.

3. Categorize each door

• Click a row in the keys grid to open it, then set its Door category.
• Use Guest door for doors that belong to a single room or rental.
• Use Entrance or Common door for shared doors such as a building entrance, a lobby or a pool gate.
• Use Other for anything that should not be offered to guests.
• This step matters: only doors categorized as Guest door appear in the key list on the room page, so a miscategorized door cannot be assigned to a room.

4. Set up extra door access

• In the Extra door access section, use Allow all guests the keys to pick the common doors every guest should receive.
• To limit a common door to part of your inventory, add a row below and select the tags it applies to, then the keys those guests should get. A door that is already granted to all guests is removed from the per tag lists automatically.
• Click Add new to create more tag based rows.

5. Choose when codes are released

• On the key provider page, set Auto release by reservation status and pick the booking status that should trigger the release.
• Duve generates and stores the code when that trigger fires, and marks the reservation as allowed to show keys.
• You can also release a code for a single reservation manually from the Tasks page, as described below.

6. Assign a key to every room

• Go to the Rooms or Rentals page and open a room.
• In the Key provider section, select your Dormakaba E-codes connection, then select the room's door from the key list.
• Save. Repeat for every room that should issue codes.

Host experience

• Codes are stored on the reservation and shown in the access codes section of the reservation page. The first field holds the room code and the second holds the common door code. The field labels follow the code type set on the room, so the first field reads Door code by default and can also read Access code, Lock box code, Key box code or Apartment code, and the second reads Building code by default and can also read Hallway code, Entrance code, Lobby code or Door code.
• On the Tasks page, the key icon on each reservation row opens the key actions. Use it to allow keys for a reservation that has not been released yet, or to revoke keys that were already released.
• The same row menu holds Release codes and Hide codes, which force the codes to show or stay hidden for that reservation regardless of your account wide access code visibility rules.
• Your account wide rules still apply to everyone else. Codes can be set to always show, to show only from a chosen number of days before check-in and from a chosen hour, to show only at a specific PMS reservation status, or to show only manually. You can also hide codes for same day reservations, or require that online check-in is completed, or that the required documents were uploaded, before any code is shown.

Early check-in and late checkout

• Duve sends Dormakaba the stay dates. The hours a code works come from the time frames in your Dormakaba account, so those time frames must already cover the earliest arrival and the latest departure you allow.
• When a guest buys early check-in or late checkout as an upsell in Duve and the order is confirmed, Duve requests a new code for the room and sends Dormakaba the matching user level, 1 for early check-in and 2 for late checkout. A standard stay uses user level 0.
• The new code replaces the one stored on the reservation, so the guest must look at the Guest app again for the current code.

Stay date changes and extensions

• When stay dates change, Duve requests a new code for the new dates and updates the reservation.
• The previous code is replaced, so a code you already sent by email or SMS is no longer the right one. Point the guest to the Guest app, or send the arrival message again.

Room reallocations

• When a reservation moves to another room, Duve automatically renews the code against the new room's door.
• The old code is no longer the guest's code, so you must send the new code to anyone who already received the old one.

Guest experience

• Once released, the guest sees the room code, and the common door code when one exists, in the Guest app alongside the rest of the arrival information.
• The codes are also included in arrival messages that use the access code placeholders.
• If a code is replaced after a room move, a date change or an early check-in or late checkout purchase, the Guest app always shows the current code, so direct guests there rather than to an older message.

Troubleshooting

• No code was generated: check that the room has a key assigned in the Key provider section, that the door is categorized as Guest door, and that the reservation has reached the booking status set in Auto release by reservation status.
• The door is missing from the room's key list: it is not categorized as Guest door, or it has not been synced yet. Fix the category or run Sync locks again.
• The connection fails to save: Duve validates by fetching the door list, so this usually means the Site Name is wrong or Dormakaba has not finished enabling your site for Duve.
• The guest says the code does not work: confirm the code on the reservation is the current one, since a room move, a date change or an early check-in or late checkout order replaces it, and confirm the Dormakaba time frame for that door covers the hour the guest is trying to enter.
• A door disappeared from the keys grid or lost its room: it was most likely renamed in Dormakaba. Map the room to the new door name.

Restrictions and limitations

• Codes are requested per stay date, not per hour. Duve has no control over the hours a code works, only over the dates.
• Duve's own check-in and check-out hours do not change code validity. Only the Dormakaba time frames do.
• Only doors categorized as Guest door can be assigned to a room.
• Each door is identified by its Dormakaba door name, so renaming a door in Dormakaba breaks the link to the room it was mapped to.
• This integration generates codes only. Mobile keys and Apple or Google wallet keys are not available through Dormakaba E-codes.
• Supported hardware is limited to Oracode versions 480i to 660.

Tips and tricks

• Name doors in Dormakaba exactly as you want them to read in Duve, and freeze the names before you map rooms.
• Use tags for common doors whenever a shared door belongs to one building or one floor, rather than granting it to all guests.
• Set the code type on each room so the label the guest sees matches reality, for example Key box code instead of Door code.
• After any room move or date change, use the arrival message rather than a manual copy and paste, so the message always carries the current code.
• If a guest needs a code before your release status is reached, use Release codes on that single reservation instead of changing your account wide rule.

FAQs

Q: Do I need a username as well as a Site Name to connect?

A: No. The Dormakaba E-codes connection in Duve uses the Site Name only. You do need your username when you first email Duve support, so Duve can arrange the connection with Dormakaba.

Q: Where do I find the key providers settings?

A: In Settings, under the Connections tab, in the Key providers sub tab.

Q: Why does the code not work at the hour my guest arrives?

A: The hours come from the time frames in your Dormakaba account. Duve only sends the stay dates. Widen the Dormakaba time frames to cover the arrival hour.

Q: What happens to the code when a guest buys early check-in or late checkout?

A: Duve requests a new code with the matching Dormakaba user level, 1 for early check-in and 2 for late checkout, and saves it on the reservation in place of the old one.

Q: Does the guest keep the same code if I move them to another room?

A: No. Duve generates a new code for the new room and the old code stops being the guest's code, so you need to send them the new one.

Q: Can I stop a code from working before the guest checks out?

A: Yes. On the Tasks page, open the key menu on that reservation and revoke the keys.

Q: Can I give a code for a shared entrance only to some rentals?

A: Yes. In Extra door access, add a tag based row and select the tags and the keys that should be granted together.

Q: Why is a door missing when I try to assign it to a room?

A: The room key list only offers doors categorized as Guest door. Change the door's category on the key provider page and try again.

Q: How do I refresh the door list after adding a door in Dormakaba?

A: Open the key provider page, open the actions menu above the keys grid, and choose Sync locks.