Amadeus HotSOS

Интерфейс взаимодействует с сервером Amadeus HotSOS через REST-API.

Принцип работы

Интерфейс синхронизирует только данные о помещениях, но не события. Если это необходимо, обратитесь в службу поддержки Antcas.

Примечание: Интерфейс очень медленный при отправке. Может потребоваться некоторое время, прежде чем значение появится в мониторе.

От сервера Antcas через HTTPS выполняются отдельные опросы на портал HotSOS. URL API фиксирован и не может быть изменен. При этом запрашиваются помещения, которые ранее были определены в приложении HotSOS и в Antcas Config. Стандартное ограничение на количество запросов составляет 30 запросов в минуту. Сервер Antcas строго придерживается установленного правила, чтобы снизить нагрузку на противоположную сторону и сеть. Это означает, что может потребоваться несколько минут, прежде чем изменение поступит на сервер Antcas.

При запуске сервера сначала всегда получаются сообщения, а затем передаются все статусы. Если в это время происходит изменение со стороны HotSOS, то статус сначала приходит в ПЛК, а затем отправляется повторно.

Если возникает ошибка соединения, запрос автоматически повторяется после достижения тайм-аута. Сообщение об ошибке отображается только один раз в мониторе. Если соединение не установлено в течение установленного времени ожидания соединения, интерфейс также объявляется офлайн.

Настройка

Целевой адрес — это адрес сервера без URI и префикса https://.

Примечание: При использовании прокси-сервера необходимо убедиться, что путь URI не изменяется.

Монитор

Монитор может отображать различные источники. В следующей таблице описаны все возможности.

Источник	Описание
Клиент	Значение, поступающее от стороны HotSOS.
Сервер	Отправленное или прочитанное Antcas Control значение.
Система	Общее системное сообщение.

Переменные

Имя	Тип данных	Описание
id	string	Устанавливает номер комнаты в соответствии с интерфейсом.
make_up	bool	Запрос на уборку комнаты.
service_status	string	Текущий статус обслуживания комнаты.
status	string	Статус комнаты.
name	string	Полученное имя комнаты.
dnd	bool	Получено "Не беспокоить".
occupied	bool	Комната занята.

Примечание: Можно отправлять только следующие значения. Все остальные значения не отправляются и отмечаются красным цветом в мониторе.

status

Значение	Описание
CLEAN	Комната чистая.
DIRTY	Комната грязная.
OUT_OF_ORDER	Комната повреждена.
OUT_OF_SERVICE	Комната не работает.
INSPECTED	Комната была осмотрена.
PICKUP	Комната находится в статусе "Забрать".

service_status

Примечание: Можно отправлять только значения AWAITING_SERVICE и DO_NOT_DISTURB.

Значение	Описание
AWAITING_SERVICE	Комната ожидает уборки.
DO_NOT_DISTURB	Гость не хочет быть побеспокоенным.
VACANT_CLEANED	Комната была убрана и свободна.
OCCUPIED_CLEANED	Комната убрана и занята.
CLEANING_STARTED	Началась уборка комнаты.
SERVICE_REFUSED	Гость отказался от обслуживания.
STOPPED	Уборка была остановлена.
TO_BE_INSPECTED	Комната нуждается в осмотре.
INSPECTED	Комната была осмотрена.
LATE_SERVICE	Гость хочет позднее обслуживание.
RETURN_LATER	Гость попросил вернуться позже.