Syntax
Die NachrichtOTA_HotelAvailNotifRQ
verwendet die folgende Syntax:
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="timestamp" Version="3.0"> <POS> <Source> <RequestorID ID="partner_account_name"/> </Source> </POS> <AvailStatusMessages HotelCode="HotelID"> <AvailStatusMessage BookingLimit="integer"> <StatusApplicationControl Start="YYYY-MM-DD" End="YYYY-MM-DD" Mon="boolean_value" Tue="boolean_value" Weds="boolean_value" Thur="boolean_value" Fri="boolean_value" Sat="boolean_value" Sun="boolean_value" InvTypeCode="RoomID"/> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="YYYY-MM-DD" End="YYYY-MM-DD" Mon="boolean_value" Tue="boolean_value" Weds="boolean_value" Thur="boolean_value" Fri="boolean_value" Sat="boolean_value" Sun="boolean_value" InvTypeCode="RoomID" RatePlanCode="PackageID"/> <LengthsOfStay> <LengthOfStay Time="integer" TimeUnit="[Day]" MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay| SetForwardMinStay]"/> </LengthsOfStay> <RestrictionStatus Status="[Close|Open]" Restriction="[Arrival|Departure|Master]" MaxAdvancedBookingOffset="integer" MinAdvancedBookingOffset="integer"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
Elemente und Attribute
Die Nachricht OTA_HotelAvailNotifRQ enthält folgende Elemente und Attribute:Element / @Attribut | Vorkommnisse | Typ | Beschreibung |
---|---|---|---|
OTA_HotelAvailNotifRQ | 1 | Komplexes Element | Das Stammelement für eine Nachricht, die die Verfügbarkeit des Zimmerpreises definiert. |
OTA_HotelAvailNotifRQ / AvailStatusMessages | 1 | AvailStatusMessages | Ein Container für ein oder mehrere <AvailStatusMessage> -Elemente. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode | 1 | String | Die eindeutige Kennung für die Unterkunft. Dieser Wert muss mit der Hotel-ID übereinstimmen, die mit <id> im Element <listing> im Hotellistenfeed angegeben wird. Die Hotel-ID ist auch im Hotel Center aufgelistet. |
OTA_HotelAvailNotifRQ / POS | 0..1 | POS | Ein Container zum Angeben des Partnerkontos für diese Nachricht. Wird normalerweise verwendet, wenn Ihr Back-End Preisfeeds für mehrere Partnerkonten bereitstellt. |
OTA_HotelAvailNotifRQ / POS/ Source | 1 | Quelle | Erforderlich, wenn <POS> vorhanden ist. Ein Container für die <RequestorID> . |
OTA_HotelAvailNotifRQ / POS / RequestorID | 1 | RequestorID | Erforderlich, wenn <POS> vorhanden ist. Definiert das Partnerkonto. |
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID | 1 | String | Das Partnerkonto für diese Nachricht. Dieser Stringwert ist der Wert „Partnerschlüssel“, der im Hotel Center auf der Seite „Kontoeinstellungen“ aufgeführt ist.
Hinweis: Wenn Sie ein Back-End haben, das Feeds für mehrere Konten bereitstellt, muss dieser Wert mit dem Attributwert |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage | 1..n | AvailStatusMessage | Definiert die Zimmerpreisverfügbarkeit und -einschränkungen für verschiedene Zeiträume für eine einzelne Unterkunft. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit | 1 | Int | Die Anzahl der verbleibenden Räume, die für den Zeitraum in <StatusApplicationControl> gebucht werden können. Wenn BooklingLimit angegeben ist, muss InvTypeCode durch <StatusApplicationControl> angegeben werden und <AvailStatusMessage> kann weder <LengthOfStay> noch <RestrictionStatus> enthalten. Muss gleich oder größer als 0 sein. Wenn kein Wert angegeben ist, wird der Standardwert 0 verwendet.
Hinweis: Zum Festlegen der Raumverfügbarkeit für eine bestimmte Einstellung |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl | 1 | StatusApplicationControl | Definiert den Zeitraum sowie die Kennungen für den Zimmertyp (InvTypeCode ) und den Preisplan (RatePlanCode ). |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start | 1 | Datum | Das Startdatum des Zeitraums. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End | 1 | Datum | Das Enddatum des Zeitraums. Muss gleich oder größer als der Wert start sein. Wenn start und end gleich sind, gilt die Aktualisierung für dieses Datum. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon | 0..1 | Boolescher Wert | Legen Sie true oder 1 fest, um Montage explizit einzubeziehen.
Wird der Wert auf |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue | 0..1 | Boolescher Wert | Legen Sie true oder 1 fest, um Dienstage explizit einzubeziehen.
Wird der Wert auf |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds | 0..1 | Boolescher Wert | Legen Sie true oder 1 fest, um Mittwoche explizit einzubeziehen.
Wird der Wert auf |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur | 0..1 | Boolescher Wert | Legen Sie true oder 1 fest, um Donnerstage explizit einzubeziehen.
Wird der Wert auf |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri | 0..1 | Boolescher Wert | Legen Sie true oder 1 fest, um Freitage ausdrücklich einzubeziehen.
Wird der Wert auf |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat | 0..1 | Boolescher Wert | Legen Sie true oder 1 fest, um Samstage explizit einzubeziehen.
Wird der Wert auf |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun | 0..1 | Boolescher Wert | Legen Sie true oder 1 fest, um Sonntage explizit einzubeziehen.
Wird der Wert auf |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode | 1 | String | Die eindeutige Kennung für das Inventar (Zimmertyp). Dieser Wert ist <RoomID> in einer Nachricht Transaktion (Unterkunftsdaten) zugeordnet. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode | 0..1 | String | Eine eindeutige Kennung für den Preisplan. Diese Kennung wird dem Wert der <PackageID> in einer Nachricht „Transaktion (Unterkunftsdaten)“ zugeordnet. Der Preisplan wird weiter definiert und in <StatusApplicationControl> in den Nachrichten <OTA_HotelRateAmountNotifRQ> und <OTA_HotelAvailNotifRQ> referenziert.
Das Attribut |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay | 0..1 | LengthsOfStay | Ein Container, um Einschränkungen hinsichtlich der Aufenthaltsdauer zu definieren. Darf nicht vorhanden sein, wenn <AvailStatusMessage> das Attribut BookingLimit enthält. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay | 1..n | LengthOfStay | Definiert Einschränkungen hinsichtlich der Aufenthaltsdauer. Wenn Sie mehr als ein <LengthOfStay> -Element verwenden, muss jedes Element einen anderen MinMaxMessageType -Wert haben. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time | 1 | Int | Einheitswert zur Messung der Aufenthaltsdauer. Der Wert Null wird als keine Einschränkung behandelt. Zum Beispiel bedeutet <LengthOfStay
Time="0" MinMaxMessageType="SetMaxLOS"/> keine maximale Aufenthaltsdauer. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit | 0..1 | Enum | Die Zeiteinheit. Wenn kein Wert angegeben ist, wird standardmäßig „Tag“ verwendet. Gültige Werte sind:
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType | 1 | Enum | Verschiedene Arten von Einschränkungen hinsichtlich der Aufenthaltsdauer. SetMaxLOS und SetMinLOS beruhen auf der Ankunft.
SetForwardMinStay und SetForwardMaxStay beruhen auf dem Aufenthalt. Höchstwerte müssen größer oder gleich den Mindestwerten sein. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus | 0..1 | RestrictionStatus | Definiert Reiseplaneinschränkungen. Darf nicht vorhanden sein, wenn <AvailStatusMessage> das Attribut BookingLimit enthält. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status | 0..1 | Enum | Gibt an, ob die mit dem Attribut
Hinweis: Um Raum- und Preisverfügbarkeit für eine bestimmte |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction | 0..1 | Enum | Dieses Attribut ist erforderlich, wenn Gültige Werte sind:
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset | 0..1 | Int | Mindestanzahl von Tagen vor dem Ankunftsdatum, für die dieser Zimmerpreis gebucht werden kann. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset | 0..1 | Int | Maximale Anzahl von Tagen vor dem Ankunftsdatum, für die dieser Zimmerpreis gebucht werden kann. |
Beispiele
Beispiel 1
Minimale/maximale Aufenthaltsdauer (beruhend auf dem Ankunftsdatum) + Min./Max. Kauf im Voraus + geschlossen für Ankunft + Inventarzahl
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage BookingLimit="5"> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1"/> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <LengthsOfStay> <LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/> <LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/> </LengthsOfStay> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Close" Restriction="Arrival" MaxAdvancedBookingOffset="30" MinAdvancedBookingOffset="7"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
Beispiel 2
Minimale/maximale Aufenthaltsdauer (beruhend auf Aufenthalt)
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <LengthsOfStay> <LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/> <LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/> </LengthsOfStay> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
Beispiel 3
Geschlossen für Abreise (schließt Reisepläne mit Check-out an bestimmten Terminen aus)
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Close" Restriction="Departure"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
Beispiel 4
Geschlossen für Ankunft (schließt Reisepläne mit Check-in an bestimmten Terminen aus)
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Close" Restriction="Arrival"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
Beispiel 5
Offene Verfügbarkeit, keine Einschränkungen
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage BookingLimit="5"> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1"/> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Open" Restriction="Master"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
Beispiel 6
Einschränkungen für minimalen und maximalen Reservierungszeitraum, die nur an Wochenenden gelten
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage> <StatusApplicationControl Start="2020-01-01" End="2020-06-30" Mon=”false” Tue=”false” Weds=”false” Thur=”false” Fri=”false” Sat=”true” Sun=”true” InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus MaxAdvancedBookingOffset="30" MinAdvancedBookingOffset="2"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
Beispiel 7
Legen Sie für einen Zimmertyp und Preisplan mehrere Einschränkungen für die gleichen Termine fest.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Close" Restriction="Master"/> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Open" Restriction="Arrival"/> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Open" Restriction="Departure"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>