Amadeus HotSOS

Die Schnittstelle kommuniziert mit einem Amadeus HotSOS Server via REST-API.

Funktionsweise

Die Schnittstelle synchronisiert nur die Raumdaten und nicht die Ereignisse. Sollte dies erforderlich sein, wenden Sie sich an den Support von Antcas.

Hinweis: Die Schnittstelle ist sehr langsam beim Senden. Es kann einen Moment dauern, bis der Wert im Monitor erscheint.

Es werden einzelne Polls vom Antcas Server via HTTPS auf das HotSOS-Portal getätigt. Das API-URL ist dabei fix festgelegt und kann nicht geändert werden. Dabei werden die Räume, die zuvor in der HotSOS-Applikation und im Antcas Config definiert wurden, abgefragt. Die Poll-Limite beträgt Standardmässig 30 Abfragen pro Minute. Der Antcas Server hält sich strikt an die eingestellte Richtlinie, um die Auslastung der Gegenseite und des Netzwerkes zu verringern. Dies bedeutet, dass es einige Minuten dauern kann, bis eine Änderung beim Antcas Server ankommt.

Beim Starten des Servers werden immer zuerst die Meldungen abgeholt und danach alle Statusmeldungen übertragen. Bei einer zwischenzeitlichen Änderung auf Seite von HotSOS hat dies dann zur Folge, dass der Status zuerst in der SPS ankommt und danach erneut gesendet wird.

Tritt ein Verbindungsfehler auf, so wird die Abfrage nach dem Erreichen des Timeouts automatisch wiederholt. Die Fehlermeldung erscheint dabei nur einmal im Monitor. Kommt keine Verbindung innerhalb des eingestellten Verbindungs-Timeouts zustande, so wird zudem die Schnittstelle als offline deklariert.

Konfiguration

Die Zieladresse ist die Adresse des Servers ohne URI und https://-Präfix.

Hinweis: Beim Verwenden eines Proxy-Servers ist darauf zu achten, dass sich der URI-Pfad nicht ändert.

Monitor

Der Monitor kann verschiedene Quellen anzeigen. In der folgenden Tabellen werden alle Möglichkeiten erläutert.

Quelle	Beschreibung
Client	Von der HotSOS-Gegenstelle kommender Wert.
Server	Von Antcas Control gesendeter oder gelesener Wert.
System	Allgemeine Systemmeldung.

Variablen

Name	Datentyp	Beschreibung
id	string	Setzt die Raumnummer entsprechend der Schnittstelle.
make_up	bool	Zimmer reinigen anfordern.
service_status	string	Aktueller Service-Status des Raumes.
status	string	Status des Raumes.
name	string	Empfangener Raumname.
dnd	bool	Do Not Disturb empfangen.
occupied	bool	Der Raum ist belegt.

Hinweis: Es können nur folgende Werte gesendet werden. Alle anderen Werte werden nicht gesendet und im Monitor rot markiert.

status

Wert	Beschreibung
CLEAN	Der Raum ist sauber.
DIRTY	Der Raum ist dreckig.
OUT_OF_ORDER	Der Raum ist beschädigt.
OUT_OF_SERVICE	Der Raum ist ausser Betrieb.
INSPECTED	Der Raum wurde inspiziert.
PICKUP	Der Raum befindet sich im Abhol-Status.

service_status

Hinweis: Nur die Werte AWAITING_SERVICE und DO_NOT_DISTURB können gesendet werden.

Wert	Beschreibung
AWAITING_SERVICE	Der Raum wartet auf Reinigung.
DO_NOT_DISTURB	Der Gast möchte nicht gestört werden.
VACANT_CLEANED	Der Raum wurde gereinigt und ist frei.
OCCUPIED_CLEANED	Der Raum ist gereinigt und belegt.
CLEANING_STARTED	Die Reinigung des Raumes hat gestartet.
SERVICE_REFUSED	Der Gast hat den Service verweigert.
STOPPED	Die Reinigung wurde gestoppt.
TO_BE_INSPECTED	Der Raum braucht eine Inspektion.
INSPECTED	Der Raum wurde inspiziert.
LATE_SERVICE	Der Gast möchte einen späten Service.
RETURN_LATER	Der Gast hat um eine spätere Rückkehr gebeten.