Amadeus HotSOS

De interface communiceert met een Amadeus HotSOS Server via REST-API.

Werking

De interface synchroniseert alleen de ruimtedata en niet de gebeurtenissen. Indien dit nodig is, neem dan contact op met de support van Antcas.

Opmerking: De interface is erg traag bij het verzenden. Het kan even duren voordat de waarde in de monitor verschijnt.

Er worden individuele polls vanaf de Antcas Server via HTTPS uitgevoerd naar het HotSOS-portaal. Het API-URL is hierbij vastgelegd en kan niet gewijzigd worden. Hierbij worden de kamers die eerder zijn gedefinieerd in de HotSOS-toepassing en in de Antcas Config, opgevraagd. De poll-limiet bedraagt standaard 30 vragen per minuut. De Antcas Server houdt zich strikt aan het ingestelde beleid om de belasting van de tegenpartij en het netwerk te verminderen. Dit betekent dat het enkele minuten kan duren voordat een wijziging bij de Antcas Server aankomt.

Bij het starten van de server worden altijd eerst de meldingen opgehaald en daarna alle statusmeldingen overgedragen. Bij een tussentijdse wijziging aan de kant van HotSOS heeft dit tot gevolg dat de status eerst in de SPS aankomt en daarna opnieuw wordt verzonden.

Treedt er een verbindingsfout op, dan wordt de vraag na het bereiken van de timeout automatisch herhaald. De foutmelding verschijnt hierbij slechts één keer in de monitor. Komt er geen verbinding tot stand binnen de ingestelde verbindingstime-out, dan wordt ook de interface als offline verklaard.

Configuratie

Het doeladres is het adres van de server zonder URI en https://-prefix.

Opmerking: Bij gebruik van een proxy-server moet erop worden gelet dat de URI-pad niet verandert.

Monitor

De monitor kan verschillende bronnen tonen. In de volgende tabel worden alle mogelijkheden toegelicht.

Bron	Omschrijving
Client	Waarde die van de HotSOS-tegenpartij komt.
Server	Waarde verzonden of gelezen door Antcas Control.
Systeem	Algemene systeemmelding.

Variabelen

Naam	Gegevens type	Omschrijving
id	string	Stelt de kamer nummer in overeenstemming met de interface.
make_up	bool	Kamer schoonmaken aanvragen.
service_status	string	Huidige service-status van de kamer.
status	string	Status van de kamer.
name	string	Ontvangen kamer naam.
dnd	bool	Do Not Disturb ontvangen.
occupied	bool	De kamer is bezet.

Opmerking: Alleen de volgende waarden kunnen worden verzonden. Andere waarden worden niet verzonden en in de monitor rood gemarkeerd.

status

Waarde	Omschrijving
CLEAN	De kamer is schoon.
DIRTY	De kamer is vuil.
OUT_OF_ORDER	De kamer is beschadigd.
OUT_OF_SERVICE	De kamer is uit dienst.
INSPECTED	De kamer is geïnspecteerd.
PICKUP	De kamer bevindt zich in de ophaalstatus.

service_status

Opmerking: Alleen de waarden AWAITING_SERVICE en DO_NOT_DISTURB kunnen worden verzonden.

Waarde	Omschrijving
AWAITING_SERVICE	De kamer wacht op schoonmaking.
DO_NOT_DISTURB	De gast wil niet worden gestoord.
VACANT_CLEANED	De kamer is schoongemaakt en vrij.
OCCUPIED_CLEANED	De kamer is schoongemaakt en bezet.
CLEANING_STARTED	De schoonmaking van de kamer is gestart.
SERVICE_REFUSED	De gast heeft de service geweigerd.
STOPPED	De schoonmaking is gestopt.
TO_BE_INSPECTED	De kamer heeft een inspectie nodig.
INSPECTED	De kamer is geïnspecteerd.
LATE_SERVICE	De gast wil een late service.
RETURN_LATER	De gast heeft om een latere terugkeer gevraagd.