Amadeus HotSOS

Grænsefladen kommunikerer med en Amadeus HotSOS-server via REST-API.

Funktionsmåde

Grænsefladen synkroniserer kun rumdata og ikke begivenheder. Hvis dette er nødvendigt, skal du kontakte Antcas-support.

Bemærk: Grænsefladen er meget langsom ved at sende. Det kan tage et øjeblik, før værdien vises i overvågningen.

Der foretages enkelte polls fra Antcas-serveren via HTTPS til HotSOS-portalen. API-URL'en er fastlagt og kan ikke ændres. Der afspørges rummene, der tidligere er defineret i HotSOS-applikationen og i Antcas Config. Poll-grænsen er standardmæssigt 30 anmodninger pr. minut. Antcas-serveren overholder strengt den indstillede retningslinje for at reducere belastningen på den anden side og netværket. Dette betyder, at det kan tage nogle minutter, før en ændring når frem til Antcas-serveren.

Når serveren startes, hentes der altid først meddelelserne, og derefter overføres alle statusmeddelelser. Hvis der foretages en midlertidig ændring på HotSOS-siden, har dette til følge, at statusen først ankommer til SPS'en og derefter sendes igen.

Hvis der opstår en forbindelsesfejl, gentages afspørgslen automatisk efter udløb af tidsgrænsen. Fejlmeddelelsen vises kun én gang i overvågningen. Hvis der ikke etableres forbindelse inden for det indstillede forbindelsestimeout, erklæres grænsefladen også som offline.

Konfiguration

Måladressen er serveradressen uden URI og https://-præfiks.

Bemærk: Når der bruges en proxy-server, skal det tages hensyn til, at URI-stien ikke ændres.

Overvågning

Overvågningen kan vise forskellige kilder. I den følgende tabel forklares alle mulighederne.

Kilde	Beskrivelse
Client	Værdi, der kommer fra HotSOS-modparten.
Server	Værdi sendt eller læst af Antcas Control.
System	Generel systemmeddelelse.

Variabler

Navn	Datatype	Beskrivelse
id	string	Sætter rumnummeret i overensstemmelse med grænsefladen.
make_up	bool	Anmoder om rengøring af værelset.
service_status	string	Aktuel servicestatus for rummet.
status	string	Status for rummet.
name	string	Modtaget rumnavn.
dnd	bool	Modtaget Do Not Disturb.
occupied	bool	Rummet er optaget.

Bemærk: Der kan kun sendes følgende værdier. Alle andre værdier sendes ikke og markeres med rødt i overvågningen.

status

Værdi	Beskrivelse
CLEAN	Rummet er rent.
DIRTY	Rummet er snavset.
OUT_OF_ORDER	Rummet er beskadiget.
OUT_OF_SERVICE	Rummet er ude af drift.
INSPECTED	Rummet er blevet inspiceret.
PICKUP	Rummet befinder sig i afhentningsstatus.

service_status

Bemærk: Kun værdierne AWAITING_SERVICE og DO_NOT_DISTURB kan sendes.

Værdi	Beskrivelse
AWAITING_SERVICE	Rummet venter på rengøring.
DO_NOT_DISTURB	Gæsten vil ikke blive forstyrret.
VACANT_CLEANED	Rummet er rengjort og ledigt.
OCCUPIED_CLEANED	Rummet er rengjort og optaget.
CLEANING_STARTED	Rengøringen af rummet er startet.
SERVICE_REFUSED	Gæsten har afvist servicen.
STOPPED	Rengøringen er stoppet.
TO_BE_INSPECTED	Rummet har brug for en inspektion.
INSPECTED	Rummet er blevet inspiceret.
LATE_SERVICE	Gæsten ønsker en sen service.
RETURN_LATER	Gæsten har bedt om at vende tilbage senere.