Сервер интеграции HSU - ПО (HSU API) - Локальная установка

Программное обеспечение интеграции HSU (HSU API) разработано для двухсторонней интеграции со смежными системами, таким как PMS*, GRMS**, административные СКУД, системы видеонаблюдения, киоски самозаселения, системы телевидения. 

Архитектура HSU API поддерживает структуру, где сервер HSU HTLock выступает как основная система безопасности на объекте, так и обратную структуру, где сервер HSU HTLock является ведомым по отношению к другой системе СКУД на объекте. 
При этом поддерживаются множественные настраиваемые подключения смежных систем к серверу интеграции HSU.

Так, например, к серверу интеграции HSU может быть одновременно подключена PMS гостиницы и административная СКУД, отвечающая за охрану периметра объекта (шлагбаумы, турникеты). В такой настройке создаваемая гостевая карта в PMS будет автоматически транслирована в административный СКУД для открытия доступа гостю в разрешенные им зоны, которые управляются внешней для HSU системой. Одновременно сервер интеграции может послать сигнал о событии выдачи карты в GRMS отеля и систему телевидения отеля о произошедшем заезде гостя.
В последнем случае это снижает количество необходимых интеграций со стороны PMS. Сервер интеграции HSU, получив от PMS команду на выпуск нового ключа, произведет заезд гостя в смежных системах. А при отмене ключа в PMS гостиницы, команды выезда будут отправлены в подключенные к серверу интеграции HSU системы.

Сигналы заезда гостей не завязаны явно на PMS. Если заезд гостя будет оформлен непосредственно в сервере HTLock, сигнал о создании заезда тоже будет отправлен в смежные системы. Такой сигнал можно отправить и обратно в PMS, тогда в системе учета гостиницы появится событие безопасности, что создана гостевая карта в обход интеграции замковой системы и PMS гостиницы.

В сценарии, где системы HSU являются ведомыми по отношению к другой системе (например, административная СКУД), сервер интеграции HSU может принять команду на создание ключа для определенного замка. К примеру, большая часть здания управляется административной СКУД, но имеется ряд помещений, в которых установлены замки HSU. При создании пользователя в административной СКУД она отправляет команду на выдачу разрешения пользователю для прохода в помещения, где установлены замки HSU. События же проходов гостей/сотрудников могут быть переданы обратно из сервера интеграции HSU в систему административной СКУД.

Сервер интеграции HSU работает под управлением операционной системы Linux, для управления и настройки предусмотрен веб-интерфейс.

Предусмотрена как локальная установка сервера интеграции HSU, так и облачная архитектура для отелей, не нуждающихся в поддержке локальных серверов. Например, если отель использует облачную PMS нет нужды в локальном развертывании сервера интеграции, таким отелям подойдет облачный сервер интеграции HSU.

Неполный список возможностей сервера интеграции HSU

Настройка

• Автоматическая синхронизация зданий, комнат, замков с сервером HSU HTLock.
• Автоматическая загрузка списка энкодеров из сервера HTLock.
• Синхронизация списка гостей сервера интеграции и сервера HTLock.

Входящие события

• Чтение карты гостя с возвратом имени гостя, комнаты, периодом проживания, зонами доступа карты.
• Создание нового заселения и копии заселения. В HSU API поддерживаются следующие типы заселений:
  • Офлайн карта – классический способ заселения для гостиничной СКУД. Вся информация о проживании записывается на карту, замок считывает карту и принимает решение о доступе. При создании офлайн карты возможно указание трех дополнительных комнат и двух зон доступа. Доступно как для замков, находящихся как в автономном, так и для замков, находящихся в онлайн режиме.
  • Онлайн карта – номер карты передается в замок. Доступно, если замок работает в онлайн режиме.
  • Мобильное приложение – для открытия замка по Bluetooth с телефона. Доступно как для замков, находящихся как в автономном, так и для замков, находящихся в онлайн режиме.
  • Онлайн код доступа – произвольный код из внешней системы передается на замок или на контроллер доступа с кодовой панелью. Доступно только для замков, находящихся в онлайн режиме.
  • Офлайн код доступа – код, создаваемый динамически. Для замков и контроллеров доступа с кодовой панелью. Созданный севером HTLock код передается в успешном ответе сервера интеграции HSU. Доступно как для замков, находящихся как в автономном, так и для замков, находящихся в онлайн режиме.
• Выезд. Поддерживается как выезд всей комнаты, так и конкретного гостя.
• Создание мастер-карты, карты здания и карты этажа.
• Создание мультидверной карты (офлайн карта, отрывающая до 100 замков).
• Запрос списка зданий и списка комнат, настроенных в HTLock.
• Запрос информации по гостям, заселенным в комнаты севера HTLock.
• Запрос событий открытия замка за период для анализа журнала во внешней системе.
• Удаленное открытие замка.

Исходящие события (push сообщения)

Исходящие события построены по принципу webhook и SSE. Для некоторых систем созданы собственные обработчики, для создания событий в формате API этих систем.

• Событие открытия замка. Например, если такое событие получает система видеонаблюдения, то она может поставить метку времени на запись для быстрого поиска событий в видеоряде. Событие содержит номер комнаты, владельца авторизации, тип авторизации (карта, код, др.), метку времени.
• Событие неудачной попытки открытия замка.
• Событие добавления авторизации. Например, PMS посылает команду на создание ключа. Будет создано push-уведомление о создании новой авторизации системам, подключённым для получения таких push-уведомлений. Стоит отметить, что даже если ключ будет создан напрямую в сервере HTLock, такое уведомление будет сгенерировано. Если PMS гостиницы имеет подписку на webhook сервера интеграции HSU, то в PMS можно будет отследить, что кто-то создал ключ на комнату в обход модуля выпуска ключей PMS.
• Событие удаления авторизации. Например, административная СКУД, подписанная на этот тип сообщения, удаляет пользователя у себя при получении такого уведомления.
• События закрытия и открытия защелки замка.
• Событие подачи и отключения электропитания в комнате. Для комнат, в которых установлен онлайн энергосберегающий выключатель HSU-FK002-BT. События создаются при вставке и извлечении карты из кармана энергосберегающего выключателя комнаты. Такое событие может быть получено PMS для следующих целей. Если в выключатель вставлена карта гостя, на карте номерного фонда в PMS можно отобразить состояние, что гость находится в комнате. Или же, если вставлена карта персонала, можно видеть, что горничная в комнате, идет уборка. Для целей безопасности: если в кармане энергосберегающего выключателя долгое время, например, ночью, находится карта персонала, а заселение гостя не было в PMS, это может свидетельствовать о том, что номер используется нелегально.

*Property Management System – программное обеспечение учетной системы гостиницы, как правило информационное ядро гостиницы.
**Guest Room Management System – система управления комнатой гостя.