Amadeus HotSOS

L'interfaccia comunica con un Server Amadeus HotSOS tramite API REST.

Funzionamento

L'interfaccia sincronizza solo i dati delle stanze e non gli eventi. Se necessario, contattare l'assistenza di Antcas.

Nota: L'interfaccia è molto lenta nell'invio. Potrebbe essere necessario attendere un momento prima che il valore appaia nel monitor.

Vengono eseguite singole interrogazioni dal server Antcas tramite HTTPS sul portale HotSOS. L'URL dell'API è fissata e non può essere modificata. Vengono interrogate le stanze precedentemente definite nell'applicazione HotSOS e in Antcas Config. Il limite di interrogazione è impostato di default su 30 richieste al minuto. Il server Antcas rispetta rigorosamente la politica impostata per ridurre il carico sul lato opposto e sulla rete. Ciò significa che potrebbero essere necessari alcuni minuti affinché una modifica venga ricevuta dal server Antcas.

All'avvio del server, vengono prima recuperati i messaggi e poi trasferiti tutti gli stati di servizio. Se HotSOS apporta modifiche nel frattempo, ciò comporta che lo stato viene prima ricevuto nella PLC e poi inviato nuovamente.

In caso di errore di connessione, la richiesta viene ripetuta automaticamente dopo il timeout. Il messaggio di errore appare solo una volta nel monitor. Se non viene stabilita alcuna connessione entro il timeout di connessione impostato, l'interfaccia viene dichiarata offline.

Configurazione

L'indirizzo di destinazione è l'indirizzo del server senza URI e prefisso https://.

Nota: Quando si utilizza un server proxy, è necessario assicurarsi che il percorso URI non cambi.

Monitor

Il monitor può visualizzare diverse fonti. Nella tabella seguente vengono illustrate tutte le possibilità.

Fonte	Descrizione
Client	Valore proveniente dal lato HotSOS.
Server	Valore inviato o letto da Antcas Control.
Sistema	Messaggio di sistema generale.

Variabili

Nome	Tipo di dati	Descrizione
id	stringa	Imposta il numero della stanza in base all'interfaccia.
make_up	bool	Richiedere la pulizia della stanza.
service_status	stringa	Stato di servizio attuale della stanza.
status	stringa	Stato della stanza.
name	stringa	Nome della stanza ricevuto.
dnd	bool	Non disturbare ricevuto.
occupied	bool	La stanza è occupata.

Nota: È possibile inviare solo i seguenti valori. Tutti gli altri valori non vengono inviati e sono contrassegnati in rosso nel monitor.

status

Valore	Descrizione
CLEAN	La stanza è pulita.
DIRTY	La stanza è sporca.
OUT_OF_ORDER	La stanza è danneggiata.
OUT_OF_SERVICE	La stanza è fuori servizio.
INSPECTED	La stanza è stata ispezionata.
PICKUP	La stanza si trova nello stato di ritiro.

service_status

Nota: È possibile inviare solo i valori AWAITING_SERVICE e DO_NOT_DISTURB.

Valore	Descrizione
AWAITING_SERVICE	La stanza attende la pulizia.
DO_NOT_DISTURB	L'ospite non vuole essere disturbato.
VACANT_CLEANED	La stanza è stata pulita e libera.
OCCUPIED_CLEANED	La stanza è pulita e occupata.
CLEANING_STARTED	La pulizia della stanza ha iniziato.
SERVICE_REFUSED	L'ospite ha rifiutato il servizio.
STOPPED	La pulizia è stata interrotta.
TO_BE_INSPECTED	La stanza necessita di un'ispezione.
INSPECTED	La stanza è stata ispezionata.
LATE_SERVICE	L'ospite desidera un servizio tardivo.
RETURN_LATER	L'ospite ha richiesto di tornare più tardi.