Электронный ключ и проживание

Если на дверях номеров стоят замки с кодовой клавиатурой, гость может получить свой код от двери на даты проживания. Код выдаётся, продлевается и снимается сам — при заселении, переселении, смене дат и выезде. Свои замки мы не делаем: система работает через облако вендора, у которого заведены ваши замки.

Кому: владельцу отеля (подключение) и стойке (ключи гостей).

Где: «Номера» → «🏷️ Типы номеров» → окно «Настройки отеля», вкладка «Номера и типы», блок «Замки и цифровые ключи».

Какие замки подходят#

Вендор	Что нужно	Какой код получает гость
TTLock	Замки заведены в приложении TTLock	Замок со шлюзом (например, G2) — собственный 7-значный код, его можно изменить и снять. Замок без шлюза — офлайн-код на даты: снять раньше срока нельзя, гость должен набрать его в первые 24 часа
Nuki	Замки в Nuki Web, у каждого — спаренная клавиатура Nuki Keypad и Bridge или встроенный Wi-Fi	Код клавиатуры из 6 цифр на окно проживания; изменить и снять можно всегда

Других вендоров нет. Замки отельных систем (Salto, dormakaba, Vostio и подобные) не подключаются. Ключ в приложении TTLock (eKey) не выдаётся — только код.

Подключить аккаунт замков#

Подключает только владелец аккаунта. Стойке экран скажет: «Подключение замков и карту номеров меняет только владелец аккаунта.»

Откройте блок «Замки и цифровые ключи».
В «Вендор замков» выберите TTLock или Nuki.
TTLock: введите «Аккаунт приложения TTLock (почта или телефон)» — тот, где заведены замки отеля, «Пароль аккаунта TTLock» и «Регион сервера». Нажмите «Войти». Пароль нужен один раз: система сразу меняет его на доступ и пароль не хранит. Регистрировать у TTLock своё приложение не нужно.
Nuki: нажмите «Войти через Nuki», войдите в Nuki Web и разрешите доступ к устройствам и авторизациям. Вы вернётесь в блок, появится «Аккаунт Nuki подключён». Запасной путь — «API-токен Nuki Web»: создайте его в Nuki Web → API с правом просмотра устройств и управления авторизациями.
Нажмите «Проверить и загрузить замки». Должно появиться «Подключение работает — найдено замков: N». У замка видно: «на связи» или «не на связи — коды не дойдут до замка», заряд батареи, «со шлюзом» или «без шлюза — офлайн-коды».

Если вместо входа видно «Ждёт подключения платформы к …» — см. границу готовности.

Привязать замки к номерам#

В блоке «Номера и замки» у каждого номера выберите «Замок» из загруженного списка или «— без замка —».
Нажмите «Сохранить карту номеров». Появится «Карта номеров сохранена».

Один замок — одному номеру: занятый замок другому номеру не отдаётся («Этот замок уже привязан к другому номеру.»). Гостю, который уже живёт в номере, где вы только что поставили замок, код выдаётся сразу.

Когда гость получает код#

Задайте в «Когда выдавать код»:

«При заселении» (по умолчанию) — код выдаётся, когда стойка заселяет гостя;
«После анкеты и оплаты (бесконтактный заезд)» — код выдаётся не раньше чем за сутки до заезда, когда анкета до приезда принята, а бронь оплачена или гарантирована.

Нажмите «Сохранить».

Код действует с времени заезда до времени выезда по часам отеля. Купленный ранний заезд или поздний выезд сдвигают это окно. Заселили раньше — код начинает действовать сразу.

Где гость видит код. Только на приватной странице проживания — по ссылке из письма или SMS о брони. В самом письме кода нет. Страница покажет код не раньше чем за сутки до начала его действия. Для офлайн-кода TTLock страница попросит набрать его на замке до указанного срока.

Стойке код в списке не показывается. Чтобы продиктовать его гостю, нажмите «Показать код» в строке брони.

Переселение, продление и выезд#

