Szállodai műveletek az ASA-val

Kezdjen célzott kérdéssel

A projekt tagjai külön kapcsolati hozzáférés nélkül használhatják a projekthez engedélyezett kapcsolatokat. A Megtekintők követhetik az eredményeket és letölthetik a megosztott fájlokat. A Közreműködők kérdezhetnek és módosításokat készíthetnek elő. A Projektmenedzserek jóvá is hagyhatják a módosításokat. A beszélgetés módja, a jóváhagyási szabályok és az üzleti eszköz hozzáférési korlátai továbbra is érvényesek.

Kérés	ASA-metódusok	Hozzáférés és gyártói modulok
„Mutasd a mai érkezéseket, távozásokat és a foglalt szobákat.”	getReservations, getInHouseRoomReservations	Közreműködő projektszerepkör; ASA-metódusjogosultság. A szállodában tartózkodók listája: Data Exchange, Cash vagy Charging station. Data Exchange/Cash nélkül a foglalási lekérdezések szűrői korlátozottak lehetnek.
„Készíts takarítási átadót a figyelmet igénylő szobákkal.”	getHousekeepingStatus	Közreműködő projektszerepkör; ASA-metódusjogosultság és Web Client/Housekeeping hozzáférés.
„Foglald össze a nyitott szobaegyenlegeket és a becsült számlákat.”	getOpenPasserByAccounts, getCurrentRoomAccountBalance, getEstimatedRoomBill	Közreműködő projektszerepkör; ASA-metódusjogosultság. Nyitott számlák: Data Exchange vagy Cash; szobaegyenlegek/becsült számlák: Pay-TV Guest-Info.
„Nézd át az éttermi asztalbeosztást, és javasold ezeket az asztalmódosításokat.”	getInHouseRoomReservations, updateDiningInfo	Közreműködő projektszerepkör; a frissítésekhez Cash; a javaslatot Jóváhagyás kérése módban hagyja jóvá.
„Keresd meg a spaidőpontokat, és készíts elő egy jóváhagyandó foglalást vagy állapotmódosítást.”	getSpaAppointments, getAvailableSpaSlots, postSpaAppointment, setSpaAppointmentStatus	Közreműködő projektszerepkör és egy jóváhagyó; ASA-metódusjogosultság. A foglaláshoz Ext. Reservation-Service szükséges; a Beauty modulhoz emellett Data Exchange is kell. Az adott metódushoz szükséges modulokról érdeklődjön az adminisztrátornál.
„Készítsd elő ellenőrzésre ezeket a minibárterheléseket.”	postRoomCharge, valamint a vendég lekérése, ha a terhelés szobaszámra szól	Közreműködő projektszerepkör és Projektmenedzser a jóváhagyáshoz; ASA-metódusjogosultság és Cash, Pay-TV Guest-Info, Room systems vagy Charging station.

A modulkövetelményeket a gyártó által támasztott előfeltételként kezelje, ne olyan jogosultságként, amely egy kapcsolatteszt eredményéből következik. A Steward a v2.14-es Reservation Service szerződés mind a 33 metódusát támogatja. Az ismeretlen metódusok és mezők tiltottak.

A módosítások jóváhagyásához vagy elutasításához Projektmenedzser hozzáférés kell a javaslat projektjében. A Közreműködők előkészíthetik a módosításokat és áttekinthetik a részleteket. Végrehajtás előtt a rendszer újra ellenőrzi a végrehajtó aktuális projekthozzáférését és a kapcsolat engedélyezését.

Egyértelmű célpontok az asszisztensnek

Terheléseknél adja meg az ASA-cikkkódot, a mennyiséget és a tizedes összeget, valamint egy állandó számla-, szobafoglalás- vagy szobavendég-azonosítót. A globális vendégazonosító eltér a szobavendég-azonosítótól; a szállodai foglalásazonosító pedig a hozzá tartozó szobafoglalás-azonosítótól. Kérje meg az asszisztenst, hogy egy módosítás előkészítése előtt kérdezze le és erősítse meg a helyes azonosítót.

Ha csak szobaszámot ad meg, a Steward a javaslatot az aktuális foglaláshoz és szobavendég-azonosítóhoz köti, és a végrehajtás előtt ismét ellenőrzi őket. Ha ugyanazon a foglaláson belül megváltozik a vendég, a javaslat szintén leáll. Változás után készítsen új javaslatot. A különböző foglalt szobákhoz tartozó terheléseket külön bizonylatokon tartsa.

Éttermi módosításoknál adja meg a foglalt szobát és a table, diningRoomAnnotation vagy kitchenAnnotation mezőt. A kihagyott mezők megtartják meglévő értéküket; a kifejezetten üresen megadott szöveg törli őket. A diningAnnotation a bemutatott telepítésben számított mező, és ezen az adapteren keresztül nem írható.

Takarításnál adja meg a szobát, az épületet, a csoportot vagy az emeletet, valamint a kívánt módosítást. Az állapotmezők a szobaelem testvérelemei, nem pedig annak belsejében találhatók.

A javaslat áttekintése

Ellenőrizze a műveletet, a célazonosítókat, az összegeket, a dátumokat és a módosított mezőket. A jelentős következménnyel járó módosítások alapértelmezés szerint ellenőrzést igényelnek. A jóváhagyás az előkészített kérésre vonatkozik. Ha megváltozik a cél, a hitelesítő adatok, a szerződés vagy egy vonatkozó szabály, új javaslatra van szükség.

Ha egy végrehajtás időtúllépéssel jár, vagy olvashatatlan XML-t ad vissza, az eredmény bizonytalan lehet. Újabb próbálkozás kérése előtt nézze meg az ASA-t és a rögzített végrehajtási eredményt. A csomag befejezett tételei befejezettek maradnak; a későbbi tételek megállhatnak megszakítás, a hozzáférés visszavonása vagy megváltozott feltételek miatt.

Az adatok korlátai

A vendégkeresés pontos feltételekkel működik; ne számítson helyettesítő karakteres keresésre vagy korlátlan vendégjegyzékre. Az üres eredmény is érvényes. Az opcionális értékek hiányozhatnak, a többnyelvű feliratok ismétlődhetnek, a pénzösszegek pedig pontos tizedes karakterláncként maradnak meg.

Csak a Steward által ellenőrzött ASA-szerződésben szereplő mezők jelennek meg. A gyártó által újonnan hozzáadott mezők a szerződés ellenőrzése után válnak elérhetővé. A töltés indítása és leállítása szoba-, szobafoglalás-, szobavendég-, kulcs- vagy járműválasztót fogad el; az ASA ezeknél a vezérlőknél nem támogatja az accountID használatát.

A szálloda helyi dátumait használja. A számlázási adatok a számla lezárásakor eltűnhetnek, ezért egy később lekérdezett becsült számla eltérhet egy korábban rögzített eredménytől. A HTTP 200 válaszon belül visszaadott ASA-hibák is hibának számítanak.

SOAP-olvasási példa

Az asszisztens a describe_integrations és annak műveletnév-szűrője segítségével lekérheti egy művelet szerződését. A generált kód a Steward meglévő HTTPX-kliensét használja. A hitelesítő adatokat, a szolgáltatás célcímét, a SOAPAction értéket és az API-verziót a háttérrendszer adja meg.

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()

A Steward a projektszerepkör és a beszélgetés módja alapján engedélyezi az ASA-műveleteket. Az ASA külön ellenőrzi a mentett fiók metódusjogait és licencelt moduljait. A SOAP-olvasás POST használatával is működik Csak olvasás módban. A megfigyelt hozzáférési panel tájékoztató jellegű, nem ad hozzáférést.