OTA_HotelAvailNotifRQ

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>

Wichtiger Hinweis: Jede <OTA_HotelAvailNotifRQ>-Nachricht wird als Delta-Update behandelt. Bei jeder Unterkunft, jedem Datum, Zimmer und Paket, die in <StatusApplicationControl> angegeben sind, ersetzt eine Aktualisierung einer zuvor definierten Einschränkung nur den Wert derselben Einschränkung. Das Hinzufügen einer neuen Einschränkung wirkt sich hingegen nicht auf andere zuvor definierte Einschränkungen aus. Wenn beispielsweise zuvor eine Mindestaufenthaltsdauer für 2 Tage definiert wurde und dann eine neue Nachricht aktualisiert wird, die nur eine maximale Aufenthaltsdauer von 7 Tagen enthält, wird der vorherige Wert für die Mindestaufenthaltsdauer nicht gelöscht.

Elemente und Attribute

Die Nachricht OTA_HotelAvailNotifRQ enthält die folgenden Elemente und Attribute:

Hinweis:Jede Art von Einschränkung der Aufenthaltsdauer wird unabhängig voneinander festgelegt. Beispielsweise überschreibt eine Nachricht, mit der SetMaxLOS festgelegt wird, keinen zuvor definierten Wert für SetForwardMaxStay.

