OTA_HotelAvailNotifRQ

Anfragen

Syntax

Die OTA_HotelAvailNotifRQ-Nachricht 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. Für jedes in <StatusApplicationControl> angegebene Hotel, Datum, Zimmer und Paket wird bei einer Aktualisierung einer zuvor definierten Einschränkung nur der Wert derselben Einschränkung ersetzt. Das Hinzufügen einer neuen Einschränkung hat keine Auswirkungen auf andere zuvor definierte Einschränkungen. 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 nicht der Wert der vorherigen Mindestaufenthaltsdauer gelöscht.

Elemente und Attribute

Die OTA_HotelAvailNotifRQ-Meldung enthält die folgenden Elemente und Attribute:

Hinweis: Jede Art von Einschränkung der Aufenthaltsdauer wird unabhängig festgelegt. Eine Nachricht, in der SetMaxLOS festgelegt wird, überschreibt beispielsweise keinen zuvor definierten Wert für SetForwardMaxStay.

Element / @Attribut	Häufigkeit	Typ	Beschreibung
OTA_HotelAvailNotifRQ	1	Complex element	Das Stammelement für eine Nachricht, in der die Verfügbarkeit von Zimmerpreisen definiert wird.
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. Es 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 Ihrer 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> im Hotellistenfeed angegeben wird. Die Hotel-ID wird 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: gegenüber dem Festlegen 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 InvTypeCode in <StatusApplicationControl> angegeben werden und <AvailStatusMessage> darf weder <LengthOfStay> noch <RestrictionStatus> enthalten. Muss gleich oder größer als 0 sein. Wenn negativ oder nicht angegeben, wird die Standardeinstellung 0 verwendet. Hinweis: Zum Festlegen der Zimmerverfü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	Date	Das Startdatum, das auf der Zeitzone der Unterkunft basiert und den Zeitraum umfasst.
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 start sein. Wenn start und end gleich sind, wird die Aktualisierung auf dieses Datum angewendet.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon	0..1	boolean	Geben Sie true oder 1 an, 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 Dienstage explizit einzubeziehen. Wenn true festgelegt ist, werden andere Wochentage ausgeschlossen, die nicht explizit auf true gesetzt sind. Sie werden also aus den Datumsangaben in 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 ausgeschlossen, die nicht explizit auf true gesetzt sind. Sie werden also aus den Datumsangaben in Start und End herausgefiltert.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur	0..1	boolean	Geben Sie true oder 1 an, um Donnerstage explizit einzubeziehen. Wenn true festgelegt ist, werden andere Wochentage ausgeschlossen, die nicht explizit auf true gesetzt sind. Sie werden also aus den Datumsangaben in Start und End herausgefiltert.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri	0..1	boolean	Geben Sie true oder 1 an, um Freitage explizit einzubeziehen. Wenn true festgelegt ist, werden andere Wochentage ausgeschlossen, die nicht explizit auf true gesetzt sind. Sie werden also aus den Datumsangaben in 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 ausgeschlossen, die nicht explizit auf true gesetzt sind. Sie werden also aus den Datumsangaben in Start und End herausgefiltert.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun	0..1	boolean	Geben Sie true oder 1 an, um Sonntage explizit einzubeziehen. Wenn true festgelegt ist, werden andere Wochentage ausgeschlossen, die nicht explizit auf true gesetzt sind. Sie werden also aus den Datumsangaben in 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 vom Typ 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 näher definiert und in <StatusApplicationControl> sowohl in <OTA_HotelRateAmountNotifRQ>- als auch in <OTA_HotelAvailNotifRQ>-Nachrichten erwähnt. 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. 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 festgelegt werden, wenn MinMaxMessageType="FullPatternLOS" verwendet wird, andernfalls fehlt es.
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 Element einen anderen MinMaxMessageType-Wert angeben.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time	0..1	integer	Einheitswert der Messung der Aufenthaltsdauer. Der Wert null wird als keine Einschränkung behandelt. Zum Beispiel bedeutet <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS">, dass es keine maximale Aufenthaltsdauer gibt. Hinweis: Dieses Attribut muss festgelegt werden, es sei denn, MinMaxMessageType="FullPatternLOS" wird verwendet.
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 einer Übernachtung.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType	1	enum	Verschiedene Arten von Einschränkungen hinsichtlich der Aufenthaltsdauer. SetMaxLOS, SetMinLOS und FullPatternLOS basieren auf Ankunft. 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 Einschränkungsmuster für die Aufenthaltsdauer. Hinweis: Dieses Element muss vorhanden sein, wenn MinMaxMessageType="FullPatternLOS" verwendet wird, und andernfalls nicht.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS	1	string	Eine Folge von Y- und N-Zeichen, die angeben, ob jede Aufenthaltsdauer zulässig ist, von einer Nacht bis zum Wert in FixedPatternLength. Bei einer Aufenthaltsdauer, die größer als FixedPatternLength ist, wird der Wert an der endgültigen Position übernommen. Bei FixedPatternLength="4" und FullPatternLOS="YNYN" sind beispielsweise nur die Aufenthaltsdauer 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 durch das Attribut Restriction angegebene Art der Einschränkung offen oder geschlossen ist. Gültige Werte: Open Close Hinweis: Standardmäßig geht Google davon aus, dass die Einstellung Master für alle Produkte auf Close gesetzt ist. Sie können dies in den Hotel Center-Preiseinstellungen unter „Standardverfügbarkeit“ konfigurieren. Der Wert „Geschlossen“ im Hotel Center entspricht dem Wert für Close. Das Festlegen von Master auf Close wird als „Stoppverkauf“ bezeichnet.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction	0..1	enum	Dieses Attribut ist erforderlich, wenn Status angegeben ist. Gültige Werte sind: Arrival: Mit diesem Wert werden Reisepläne mit einem Check-in-Datum innerhalb des Zeitraums von Start bis End verhindert. Departure: Mit diesem Wert werden Reisepläne mit einem Check-out-Datum innerhalb des Zeitraums Start bis End verhindert. Master: Dieser Wert gibt an, ob der Zimmerpreis an diesem Datum gebucht werden kann. Hinweis: Wenn Restriction nicht angegeben ist, ist der Standardwert Master.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset	0..1	integer or duration	Der Mindestzeitraum vor dem Ankunftsdatum (in der Ortszeit der Unterkunft), für den dieser Zimmerpreis gebucht werden kann. Folgende Werttypen sind gültig: Integer: Die Anzahl der Tage vor dem Ankunftsdatum. Der Wert 1 gibt beispielsweise an, dass der Zimmerpreis mindestens einen Tag vor dem Ankunftsdatum gebucht werden muss. Der Wert 0 (Standardwert) gibt an, dass es keine Beschränkung für die letzte Buchungszeit gibt. 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 dem Ende des Ankunftsdatums (z.B. 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 für die früheste 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 bedeutet, dass die Buchung nicht früher als 18:00 Uhr, also 30 Tage vor dem Ankunftsdatum, erfolgen kann.

Beispiele

LoS-Ankunftsdatum

Legen Sie die minimale und maximale Aufenthaltsdauer fest (basierend auf dem Ankunftsdatum).

<?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 fest (basierend auf dem Aufenthalt).

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

Abfahrtsbeschränkung

Legen Sie eine Einschränkung vom Typ „Abreisezeit“ fest. (Dadurch werden Reisepläne mit Check-out an bestimmten Tagen 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 den Ankunftszeitraum fest. (Dadurch werden Reisepläne mit Check-in an bestimmten Tagen 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: Übernachtungspreise sind ebenfalls erforderlich, zusammen mit einer Inventarzahl größer als 0 für den Zimmertyp, 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 Preisplan an bestimmten Tagen schließen. Dies wird auch als „Stoppverkauf“ 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. Diese gelten nur an Wochenenden.

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

Geben Sie einen Annahmeschluss für die Buchung am Ankunftsdatum um 18:00 Uhr der Ortszeit des Hotels an.

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

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

Buchungslimit

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

Hinweis: Die Nachricht OTA_HotelInvCountNotifRQ wird gegenüber dem Festlegen dieses Attributs 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 der Aufenthaltsdauer in vollem Umfang fest.

Bei einem Check-in am 26. Juli 2023 ist nur eine Aufenthaltsdauer von 2, 4 und 6 Personen zulässig. Aufenthaltsdauern für 1, 3, 5 und 7 oder höher 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 OTA_HotelAvailNotifRS-Nachricht 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 OTA_HotelAvailNotifRS-Meldung 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 aus der verknüpften OTA_HotelAvailNotifRQ-Nachricht.
OTA_HotelAvailNotifRS / Success	0..1	Success	Gibt an, dass die OTA_HotelAvailNotifRQ-Nachricht erfolgreich verarbeitet wurde. In jeder Nachricht ist entweder <Success> oder <Errors> vorhanden.
OTA_HotelAvailNotifRS / Errors	0..1	Errors	Ein Container für ein oder mehrere Probleme, die bei der Verarbeitung der Nachricht OTA_HotelAvailNotifRQ aufgetreten sind. In jeder Nachricht ist entweder <Success> oder <Errors> vorhanden.
OTA_HotelAvailNotifRS / Errors / Error	1..n	Error	Die Beschreibung eines Fehlers, der bei der Verarbeitung der OTA_HotelAvailNotifRQ-Meldung 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 (Fehlerwarnungstyp). Nur der Wert 12 (Processing exception) wird verwendet.
OTA_HotelAvailNotifRS / Errors / Error / @Code	1	integer	Der mit dem Fehler verknüpfte OpenTravel Alliance ERR (Fehlercode). Nur der Wert 450 (Unable to process) wird verwendet.
OTA_HotelAvailNotifRS / Errors / Error / @Code	1	enum	Der Status der ursprünglichen Anfrage. Es wird nur der Wert NotProcessed verwendet.
OTA_HotelAvailNotifRS / Errors / Error / @ShortText	1	string	Die Google-ID für das Problem. Details zu diesen Fehlern finden Sie unter Fehlermeldungen für den Feedstatus.

Beispiele

Erfolgreich

Im Folgenden finden Sie eine Antwort auf eine erfolgreich verarbeitete Nachricht OTA_HotelAvailNotifRQ.

<?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 Nachricht OTA_HotelAvailNotifRQ, 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>