Mit ASA im Hotelbetrieb arbeiten

Mit einer gezielten Frage beginnen

Projektmitglieder nutzen die für ihr Projekt aktivierten Verbindungen ohne separate Verbindungsfreigabe. Betrachter verfolgen Ergebnisse und laden geteilte Dateien herunter. Mitwirkende stellen Fragen und bereiten Änderungen vor. Projektmanager genehmigen außerdem Änderungen. Chatmodus, Genehmigungsregeln und die Zugriffsgrenzen des Geschäftstools gelten weiterhin.

Anfrage	ASA-Methoden	Zugriff und Herstellermodule
„Zeige die heutigen Anreisen, Abreisen und belegten Zimmer.“	getReservations, getInHouseRoomReservations	Projektzugriff als Mitwirkender; ASA-Methodenberechtigung. In-House-Liste: Data Exchange, Cash oder Charging station. Reservierungsabfragen haben ohne Data Exchange/Cash möglicherweise nur eingeschränkte Filter.
„Erstelle eine Housekeeping-Übergabe mit den Zimmern, die Aufmerksamkeit brauchen.“	getHousekeepingStatus	Projektzugriff als Mitwirkender; ASA-Methodenberechtigung und Zugriff auf Web Client/Housekeeping.
„Fasse offene Zimmersalden und voraussichtliche Rechnungen zusammen.“	getOpenPasserByAccounts, getCurrentRoomAccountBalance, getEstimatedRoomBill	Projektzugriff als Mitwirkender; ASA-Methodenberechtigung. Offene Konten: Data Exchange oder Cash; Zimmersalden/voraussichtliche Rechnungen: Pay-TV Guest-Info.
„Prüfe die Tischzuordnungen und schlage diese Tischänderungen vor.“	getInHouseRoomReservations, updateDiningInfo	Mitwirkender; Cash für Aktualisierungen; Vorschlag im Modus „Genehmigung anfordern“ genehmigen.
„Finde Spa-Termine und bereite eine genehmigte Buchung oder Statusänderung vor.“	getSpaAppointments, getAvailableSpaSlots, postSpaAppointment, setSpaAppointmentStatus	Mitwirkender und eine genehmigende Person; ASA-Methodenberechtigung. Buchungen erfordern Ext. Reservation-Service; Beauty erfordert zusätzlich Data Exchange. Fragen Sie den Administrator nach den jeweils erforderlichen methodenspezifischen Modulen.
„Bereite diese Minibar-Buchungen zur Prüfung vor.“	postRoomCharge sowie eine Abfrage der Zimmerbelegung, wenn eine Zimmernummer angegeben ist	„Schreiben“ + „Genehmigen“ sowie „Lesen“ zur Prüfung der Belegung; ASA-Methodenberechtigung und Cash, Pay-TV Guest-Info, Room systems oder Charging station.

Betrachten Sie Modulanforderungen als Voraussetzungen des Herstellers, nicht als Berechtigungen, die sich aus einem Verbindungstest ableiten lassen. Steward unterstützt alle 33 Methoden des Reservation-Service-Vertrags v2.14. Unbekannte Methoden und Felder werden blockiert.

Zum Genehmigen oder Ablehnen benötigen Sie Projektmanagerzugriff auf das Projekt des Vorschlags. Mitwirkende können Änderungen vorbereiten und die Details prüfen. Vor der Ausführung werden der aktuelle Projektzugriff der ausführenden Person und die aktivierte Verbindung erneut geprüft.

Dem Assistenten klare Ziele nennen

Geben Sie für Buchungen den ASA-Artikelcode, die Menge und den Betrag als Dezimalzahl an, außerdem eine eindeutige Kennung für Konto, Zimmerreservierung oder Zimmergast. Eine globale Gast-ID unterscheidet sich von einer Zimmergast-ID; eine Hotelreservierungs-ID unterscheidet sich von der zugehörigen Zimmerreservierungs-ID. Bitten Sie den Assistenten, die richtige Identität abzurufen und zu bestätigen, bevor er eine Änderung vorbereitet.

