Anfragen
Syntax
Die Nachricht OTA_HotelAvailNotifRQ
verwendet die folgende Syntax:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="message_ID"
TimeStamp="timestamp"
Version="3.0">
<POS>
<Source>
<RequestorID ID="partner_key"/>
</Source>
</POS>
<AvailStatusMessages HotelCode="HotelID">
<AvailStatusMessage BookingLimit="integer">
<StatusApplicationControl Start="YYYY-MM-DD"
End="YYYY-MM-DD"
Mon="boolean"
Tue="boolean"
Weds="boolean"
Thur="boolean"
Fri="boolean"
Sat="boolean"
Sun="boolean"
InvTypeCode="RoomID"/>
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="YYYY-MM-DD"
End="YYYY-MM-DD"
Mon="boolean"
Tue="boolean"
Weds="boolean"
Thur="boolean"
Fri="boolean"
Sat="boolean"
Sun="boolean"
InvTypeCode="RoomID"
RatePlanCode="PackageID"/>
<LengthsOfStay FixedPatternLength="integer">
<LengthOfStay Time="integer"
TimeUnit="[Day]"
MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
SetForwardMinStay|FullPatternLOS]">
<LOS_Pattern FullPatternLOS="pattern"/>
</LengthOfStay>
</LengthsOfStay>
<RestrictionStatus Status="[Close|Open]"
Restriction="[Arrival|Departure|Master]"
MaxAdvancedBookingOffset="integer_or_duration"
MinAdvancedBookingOffset="integer_or_duration"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Jede <OTA_HotelAvailNotifRQ>
-Nachricht wird als Delta-Update behandelt.
Bei jeder Unterkunft, jedem Datum, jedem Zimmer und jedem Paket, das in <StatusApplicationControl>
angegeben ist, wird durch eine Aktualisierung einer zuvor definierten Einschränkung nur der Wert derselben Einschränkung ersetzt. Das Hinzufügen einer neuen Einschränkung wirkt sich dagegen nicht auf andere zuvor definierte Einschränkungen aus. Wenn beispielsweise zuvor eine Mindestaufenthaltsdauer von 2 Tagen definiert wurde und dann eine neue Nachricht mit nur einer maximalen Aufenthaltsdauer von 7 Tagen aktualisiert wurde, wird durch diese Aktion der vorherige Wert für die Mindestaufenthaltsdauer nicht gelöscht.
Elemente und Attribute
Die Nachricht OTA_HotelAvailNotifRQ
enthält folgende Elemente und Attribute:
Hinweis:Jede Art von Einschränkung hinsichtlich der Aufenthaltsdauer wird unabhängig festgelegt. Beispiel: Eine Nachricht, mit der SetMaxLOS
festgelegt wird, überschreibt nicht den zuvor für SetForwardMaxStay
definierten Wert.
Element / @Attribut | Häufigkeit | Typ | Beschreibung |
---|---|---|---|
OTA_HotelAvailNotifRQ | 1 | Complex element | Das Stammelement für eine Nachricht, die die Verfügbarkeit des Zimmerpreises definiert. |
OTA_HotelAvailNotifRQ / @xmlns | 0..1 | string (URI) | Der XML-Namespace. |
OTA_HotelAvailNotifRQ / @EchoToken | 1 | string | Eine eindeutige Kennung für diese Anfragenachricht. Dieser Wert wird in der Antwortnachricht zurückgegeben. Zulässige Zeichen sind a-z , A-Z , 0-9 , _ (Unterstrich) und - (Bindestrich). |
OTA_HotelAvailNotifRQ / @TimeStamp | 1 | DateTime | Erstellungsdatum und -uhrzeit der Nachricht. |
OTA_HotelAvailNotifRQ / @Version | 1 | decimal | Die Nachrichtenversion von OpenTravel. |
OTA_HotelAvailNotifRQ / POS | 0..1 | POS | Ein Container zum Angeben des Partnerkontos für diese Nachricht. Sie verwenden dieses Attribut normalerweise, wenn Ihr Backend Preisfeeds für mehrere Partnerkonten bereitstellt. |
OTA_HotelAvailNotifRQ / POS/ Source | 1 | Source | 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 Partner key , der im Hotel Center auf der
Seite „Kontoeinstellungen“ aufgeführt ist.
Hinweis: Wenn Sie ein Backend haben, das Feeds für mehrere Konten bereitstellt, muss dieser Wert mit dem Attributwert |
OTA_HotelAvailNotifRQ / AvailStatusMessages | 1 | AvailStatusMessages | Ein Container für ein oder mehrere <AvailStatusMessage> -Elemente. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode | 1 | string | Die eindeutige Kennung der 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 / 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 | integer |
Hinweis:Statt dieses Attribut zu setzen, wird als Methode die Verwendung der Nachricht
OTA_HotelInvCountNotifRQ bevorzugt. Die Anzahl der verbleibenden Räume, die für den Zeitraum in Muss gleich oder größer als 0 sein. Die Standardeinstellung ist 0, wenn negativ oder nicht angegeben. Hinweis: Zum Festlegen der Zimmerverfügbarkeit für eine bestimmte |
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 | Date | Das einschließliche Startdatum (basierend auf der Zeitzone der Unterkunft) des Zeitraums. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End | 1 | Date | Das einschließliche Enddatum (basierend auf der Zeitzone der Unterkunft) 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 | boolean | Geben Sie true oder 1 an, um Montagen explizit einzubeziehen.
Wird der Wert auf |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue | 0..1 | boolean | Geben Sie true oder 1 an, um Dienstage explizit einzubeziehen.
Wird der Wert auf |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds | 0..1 | boolean | Geben Sie true oder 1 an, um Mittwoche explizit einzubeziehen.
Wird der Wert auf |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur | 0..1 | boolean | Geben Sie true oder 1 an, um Donnerstage explizit einzubeziehen.
Wird der Wert auf |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri | 0..1 | boolean | Geben Sie true oder 1 an, um Freitage ausdrücklich einzubeziehen.
Wird der Wert auf |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat | 0..1 | boolean | Geben Sie true oder 1 an, um Samstage explizit einzubeziehen.
Wird der Wert auf |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun | 0..1 | boolean | Geben Sie true oder 1 an, 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 Transaktionen (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 / @FixedPatternLength | 0..1 | integer | Die Länge des in FullPatternLOS definierten Musters.
Hinweis: Dieses Attribut muss bei Verwendung von |
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 | 0..1 | integer | 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.
Hinweis:Dieses Attribut muss festgelegt werden, es sei denn, Sie verwenden |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit | 0..1 | enum | Die Zeiteinheit. Wenn kein Wert angegeben ist, wird der Standardwert "Day" verwendet. Gültiger Wert:
"Day" -Einheit entspricht einem Aufenthalt von einer Nacht.
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType | 1 | enum | Verschiedene Arten von Einschränkungen hinsichtlich der Aufenthaltsdauer. SetMaxLOS , SetMinLOS und FullPatternLOS sind ankunftsbasiert. SetForwardMinStay und
SetForwardMaxStay beruhen auf dem Aufenthalt. Höchstwerte müssen größer oder gleich den Mindestwerten sein. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern | 0..1 | LOS_Pattern | Definiert das Muster für Einschränkungen hinsichtlich der Aufenthaltsdauer.
Hinweis:Dieses Element muss vorhanden sein, wenn |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS | 1 | string | Eine Folge von Y - und N -Zeichen, die angibt, ob die jeweilige Aufenthaltsdauer zulässig ist, von einer Nacht bis zum Wert in FixedPatternLength . Bei einer Aufenthaltsdauer von mehr als
FixedPatternLength wird der Wert an der letzten Position übernommen. Bei FixedPatternLength="4" und
FullPatternLOS="YNYN" sind beispielsweise nur die Aufenthaltsdauern 1 und 3 zulässig.
|
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 Restriction festgelegte Einschränkung offen oder geschlossen ist. Gültige Werte sind:
Open und Close mit Arrival :
Mit dieser Kombination wird angegeben, welche Tage im Reiseplan für den Check-in verfügbar sind.Open und Close mit Departure :
Mit dieser Kombination wird angegeben, welche Tage im Reiseplan für den Check-out verfügbar sind.Das Datum Ein Aufenthalt vom 1. bis 4. April, bei dem der 2. bis 4. April nicht gebucht werden kann, ist beispielsweise weiterhin buchbar. Hinweis:
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction | 0..1 | enum | Dieses Attribut ist erforderlich, wenn Gültige Werte sind:
Sowohl Bei einem Aufenthalt von drei Nächten mit dem Anreisedatum 1. April umfasst der Reiseplan beispielsweise den 1. bis 4. April. Der Wert für Hinweis:Wenn |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset | 0..1 | integer or duration | Zeitraum vor dem Ankunftsdatum (in der Ortszeit der Unterkunft), innerhalb dessen die Buchung eines Zimmers zu diesem Preis spätestens erfolgt sein muss.
Folgende Werttypen sind gültig:
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset | 0..1 | integer or duration | Zeitraum vor dem Ankunftsdatum (in der Ortszeit der Unterkunft), innerhalb dessen das Zimmer zu diesem Preis gebucht werden kann.
Folgende Werttypen sind gültig:
|
Beispiele
Datum der Ankunft des Kundenservicemitarbeiters
Legen Sie die minimale und maximale Aufenthaltsdauer (bezogen auf das Ankunftsdatum) fest.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay>
<LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/>
<LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Aufenthaltsdauer
Legen Sie die minimale und maximale Aufenthaltsdauer (bezogen auf Aufenthalt) fest.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay>
<LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/>
<LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Sichtbarkeitsbeschränkungen entfernen
Wenn Sie für <LengthOfStay>
die Option „Time“ auf „0“ festlegen, gibt es keine Einschränkungen für die angegebene Aufenthaltsdauer. <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/>
bedeutet beispielsweise, dass es keine maximale Aufenthaltsdauer gibt.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2024-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2024-07-26"
End="2024-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay>
<LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Abflugbeschränkung
Legen Sie eine Einschränkung „Ausgeschlossene Abreisetage“ fest. (Dadurch werden Reisepläne mit Check-out an bestimmten Terminen verhindert.)
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Departure"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Einreisebeschränkung
Legen Sie eine Einschränkung „Ausgeschlossene Ankunftstage“ fest. Dadurch werden Reisepläne mit Check-in an bestimmten Terminen verhindert.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Arrival"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Verfügbare Tage
Verfügbarkeit für einen Zimmertyp und Preisplan an bestimmten Terminen zulassen.
Hinweis:Übernachtungspreise werden ebenfalls zusammen mit einer Inventarzahl größer als 0 für den Zimmertyp benötigt, bevor die Preise vollständig verfügbar sind.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Open" Restriction="Master"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Verfügbarkeitsdaten schließen
Verfügbarkeit für einen Zimmertyp und einen Preisplan an bestimmten Tagen ausschließen. Dies wird auch als „Stopp-Sell“ bezeichnet.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Master"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Einschränkungen bei der Vorausbuchung
Legen Sie minimale und maximale Beschränkungen des Reservierungszeitraums fest, die nur an Wochenenden gelten.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-01-01"
End="2023-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>
Annahmeschluss für Buchungen
Legen Sie einen Termin für die Buchung am Anreisetag um 18:00 Uhr (Ortszeit des Hotels) fest.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-01-01"
End="2023-06-30"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus MinAdvancedBookingOffset="P0DT6H0M"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Mehrere Einschränkungen
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"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Open" Restriction="Master"/>
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Arrival"/>
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Departure"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Buchungslimit
Legen Sie die Inventarzahl für einen Zimmertyp für bestimmte Termine fest.
Hinweis:Statt dieses Attribut zu setzen, wird als Methode die Verwendung der Nachricht OTA_HotelInvCountNotifRQ bevorzugt.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage BookingLimit="5">
<!-- Note: RatePlanCode must not be specified here when setting inventory counts. -->
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
FullPatternLoS
Legen Sie eine Einschränkung für die Aufenthaltsdauer für das vollständige Muster fest.
Für einen Check-in am 26. Juli 2023 sind nur Aufenthaltsdauern von 2, 4 und 6 Tagen zulässig. Die Aufenthaltsdauern 1, 3, 5 und 7 Tage oder mehr sind nicht verfügbar.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-26"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay FixedPatternLength="7">
<LengthOfStay MinMaxMessageType="FullPatternLOS">
<LOS_Pattern FullPatternLOS="NYNYNYN"/>
</LengthOfStay>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Antworten
Syntax
Die Nachricht OTA_HotelAvailNotifRS
verwendet die folgende Syntax:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
TimeStamp="timestamp"
EchoToken="echo_token"
Version="3.0">
<!-- Either Success or Errors will be populated. -->
<Success/>
<Errors>
<Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
</Errors>
</OTA_HotelAvailNotifRS>
Elemente und Attribute
Die Nachricht OTA_HotelAvailNotifRS
enthält folgende Elemente und Attribute:
Element / @Attribut | Häufigkeit | Typ | Beschreibung |
---|---|---|---|
OTA_HotelAvailNotifRS | 1 | Complex element | Das Stammelement für eine Antwort auf eine Verfügbarkeitsnachricht. |
OTA_HotelAvailNotifRS / @TimeStamp | 1 | DateTime | Erstellungsdatum und -uhrzeit der Nachricht. |
OTA_HotelAvailNotifRS / @EchoToken | 1 | string | Die eindeutige Kennung der zugehörigen OTA_HotelAvailNotifRQ -Nachricht. |
OTA_HotelAvailNotifRS / Success | 0..1 | Success | Gibt an, dass die Nachricht OTA_HotelAvailNotifRQ erfolgreich verarbeitet wurde.
Entweder |
OTA_HotelAvailNotifRS / Errors | 0..1 | Errors | Ein Container für ein oder mehrere Probleme, die bei der Verarbeitung der Nachricht OTA_HotelAvailNotifRQ aufgetreten sind.
Entweder |
OTA_HotelAvailNotifRS / Errors / Error | 1..n | Error | Die Beschreibung eines Fehlers, der bei der Verarbeitung der Nachricht OTA_HotelAvailNotifRQ aufgetreten ist. Details zu diesen Fehlern finden Sie unter
Fehlercodes für den Feedstatus. |
OTA_HotelAvailNotifRS / Errors / Error / @Type | 1 | integer | Der mit dem Fehler verknüpfte OpenTravel Alliance EWT (Error Warning Type, Art der Fehlerwarnung). Nur der Wert 12 (Processing exception) wird verwendet. |
OTA_HotelAvailNotifRS / Errors / Error / @Code | 1 | integer | Der mit dem Fehler verknüpfte OpenTravel Alliance ERR (Error Code, Fehlercode).
Nur der Wert 450 (Unable to process) wird verwendet. |
OTA_HotelAvailNotifRS / Errors / Error / @Code | 1 | enum | Der Status der ursprünglichen Anfrage. Nur der Wert NotProcessed wird verwendet. |
OTA_HotelAvailNotifRS / Errors / Error / @ShortText | 1 | string | Die Google-Kennung für das Problem. Details zu diesen Fehlern finden Sie unter Fehlercodes für den Feedstatus. |
Beispiele
Erfolg
Die folgende Antwort ist eine Antwort auf eine erfolgreich verarbeitete OTA_HotelAvailNotifRQ-Nachricht.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<Success/>
</OTA_HotelAvailNotifRS>
Fehler
Im Folgenden finden Sie eine Antwort auf eine OTA_HotelAvailNotifRQ-Nachricht, die aufgrund von Fehlern nicht verarbeitet wurde.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<Errors>
<Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
</Errors>
</OTA_HotelAvailNotifRS>