Element / @Attribut	Häufigkeit	Typ	Beschreibung
OTA_HotelAvailNotifRQ	1	Complex element	Das Stammelement für eine Nachricht, die die Verfügbarkeit von Zimmerpreisen 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 OpenTravel-Nachrichtenversion.
OTA_HotelAvailNotifRQ / POS	0..1	POS	Ein Container zum Angeben des Partnerkontos für diese Nachricht. Sie wird normalerweise verwendet, 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 partner der Nachricht „Transaktion (Unterkunftsdaten)“ und dem Attributwert ID im Element <RequestorID> der Nachricht <OTA_HotelRateAmountNotifRQ> für dasselbe Konto übereinstimmen.
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> des Hotellistenfeeds angegeben wurde. Die Hotel-ID ist auch im Hotel Center aufgeführt.
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: Anstelle dieses Attributs wird die Nachricht OTA_HotelInvCountNotifRQ bevorzugt. Die Anzahl der verbleibenden Räume, die für den Zeitraum in <StatusApplicationControl> gebucht werden können. Wenn BookingLimit angegeben ist, muss für <StatusApplicationControl> InvTypeCode angegeben werden und <AvailStatusMessage> darf weder <LengthOfStay> noch <RestrictionStatus> enthalten. 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 <StatusApplicationControl>-Einstellung muss das Attribut BookingLimit mindestens einmal festgelegt werden.
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 Startdatum, basierend auf der Zeitzone der Property, die den Zeitraum einschließt.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End	1	Date	Das Enddatum (basierend auf der Zeitzone der Unterkunft), einschließlich des Zeitraums. Muss gleich oder größer als der Wert von start sein. Wenn start und end gleich sind, wird die Aktualisierung auf dieses Datum angewendet.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon	0..1	boolean	Legen Sie true oder 1 fest, um Montage explizit einzubeziehen. Wenn true festgelegt ist, werden andere Wochentage, die nicht explizit auf „true“ gesetzt sind, ausgeschlossen. Sie werden also aus den Datumsangaben im Start and End). herausgefiltert.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue	0..1	boolean	Legen Sie true oder 1 fest, um Dienstags explizit einzubeziehen. Wenn true festgelegt ist, werden andere Wochentage, die nicht explizit auf true festgelegt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start und End herausgefiltert.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds	0..1	boolean	Legen Sie true oder 1 fest, um Mittwoche explizit einzubeziehen. Wenn true festgelegt ist, werden andere Wochentage, die nicht explizit auf true festgelegt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start und End herausgefiltert.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur	0..1	boolean	Legen Sie true oder 1 fest, um Donnerstage explizit einzubeziehen. Wenn true festgelegt ist, werden andere Wochentage, die nicht explizit auf true festgelegt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start und End herausgefiltert.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri	0..1	boolean	Legen Sie true oder 1 fest, um Freitage explizit einzubeziehen. Wenn true festgelegt ist, werden andere Wochentage, die nicht explizit auf true festgelegt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start und End herausgefiltert.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat	0..1	boolean	Legen Sie true oder 1 fest, um Samstage explizit einzubeziehen. Wenn true festgelegt ist, werden andere Wochentage, die nicht explizit auf true gesetzt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen „Start“ und „End“ herausgefiltert.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun	0..1	boolean	Legen Sie true oder 1 fest, um Sonntage explizit einzubeziehen. Wenn true festgelegt ist, werden andere Wochentage, die nicht explizit auf true festgelegt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start und End herausgefiltert.
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 ist dem Wert von <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 RatePlanCode ist nicht anwendbar und darf nicht angegeben werden, wenn <AvailStatusMessage> das Attribut BookingLimit enthält. Muss angegeben werden, wenn <RestrictionStatus> oder <LengthOfStay> angegeben ist.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay	0..1	LengthsOfStay	Ein Container zum Definieren von Einschränkungen der Aufenthaltsdauer. Muss 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 festgelegt werden, wenn MinMaxMessageType="FullPatternLOS" verwendet wird, andernfalls wird es nicht angegeben.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay	1..n	LengthOfStay	Definiert Einschränkungen für die Aufenthaltsdauer. Wenn Sie mehr als ein <LengthOfStay>-Element verwenden, muss jedes einen anderen MinMaxMessageType-Wert angeben.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time	0..1	integer	Einheitswert für die Messung der Aufenthaltsdauer. Der Wert null gilt als keine Einschränkung. Beispielsweise bedeutet <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS">, dass keine maximale Aufenthaltsdauer vorhanden ist. Hinweis: Dieses Attribut muss festgelegt werden, sofern nicht MinMaxMessageType="FullPatternLOS" verwendet wird.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit	0..1	enum	Die Zeiteinheit. Wenn kein Wert angegeben ist, wird standardmäßig "Day" verwendet. Gültiger Wert: Day Hinweis: Eine "Day"-Einheit entspricht einer Übernachtung.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType	1	enum	Verschiedene Arten von Einschränkungen bei der Aufenthaltsdauer SetMaxLOS, SetMinLOS und FullPatternLOS sind ankunftsbasiert. SetForwardMinStay und SetForwardMaxStay basieren 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 die Einschränkung der Aufenthaltsdauer. Hinweis: Dieses Element muss bei Verwendung von MinMaxMessageType="FullPatternLOS" vorhanden sein und andernfalls nicht vorhanden sein.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS	1	string	Eine Folge aus Y- und N-Zeichen, die angibt, ob die einzelnen Aufenthaltsdauern von einer Nacht bis zum Wert in FixedPatternLength zulässig sind. Bei einer Aufenthaltsdauer, die größer als FixedPatternLength ist, wird der Wert an der endgültigen Position übernommen. Mit 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. Muss nicht vorhanden sein, wenn <AvailStatusMessage> das Attribut BookingLimit enthält.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status	0..1	enum	Gibt an, ob die durch das Attribut Restriction angegebene Einschränkungsart offen oder geschlossen ist. Gültige Werte sind: Open Close Hinweis: Standardmäßig geht Google davon aus, dass die Einstellung Master für alle Produkte Close ist. Sie können dies in den Preiseinstellungen des Hotel Centers unter „Standardverfügbarkeit“ konfigurieren. Der Wert „Geschlossen“ im Hotel Center entspricht dem Wert Close. Das Festlegen von Master auf Close wird als „Stopp-Sell“ bezeichnet.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction	0..1	enum	Dieses Attribut ist erforderlich, wenn Status angegeben wird. Gültige Werte sind: Arrival: Mit diesem Wert werden Reisepläne mit einem Check-in-Datum im Zeitraum Start und End (einschließlich) verhindert. Departure: Mit diesem Wert werden Reisepläne mit einem Check-out-Datum im Zeitraum Start und End (einschließlich) verhindert. Master: Dieser Wert gibt an, ob der Zimmerpreis für die Buchung für das Datum verfügbar ist. Hinweis: Wenn Restriction nicht angegeben ist, ist der Standardwert Master.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset	0..1	integer or duration	Mindestdauer vor dem Ankunftsdatum (in der Ortszeit der Unterkunft), bis zu der dieser Zimmerpreis gebucht werden kann. Folgende Werttypen sind gültig: Integer:: Die Anzahl der Tage vor dem Ankunftsdatum. Beispielsweise gibt der Wert 1 an, dass der Zimmerpreis mindestens einen Tag vor dem Ankunftsdatum gebucht werden muss. Der Wert 0 (Standardwert) gibt an, dass die letzte Buchungszeit nicht eingeschränkt ist. ISO 8601 Duration (days, hours, and minutes):: Die Anzahl der Tage (und optional Stunden/Minuten) vor dem Ankunftsdatum. Der Wert P1D gibt beispielsweise an, dass der Zimmerpreis einen Tag vor dem Ankunftsdatum gebucht werden muss. Der Wert P0DT6H gibt an, dass die Buchung mindestens sechs Stunden vor Ende der Ankunft (18:00 Uhr) erfolgen muss.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset	0..1	integer or duration	Maximale Dauer vor dem Ankunftsdatum (in der Ortszeit der Unterkunft), für die dieser Zimmerpreis gebucht werden kann. Folgende Werttypen sind gültig: Integer:: Die Anzahl der Tage vor dem Ankunftsdatum. Der Wert 30 gibt beispielsweise an, dass der Zimmerpreis nicht früher als 30 Tage vor dem Ankunftsdatum gebucht werden kann. Der Wert 0 (Standardwert) gibt keine Einschränkung der frühesten Buchungszeit an. ISO 8601 Duration (days, hours, and minutes):: Die Anzahl der Tage (und optional Stunden/Minuten) vor dem Ankunftsdatum. Der Wert P30D gibt beispielsweise an, dass der Zimmerpreis nicht früher als 30 Tage vor dem Ankunftsdatum gebucht werden kann. Der Wert P30DT6H gibt an, dass die Buchung nicht früher als 18:00 Uhr 30 Tage vor dem Ankunftsdatum erfolgen kann.

