OTA_HotelAvailNotifRQ

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"
                       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 partner Ihrer Nachricht „Transaktion (Unterkunftsdaten)“ und dem Attributwert ID im Element <RequestorID> der Nachricht <OTA_HotelRateAmountNotifRQ> für dasselbe Konto übereinstimmen.

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 <StatusApplicationControl> 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 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 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 / @Tue 0..1 Boolescher Wert Legen Sie true oder 1 fest, 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 Boolescher Wert Legen Sie true oder 1 fest, 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 Boolescher Wert Legen Sie true oder 1 fest, 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 Boolescher Wert Legen Sie true oder 1 fest, 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 Boolescher Wert Legen Sie true oder 1 fest, 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 Boolescher Wert Legen Sie true oder 1 fest, 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 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 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 / 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:

  • Tag
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 Restriction festgelegte Einschränkung offen oder geschlossen ist. Gültige Werte sind:

  • Offen
  • Geschlossen

Hinweis: Um Raum- und Preisverfügbarkeit für eine bestimmte <StatusApplicationControl>-Einstellung zu ermitteln, muss das Status-Attribut aufOffen und das Restriction-Attribut mindestens einmal auf Master festgelegt werden. Alternativ können Partner Google bitten, ihr Konto so zu konfigurieren, dass das Status-Attribut standardmäßig auf Offen gesetzt wird, nachdem sie uns einen Preis mitgeteilt haben und BookingLimit größer als 0 ist.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction 0..1 Enum

Dieses Attribut ist erforderlich, wenn Status angegeben wird.

Gültige Werte sind:

  • Ankunft: Mit diesem Wert werden Reisepläne mit einem Anreisedatum innerhalb des Zeitraums von Start bis End ausgeschlossen.
  • Abreise: 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.
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>