Collegare ASA HOTEL
Configura il Reservation Service, prova la connessione e scopri come funzionano le autorizzazioni sui metodi ASA.
Ottenere i dati del servizio
Chiedi all’amministratore ASA del tuo hotel o al team interfacce di ASA:
- L’Endpoint del Reservation Service pubblico in HTTPS, che termina con
/ws/hotel/reservation. - Nome utente e password ASA, con le autorizzazioni sui metodi previste.
- I moduli di interfaccia attivi nell’hotel ed eventuali configurazioni utente dell’Extended Reservation-Service.
- Client ID e client secret del service token di Cloudflare Access, se l’endpoint usa questo gateway di accesso. Alcune installazioni si autenticano esclusivamente tramite questo gateway: verifica la configurazione con l’amministratore.
Usa l’URL effettivo del servizio, non un URL per scaricare il WSDL né un indirizzo copiato da un esempio di sviluppo. Gli endpoint su reti private non sono raggiungibili da questo connettore.
Aggiungere e provare la connessione
- Come proprietario o amministratore dell’area di lavoro, apri Impostazioni → Connessioni → Collega uno strumento.
- Scegli ASA HOTEL.
- Inserisci un nome riconoscibile e l’Endpoint del Reservation Service completo.
- Inserisci le credenziali ASA e, se richiesta, la coppia di credenziali di Cloudflare Access.
- Seleziona Collega ASA HOTEL. Seleziona Prova nella scheda della nuova connessione.
La prova mostra la versione del servizio e chiama getVersion, che è una lettura anche se usa SOAP POST. Un risultato positivo conferma l’autenticazione e la raggiungibilità, ma non tutte le autorizzazioni sui metodi. Il connettore invia automaticamente una versione dell’API fissa.
Questo connettore supporta tutti i 33 metodi del contratto verificato v2.14 del Reservation Service e invia le richieste con quella versione. Metodi e campi sconosciuti restano bloccati. Il tuo account ASA ha comunque bisogno dell’autorizzazione per ogni metodo e degli eventuali moduli in licenza richiesti.
Il servizio può indicare una versione più recente, ad esempio 3.14. Steward continua a inviare nelle richieste la versione supportata 2.14. Con l’autorizzazione Configurazione, usa Autorizzazioni ASA → Verifica contratto del fornitore per controllare le modifiche del fornitore: vengono messe in coda per la verifica e non aggiungono automaticamente il supporto. Se la verifica non riesce a scaricare un contratto leggibile, chiedi all’amministratore ASA il pacchetto aggiornato del fornitore.
Attivarla per il tuo team
Attiva la connessione per un progetto, poi invita i colleghi con il ruolo nel progetto adatto. Possono usare la connessione configurata senza un accesso separato.
Inizia in modalità Sola lettura con un briefing per la reception. Usa Chiedi approvazione quando prepari aggiornamenti operativi. Le modifiche finanziarie e quelle con conseguenze rilevanti richiedono per impostazione predefinita un’approvazione, anche in modalità Automatica.
Aggiornare le credenziali
Seleziona il pulsante con la matita in alto a destra nella scheda della connessione. Lascia vuoti i campi per mantenere i valori salvati e inserisci solo quelli che vuoi sostituire. Se modifichi l’endpoint, inserisci di nuovo le credenziali complete: le credenziali salvate non vengono mai inviate a un nuovo endpoint. Le modifiche alle credenziali o all’endpoint azzerano l’accesso ASA rilevato e invalidano le proposte ASA in sospeso. Dopo aver modificato la connessione, prepara nuove proposte.
Se un metodo viene negato, chiedi all’amministratore di attivare il metodo indicato e i moduli pertinenti. Una prova di connessione riuscita cancella i dinieghi memorizzati nella cache, ma non concede quelle autorizzazioni.