Что произошло	Что делает система
Переселение в другой номер	Сначала выдаёт код нового номера, потом снимает старый. Старый работает ещё «Сколько работает старый код после переселения, минут» — по умолчанию 60, от 0 до 1440
Продление или смена дат	Сдвигает окно кода. Офлайн-код TTLock сдвинуть нельзя — выдаётся новый, старый доживает свои даты
Выезд, отмена, неявка	Снимает код. Офлайн-код TTLock снять раньше срока нельзя — он работает до конца своих дат, панель пишет «Старый код работает до …»

Правки брони на стойке доходят до замка сразу. Правки, сделанные гостем на сайте, и брони каналов система подхватывает при плановой проверке — в пределах 15 минут.

Перевыпустить или отозвать код#

В списке «Ключи гостей» — строка на бронь: номер, статус, «Действует» (окно). Кнопка «Обновить» перечитывает список.

«Перевыпустить» — выдать новый код. Текущий перестанет работать сразу (у замка без шлюза — в конце своих дат). Пригодится, если гость сообщил код постороннему или офлайн-код не набрали в первые 24 часа.
«Отозвать» — снять код и не выдавать его этой брони, пока вы не нажмёте «Перевыпустить». Строка получит пометку «Отозван стойкой».

Оба действия просят подтверждения.

Статусы и неоднозначный ответ#

Статус	Что значит
«Выдан»	Код на замке
«Выдаётся»	Код отправлен вендору, ответ ещё не пришёл или был неоднозначным
«Не выдан»	Вендор отказал или три попытки не прошли. Стойке ставится задача на доске смены
«Отозван»	Код снят
«Ключа нет»	Код не нужен: номер без замка, бронь ещё не заселена, окно кончилось

Если связь оборвалась посреди выдачи, код мог дойти до замка, а мог и нет. Система это помнит: перед новой попыткой она ищет у вендора код этой попытки. Нашёлся — берёт его, а не создаёт второй. Не нашёлся — выдаёт заново. Под строкой видно «Попыток: …; следующая …; ошибка …».

Не получилось снять код (замок не на связи) — система повторяет, пока вендор не подтвердит, и ставит задачу стойке.

Граница готовности#

Честно о том, что проверено, а что нет:

Вход TTLock и «Войти через Nuki» работают, когда платформа подключена к вендору. Пока этого нет, блок пишет «Ждёт подключения платформы к …» и вход недоступен. Nuki на это время можно подключить API-токеном Nuki Web. TTLock до подключения платформы не подключается.
На реальных замках интеграция пока не проверялась — ни TTLock со шлюзом, ни Nuki с клавиатурой. Логика выдачи, продления и отзыва проверена тестами по документации вендоров. Перед тем как давать коды всем гостям, проверьте весь цикл — заселение, продление, переселение, выезд — на одном номере с тестовой бронью.
Замки старых моделей TTLock со старыми алгоритмами кодов не поддерживаются: вендор отклонит запрос.
Отключить аккаунт можно кнопкой «Отключить». Уже выданные коды работают до конца своих дат, новые выдаваться не будут.

Связанные разделы#

Частые вопросы#

Гость не может открыть дверь офлайн-кодом.#

Офлайн-код замка без шлюза надо набрать хотя бы раз в первые 24 часа от начала его действия, иначе замок его отключит. Прошло больше суток — нажмите «Перевыпустить» и дайте гостю новый код.

Можно ли сразу отключить код выехавшего гостя?#

Да, если замок со шлюзом (TTLock) или это Nuki — код снимается при выезде. Офлайн-код замка без шлюза работает до конца своих дат; если нужен немедленный отзыв, нужен шлюз.

Где гость видит код — в письме?#

Нет. В письме ссылка на страницу проживания, код — на ней.

Нужно ли регистрировать своё приложение у TTLock или Nuki?#

Нет. Приложение у вендора одно на платформу, отель только входит своим аккаунтом.

Стойка видит код гостя?#

Только по кнопке «Показать код» — чтобы продиктовать. В списке ключей кодов нет.