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>

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 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 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 <StatusApplicationControl> gebucht werden können. Wenn BookingLimit angegeben ist, muss InvTypeCode durch <StatusApplicationControl> 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 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 true gesetzt, werden andere Tage der Woche, die nicht explizit auf „wahr“ gesetzt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start and End).

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue 0..1 boolean Geben Sie true oder 1 an, um Dienstage explizit einzubeziehen.

Wird der Wert auf true gesetzt, werden andere Tage der Woche, die nicht explizit auf true gesetzt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start und End herausgefiltert.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean Geben Sie true oder 1 an, um Mittwoche explizit einzubeziehen.

Wird der Wert auf true gesetzt, werden andere Tage der Woche, die nicht explizit auf true gesetzt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start und End herausgefiltert.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean Geben Sie true oder 1 an, um Donnerstage explizit einzubeziehen.

Wird der Wert auf true gesetzt, werden andere Tage der Woche, die nicht explizit auf true gesetzt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start und End herausgefiltert.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0..1 boolean Geben Sie true oder 1 an, um Freitage ausdrücklich einzubeziehen.

Wird der Wert auf true gesetzt, werden andere Tage der Woche, die nicht explizit auf true gesetzt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start und End herausgefiltert.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat 0..1 boolean Geben Sie true oder 1 an, um Samstage explizit einzubeziehen.

Wird der Wert auf true gesetzt, werden andere Tage der Woche, 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 Geben Sie true oder 1 an, um Sonntage explizit einzubeziehen.

Wird der Wert auf true gesetzt, werden andere Tage der Woche, die nicht explizit auf true gesetzt 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 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 RatePlanCode ist nicht anwendbar und darf nicht angegeben werden, wenn <AvailStatusMessage> das Attribut BookingLimit enthält. Muss angegeben werden, wenn <RestrictionStatus> oder <LengthOfStay> festgelegt ist.

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 MinMaxMessageType="FullPatternLOS" festgelegt sein. Andernfalls darf es nicht vorhanden sein.

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 MinMaxMessageType="FullPatternLOS".

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
Hinweis:Eine "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 MinMaxMessageType="FullPatternLOS" verwendet wird, andernfalls nicht.

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
  • Close

Open- und Close-Werte sind mit allen Werten des <Restriction>-Elements kompatibel. Wenn die Werte Open und Close mit den Werten Arrival und Departure verwendet werden, werden bestimmte Daten im Reiseplan für den Check-in bzw. Check-out eingeschränkt.

  • 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 Arrival schränkt die Verfügbarkeit für die Übernachtungen nach dem Check-in-Datum nicht ein.

    Ein Aufenthalt vom 1. bis 4. April, bei dem der 2. bis 4. April nicht gebucht werden kann, ist beispielsweise weiterhin buchbar.

    Hinweis:

    • Standardmäßig geht Google davon aus, dass die Master-Einstellung für alle Produkte Close ist. Sie können dies unter „Standardverfügbarkeit“ in den Preiseinstellungen des Hotel Centers konfigurieren. Der Wert „Geschlossen“ im Hotel Center entspricht hier 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 innerhalb des Zeitraums von Start bis End ausgeschlossen.
    • Departure: Mit diesem Wert werden Reisepläne mit einem Abreisedatum innerhalb des Zeitraums von Start bis End ausgeschlossen.
    • Master:: Dieser Wert gibt an, ob der Zimmerpreis für die Buchung an diesem Datum verfügbar ist.

    Sowohl Arrival als auch Departure müssen für den angegebenen Reiseplan verfügbar sein. Der Standardwert für Arrival und Departure ist Open, es sei denn, es wurde zuvor eine Nachricht gesendet, die darauf hinweist, dass die Anfrage geschlossen wurde. Außerdem muss die Kombination aus Zimmer und Paket für alle Tage des Reiseplans verfügbar sein, mit Ausnahme des letzten Tages des Aufenthalts. Diese Verfügbarkeit kann entweder über die Standardeinstellungen im Hotel Center oder über das Element <Status> oder <Restriction> festgelegt werden. Wenn die Standardeinstellung Close ist, müssen Sie für die entsprechenden Datumsangaben einen Status-Wert von Open und einen restriction-Wert von Master senden, um die Verfügbarkeit für die Reisedaten wieder zu aktivieren.

    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 Status sollte auf Open und der Wert für Restriction auf Master für die Übernachtung vom 1. bis 3. April festgelegt sein. Der letzte Tag des Aufenthalts (4. April) ist geschlossen, da nur die Daten der Übernachtungen einen Open-Status erfordern.

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

    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:

    • Integer: Die Anzahl der Tage vor dem Ankunftsdatum. Der Wert 1 gibt beispielsweise an, dass der Zimmerpreis spätestens einen Tag vor dem Ankunftsdatum gebucht werden muss. Der Wert 0 (Standardwert) gibt keine Einschränkung der spätesten Buchungszeit an.
    • 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 spätestens sechs Stunden vor Ende der Ankunftszeit (d.h. 18:00 Uhr) erfolgen muss.
    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:

    • Integer: Die Anzahl der Tage vor dem Ankunftsdatum. Der Wert 30 gibt beispielsweise an, dass der Zimmerpreis frühestens 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 frühestens 30 Tage vor dem Ankunftsdatum gebucht werden kann. Der Wert P30DT6H gibt an, dass die Buchung frühestens 30 Tage (ab 18:00 Uhr) vor dem Ankunftsdatum erfolgen kann.

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