Lavorare con le operazioni alberghiere ASA

Inizia con una domanda mirata

I membri del progetto usano le connessioni attive nel progetto senza un accesso separato alla connessione. I visualizzatori seguono i risultati e scaricano file condivisi. I collaboratori fanno domande e preparano modifiche. I responsabili approvano anche le modifiche. Restano validi modalità della chat, regole di approvazione e limiti di accesso dello strumento aziendale.

Prompt	Metodi ASA	Accesso e moduli del fornitore
“Mostra gli arrivi, le partenze e le camere occupate di oggi.”	getReservations, getInHouseRoomReservations	ruolo di Collaboratore nel progetto; autorizzazione al metodo in ASA. Elenco degli ospiti in casa: Data Exchange, Cash o Charging station. Senza Data Exchange/Cash le query sulle prenotazioni possono avere filtri limitati.
“Prepara un passaggio di consegne per l’housekeeping con le camere che richiedono attenzione.”	getHousekeepingStatus	ruolo di Collaboratore nel progetto; autorizzazione al metodo in ASA e accesso a Web Client/Housekeeping.
“Riepiloga i saldi aperti delle camere e i conti stimati.”	getOpenPasserByAccounts, getCurrentRoomAccountBalance, getEstimatedRoomBill	ruolo di Collaboratore nel progetto; autorizzazione al metodo in ASA. Conti aperti: Data Exchange o Cash; saldi delle camere/conti stimati: Pay-TV Guest-Info.
“Rivedi le assegnazioni dei tavoli e proponi queste modifiche.”	getInHouseRoomReservations, updateDiningInfo	Collaboratore; Cash per gli aggiornamenti; approva la proposta in modalità Chiedi approvazione.
“Trova gli appuntamenti spa e prepara una prenotazione o un cambio di stato da approvare.”	getSpaAppointments, getAvailableSpaSlots, postSpaAppointment, setSpaAppointmentStatus	Collaboratore e una persona che approva; autorizzazione al metodo in ASA. La prenotazione richiede Ext. Reservation-Service; Beauty richiede in più Data Exchange. Chiedi all’amministratore quali moduli specifici si applicano a ciascun metodo.
“Prepara questi addebiti minibar per la verifica.”	postRoomCharge più una lettura degli occupanti se indichi un numero di camera	Collaboratore e Responsabile del progetto per l’approvazione; autorizzazione al metodo in ASA e Cash, Pay-TV Guest-Info, Room systems o Charging station.

Considera i requisiti dei moduli come prerequisiti del fornitore, non come concessioni dedotte da un test della connessione. Steward supporta tutti i 33 metodi del contratto Reservation Service v2.14. Metodi e campi sconosciuti sono bloccati.

Per approvare o rifiutare modifiche serve il ruolo di Responsabile nel progetto della proposta. I collaboratori possono preparare modifiche e verificarne i dettagli. Prima dell’esecuzione vengono ricontrollati l’accesso attuale dell’esecutore al progetto e la connessione attiva.

Dai all’assistente destinazioni chiare

Per gli addebiti, indica il codice articolo ASA, la quantità e l’importo decimale, insieme a un identificatore stabile del conto, della prenotazione della camera o dell’ospite in camera. Un ID ospite globale è diverso da un ID ospite in camera; un ID di prenotazione dell’hotel è diverso dall’ID della prenotazione della camera. Chiedi all’assistente di recuperare e confermare l’identità corretta prima di preparare una modifica.

Se indichi solo un numero di camera, Steward collega la proposta alla prenotazione e all’ospite in camera attuali e li verifica di nuovo prima dell’esecuzione. Anche un cambio di ospite all’interno della stessa prenotazione ferma la proposta. Dopo un cambiamento, prepara una nuova proposta. Tieni documenti di addebito separati per camere occupate diverse.

Per le modifiche alla ristorazione, indica la camera occupata e table, diningRoomAnnotation o kitchenAnnotation. I campi omessi mantengono i valori esistenti; un testo vuoto esplicito li cancella. diningAnnotation è calcolato nell’installazione dimostrativa e non è scrivibile tramite questo adattatore.

Per l’housekeeping, identifica una camera, un edificio, un gruppo o un piano e la modifica prevista. I campi di stato sono elementi fratelli dell’elemento camera, non annidati al suo interno.

Esamina la proposta

Controlla l’operazione, le identità di destinazione, gli importi, le date e i campi modificati. Le modifiche con conseguenze rilevanti richiedono una verifica per impostazione predefinita. L’approvazione si applica alla richiesta preparata. Una destinazione modificata, una modifica delle credenziali, un cambio di contratto o di una regola applicabile richiedono una nuova proposta.

Se un’esecuzione va in timeout o restituisce XML illeggibile, il risultato può essere incerto. Consulta ASA e il risultato dell’esecuzione registrato prima di chiedere un nuovo tentativo. Gli elementi già completati del gruppo restano completati; quelli successivi possono fermarsi dopo un annullamento, una revoca o un cambiamento delle condizioni.

Capisci i limiti dei dati

Le ricerche degli ospiti usano criteri esatti: non aspettarti ricerche con caratteri jolly né un elenco ospiti senza restrizioni. I risultati vuoti sono validi. I valori facoltativi possono mancare, le etichette multilingue possono ripetersi e gli importi restano stringhe decimali esatte.

Vengono restituiti solo i campi presenti nel contratto ASA verificato da Steward. I nuovi campi aggiunti dal fornitore diventano disponibili dopo la verifica del contratto. L’avvio/arresto della ricarica accetta selettori per camera, prenotazione della camera, ospite in camera, chiave o veicolo; ASA non supporta accountID per questi controlli.

Usa le date locali dell’hotel. I dati di fatturazione possono scomparire alla chiusura di un conto, quindi un conto stimato letto in seguito può differire da un risultato acquisito in precedenza. Gli errori ASA restituiti all’interno di una risposta HTTP 200 restano comunque errori.

Esempio di lettura SOAP

L’assistente può recuperare il contratto di una singola operazione con describe_integrations e il relativo filtro per nome dell’operazione. Il codice generato usa il client HTTPX di Steward già esistente. Credenziali, destinazione del servizio, SOAPAction e versione dell’API vengono forniti dal backend.

import steward_http

xml = b'''<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
  <env:Body><getReservations xmlns="http://www.asahotel.com/hotel">
    <arrival><fromDate>2026-10-04</fromDate><toDate>2026-10-04</toDate></arrival>
  </getReservations></env:Body>
</env:Envelope>'''
async with steward_http.AsyncClient(connection=connection_id) as client:
    response = await client.post("/", content=xml, headers={"Content-Type": "text/xml"})
    response.raise_for_status()

Steward autorizza le operazioni ASA in base al ruolo nel progetto e alla modalità della chat. ASA verifica separatamente i permessi dei metodi e i moduli concessi all’account salvato. Le letture SOAP funzionano in Sola lettura anche se usano POST. Il pannello degli accessi osservati è informativo e non concede accesso.