Wird nur eine Zimmernummer angegeben, verknüpft Steward den Vorschlag mit der aktuellen Reservierung und dem aktuellen Zimmergast und prüft beides vor der Ausführung erneut. Auch ein Gastwechsel innerhalb derselben Reservierung stoppt den Vorschlag. Bereiten Sie nach einer Änderung einen neuen Vorschlag vor. Verwenden Sie für verschiedene belegte Zimmer separate Buchungsbelege.

Nennen Sie für Änderungen in der Gastronomie das belegte Zimmer und table, diningRoomAnnotation oder kitchenAnnotation. Nicht angegebene Felder behalten ihre bisherigen Werte; ausdrücklich leerer Text löscht sie. diningAnnotation wird in der gezeigten Installation berechnet und kann über diesen Adapter nicht geschrieben werden.

Geben Sie für das Housekeeping ein Zimmer, ein Haus, eine Gruppe oder eine Etage sowie die gewünschte Änderung an. Statusfelder stehen auf derselben Ebene wie das Zimmerelement und sind nicht darin verschachtelt.

Den Vorschlag prüfen

Prüfen Sie Vorgang, Zielidentitäten, Beträge, Daten und geänderte Felder. Folgenreiche Änderungen müssen standardmäßig geprüft werden. Die Genehmigung gilt für die vorbereitete Anfrage. Ändern sich Ziel, Zugangsdaten, Vertrag oder eine geltende Regel, ist ein neuer Vorschlag erforderlich.

Läuft eine Ausführung in ein Zeitlimit oder liefert sie unlesbares XML, kann das Ergebnis unsicher sein. Prüfen Sie ASA und das erfasste Ausführungsergebnis, bevor Sie einen weiteren Versuch anfordern. Abgeschlossene Einträge eines Batches bleiben abgeschlossen; spätere Einträge können nach einem Abbruch, einem Widerruf oder veränderten Bedingungen stoppen.

Die Grenzen der Daten kennen

Gastsuchen verwenden exakte Kriterien; erwarten Sie keine Platzhaltersuche und kein uneingeschränktes Gästeverzeichnis. Leere Ergebnisse sind gültig. Optionale Werte können fehlen, mehrsprachige Bezeichnungen können sich wiederholen, und Geldbeträge bleiben exakte Dezimalzeichenfolgen.

Es werden nur Felder aus Stewards geprüftem ASA-Vertrag zurückgegeben. Neu hinzugefügte Herstellerfelder stehen nach einer Prüfung des Vertrags zur Verfügung. Das Starten/Stoppen von Ladevorgängen akzeptiert Zimmer, Zimmerreservierung, Zimmergast, Schlüssel oder Fahrzeug als Auswahl; ASA unterstützt accountID für diese Steuerungen nicht.

Verwenden Sie die lokalen Daten des Hotels. Abrechnungsdaten können beim Schließen eines Kontos verschwinden, sodass eine später abgerufene voraussichtliche Rechnung von einem früher erfassten Ergebnis abweichen kann. ASA-Fehler, die innerhalb einer HTTP-200-Antwort zurückgegeben werden, sind dennoch Fehler.

Beispiel für einen SOAP-Lesezugriff

Der Assistent kann einen einzelnen Vorgangsvertrag mit describe_integrations und dessen Filter für Vorgangsnamen abrufen. Erzeugter Code verwendet den vorhandenen Steward-HTTPX-Client. Zugangsdaten, Dienstziel, SOAPAction und API-Version stellt das Backend bereit.

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 autorisiert ASA-Aufgaben über Projektrolle und Chatmodus. ASA prüft separat die Methodenberechtigungen des gespeicherten Kontos und lizenzierte Module. SOAP-Lesezugriffe funktionieren trotz POST im Modus Nur lesen. Der Bereich mit beobachtetem Zugriff dient nur zur Information und erteilt keinen Zugriff.