Beispiele

LOS-Ankunftsdatum

Legen Sie die minimale und maximale Aufenthaltsdauer (basierend auf dem 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>

Dauer der Aufenthaltsdauer

Legen Sie die minimale und maximale Aufenthaltsdauer (basierend auf dem 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>

Abflugbeschränkung

Legen Sie einen Ausschluss für die Abreisezeit fest. (Dadurch werden Reisepläne mit Check-out an bestimmten Daten 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>

Ankunftsbeschränkung

Legen Sie eine Einschränkung für Ankunftssperren 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ügbarkeitsdaten öffnen

Verfügbarkeit für einen Zimmertyp und Preisplan an bestimmten Tagen öffnen.

Hinweis:Auch Übernachtungspreise sind zusammen mit einer Inventarzahl größer als 0 für den Zimmertyp erforderlich, bevor 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 Preisplan an bestimmten Terminen schließ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 Vorausbuchungen

Legen Sie minimale und maximale Einschränkungen für den Reservierungszeitraum 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>

Bestellannahmeschluss

Lege einen Annahmeschluss für Buchungen am Ankunftsdatum um 18:00 Uhr in der 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 dieselben Daten 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>

Hinweis: Wenn Restriction nicht angegeben ist, ist der Standardwert Master.

Buchungslimit

Legen Sie die Inventaranzahl für einen Zimmertyp für bestimmte Zeiträume fest.

Hinweis: Anstelle dieses Attributs sollte die Nachricht OTA_HotelInvCountNotifRQ bevorzugt werden.

<?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 vollständige Einschränkung der Aufenthaltsdauer fest.

Für einen Check-in am 26. Juli 2023 ist nur eine Aufenthaltsdauer von 2, 4 und 6 Aufenthalten zulässig. Die Aufenthaltsdauern ab 1, 3, 5 und 7 Jahre 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 die folgenden 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 <Success> oder <Errors> ist in jeder Nachricht enthalten.
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 <Success> oder <Errors> ist in jeder Nachricht enthalten.
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 Fehlermeldungen zum 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 Fehlermeldungen zum Feedstatus.

Beispiele

Abgeschlossen

Im Folgenden finden Sie 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>