XML-Referenz für Preise und Zimmerinventar (Transaktionen)

Diese Seite enthält eine Referenz für die XML-basierten Transaktionsnachrichten.

<Transaction>

Das Stammelement einer Transaktionsnachricht ist <Transaction>. Es ist ein Container für beschreibende Informationen zu Zimmern und Paketen bzw. zu Preisen und Verfügbarkeit für Zimmer und Pakete.

Das Element <Transaction> wird an der folgenden Stelle in der XML-Hierarchie der Transaktionsnachricht angezeigt:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>           // Pricing and availability
        + <Rates>
        + <RoomBundle>
        + ...

Nachrichten, in denen <Transaction> als Stammelement verwendet wird, müssen mindestens ein untergeordnetes Element enthalten. Transaktionsnachrichten können eine beliebige Anzahl von untergeordneten Elementen enthalten, solange die Größe der Nachricht 100 MB nicht überschreitet.

Wichtiger Hinweis :HTML-Syntax ist in XML-Elementen nicht zulässig (auch wenn sie maskiert ist). Alle Transaktionsnachrichten mit HTML werden abgelehnt.

Syntax

Das <Transaction>-Element verwendet die folgende Syntax:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="timestamp" id="transaction_ID">

  <!-- Defines data about a room or package (Room Bundle) -->
  <PropertyDataSet>
    ...
  </PropertyDataSet>

  <!-- Updates/sets prices and availability for rooms and Room Bundles -->
  <!-- (Also removes itineraries from inventory) -->
  <Result>
    ...
  </Result>

</Transaction>

Attribute

Das <Transaction>-Element hat die folgenden Attribute:

Attribut	Erforderlich/Optional?	Typ	Beschreibung
id	Required	String	Eine eindeutige Kennung für jede Transaktionsnachricht.
partner	Optional	string	Das Partnerkonto, für das die Transaktionsnachricht bestimmt ist. Sie verwenden sie in der Regel, wenn Ihr Back-End Preisfeeds für mehrere Partnerkonten bereitstellt. Dieser Stringwert ist der Wert für „Partnerschlüssel“, der im Hotel Center auf der Seite „Kontoeinstellungen“ aufgeführt ist.
timestamp	Required	DateTime	Der Zeitpunkt, zu dem die Transaktionsnachricht gesendet wurde. Alle Nachrichten, die innerhalb der vergangenen 24 Stunden mit einem Zeitstempel gesendet wurden, werden verarbeitet. Alle anderen Nachrichten werden verworfen. Nachrichten werden in der Reihenfolge timestamp und nicht in der Reihenfolge ihres Empfangs verarbeitet. Beispielsweise wird eine Preisaktualisierung mit dem Zeitstempel 2019-05-03 14:09:00, die nach einer Nachricht mit dem Zeitstempel 2019-05-03 14:10:00 empfangen wird, trotzdem in der angegebenen Reihenfolge verarbeitet. Es wird der Preis aus der Nachricht mit dem Zeitstempel 2019-05-03 14:10:00 verwendet.

Untergeordnete Elemente

Das <Transaction>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element	Erforderlich?	Typ	Beschreibung
<PropertyDataSet>	Optional*	<PropertyDataSet>	Beschreibt ein bestimmtes Zimmer und Zimmerpakete. Sie verwenden dieses Element in der Regel in einer separaten Transaktionsnachricht, um gemeinsame Werte für Zimmerpakete zu definieren und die Größe Ihrer Transaktionsnachrichten zu reduzieren.
<Result>	Optional*	<Result>	Preisdaten für den Reiseplan eines Zimmers oder ein <RoomBundle>-Element, das Zimmerpakete und zusätzliche Zimmertypen für die Unterkunft definiert. Mit dem Element <Result> können auch Reisepläne aus einem Inventar entfernt werden.
* Es muss in jedem Fall entweder <PropertyDataSet> oder <Result> angegeben werden.

Beispiele

Zimmerdaten

Im folgenden Beispiel werden Zimmerdaten in einer einfachen Transaktionsnachricht definiert:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>5440OF</RoomID>
      <Name>
        <Text text="Single King Bed Room" language="en"/>
        <Text text="Simple Lit de Roi" language="fr"/>
      </Name>
      <Description>
        <Text text="One king bed with pillowtop mattresses, 300-thread-count linens,
          and down comforters (bedspreads). City view. 300 square feet. Desk with
          rolling chair. Multi-line phone with voice mail. Cable/satellite TV with
          complimentary HBO and pay movies." language="en"/>
        <Text text="Un très grand lit avec matelas à plateau-coussin, ..." language="fr"/>
      </Description>
      <PhotoURL>
        <Caption>
          <Text text="Bathroom View" language="en"/>
          <Text text="La salle de baines" language="fr"/>
        </Caption>
        <URL>http://www.foo.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <Capacity>4</Capacity>
    </RoomData>
  </PropertyDataSet>
</Transaction>

Preise

Im folgenden Beispiel werden Preisdaten in einer einfachen Transaktionsnachricht definiert:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
  <Result>
    <Property>060773</Property>
    <RoomID>RoomType101</RoomID>
    <PackageID>Package101</PackageID>
    <Checkin>2018-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">278.33</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="site1"/>
    </AllowablePointsOfSale>
  </Result>
  <Result>
    <Property>052213</Property>
    <RoomID>RoomType101</RoomID>
    <PackageID>Package101</PackageID>
    <Checkin>2018-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">299.98</Baserate>
    <Tax currency="USD">26.42</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="otto"/>
      <PointOfSale id="simon"/>
    </AllowablePointsOfSale>
  </Result>
</Transaction>

Übernachtungspreise

Im folgenden Beispiel werden Preisdaten für eine bis sieben Übernachtungen ab dem 7. Juni 2023 definiert:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-08-24T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>1</Nights>
    <Baserate currency="USD">209.99</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">419.98</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>3</Nights>
    <Baserate currency="USD">614.97</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>4</Nights>
    <Baserate currency="USD">819.96</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>5</Nights>
    <Baserate currency="USD">999.95</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>6</Nights>
    <Baserate currency="USD">1193.94</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>7</Nights>
    <Baserate currency="USD">1259.93</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
</Transaction>

Basispreise und nutzerabhängige Preise

Das folgende Beispiel zeigt eine Transaktionsnachricht, die einen Basispreis und einen nutzerabhängigen Preis enthält:

<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2023-04-10</Checkin>
    <Nights>1</Nights>

    <Baserate currency="USD">200.00</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">1.00</OtherFees>

    <Rates>
      <!-- The rate_rule_id is required when using conditional rates -->
      <Rate rate_rule_id="mobile">
        <!-- Override base rate and taxes for conditional rates -->
        <Baserate currency="USD">180.00</Baserate>
        <Tax currency="USD">18.00</Tax>
        <!-- NOTE: OtherFees is inherited from the above setting -->
        <Custom1>ratecode123</Custom1>
      </Rate>
    </Rates>

  </Result>
</Transaction>

Inventar entfernen

Im folgenden Beispiel werden mehrere Inventare (Aufenthalte mit 1 Übernachtung an verschiedenen Tagen) für ein Hotel aus dem Inventar entfernt:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-05-23T16:20:00-04:00" id="42">
  <Result>
    <Property>1123581321</Property>
    <Checkin>2023-05-23</Checkin>
    <Nights>1</Nights>
    <Unavailable>
      <NoVacancy/>
    </Unavailable>
    <Tax currency="USD">0</Tax>
    <OtherFees currency="USD">0</OtherFees>
  </Result>
  <Result>
    <Property>1123581321</Property>
    <Checkin>2023-05-24</Checkin>
    <Nights>1</Nights>
    <Unavailable>
      <NoVacancy/>
    </Unavailable>
    <Tax currency="USD">0</Tax>
    <OtherFees currency="USD">0</OtherFees>
  </Result>
  <!---Sending <Baserate> is optional with <Unavailable> -->
  <Result>
    <Property>1123581321</Property>
    <Checkin>2023-05-25</Checkin>
    <Nights>1</Nights>
    <Baserate currency="USD">-1</Baserate>
    <Unavailable>
      <NoVacancy/>
    </Unavailable>
    <Tax currency="USD">0</Tax>
    <OtherFees currency="USD">0</OtherFees>
  </Result>
</Transaction>

<PropertyDataSet>

Ein Container für Zimmer- und Paketinformationen (oder Zimmerpaket-Informationen) in einer <Transaction>-Nachricht. Die für ein Hotel festgelegten Werte überschreiben die für einen Partner festgelegten Werte. Google speichert diese Informationen, damit Sie sie nicht jedes Mal neu definieren müssen, wenn Sie Preisaktualisierungen senden.

Das Element <PropertyDataSet> wird an der folgenden Stelle in der XML-Hierarchie der Transaktionsnachricht angezeigt:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>  // Pricing and availability
        + <Rates>
        + <RoomBundle>
        + ...

Weitere Informationen finden Sie unter Zimmerpaket-Metadaten.

Syntax

Das <PropertyDataSet>-Element verwendet die folgende Syntax:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <PropertyDataSet>
    <!-- (Required) ID that matches the Hotel List Feed -->
    <Property>hotel_ID</Property>

    <!-- (Optional) Defines metadata about a room -->
    <RoomData>
      ...
    </RoomData>

    <!-- (Optional) Defines package metadata to be paired with rooms (Room Bundles) -->
    <PackageData>
      ...
    </PackageData>
  </PropertyDataSet>
  ...
</Transaction>

Attribute

Das <PropertyDataSet>-Element hat keine Attribute.

Untergeordnete Elemente

Das <PropertyDataSet>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element	Erforderlich?	Typ	Beschreibung
<PackageData>	Optional*	<PackageData>	Beschreibt ein Zimmerpaket. Diese Daten sind mit einem Partner und einem Hotel, aber nicht mit einem Reiseplan verknüpft. Dieses Element ähnelt <RoomData>, beschreibt jedoch Ausstattungsmerkmale und Bedingungen, die nicht Teil der Beschreibung des physischen Zimmers sind. In Ihren Preisaktualisierungen verweisen Sie auf die Paket-ID. Weitere Informationen finden Sie unter Zimmerpaket-Metadaten.
<Property>	Required	string	Die ID eines Hotels, auf das sich die verknüpften Daten beziehen. Der Wert dieses Elements muss ein String sein, der mit dem Eintrag <id> in Ihrem Hotellistenfeed übereinstimmt.
<RoomData>	Optional*	<RoomData>	Beschreibt ein Zimmer. Diese Daten sind mit einem Partner und einem Hotel, aber nicht mit einem Reiseplan verknüpft. In Ihren Preisaktualisierungen verweisen Sie auf die Zimmer-ID.
* Es muss in jedem Fall entweder <PackageData> oder <RoomData> angegeben werden.

Beispiele

Zimmer- und Paketdaten

Das folgende Beispiel zeigt sowohl Zimmer- als auch Paketdaten in einer <PropertyDataSet>:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>180054</Property>
    <RoomData>
      <RoomID>060773</RoomID>
      <Name>
        <Text text="Single Bed Room" language="en"/>
        <Text text="Chambre single" language="fr"/>
      </Name>
      <Description>
        <Text text="Non-smoking" language="en"/>
        <Text text="Pas de fumiers" language="fr"/>
      </Description>
      <PhotoURL>
        <Caption>
          <Text text="Living area" language="en"/>
          <Text text="Le chambre" language="fr"/>
        </Caption>
        <URL>http://www.foo.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
    </RoomData>
    <PackageData>
      <PackageID>P54321</PackageID>
      <Name>
        <Text text="Breakfast Included" language="en"/>
        <Text text="Avec le petit déjeuner" language="fr"/>
      </Name>
      <Description>
        <Text text="Includes a delightful array of jams and jellies." language="en"/>
        <Text text="Comprend une délicieuse gamme de confitures et gelées." language="fr"/>
      </Description>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>

Wenn Sie Preise und Verfügbarkeit für dieses Zimmer und/oder Zimmerpaket senden, verweisen Sie in Ihren Preisnachrichten auf die Zimmer- und Paket-ID. Das Ergebnis ist, dass Sie die Größe Ihrer Nachrichten erheblich reduzieren und auch die Fehleranzahl reduzieren, die aufgrund von doppelten Daten auftreten kann. Weitere Informationen finden Sie unter Zimmerpaket-Metadaten.

<RoomData>

Definiert vom Reiseplan unabhängige Metadaten für Zimmer und somit auch für Zimmerpakete (da Zimmerpakete Zimmer plus zusätzliche Ausstattung sind). Mit <RoomData> reduzieren Sie die Wiederholung beschreibender Daten in Ihrem Preisfeed.

Das Element <RoomData> wird an der folgenden Stelle in der XML-Hierarchie der Transaktionsnachricht angezeigt:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>           // Pricing and availability
        + <Rates>
        + <RoomBundle>
        + ...

<RoomData>-Elemente enthalten Informationen, die mit einem Partner und einem Hotel, aber nicht mit einem Reiseplan verknüpft sind. Der Zweck ist für alle nicht auf einen Reiseplan bezogenen Daten.

Das <RoomData>-Element ähnelt <PackageData>, beschreibt jedoch das physische Zimmer und nicht die Ausstattung und Bedingungen eines Pakets. Sie verwenden <RoomData> und <PackageData> in Kombination, um Details zu Zimmerpaketen bereitzustellen. Verwenden Sie für einzelne Zimmer, die nicht Teil eines Pakets sind, nur <RoomData>.

Sie können sowohl das Element <RoomData> als auch das Element <PackageData> für dasselbe Zimmer oder Zimmerpaket definieren. Wenn Google dieses Zimmer oder Paket in den Suchergebnissen anzeigt, enthält es die Beschreibungen beider Elemente, getrennt durch einen Bindestrich.

Weitere Informationen finden Sie unter Zimmerpaket-Metadaten.

Syntax

Das <RoomData>-Element verwendet die folgende Syntax:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <PropertyDataSet>
    ...
    <RoomData>
      <RoomID>room_ID</RoomID>

      <Name>
        <Text text="room_name" language="language_code"/>
        ...
      </Name>

      <Description>
        <Text text="room_description" language="language_code"/>
        ...
      </Description>

      <Capacity>max_number_of_occupants</Capacity>
      <Occupancy>max_number_of_intended_occupants</Occupancy>
      <OccupancyDetails> <!-- optional info about the types of guests,
      whether adults, children, or seniors --></OccupancyDetails>
      <OccupancySettings>
        <MinOccupancy>min_number_of_occupants</MinOccupancy>
        <MinAge>min_age_of_occupants</MinAge>
      </OccupancySettings>

      <PhotoURL>
        <Caption>
          <Text text="photo_description" language="language_code"/>
          ...
        </Caption>
        <URL>photo_location</URL>
      </PhotoURL>
      <RoomFeatures>
        ...
      </RoomFeatures>
    </RoomData>
    ...
  </PropertyDataSet>
</Transaction>

Attribute

Das <RoomData>-Element hat keine Attribute.

Untergeordnete Elemente

Das <RoomData>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element	Erforderlich?	Typ	Beschreibung
<Capacity>	Optional	integer	Die maximale Anzahl von Gästen, die im Zimmer Platz haben. Bei einem Zimmer ist die Kapazität größer oder gleich der Belegung. Wenn dieser Wert angegeben wird, muss er größer oder gleich dem Wert des Elements <Occupancy> sein, das die für ein bestimmtes Zimmer vorgesehene Anzahl von Gästen angibt. Beispiel: Für eine große Suite kann <Capacity> 6 sein, während <Occupancy> = 4 ist. Der Wert für <Capacity> muss eine positive Ganzzahl zwischen 1 und 20 sein.
<Description>	Optional	Object	Eine detaillierte Beschreibung des Zimmers. Dieses Element sollte Informationen enthalten, die weder in anderen Elementen noch im Element <Name> beschrieben sind. Geben Sie die Beschreibung des Zimmers nicht ausschließlich in Großbuchstaben an. Das Element <Description> verwendet nur das untergeordnete Element <Text> mit den beiden folgenden erforderlichen Attributen: text: Eine detaillierte Beschreibung des Zimmers. language: Ein aus zwei Buchstaben bestehender Sprachcode, z. B. fr. Verwenden Sie für jede Sprache, in der Ihre Anzeige oder Ihr kostenloser Buchungslink erscheinen könnte, ein separates <Text>-Element (mit unterschiedlichen Werten für die language-Attribute). Das folgende Beispiel zeigt die französische und englische Version der Zimmerbeschreibung: <Description> <Text text="Two queen-sized beds" language="en"/> <Text text="Deux lits de la reine" language="fr"/> </Description>
<Name>	Required	string	Der Name der Zimmerkategorie. Dieser Wert sollte mit den Angaben auf der Landingpage des Hotels (früher Point of Sale) übereinstimmen. Schreiben Sie den Wert dieses Elements nicht rein in Großbuchstaben, sondern verwenden Sie Groß-/Kleinschreibung. Dieses Element verwendet nur das untergeordnete Element <Text> mit den beiden folgenden erforderlichen Attributen: text: Der Name des Chatrooms. language: Ein aus zwei Buchstaben bestehender Sprachcode, z. B. fr. Verwenden Sie für jede Sprache, in der Ihre Anzeige oder Ihr kostenloser Buchungslink erscheinen könnte, ein separates <Text>-Element (mit unterschiedlichen Werten für die language-Attribute). Das folgende Beispiel zeigt die französische und englische Version des Raumnamens: <Name> <Text text="Standard Double Room" language="en"/> <Text text="Le chambre double" language="fr"/> </Name>
<Occupancy>	Optional	integer	Die maximale Anzahl von Gästen, für die ein Zimmer vorgesehen ist. Eine große Suite kann beispielsweise physisch Platz für 6 Personen bieten (Kapazität = 6), ist aber nur für bis zu 4 Personen vorgesehen. Dieser Wert muss kleiner oder gleich dem Element <Capacity> sein. Das Element gibt die Anzahl von Personen an, die im Zimmer Platz haben. Der Wert für <Occupancy> muss eine positive Ganzzahl im Bereich von 1 bis 99 sein. <Occupancy> wird möglicherweise von <OccupancyDetails> begleitet, wodurch die Art der Gäste (Erwachsene oder Kinder) angegeben wird. Informationen zur Syntax und Beschreibung untergeordneter Elemente finden Sie unter <OccupancyDetails>.
<OccupancySettings>	Optional	Object	Einstellungen, mit denen die Belegungsanforderungen eines Zimmers eingeschränkt oder geändert werden können. Das <OccupancySettings>-Element verwendet die folgenden untergeordneten Elemente: <MinOccupancy>: Die Mindestanzahl von Gästen, die in einem Zimmer übernachten können. Wenn hier beispielsweise 2 festgelegt ist, kann dieser Raum nicht für einen einzelnen Gast gebucht werden. Der Wert für <MinOccupancy> muss eine positive Ganzzahl im Bereich von 1 bis 99 sein. <MinAge>: Das Mindestalter für alle Gäste, die in einem Zimmer übernachten. Wenn Sie beispielsweise 18 festlegen, kann dieser Raum nur für Gruppen gebucht werden, in denen alle Gäste mindestens 18 Jahre alt sind. Der Wert für <MinAge> muss eine positive Ganzzahl im Bereich von 0 bis 99 sein. <OccupancySettings> <MinOccupancy>2</MinOccupancy> <MinAge>16</MinAge> </OccupancySettings> Nicht alle untergeordneten Elemente müssen enthalten sein.
<PhotoURL>	Optional	Object	Eine URL und optionale Bildunterschrift für ein Foto des entsprechenden Zimmers oder Zimmerpakets. Sie können mehr als eine <PhotoURL> für ein Zimmer oder Zimmerpaket angeben. Jede Foto-URL muss in einem eigenen <PhotoURL>-Objekt enthalten sein. Dieses Element verwendet die folgenden untergeordneten Elemente: <URL>: Gibt den Speicherort des Fotos an. Der Speicherort sollte öffentlich (nicht hinter einer Firewall) sein und das Protokoll enthalten (z. B. https://). Verwenden Sie nur eine <URL> pro <PhotoURL>. <Caption>: Definiert die Bildunterschrift des Fotos. Dieses Element verwendet nur das untergeordnete Element <Text> mit den beiden erforderlichen Attributen text und language. Das Attribut text ist der Untertitel und das Attribut language gibt einen aus zwei Buchstaben bestehenden Sprachcode wie en an. Beispiel: <PhotoURL> <URL>https://www.example.com/static/bar/image1234.jpg</URL> <Caption> <Text text="A bright and breezy way to enjoy your mornin' cuppa tea." language="en"/> <Text text="Une façon lumineuse et aérée pour profiter de votre journée tasse de thé." language="fr"/> </Caption> </PhotoURL> <PhotoURL> <URL>https://www.foo.com/static/bar/image5678.jpg</URL> <Caption> <Text text="Or, perhaps you prefer coffee." language="en"/> <Text text="Ou peut-être préférez-vous le café." language="fr"/> </Caption> </PhotoURL>
<RoomFeatures>	Optional	<RoomFeatures>	Enthält Informationen zu Zimmerelementen.
<RoomID>	Required	string	Die eindeutige ID für das Zimmer. Mit dieser ID ordnen Sie die Zimmerdaten den <Result>-Blöcken in Ihren Preisaktualisierungen zu. Weitere Informationen finden Sie unter Zimmerpaket-Metadaten. Wenn Sie Zimmerdaten inline definieren, können Sie mit dieser ID auf eine allgemeine Zimmerdefinition in einer einzelnen Transaktionsnachricht verweisen.

Beispiele

Zimmerdaten

Im folgenden Beispiel werden Zimmerdaten definiert:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>5440OF</RoomID>
      <Name>
        <Text text="Single King Bed Room" language="en"/>
        <Text text="Simple Lit de Roi" language="fr"/>
      </Name>
      <Description>
        <Text text="One king bed with pillowtop mattresses, 300-thread-count linens,
          and down comforters (bedspreads). City view. 300 square feet. Desk with
          rolling chair. Multi-line phone with voice mail. Cable/satellite TV with
          complimentary HBO and pay movies." language="en"/>
        <Text text="Un très grand lit avec matelas à plateau-coussin, ..." language="fr"/>
      </Description>
      <PhotoURL>
        <Caption>
          <Text text="Bathroom View" language="en"/>
          <Text text="La salle de baines" language="fr"/>
        </Caption>
        <URL>http://www.foo.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <Capacity>4</Capacity>
    </RoomData>
  </PropertyDataSet>
</Transaction>

Zimmer- und Paketmetadaten

Im folgenden Beispiel werden Zimmer- und Paketmetadaten definiert:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>180054</Property>
    <RoomData>
      <RoomID>060773</RoomID>
      <Name>
        <Text text="Single Bed Room" language="en"/>
        <Text text="Chambre single" language="fr"/>
      </Name>
      <Description>
        <Text text="Non-smoking" language="en"/>
        <Text text="Pas de fumiers" language="fr"/>
      </Description>
      <PhotoURL>
        <Caption>
          <Text text="Living area" language="en"/>
          <Text text="Le chambre" language="fr"/>
        </Caption>
        <URL>http://www.foo.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
    </RoomData>
    <PackageData>
      <PackageID>P54321</PackageID>
      <Name>
        <Text text="Breakfast Included" language="en"/>
        <Text text="Avec le petit déjeuner" language="fr"/>
      </Name>
      <Description>
        <Text text="Includes a delightful array of jams and jellies." language="en"/>
        <Text text="Comprend une délicieuse gamme de confitures et gelées." language="fr"/>
      </Description>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>

Pakete für mehrere Zimmer

Im folgenden Beispiel werden Zimmer- und Paketmetadaten für mehrere Zimmerpakete definiert:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <!-- A transaction message with room types result. -->
  <PropertyDataSet>
    <Property>12345</Property>
    <RoomData>
      <RoomID>single</RoomID>
      <Name>
        <Text text="Single room" language="en"/>
        <Text text="Chambre simple" language="fr"/>
      </Name>
      <Description>
        <Text text="A single room" language="en"/>
        <Text text="Le chambre simple" language="fr"/>
      </Description>
      <PhotoURL>
        <Caption>
          <Text text="Living area" language="en"/>
          <Text text="Le chambre" language="fr"/>
        </Caption>
        <URL>http://www.foo.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <PhotoURL>
        <URL>http://www.foo.com/static/bar/image1235.jpg</URL>
      </PhotoURL>
      <Capacity>2</Capacity>
    </RoomData>
    <RoomData>
      <RoomID>double</RoomID>
      <Name>
        <Text text="Double room" language="en"/>
        <Text text="Chambre double" language="fr"/>
      </Name>
      <Occupancy>1</Occupancy>
    </RoomData>
    <PackageData>
      <PackageID>refundbreakfast</PackageID>
      <Name>
        <Text text="Refundable Room with Breakfast" language="en"/>
        <Text text="Chambre remboursable avec le petit déjeuner" language="fr"/>
      </Name>
      <Description>
        <Text text="Continental Breakfast" language="en"/>
        <Text text="Petit déjeuner continental" language="fr"/>
      </Description>
      <ChargeCurrency>hotel</ChargeCurrency>
      <Refundable available="1" refundable_until_days="3"/>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
    <PackageData>
      <PackageID>prepaid</PackageID>
      <Name>
        <Text text="Nonrefundable" language="en"/>
        <Text text="Non remboursable" language="fr"/>
      </Name>
      <Description>
        <Text text="Blah blah blad" language="en"/>
        <Text text="Le blah blah blad" language="fr"/>
      </Description>
      <Occupancy>2</Occupancy>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="0"/>
    </PackageData>
  </PropertyDataSet>
</Transaction>

<RoomFeatures>

Definiert die im Raum gefundenen Merkmale.

Das Element <RoomFeatures> wird an der folgenden Stelle in der XML-Hierarchie der Transaktionsnachricht angezeigt:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
            + <RoomFeatures>

Syntax

Das <RoomFeatures>-Element verwendet die folgende Syntax:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <PropertyDataSet ... >
    ...
    <RoomData>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>[western|japanese|japanese_western]</JapaneseHotelRoomStyle>
        <Beds>
           <Bed size="[single|semi_double|double|queen|king]">
             <Width unit="cm" number="width"/>
             <Length unit="cm" number="length"/>
           </Bed>
           <!-- Include with any additional beds. -->
        </Beds>
        <Suite/>
        <Capsule/>
        <Roomsharing>[shared|private]</Roomsharing>
        <Outdoor/>
        <MobilityAccessible/>
        <Smoking>[smoking|non_smoking]</Smoking>
        <BathAndToilet relation="[together|separate]">
          <Bath bathtub="[false|true]" shower="[false|true]"/>
          <Toilet electronic_bidet="[false|true]" mobility_accessible="[false|true]"/>
        </BathAndToilet>
        <OpenAirBath/>
        <AirConditioning/>
        <Balcony/>
        <Views>
          <!-- (Optional) Defines the type of views from the room. -->
          <!-- Example: <OceanView/> -->
        </Views>

      </RoomFeatures>
      ...
    </RoomData>
    ...
  </PropertyDataSet>
</Transactions>

Attribute

Das <RoomFeatures>-Element hat keine Attribute.

Untergeordnete Elemente

Das <RoomFeatures>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element	Erforderlich?	Typ	Beschreibung
<JapaneseHotelRoomStyle>	Optional	enum	Gibt den Stil eines japanischen Hotelzimmers an. Gültige Werte sind: western: Ein Zimmer im Westernstil mit Betten. japanese: Ein Zimmer im japanischen Stil mit Futons. japanese_western: Ein Zimmer im japanischen Westernstil mit Betten im westlichen Stil und Futons im japanischen Stil.
<Beds>	Optional	Object	Enthält so viele <Bed> wie der Raum. Bitte beachte, dass japanische Futons hier nicht mitgezählt werden. Jeder <Bed> hat die folgenden Attribute: size (optional): Gültige Werte sind single, semi_double, double, queen und king. Jede <Bed> hat die folgenden untergeordneten Elemente: <Width> (optional): Gibt die Breite des Betts an. Es muss das Attribut unit mit dem Wert cm und das Attribut number mit der Breite des Betts in ganzzahligen Zentimetern angegeben werden. <Length> (optional): Gibt die Länge der Betten an. Es muss das Attribut unit mit dem Wert cm und das Attribut number mit der Länge des Betts in ganzzahligen Zentimetern angegeben werden. Beispiel: <Beds> <Bed size="double"> <Width unit="cm" number="140"/> <Length unit="cm" number="195"/> </Bed> <Bed/> <!-- Size unknown --> </Beds>
<Suite>	Optional	empty	Geben Sie dieses Element an, wenn dieses Zimmer eine Suite ist.
<Capsule>	Optional	empty	Geben Sie dieses Element an, wenn dieser Raum ein Kapselraum ist.
<Roomsharing>	Optional	enum	Gibt an, ob dieses Zimmer mit anderen Personen geteilt wird, z. B. mit Eigentümern oder anderen Gästen. Gültige Werte sind shared und private.
<Outdoor>	Optional	empty	Geben Sie dieses Element an, wenn es sich bei diesem Raum um eine Unterkunft im Freien ohne feste Wände, Sanitärinstallationen und Klimaanlagen handelt. Hotelzimmer sind beispielsweise keine Übernachtungsmöglichkeiten im Freien, während Campingplätze, auf denen die Gäste in Zelten übernachten, und Wohnmobilparks, in denen Gäste ihr eigenes Wohnmobil mitbringen, Outdoorunterkünfte.
<MobilityAccessible>	Optional	empty	Dieses Element sollte bereitgestellt werden, wenn dieser Raum rollstuhlgerecht ist.
<Smoking>	Optional	enum	Gibt an, ob dieses Zimmer ein Nichtraucher- oder Raucherzimmer ist. Gültige Werte sind non_smoking und smoking.
<BathAndToilet>	Optional	Object	Enthält Informationen zu einem Bad und einer Toilette im Raum. Das Attribut lautet: relation (optional): Gibt an, wie Bad und Toilette gegeneinander platziert sind. Gültige Werte sind together (Bad und WC befinden sich beide im selben Raum (z.B. Bad) direkt nebeneinander) und separate (Bad und Toilette haben jeweils einen eigenen Bereich). Dieses Attribut darf nicht festgelegt werden, wenn der Raum nicht sowohl ein Bad als auch eine Toilette hat. Das -Element verwendet optional die folgenden untergeordneten Elemente: <Bath> (optional): Dieses Element weist darauf hin, dass der Raum ein Bad hat. Folgende Attribute sind verfügbar: bathtub (optional): Gibt an, dass sich im Bad eine Badewanne befindet. Gültige Werte sind 0 (oder false) und 1 (oder true). shower (optional): Gibt an, dass es eine Dusche gibt. Gültige Werte sind 0 (oder false) und 1 (oder true). <Toilet> (optional): Dieses Element weist darauf hin, dass es in diesem Raum eine Toilette gibt. Folgende Attribute sind verfügbar: electronic_bidet (optional): Gibt an, dass die Toilette ein elektronisches Bidet hat. Gültige Werte sind 0 (oder false) und 1 (oder true). mobility_accessible (optional): Gibt an, dass die Toilette mobil barrierefrei ist. Gültige Werte sind 0 (oder false) und 1 (oder true). Beispiel: <BathAndToilet relation="separate"> <Bath bathtub="1" shower="1"/> <Toilet electronic_bidet="1" mobility_accessible="1"/> </BathAndToilet>
<OpenAirBath>	Optional	empty	Geben Sie dieses Element an, wenn dieser Raum ein eigenes Bad im Freien hat.
<AirConditioning>	Optional	empty	Geben Sie dieses Element an, wenn es in diesem Raum eine Klimaanlage gibt.
<Balcony>	Optional	empty	Geben Sie dieses Element an, wenn dieses Zimmer einen Balkon oder eine Veranda hat.
<Views>	Optional	Object	Gültige Optionen: <AirportView/> <BayView/> <BeachView>/> <CastleView/> <CityView/> <CountrysideView/> <CourtyardView/> <DuneView/> <ForestView/> <GardenView/> <GolfCourseView/> <HarborView/> <LagoonView/> <LakeView/> <MarinaView/> <MountainView/> <NatureView/> <OceanView/> <ParkView/> <PartialOceanView/> <PisteView/> <PoolView/> <PyramidView/> <RiverView/> <StreetView/>

Beispiele

JapaneseHotelRoomStyle hat keinen Standardwert. Das Weglassen eines Werts führt nicht zu einem XML-Fehler. Ihr Eintrag wird jedoch nicht in den Suchergebnissen angezeigt, wenn Nutzer nach Zimmerstil oder Betten filtern.

Zwei Einzelbetten

Das folgende Beispiel zeigt, wie <RoomFeatures> verwendet wird:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
        <Beds> <!-- Two single beds -->
          <Bed size="single">
            <Width unit="cm" number="97"/>
            <Length unit="cm" number="195"/>
          </Bed>
          <Bed size="single">
            <Width unit="cm" number="97"/>
            <Length unit="cm" number="195"/>
          </Bed>
        </Beds>
        <Suite/>
        <Capsule/>
        <Roomsharing>private</Roomsharing>
        <Outdoor/>
        <MobilityAccessible/>
        <Smoking>non_smoking</Smoking>
        <BathAndToilet relation="separate">
          <Bath bathtub="1" shower="1"/>
          <Toilet electronic_bidet="1" mobility_accessible="1"/>
        </BathAndToilet>
        <OpenAirBath/>
        <AirConditioning/>
        <Balcony/>
        <Views>
          <LakeView/>
          <MarinaView/>
          <BeachView/>
          <ForestView/>
          <MountainView/>
          <NatureView/>
        </Views>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

Zwei Doppelbetten

Das folgende Beispiel zeigt ein japanisches Zimmer im western-Stil mit zwei double-Betten.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
        <Beds> <!-- Two double beds-->
          <Bed size="double"></Bed>
          <Bed size="double"></Bed>
        </Beds>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

Japanischer Stil ohne Bett

Das folgende Beispiel zeigt ein Zimmer im japanischen Stil ohne Bett. Für ein Zimmer im Stil „japanese“ sind keine Informationen zu den Betten erforderlich.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>japanese</JapaneseHotelRoomStyle>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

Wichtiger Hinweis :Die Angabe von Betteninformationen für ein Zimmer im japanese-Stil hat keine Auswirkungen.

Japanischer Westen mit Bett

Das folgende Beispiel zeigt ein Zimmer im Stil japanese_western mit einem Bett der Größe king.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
        <Beds>
          <Bed size="king"></Bed>
        </Beds>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

Wenn der Partner die Anzahl der Betten in japanese_western Zimmern nicht hat, folge dem folgenden Beispiel:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

<PackageData>

Definiert vom Reiseplan unabhängige Metadaten für Zimmerpakete für eine Unterkunft. Dieses Element enthält Informationen, die mit einem Partner und einem Hotel, aber nicht mit einem Reiseplan verknüpft sind. Ziel ist es, alle nicht zum Reiseplan gehörenden Daten einmal zu definieren und von Reiseplandaten darauf zu verweisen.

Das Element <PackageData> wird an der folgenden Stelle in der XML-Hierarchie der Transaktionsnachricht angezeigt:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>           // Pricing and availability
        + <Rates>
        + <RoomBundle>
        + ...

Das <PackageData>-Element ähnelt <RoomData>, beschreibt jedoch Preismerkmale und Bedingungen, die nicht Teil der Beschreibung des physischen Zimmers sind. Sie verwenden <RoomData> und <PackageData> in Kombination, um Details zu Zimmerpaketen und Preismerkmalen bereitzustellen. Verwenden Sie für einzelne Zimmer, die nicht Teil eines Pakets sind, nur <RoomData>.

Sie können sowohl das Element <RoomData> als auch das Element <PackageData> für dasselbe Zimmer oder Zimmerpaket definieren. Wenn Google dieses Zimmer oder Paket in den Suchergebnissen anzeigt, enthält es die Beschreibungen beider Elemente, getrennt durch einen Bindestrich.

Wenn Sie ein einzelnes <PackageData>-Element für eine Unterkunft aktualisieren, müssen Sie alle <PackageData>- und <RoomData>-Elemente für die Unterkunft aktualisieren. Bei jedem <PropertyDataSet> wird davon ausgegangen, dass alle Daten zu der Property enthalten sind, und überschreibt alle vorhandenen Daten.

Weitere Informationen finden Sie unter Zimmerpaket-Metadaten.

Syntax

Das <PackageData>-Element verwendet die folgende Syntax:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <PropertyDataSet ... >
    <PackageData>
      <PackageID>package_ID</PackageID>
      <Name>
        <Text text="package_name" language="language_code"/>
        ...
      </Name>
      <Description>
        <Text text="package_description" language="language_code"/>
        ...
      </Description>
      <Refundable available="[false|true]" refundable_until_days="number_of_days"
        refundable_until_time="time"/>
      <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency>
      <Occupancy>max_number_of_intended_occupants</Occupancy>
      <OccupancyDetails><!-- optional info about the types of guests,
      whether adults or children --></OccupancyDetails>
      <!-- For these next 3 elements, boolean_value can be 0/1 or true/false -->
      <BreakfastIncluded>boolean_value</BreakfastIncluded>
      <InternetIncluded>boolean_value</InternetIncluded>
      <ParkingIncluded>boolean_value</ParkingIncluded>
      <PhotoURL>
        <Caption>
          <Text text="photo_description" language="language_code"/>
          ...
        </Caption>
        <URL>photo_location</URL>
      </PhotoURL>
      ...
      <Meals>
        <Breakfast
          included="[true|false]" buffet="[true|false]"
          in_room="[true|false]" in_private_space="[true|false]"/>
        <Dinner
          included="[true|false]" buffet="[true|false]"
          in_room="[true|false]" in_private_space="[true|false]"/>
      </Meals>
      <CheckinTime>checkin_time</CheckinTime>
      <CheckoutTime>checkout_time</CheckoutTime>
      <MembershipBenefitsIncluded>
        <ProgramName>
          <Text language="en" text="Special Rewards">
        </ProgramName>
        <ProgramLevel>
          <Text language="en" text="Platinum">
        </ProgramLevel>
      </MembershipBenefitsIncluded>
      <OnPropertyCredit>
        <Amount currency="USD">123.45</Amount>
      </OnPropertyCredit>
    </PackageData>
    <!-- a PackageID with a MilesIncluded rate feature -->
    <PackageData>
      <PackageID>room_with_miles</PackageID>
      <Name>
       <Text text="Room with Bundled Miles" language="en">
      </Name>
      <ChargeCurrency>hotel </ChargeCurrency>
      <MilesIncluded>
        <NumberOfMiles>1000 </NumberOfMiles>
        <Provider>
          <Text language="en" text="United Airlines">
        </Provider>
      </MilesIncluded>
    </PackageData>
    ...
    ...
  </PropertyDataSet>
  ...
</Transaction>

Attribute

Das <PackageData>-Element hat keine Attribute.

Untergeordnete Elemente

Das <PackageData>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element	Erforderlich?	Typ	Beschreibung
<BreakfastIncluded>	Optional	boolean	Gibt an, ob im Preis des Pakets Frühstück enthalten ist. Gültige Werte sind 0 (oder false) und 1 (oder true). Wir empfehlen, <Meals> anstelle von <BreakfastIncluded> zu verwenden.
<ChargeCurrency>	Optional	enum	Wann und wo der Nutzer für eine Buchung bezahlt. Für dieses Element wird dieselbe Syntax wie für <ChargeCurrency> in <Result> verwendet. Der Standardwert ist web.
<CheckinTime>	Optional	Time	Früheste Check-in-Zeit. Die Zeit muss vor 24:00 Uhr der Ortszeit des Hotels liegen.
<CheckoutTime>	Optional	Time	Späteste mögliche Abreisezeit in der Ortszeit des Hotels.
<Description>	Optional	Object	Eine detaillierte Beschreibung des Pakets. Dieses Element sollte Informationen enthalten, die weder in anderen Elementen noch im Element <Name> beschrieben sind. Geben Sie die Beschreibung des Zimmers nicht ausschließlich in Großbuchstaben an. Das Element <Description> verwendet nur das untergeordnete Element <Text> mit den beiden erforderlichen Attributen text und language. Das Attribut text ist die Beschreibung und das Attribut language gibt einen aus zwei Buchstaben bestehenden Sprachcode an, wie im folgenden Beispiel gezeigt: <Description> <Text text="Two breakfast buffet certificates for each night of stay." language="en"/> <Text text="Deux certificats petit-déjeuner buffet pour chaque nuit de séjour." language="fr"/> </Description>
<InternetIncluded>	Optional	boolean	Wenn ein Paket kostenlosen Internetzugang beinhaltet, während andere Pakete diese Ausstattung nicht enthalten. Legen Sie dieses Element nicht für Zimmerpakete eines Hotels fest, die für alle Zimmer kostenlosen Internetzugang bieten. Dieses Element gilt nicht für einen kabelgebundenen oder kabellosen Internetzugang, der nicht in den Zimmern verfügbar ist. Gültige Werte sind 0 (oder false) und 1 (oder true).
<Meals>	Optional	Object	Enthält Informationen zu Mahlzeiten in diesem Paket. Das Element <Meals> verwendet zwei optionale untergeordnete Elemente, <Breakfast> und <Dinner>, mit den folgenden Attributen: included (erforderlich): Legen Sie 1 (oder true) fest, wenn Frühstück und Abendessen im Preis inbegriffen sind, andernfalls 0 oder false. in_room (optional): Legen Sie 1 (oder true) fest, wenn die Gäste die Möglichkeit haben, in dem Zimmer zu essen, in dem sie übernachten. Andernfalls geben Sie 0 (oder false) an. in_private_space (optional): Legen Sie 1 (oder true) fest, wenn Gäste die Möglichkeit haben, in einem Raum (mit Ausnahme des Zimmers, in dem sie übernachten) zu frühstücken oder zu Abend essen können, in dem sie Kontakt mit anderen Gästen vermeiden können. Andernfalls geben Sie 0 (oder false) an. buffet (optional): Legen Sie 1 (oder true) fest, wenn Frühstück und Abendessen als Buffet angeboten werden, andernfalls 0 (oder false). Die optionalen Attribute werden nur verwendet, wenn included wahr ist. Damit die Mahlzeitenfilter (no meals, breakfast only, dinner only und breakfast and dinner) funktionieren, müssen sowohl <Breakfast> als auch <Dinner> mit dem Attribut included angegeben werden.
<Name>	Required	string	Der Name des Pakets. Dieser Wert sollte mit den Angaben auf der Landingpage des Hotels übereinstimmen. Schreiben Sie den Wert dieses Elements nicht rein in Großbuchstaben, sondern verwenden Sie Groß-/Kleinschreibung. Dieses Element verwendet nur das untergeordnete Element <Text> mit den beiden Attributen text und language. Das Attribut text ist die Beschreibung und das Attribut language gibt einen aus zwei Buchstaben bestehenden Sprachcode an, wie im folgenden Beispiel gezeigt: <Name> <Text text="Bed and Breakfast" language="en"/> <Text text="Lit et petit déjeuné" language="fr"/> </Name>
<Occupancy>	Optional	integer	Die maximale Anzahl von Gästen, für die ein Zimmerpaket vorgesehen ist. Eine große Suite bietet Platz für bis zu 6 Personen, ist aber nur für bis zu 4 Personen vorgesehen. Dieser Wert muss kleiner oder gleich dem Element <Capacity> sein. Das Element gibt die Anzahl von Personen an, die im Zimmer Platz haben. Der Wert für <Occupancy> muss eine positive Ganzzahl im Bereich von 1 bis 99 sein. Wenn Sie dieses Element sowohl in <RoomBundle> als auch in <PackageData> angeben, hat der Wert in <RoomBundle> Vorrang. Hinweise: <Occupancy> wird möglicherweise von <OccupancyDetails> begleitet,wodurch die Art der Gäste (Erwachsene oder Kinder) angegeben wird. Informationen zur Syntax und Beschreibung untergeordneter Elemente finden Sie unter <OccupancyDetails>.
<PackageID>	Required	string	Die eindeutige ID für das Paket. Mit dieser ID ordnen Sie die Daten des Zimmerpakets den <Result>-Blöcken in Ihren Preisaktualisierungen zu. Weitere Informationen finden Sie unter Zimmerpaket-Metadaten. Wenn Sie die Daten eines Zimmerpakets inline definieren, können Sie mit dieser ID auf eine allgemeine Definition für ein Zimmerpaket in einer einzelnen Transaktionsnachricht verweisen.
<ParkingIncluded>	Optional	boolean	Gibt an, ob ein Zimmerpaket kostenloses Parken beinhaltet, wenn das Parken in diesem Hotel ansonsten kostenpflichtig wäre. Geben Sie für dieses Element keinen Wert an, wenn das Hotel kostenlose Parkplätze anbietet. Gültige Werte sind 0 (oder false) und 1 (oder true). Der Standardwert ist false.
<PhotoURL>	Optional	Object	(Wie <PhotoURL> in <RoomData>, aber für das Paket (z.B. Fotos von Mahlzeiten).)
<Refundable>	Optional	Object	Ermöglicht das Eintragen eines Preises als vollständig erstattungsfähig oder mit kostenloser Stornierung. Wenn nicht angegeben, werden keine Informationen zu einer Erstattung angezeigt. Eine Erstattungsrichtlinie auf <PackageData>-Ebene überschreibt die Erstattungsrichtlinie auf <Result>-Ebene. Eine Erstattungsrichtlinie auf <Rates>-Ebene überschreibt die Erstattungsrichtlinie auf <PackageData>-Ebene. Erstattungsfähige Preise können Nutzern auch durch alternative Optionen hervorgehoben werden, ohne das Schema für Transaktionsnachrichten direkt zu ändern. Weitere Informationen zu diesen Optionen Das folgende Beispiel zeigt das Element <Refundable> mit allen zugehörigen Attributen: <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Hinweis: Es wird empfohlen, alle Attribute festzulegen. Wenn ein oder mehrere Attribute nicht festgelegt wurden, wird eine Warnmeldung für den Feedstatus generiert. Wenn Sie keine Attribute festlegen, wird der Preis nicht als erstattungsfähig angezeigt. Folgende Attribute sind verfügbar: available: (Erforderlich) Legen Sie 1 oder true fest, um anzugeben, ob für den Preis eine vollständige Erstattung möglich ist. Andernfalls geben Sie 0 oder false an. refundable_until_days: (erforderlich, wenn available den Wert true hat) Gibt die Anzahl der Tage vor dem Check-in an, innerhalb derer eine vollständige Erstattung beantragt werden kann. Der Wert für refundable_until_days muss eine Ganzzahl im Bereich von 0 bis 330 sein. refundable_until_time: (dringend empfohlen, wenn available den Wert true hat) Gibt die späteste Uhrzeit in der Ortszeit des Hotels an, bis zu der ein Antrag auf eine vollständige Erstattung berücksichtigt wird. Dies kann mit refundable_until_days kombiniert werden, um beispielsweise anzugeben, dass „Erstattungen bis 16:00 Uhr zwei Tage vor dem Check-in möglich sind“. Wenn refundable_until_time nicht festgelegt ist, wird Mitternacht standardmäßig verwendet. Der Wert dieses Attributs wird im Zeitformat angegeben. Beachten Sie beim Festlegen der Attribute Folgendes: Wenn available oder refundable_until_days nicht festgelegt ist, wird der Preis nicht als erstattungsfähig angezeigt. Wenn available den Wert 0 oder false hat, werden die anderen Attribute ignoriert. Der Preis wird nicht als erstattungsfähig angezeigt, auch wenn eines oder beide der anderen Attribute festgelegt sind.
<MembershipBenefits Included>	Optional	boolean	Der Preis beinhaltet Vorteile des Elite-Status für die Dauer des Aufenthalts. Enthält die folgenden Parameter: ProgramName: Name des Elite-Statusprogramms ProgramLevel: Level des Programms, z.B. „Gold“. NightlyValue (optional): Wert der Vorteile pro Nacht.
<CarRentalIncluded>	Optional	boolean	Der Preis beinhaltet eine kostenlose Autovermietung für die Dauer des Aufenthalts.
<MilesIncluded>>	Optional	boolean	Der Preis enthält Vielfliegermeilen. Zu den Parametern gehören: NumberofMiles: Anzahl der Meilen pro Reiseplan. Provider: Vielfliegermeilen können zur Verfügung gestellt werden.
<OnPropertyCredit>	Optional	boolean	Der Preis beinhaltet Guthaben in der Unterkunft (Lebensmittel und Getränke, Resort, Spa usw.). Parameter: Amount: Der Wert des Guthabens pro Reiseplan in Landeswährung.
<AirportTransportationIncluded>	Optional	Object	Der Preis beinhaltet den kostenlosen Transport von und zu einem nahe gelegenen Flughafen. Das optionale Attribut direction gibt die Fahrtrichtung an. Gültige Werte: from: Es wird ein Transport vom Flughafen zum Hotel angeboten. Dies ist der Standardwert, wenn keine Richtung angegeben wird. to: Es wird ein Shuttleservice vom Hotel zum Flughafen angeboten. round_trip: Der Transport zum und vom Flughafen wird angeboten.

Beispiele

Einzelzimmerpaket

Im folgenden Beispiel wird ein Einzelzimmerpaket mit einer Belegung von 2 Personen (1 Erwachsener und 1 Kind) definiert, einschließlich Frühstück:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <PackageData>
      <Occupancy>2</Occupancy>
      <OccupancyDetails>
        <NumAdults>1</NumAdults>
        <Children>
          <Child age="17"/>
        </Children>
      </OccupancyDetails>
      <PackageID>P54321</PackageID>
      <Name>
         <Text text="Breakfast Included" language="en"/>
         <Text text="Avec le petit déjeuner" language="fr"/>
      </Name>
      <Description>
        <Text text="Two certificates for continental
          breakfast will be provided." language="en"/>
        <Text text="Deux certificats pour le petit déjeuner
          continental seront fournis." language="fr"/>
      </Description>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>

Zimmer- und Paketmetadaten

Im folgenden Beispiel werden Zimmer- und Paketmetadaten definiert:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>180054</Property>
    <RoomData>
      <RoomID>060773</RoomID>
      <Name>
        <Text text="Single Bed Room" language="en"/>
        <Text text="Chambre single" language="fr"/>
      </Name>
      <Description>
        <Text text="Non-smoking" language="en"/>
        <Text text="Pas de fumiers" language="fr"/>
      </Description>
      <PhotoURL>
        <Caption>
          <Text text="Living area" language="en"/>
          <Text text="Le chambre" language="fr"/>
        </Caption>
        <URL>http://www.foo.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
    </RoomData>
    <PackageData>
      <PackageID>P54321</PackageID>
      <Name>
        <Text text="Breakfast Included" language="en"/>
        <Text text="Avec le petit déjeuner" language="fr"/>
      </Name>
      <Description>
        <Text text="Includes a delightful array of jams and jellies." language="en"/>
        <Text text="Comprend une délicieuse gamme de confitures et gelées." language="fr"/>
      </Description>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>

Pakete für mehrere Zimmer

Im folgenden Beispiel werden Zimmer- und Paketmetadaten für mehrere Zimmerpakete definiert:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <!-- A transaction message with room types result. -->
  <PropertyDataSet>
    <Property>12345</Property>
    <RoomData>
      <RoomID>single</RoomID>
      <Name>
        <Text text="Single room" language="en"/>
        <Text text="Chambre simple" language="fr"/>
      </Name>
      <Description>
        <Text text="A single room" language="en"/>
        <Text text="Le chambre simple" language="fr"/>
      </Description>
      <PhotoURL>
        <Caption>
          <Text text="Living area" language="en"/>
          <Text text="Le chambre" language="fr"/>
        </Caption>
        <URL>http://www.foo.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <PhotoURL>
        <URL>http://www.foo.com/static/bar/image1235.jpg</URL>
      </PhotoURL>
      <Capacity>2</Capacity>
    </RoomData>
    <RoomData>
      <RoomID>double</RoomID>
      <Name>
        <Text text="Double room" language="en"/>
        <Text text="Chambre double" language="fr"/>
      </Name>
      <Occupancy>1</Occupancy>
    </RoomData>
    <PackageData>
      <PackageID>refundbreakfast</PackageID>
      <Name>
        <Text text="Refundable Room with Breakfast" language="en"/>
        <Text text="Chambre remboursable avec le petit déjeuner" language="fr"/>
      </Name>
      <Description>
        <Text text="Continental Breakfast" language="en"/>
        <Text text="Petit déjeuner continental" language="fr"/>
      </Description>
      <ChargeCurrency>hotel</ChargeCurrency>
      <Refundable available="1" refundable_until_days="3"/>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
    <PackageData>
      <PackageID>prepaid</PackageID>
      <Name>
        <Text text="Nonrefundable" language="en"/>
        <Text text="Non remboursable" language="fr"/>
      </Name>
      <Description>
        <Text text="Blah blah blad" language="en"/>
        <Text text="Le blah blah blad" language="fr"/>
      </Description>
      <Occupancy>2</Occupancy>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="0"/>
    </PackageData>
  </PropertyDataSet>
</Transaction>

Zimmerpaket mit Preisen

Im folgenden Beispiel werden Zimmer- und Paketmetadaten für ein Zimmerpaket mit Preismerkmalen definiert:

<Transaction timestamp="2010-04-24T20:44:56-04:00" id="TXNID">
  <PropertyDataSet>
    <Property>12345</Property>
    <RoomData>
     ...
    </RoomData>
<!-- definitions of PackageData types including rate features -->
    <PackageData>
      <PackageID>room_with_addl_benefits</PackageID>
      <Name>
        <Text text="Acme Hotels 2017 Promotion Package" language="en"/>
      </Name>
      <ChargeCurrency>hotel</ChargeCurrency>
      <BreakfastIncluded>1</BreakfastIncluded>
      <MembershipBenefitsIncluded>
        <ProgramName>
          <Text language="en" text="Marriott Rewards"/>
        </ProgramName>
        <ProgramLevel>
          <Text language="en" text="Platinum"/>
        </ProgramLevel>
      </MembershipBenefitsIncluded>
      <OnPropertyCredit>
        <Amount currency="USD">123.45</Amount>
      </OnPropertyCredit>
    </PackageData>
    <PackageData>
      <PackageID>room_with_miles</PackageID>
      <Name>
        <Text text="Room with Bundled Miles" language="en"/>
      </Name>
      <ChargeCurrency>hotel</ChargeCurrency>
      <MilesIncluded>
        <NumberOfMiles>1000</NumberOfMiles>
        <Provider>
          <Text language="en" text="United Airlines"/>
        </Provider>
      </MilesIncluded>
      <AirportTransportationIncluded direction="from"/>
    </PackageData>
  </PropertyDataSet>

<!-- The actual list of prices -->
  <Result>
…
  </Result>
</Transaction>

Mahlzeiten und Fotos

Im folgenden Beispiel werden Zimmer- und Paketmetadaten für Mahlzeiten, Fotos sowie Check-in- und Check-out-Zeiten definiert:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <PackageData>
      <PhotoURL>
        <Caption>
          <Text text="Breakfast" language="en"/>
          <Text text="朝食" language="ja"/>
        </Caption>
        <URL>http://example.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <Meals>
        <!-- Guests can choose to have breakfast in their room or in another
        space to avoid contact with other guests. -->
        <Breakfast included="1" in_room="1" in_private_space="1"/>
        <Dinner included="1" buffet="1"/>
      </Meals>
      <CheckinTime>15:00</CheckinTime>
      <CheckoutTime>11:00</CheckoutTime>
    </PackageData>
  </PropertyDataSet>
</Transaction>

Frühstück

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <PackageData>
      <PhotoURL>
        <Caption>
          <Text text="Breakfast" language="en"/>
          <Text text="朝食" language="ja"/>
        </Caption>
        <URL>http://example.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <Meals>
        <Breakfast included="true"/>
        <!-- Dinner not included needs to be explicitly specified -->
        <Dinner included="false"/>
      </Meals>
      <CheckinTime>15:00</CheckinTime>
      <CheckoutTime>11:00</CheckoutTime>
    </PackageData>
  </PropertyDataSet>
</Transaction>

Wichtiger Hinweis :Du musst Breakfast und/oder Dinner explizit als false angeben, wenn du sie von der Mahlzeit ausschließen möchtest.

<Result>

Ein Container für Preis- und Verfügbarkeitsaktualisierungen in einer <Transaction>-Nachricht.

Wichtiger Hinweis :Lassen Sie <BaseRate> für <Result> für Mehrbettzimmer (z.B. in Hostels) leer. Geben Sie stattdessen die Preisinformationen für Mehrbettzimmer und Hostels in <RoomBundle> an.

Das Element <Result> wird an der folgenden Stelle in der XML-Hierarchie der Transaktionsnachricht angezeigt:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>           // Pricing and availability
        + <Rates>
        + <RoomBundle>
        + ...

Verwenden Sie <Result>, um Zimmerpreise festzulegen oder zu aktualisieren und um verfügbares Inventar zu definieren. In diesem Element definierte Elemente verweisen in der Regel auf vom Reiseplan unabhängige Metadaten eines Zimmers oder Pakets (z. B. eine Beschreibung oder Ausstattung), die in <PackageData> und <RoomData> definiert sind.

Transaktionsnachrichten mit Preisaktualisierungen werden in der Regel sehr häufig gesendet. Wie und wie oft Sie dies tun, hängt von Ihrem Übermittlungsmodus ab.

Sie können <Result> in einer Transaktionsnachricht verwenden, um Reisepläne zu entfernen, wie unter Inventar entfernen beschrieben. Weitere Informationen zum Aktualisieren von Preisen und Verfügbarkeit mithilfe von Transaktionsnachrichten finden Sie unter Inventar hinzufügen und aktualisieren.

Eine Transaktionsnachricht kann eine beliebige Anzahl von <Result>-Elementen enthalten, solange die Größe der Nachricht 100 MB nicht überschreitet.

Syntax

Das <Result>-Element verwendet die folgende Syntax:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <Result>
    <!-- Required -->
    <Property>hotel_ID</Property>
    <!-- Required -->
    <Checkin>YYYY-MM-DD</Checkin>
    <!-- Required -->
    <Nights>number_of_nights</Nights>

    <Baserate currency="currency_code">price</Baserate>
    <!-- Only required when <Baserate> contains a real price -->
    <Tax currency="currency_code">tax_amount</Tax>
    <!-- Only required when <Baserate> contains a real price  -->
    <OtherFees currency="currency_code">fee_amount</OtherFees>
    <Refundable available="[false|true]" refundable_until_days="number_of_days"
      refundable_until_time="time"/>

    <RoomID>room_ID</RoomID>
    <PackageID>package_ID</PackageID>
    <ExpirationTime>expiration_time</ExpirationTime>
    <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency>

    <Occupancy>max_number_of_intended_occupants</Occupancy>
    <!-- For Baserate, occupancy value must be greater than or equal to 2.
         If a value is not provided for occupancy, it defaults to 2. -->
    <OccupancyDetails>occupancy_info</OccupancyDetails>

    <Rates>...</Rates>

    <RoomBundle>...</RoomBundle>

    <AllowablePointsOfSale>
      <PointOfSale id="landing_page_identifier"/>
      ...
    </AllowablePointsOfSale>

    <Custom[1-5]>custom_value</Custom[1-5]>
  </Result>
  ...
  </Transaction>

Attribute

Das <Result>-Element hat die folgenden Attribute:

Attribut	Erforderlich/Optional?	Typ	Beschreibung
mergeable	Optional	boolean	Standardmäßig überschreiben neue Preise für ein bestimmtes Hotel/Reiseplan-Paar alle vorherigen (nicht abgelaufenen) Preise im Cache von Google. Mit dem Attribut „mergeable“ können Sie zusätzliche Preise im Cache von Google speichern, ohne vorherige Preisinformationen zu löschen. Bei Livepreisabfragen mit Kontextantworten wird dieses Attribut immer auf true gesetzt (unabhängig von der Antwort auf die Transaktionsnachricht).

Untergeordnete Elemente

Das <Result>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element	Erforderlich?	Typ	Beschreibung
<AllowablePointsOfSale>	Optional	Object	Eine oder mehrere Landingpages, die für das Hotel infrage kommen. Eine Landingpage ist eine Website, auf der der Buchungsprozess des Endnutzers verarbeitet werden kann. Wenn Sie bestimmte Landingpages explizit einschließen und andere ausschließen möchten, fügen Sie ein oder mehrere <AllowablePointsOfSale>-Elemente hinzu, die dem id-Attribut des <PointOfSale>-Elements in der Landingpage-Datei entsprechen. Wenn Sie dieses Element nicht angeben, können alle in der Landingpage-Datei definierten Landingpages für die Buchung des Zimmers verwendet werden. Weitere Informationen finden Sie unter Syntax der Landingpage-Datei.
<Baserate>	Optional	float	Der Preis des Zimmers für den Aufenthalt. Der Wert dieses Elements sollte Folgendes widerspiegeln: Legen Sie für ein privates Zimmer den günstigsten Doppelzimmerpreis fest, den Sie anbieten. Lassen Sie das Feld bei einem gemeinsam genutzten Raum leer und verwenden Sie <RoomBundle>. Die Gesamtdauer eines Aufenthalts, nicht der durchschnittliche Übernachtungspreis. Wenn das Zimmer für den Reiseplan nicht verfügbar ist, sollte <Baserate> entweder weggelassen oder auf -1 gesetzt werden. Außerdem sollte <Unavailable> zusammen mit den bekannten Gründen für die Nichtverfügbarkeit angegeben werden. Informationen zum Entfernen eines Zimmerpakets finden Sie unter Zimmerpaket entfernen. Der <Baserate> darf keine Symbole zum Gruppieren von Zahlen enthalten, z. B. ein Komma (,) oder einen Punkt (.). Brüche müssen immer durch einen Punkt (.) als Dezimalzeichen getrennt werden. Stellen Sie 1.200,40 $beispielsweise so dar: <Baserate currency="USD">1200.40</Baserate> Das Element <Baserate> verwendet die folgenden optionalen Attribute: all_inclusive: Ein boolescher Wert, der angibt, ob im Preis Steuern und Gebühren enthalten sind. Legen Sie diesen Wert für Endnutzer in den USA und Kanada im Allgemeinen auf false fest und geben Sie Werte für die Elemente <Tax> und <OtherFees> an. Wenn Sie Pauschalpreise verwenden, werden Sie möglicherweise nicht in den Einträgen angezeigt, wenn Steuern und Gebühren für Nutzer in den USA und Kanada nicht separat angegeben sind. Für alle anderen Endnutzer beziehen Sie Steuern und Gebühren in der Regel in den Basispreis mit ein und setzen den Wert des Attributs all_inclusive auf true. Weitere Informationen finden Sie unter Steuern- und Gebührenrichtlinie. Der Standardwert ist false. currency: Der dreistellige Währungscode. Beispiel: USD für US-Dollar.
<ChargeCurrency>	Optional	enum	Wann und wo der Nutzer für eine Buchung bezahlt. Dieses Element kann in einer Transaktionsnachricht im Element <Result> für den Hotelpreis oder im <PackageData>-Block für ein Zimmerpaket verwendet werden. Gültige Werte sind: web: Der Nutzer wird bei der Buchung online belastet. „Immer“ ist der Standardwert. Die tatsächliche Landingpage wird durch die Landingpage-Datei definiert. Sie kann von der Währung, dem Standort, der Sprache oder anderen Faktoren beeinflusst werden. hotel: Der Nutzer zahlt beim Check-in im Hotel. Wenn die Zahlung immer in der Währung des Hotels erfolgen muss, setzen Sie den Wert von <ChargeCurrency> auf hotel. Die tatsächliche Landingpage wird nicht von der Währung des Nutzers beeinflusst. deposit: Dem Nutzer wird ein Teil sofort in Rechnung gestellt, der Rest wird zu einem späteren Zeitpunkt in Rechnung gestellt, in der Regel beim Check-out des Hotels. installments: Dem Nutzer wird ein erster Teil der fälligen Gesamtsumme in Rechnung gestellt und er zahlt regelmäßig über einen festgelegten Zeitraum hinweg einen festgelegten Betrag. Der Standardwert ist web.
<Checkin>	Required	Date	Das Check-in-Datum für einen Reiseplan im Format Date. Der Reiseplan setzt sich aus dem Element <Nights> und dem Element <Checkin> zusammen.
<Custom[1‑5]>	Optional	string	Definiert ein benutzerdefiniertes Feld, mit dem Sie zusätzliche Daten zu einem Hotel übergeben können. Sie können bis zu fünf benutzerdefinierte Werte mit den folgenden Elementnamen übergeben: <Custom1> <Custom2> <Custom3> <Custom4> <Custom5> Mit den <Custom>-Elementen können Sie beliebige Daten übergeben. Sie können in diesem Feld beispielsweise einen Wert angeben, der dann von der Landingpage-Datei verwendet wird, um eine benutzerdefinierte URL für eine Landingpage zu erstellen. Pro benutzerdefiniertes Feld dürfen maximal 200 Zeichen verwendet werden. Weitere Informationen finden Sie unter Landingpage-Dateien. <Custom>-Elemente, die im <Rate>-Element angegeben sind, werden nicht für das <RoomBundle>-Element übernommen. Das <Custom>-Attribut sollte in jeder <RoomBundle> separat definiert werden.
<ExpirationTime>	Optional	DateTime	Datum und Uhrzeit, zu der der Preis als abgelaufen gilt (mindestens 3 Stunden). Wir empfehlen, keine Ablaufzeitstempel anzugeben, wenn dies für Ihre Preisstruktur nicht entscheidend ist. Google zeigt keine abgelaufenen Preise an. Alle Reisepläne mit einem abgelaufenen Preis kommen für die Livepreisabfrage infrage.
<Nights>	Required	integer	Die Anzahl der Übernachtungen für einen Reiseplan. Der Wert des Elements <Nights> muss eine positive Ganzzahl sein. Die Kombination aus <Nights> und <Checkin> ergibt einen Reiseplan.
<OtherFees>	Optional	float	Abgesehen vom Basispreis und den Steuern anfallende Gebühren, die sich auf den endgültigen Zimmerpreis auswirken. Das Element <OtherFees> verwendet nur das Attribut currency, das den aus drei Buchstaben bestehenden Währungscode für die Gebühren angibt. Beispiel: USD Das Element <OtherFees> ist erforderlich, wenn <Baserate> größer als null ist.
<Occupancy>	Optional	integer	Gibt die maximale Anzahl von Personen an. Wenn <Occupancy> unter <Result> erscheint, muss mindestens 2 angegeben werden. <Occupancy> wird möglicherweise von <OccupancyDetails> begleitet, wodurch die Art der Gäste (Erwachsene oder Kinder) angegeben wird. Unter <OccupancyDetails> finden Sie Informationen zur Syntax und eine Beschreibung untergeordneter Elemente. Wenn das Element <Occupancy> nicht angegeben ist, wird die Belegung standardmäßig auf 2 festgelegt. Hinweis: Wenden Sie sich an Ihr Supportteam, um das Senden von Preisen für eine von 2 abweichende Belegung zu aktivieren.
<PackageID>	Optional	string	Die eindeutige ID des Pakets, um es vordefinierten Paketdaten zuzuordnen. Wird auch verwendet, um die Landingpage-Variable PACKAGE-ID zu füllen. Weitere Informationen finden Sie unter Zimmerpaket-Metadaten.
<Property>	Required	string	Die ID eines Hotels, das von den zugehörigen Daten betroffen ist (Preis, Reiseplan, Zimmerpaket oder Metadaten). Der Wert dieses Elements muss ein String sein. Der Wert dieses Elements muss mit dem Eintrag <id> übereinstimmen, den Sie in Ihrem Hotellistenfeed definiert haben.
<Rates>	Optional	<Rates>	Ein Container für ein oder mehrere <Rate>-Blöcke. Jede <Rate> in <Rates> definiert einen anderen Preis für die Kombination aus Zimmer und Reiseplan. Verwenden Sie das Element <Rates> nur, wenn es mehrere Preise für dieselbe Kombination aus Zimmer und Reiseplan gibt. Zum Beispiel definieren Sie mehrere Preise für nutzerabhängige Preise, Tarife für bestimmte Zielgruppen oder nutzerabhängige Preise in Zimmerpaketen.
<Refundable>	Optional	Object	Ermöglicht das Eintragen eines Preises als vollständig erstattungsfähig oder mit kostenloser Stornierung. Wenn nicht angegeben, werden keine Informationen zu einer Erstattung angezeigt. Eine Erstattungsrichtlinie auf <PackageData>-Ebene überschreibt die Erstattungsrichtlinie auf <Result>-Ebene. Eine Erstattungsrichtlinie auf <Rates>-Ebene überschreibt die Erstattungsrichtlinie auf <PackageData>-Ebene. Erstattungsfähige Preise können Nutzern auch durch alternative Optionen hervorgehoben werden, ohne das Schema für Transaktionsnachrichten direkt zu ändern. Weitere Informationen zu diesen Optionen Das folgende Beispiel zeigt das Element <Refundable> mit allen zugehörigen Attributen: <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Hinweis: Es wird empfohlen, alle Attribute festzulegen. Wenn ein oder mehrere Attribute nicht festgelegt wurden, wird eine Warnmeldung für den Feedstatus generiert. Wenn Sie keine Attribute festlegen, wird der Preis nicht als erstattungsfähig angezeigt. Folgende Attribute sind verfügbar: available: (Erforderlich) Legen Sie 1 (oder true) fest, um anzugeben, ob für den Preis eine vollständige Erstattung möglich ist. Andernfalls geben Sie 0 (oder false) an. refundable_until_days: (erforderlich, wenn available den Wert true hat) Gibt die Anzahl der Tage vor dem Check-in an, innerhalb derer eine vollständige Erstattung beantragt werden kann. Der Wert für refundable_until_days muss eine Ganzzahl im Bereich von 0 bis 330 sein. refundable_until_time: (dringend empfohlen, wenn available den Wert true hat) Gibt die späteste Uhrzeit in der Ortszeit des Hotels an, bis zu der ein Antrag auf eine vollständige Erstattung berücksichtigt wird. Dies kann mit refundable_until_days kombiniert werden, um beispielsweise anzugeben, dass „Erstattungen bis 16:00 Uhr zwei Tage vor dem Check-in möglich sind“. Wenn refundable_until_time nicht festgelegt ist, wird Mitternacht standardmäßig verwendet. Der Wert dieses Attributs wird im Zeitformat angegeben. Beachten Sie beim Festlegen der Attribute Folgendes: Wenn available oder refundable_until_days nicht festgelegt ist, wird der Preis nicht als erstattungsfähig angezeigt. Wenn available den Wert 0 (oder false) hat, werden die anderen Attribute ignoriert. Der Preis wird nicht als erstattungsfähig angezeigt, auch wenn eines oder beide der anderen Attribute festgelegt sind.
<RoomBundle>	Optional	<RoomBundle>	Ein Container für Informationen zu physischen Beschreibungen eines Zimmers mit Preisen, Ausstattungspaketen und einigen Details zu Kaufrichtlinien für das jeweilige Hotel und den Reiseplan. Verwenden Sie dieses Element im Allgemeinen, um den Preis für das Basiszimmer und verschiedene Zimmertypen innerhalb derselben Unterkunft zu definieren. Es ist zwar möglich, Beschreibungen von Zimmerpaketen inline zu definieren, sollten Sie jedoch eine separate Transaktionsnachricht verwenden, um diese Informationen anzugeben. Google speichert Metadaten, damit du bei zukünftigen Preisaktualisierungen darauf verweisen kannst, anstatt sie zu wiederholen.
<RoomID>	Optional	string	Die eindeutige ID des Zimmers, um es vordefinierten Zimmerdaten zuzuordnen. Wird auch verwendet, um die Landingpage-Variable PARTNER-ROOM-ID auszufüllen. Weitere Informationen finden Sie unter Zimmerpaket-Metadaten.
<Tax>	Optional	float	Die Steuern, die für den endgültigen Preis eines Zimmers berechnet werden. Das Element <Tax> verwendet das einzelne erforderliche Attribut currency, das den aus drei Buchstaben bestehenden Währungscode für die Steuern definiert. Beispiel: USD Das Element <Tax> ist erforderlich, wenn <Baserate> größer als null ist.
<Unavailable>	Optional	Object	Gibt an, dass der Reiseplan nicht gebucht werden kann. Er dient als Container für detailliertere Gründe, warum der Reiseplan nicht verfügbar war. Einer oder mehrere der folgenden Gründe für die Nichtverfügbarkeit können unter dem <Unavailable>-Tag verschachtelt sein: <NoVacancy/>: Für eine oder mehrere Nächte des Aufenthalts sind keine weiteren Zimmer für den Verkauf verfügbar. <MinNightStay value=N/>: Der Reiseplan lag für die Aufenthaltsdaten unter der Mindestaufenthaltsdauer von N. <MaxNightStay value=N/>: Der Reiseplan lag über der maximalen Aufenthaltsdauer von N für die Aufenthaltsdaten. <MinAdvancePurchase value=N/>: Der Reiseplan lag für die Aufenthaltsdaten unter dem minimalen Reservierungszeitraum von N. <MaxAdvancePurchase value=N/>: Der Reiseplan lag für die Aufenthaltsdaten über dem maximalen Reservierungszeitraum von N. <ClosedToArrival/>: Ein Check-in am Ankunftsdatum des Reiseplans ist nicht zulässig. <ClosedToDeparture/>: Am Abreisedatum des Reiseplans ist kein Check-out möglich. <PropertyClosed first_open="YYYY-MM-DD" first_closed="YYYY-MM-DD"/>: Die Unterkunft ist für einen Teil oder den gesamten Aufenthalt geschlossen. Die empfohlenen Attribute first_open und first_closed geben die ersten Tage an, die größer oder gleich dem Ankunftsdatum sind, an dem die Unterkunft geöffnet bzw. geschlossen ist. Bei Unterkünften, die nach dem Ankunftsdatum schließen, muss first_open dem Ankunftsdatum und first_closed das Datum sein, an dem die Unterkunft schließt. Bei Unterkünften, die am Ankunftsdatum geschlossen sind, muss first_closed dem Ankunftsdatum entsprechen und first_opened das nächste Datum, an dem die Unterkunft geöffnet ist. <NotFetched/>: Ein Preis für den Reiseplan wurde nicht von nachgelagerten Datenquellen bereitgestellt. <InvalidProperty/>: Die angeforderte Property-ID wurde nicht erkannt. <InvalidOccupancy/>: Die angeforderte Belegung wird von der Unterkunft nicht unterstützt. <PriceIssue/>: Ein Problem mit dem Preis hat dazu geführt, dass der Preis nicht gesendet wurde. <InternalError reason=""/>: Ein nicht aufgezählter Fehler ist aufgetreten. Mit dem optionalen Attribut „reason“ kann der Fehler in Textform gemeldet werden. <OtherRestriction restriction=""/>: Der Reiseplan war aufgrund nicht aufgezählter Buchungsbeschränkungen nicht verfügbar. Mit einem optionalen Einschränkungsattribut kann die Einschränkung in Textform gemeldet werden.

Beispiele

Beispiel für mehrere Unterkünfte

Im folgenden Beispiel werden ein Reiseplan und dessen Preise für zwei Unterkünfte definiert:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
  <Result>
    <Property>060773</Property>
    <RoomID>RoomType101</RoomID>
    <PackageID>Package101</PackageID>
    <Checkin>2018-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">278.33</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="site1"/>
    </AllowablePointsOfSale>
  </Result>
  <Result>
    <Property>052213</Property>
    <RoomID>RoomType101</RoomID>
    <PackageID>Package101</PackageID>
    <Checkin>2018-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">299.98</Baserate>
    <Tax currency="USD">26.42</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="otto"/>
      <PointOfSale id="simon"/>
    </AllowablePointsOfSale>
  </Result>
</Transaction>

In diesem Beispiel werden keine Details über das Zimmer gezeigt, wie etwa eine Beschreibung, ein Bild mit Bildunterschrift, der Raumname oder die Kapazität.

Sie können diese Informationen einmalig in einer separaten Transaktionsnachricht definieren, die Google speichert. Sie können sie dann bei allen nachfolgenden Preis- und Inventaraktualisierungen verwenden. Weitere Informationen finden Sie unter Zimmerpaket-Metadaten.

Beispiel für mehrere Preise

Im folgenden Beispiel werden ein einzelner Reiseplan und eine Unterkunft mit mehreren Preisen für verschiedene Belegungen definiert. Mit dem Element <Rates> können Sie mehrere Preise für eine bestimmte Unterkunft angeben. Das folgende Beispiel ist auch für Ferienunterkünfte nützlich.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-07-23T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2021-01-13</Checkin>
    <Nights>9</Nights>
    <Baserate currency="USD">3196.1</Baserate>
    <Tax currency="USD">559.49</Tax>
    <OtherFees currency="USD">543.34</OtherFees>
    <Occupancy>2</Occupancy>
    <Rates>
      <Rate>
        <Baserate currency="USD">3196.1</Baserate>
        <Tax currency="USD">559.49</Tax>
        <OtherFees currency="USD">543.34</OtherFees>
        <Occupancy>1</Occupancy>
      </Rate>
      <Rate>
        <Baserate currency="USD">3196.1</Baserate>
        <Tax currency="USD">559.49</Tax>
        <OtherFees currency="USD">543.34</OtherFees>
        <Occupancy>3</Occupancy>
      </Rate>
      <Rate>
        <Baserate currency="USD">3196.1</Baserate>
        <Tax currency="USD">559.49</Tax>
        <OtherFees currency="USD">543.34</OtherFees>
        <Occupancy>4</Occupancy>
      </Rate>
      <Rate>
        <Baserate currency="USD">3196.1</Baserate>
        <Tax currency="USD">559.49</Tax>
        <OtherFees currency="USD">543.34</OtherFees>
        <Occupancy>5</Occupancy>
      </Rate>
      <Rate>
        <Baserate currency="USD">3196.1</Baserate>
        <Tax currency="USD">559.49</Tax>
        <OtherFees currency="USD">543.34</OtherFees>
        <Occupancy>6</Occupancy>
      </Rate>
    </Rates>
  </Result>
</Transaction>

Beispiel nicht verfügbar

Im folgenden Beispiel wird ein Reiseplan definiert, dessen Verfügbarkeit nicht von nachgelagerten Kanälen abgerufen werden konnte, eine zweite, die unter der Mindestaufenthaltsdauer liegt und bereits für die angegebenen Daten gebucht wurde, und ein dritter Reiseplan, dessen Unterkunft am Ankunftsdatum geschlossen ist, aber während des Aufenthalts geöffnet wird:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
  <Result>
    <Property>060773</Property>
    <Checkin>2018-06-10</Checkin>
    <Nights>2</Nights>
    <Unavailable>
      <NotFetched/>
    </Unavailable>
  </Result>
  <Result>
    <Property>073313</Property>
    <Checkin>2018-06-10</Checkin>
    <Nights>2</Nights>
    <Unavailable>
      <NoVacancy/>
      <MinNightStay value=3/>
    </Unavailable>
  </Result>
  <Result>
    <Property>052213</Property>
    <Checkin>2018-06-10</Checkin>
    <Nights>10</Nights>
    <Unavailable>
      <PropertyClosed first_open="2018-06-15" first_closed="2018-06-10"/>
    </Unavailable>
  </Result>
</Transaction>

<Rates>

Ein Container für ein oder mehrere <Rate>-Blöcke. Jede <Rate> in <Rates> definiert einen anderen Preis für die Kombination aus Zimmer und Reiseplan.

Verwenden Sie das Element <Rates> nur, wenn es mehrere Preise für dieselbe Kombination aus Zimmer und Reiseplan gibt. Sie definieren beispielsweise mehrere Preise für nutzerabhängige Preise, Tarife für bestimmte Zielgruppen oder nutzerabhängige Preise in Zimmerpaketen.

Das Element <Rates> wird an der folgenden Stelle in der XML-Hierarchie der Transaktionsnachricht angezeigt:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>           // Pricing and availability
        + <Rates>
        + <RoomBundle>           (Can also contain <Rates>)
        + ...

Werte, die in einem <Rate> festgelegt werden, überschreiben preisbezogene Werte für das übergeordnete Element <Result> oder <RoomBundle>. Wenn sie nicht in <Rate> festgelegt sind, übernehmen sie ihren Wert vom übergeordneten Element. Nur <AllowablePointsofSale> wird in das <RoomBundle>-Element übernommen.

Syntax

Das <Rates>-Element verwendet die folgende Syntax:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <Result>
    <Rates>
      <Rate rate_rule_id="rate_rule_id">
        <Baserate currency="currency_code">price</Baserate>
        <Tax currency="currency_code">tax_amount</Tax>
        <OtherFees currency="currency_code">fee_amount</OtherFees>
        <ExpirationTime>expiration_time</ExpirationTime>
        <Refundable available="[false|true]" refundable_until_days="number_of_days"
        refundable_until_time="time"/>
        <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency>
        <AllowablePointsOfSale>
          <PointOfSale id="landing_page_identifier"/>
        </AllowablePointsOfSale>
        <Occupancy>max_number_of_intended_occupants</Occupancy>
        <OccupancyDetails> <!-- optional info about the types of guests,
      whether adults or children --></OccupancyDetails>
          ...
        <Custom[1-5]>custom_value</Custom[1-5]>
      </Rate>
      ...
    </Rates>
  </Result>
  ...
</Transaction>

Attribute

Das <Rates>-Element hat die folgenden Attribute:

Attribut	Erforderlich/Optional?	Beschreibung
rate_rule_id	Optional	Bei nutzerabhängigen Preisen entspricht diese ID einem Preis in Ihrer Definitionsdatei für die Preisregel. Die Zeichenbeschränkung für dieses Feld beträgt 40 Zeichen.

Untergeordnete Elemente

Das <Rates>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element	Erforderlich?	Typ	Beschreibung
<AllowablePointsOfSale>	Optional	Object	Eine oder mehrere Landingpages, die für das Hotel infrage kommen. Für dieses Element wird dieselbe Syntax wie für <AllowablePointsOfSale> in <Result> verwendet.
<Baserate>	Required	float	Der Preis des Zimmers für den Aufenthalt. Für dieses Element wird dieselbe Syntax wie für <Baserate> in <Result> verwendet. Hinweis: Das untergeordnete Element <Baserate> unter <Rate> kann nicht als nicht verfügbar definiert werden.
<ChargeCurrency>	Optional	enum	Wann und wo der Nutzer für eine Buchung bezahlt. Für dieses Element wird die gleiche Syntax wie für <ChargeCurrency> in <Result> verwendet.
<Custom[1‑5]>	Optional	string	Benutzerdefinierte Felder, mit denen Sie zusätzliche Daten zu einem Hotel an eine Landingpage übergeben können. Für dieses Element wird die gleiche Syntax wie für <Custom[1‑5]> in <Result> verwendet. Pro benutzerdefiniertes Feld dürfen maximal 200 Zeichen verwendet werden. Weitere Informationen finden Sie unter Landingpage-Dateien. Wenn im Element <Result> <Custom>-Elemente angegeben sind, werden sie nicht im <RoomBundle>-Element übernommen und müssen für jede <RoomBundle> separat definiert werden oder können bei Bedarf in <PackageData> aufgenommen werden.
<ExpirationTime>	Optional	DateTime	Datum und Uhrzeit, zu der der Preis als abgelaufen gilt. Für dieses Element wird die gleiche Syntax wie für <ExpirationTime> in <Result> verwendet.
<Occupancy>	Optional	integer	Gibt die maximale Anzahl von Personen an. <Occupancy> wird möglicherweise von <OccupancyDetails> begleitet, wodurch die Art der Gäste (Erwachsene oder Kinder) angegeben wird. Unter <OccupancyDetails> finden Sie Informationen zur Syntax und eine Beschreibung untergeordneter Elemente.
<OtherFees>	Required	float	Neben dem Basispreis und den Steuern anfallende Gebühren, die sich auf den endgültigen Zimmerpreis auswirken. Für dieses Element wird die gleiche Syntax wie für <OtherFees> in <Result> verwendet.
<Refundable>	Optional	Object	Ermöglicht das Eintragen eines Preises als vollständig erstattungsfähig oder mit kostenloser Stornierung. Wenn nicht angegeben, werden keine Informationen zu einer Erstattung angezeigt. Eine Erstattungsrichtlinie auf <PackageData>-Ebene überschreibt die Erstattungsrichtlinie auf <Result>-Ebene. Eine Erstattungsrichtlinie auf <Rates>-Ebene überschreibt die Erstattungsrichtlinie auf <PackageData>-Ebene. Erstattungsfähige Preise können Nutzern auch durch alternative Optionen hervorgehoben werden, ohne das Schema für Transaktionsnachrichten direkt zu ändern. Weitere Informationen zu diesen Optionen Das folgende Beispiel zeigt das Element <Refundable> mit allen zugehörigen Attributen: <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Hinweis: Es wird empfohlen, alle Attribute festzulegen. Wenn ein oder mehrere Attribute nicht festgelegt wurden, wird eine Warnmeldung für den Feedstatus generiert. Wenn Sie keine Attribute festlegen, wird der Preis nicht als erstattungsfähig angezeigt. Folgende Attribute sind verfügbar: available: (Erforderlich) Legen Sie 1 (oder true) fest, um anzugeben, ob für den Preis eine vollständige Erstattung möglich ist. Andernfalls geben Sie 0 (oder false) an. refundable_until_days: (erforderlich, wenn available den Wert true hat) Gibt die Anzahl der Tage vor dem Check-in an, innerhalb derer eine vollständige Erstattung beantragt werden kann. Der Wert für refundable_until_days muss eine Ganzzahl im Bereich von 0 bis 330 sein. refundable_until_time: (dringend empfohlen, wenn available den Wert true hat) Gibt die späteste Uhrzeit in der Ortszeit des Hotels an, bis zu der ein Antrag auf eine vollständige Erstattung berücksichtigt wird. Dies kann mit refundable_until_days kombiniert werden, um beispielsweise anzugeben, dass „Erstattungen bis 16:00 Uhr zwei Tage vor dem Check-in möglich sind“. Wenn refundable_until_time nicht festgelegt ist, wird Mitternacht standardmäßig verwendet. Der Wert dieses Attributs wird im Zeitformat angegeben. Beachten Sie beim Festlegen der Attribute Folgendes: Wenn available oder refundable_until_days nicht festgelegt ist, wird der Preis nicht als erstattungsfähig angezeigt. Wenn available den Wert 0 (oder false) hat, werden die anderen Attribute ignoriert. Der Preis wird nicht als erstattungsfähig angezeigt, auch wenn eines oder beide der anderen Attribute festgelegt sind.
<Tax>	Required	float	Die Steuern, die für den endgültigen Preis eines Zimmers berechnet werden. Für dieses Element wird dieselbe Syntax wie für <Tax> in <Result> verwendet.

Wichtiger Hinweis: <Rates> verwendet dieselben untergeordneten Elemente wie <Result>, außer <Checkin>, <Nights>, <Property>, <RoomBundle> und <RoomID>.

Beispiele

Basispreis und nutzerabhängiger Preis

Das folgende Beispiel zeigt eine Transaktionsnachricht, die einen Basispreis und einen nutzerabhängigen Preis enthält:

<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2023-04-10</Checkin>
    <Nights>1</Nights>

    <Baserate currency="USD">200.00</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">1.00</OtherFees>

    <Rates>
      <!-- The rate_rule_id is required when using conditional rates -->
      <Rate rate_rule_id="mobile">
        <!-- Override base rate and taxes for conditional rates -->
        <Baserate currency="USD">180.00</Baserate>
        <Tax currency="USD">18.00</Tax>
        <!-- NOTE: OtherFees is inherited from the above setting -->
        <Custom1>ratecode123</Custom1>
      </Rate>
    </Rates>

  </Result>
</Transaction>

Mehrere nutzerabhängige Preise

Im folgenden Beispiel werden ein Basispreis und mehrere nutzerabhängige Preise in einem <RoomBundle> definiert:

<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2023-04-10</Checkin>
    <Nights>2</Nights>
    <!-- When Google receives new room bundle information for an itinerary, all
    previous room bundle pricing is dropped from Google's cache. Thus, if you
    want to delete a specific room bundle from Google's cache, you may do so
    by simply not providing that specific room bundle in subsequent transaction
    messages. -->
    <RoomBundle>
     ...
      <!-- RoomID is required, PackageID is recommended. -->
      <RoomID>5</RoomID>
      <PackageID>ABC</PackageID>
      <!-- Baserate is required. -->
      <Baserate currency="USD">275.00</Baserate>
      <Tax currency="USD">27.50</Tax>
      <OtherFees currency="USD">2.00</OtherFees>

      <!-- RatePlanID is optional and represents the unique identifier for a
      room and package data combination. We strongly recommend using RatePlanID
      as a variable to build your dynamic landing page (formerly Point of Sale)
      URL. For details, see Using Variables and Conditions. -->
      <RatePlanID>5-ABC</RatePlanID>

      <!-- Occupancy is mandatory for RoomBundle elements. -->
      <!-- Elements below will get inherited to nested rate elements. -->
      <Occupancy>2</Occupancy>
      <OccupancyDetails>
        <NumAdults>2</NumAdults>
      </OccupancyDetails>
      <InternetIncluded>1</InternetIncluded>


      <!-- Rate rule "mobile" overrides chargeCurrency, "us_or_gb" doesn't. -->
      <ChargeCurrency>web</ChargeCurrency>
      <Custom1>ratebasic</Custom1>
      <!-- Neither rate overrides Custom2. -->
      <Custom2>ratebasic</Custom2>

      <Rates>
        <Rate rate_rule_id="mobile">
          <Baserate currency="USD">258.33</Baserate>
          <Tax currency="USD">25.83</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
          <!-- The value below overrides ChargeCurrency from roombundle. -->
          <ChargeCurrency>hotel</ChargeCurrency>
          <!-- The value below overrides Custom1 from roombundle. -->
          <Custom1>ratecode321</Custom1>
          <!-- Custom2 is inherited from roombundle. -->
        </Rate>
        <Rate rate_rule_id="us_or_gb">
          <Baserate currency="USD">268.33</Baserate>
          <Tax currency="USD">26.83</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
          <!-- The value below overrides Custom1 from roombundle. -->
          <Custom1>ratecode432</Custom1>
          <!-- Custom2 is inherited from roombundle. -->
        </Rate>
      </Rates>
    </RoomBundle>
  </Result>
</Transaction>

<RoomBundle>

Definiert Preise und Verfügbarkeit für Zimmerpakete als untergeordnetes Element von <Result> in einer <Transaction>-Nachricht. Definieren Sie für jede Kombination aus Paket und Reiseplan ein separates Element. Verwenden Sie <RoomData>, um das Paket und die Bedingungen der Zimmerpakete zu definieren.

Das Element <RoomBundle> wird an der folgenden Stelle in der XML-Hierarchie der Transaktionsnachricht angezeigt:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>           // Pricing and availability
        + <Rates>
        + <RoomBundle>
        + ...

Weitere Informationen finden Sie unter Verwenden von Zimmerpaketen.

Syntax

Das <RoomBundle>-Element verwendet die folgende Syntax:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <Result>
    ...
    <RoomBundle>
      <!-- Required unless specified inline under <RoomData> -->
      <RoomID>room_ID</RoomID>
      <!-- Required  <PackageData> -->
      <PackageID>package_ID</PackageID>

      <!-- Required -->
      <Baserate currency="currency_code">price</Baserate>
      <!-- Required -->
      <Tax currency="currency_code">taxes</Tax>
      <!-- Required -->
      <OtherFees currency="currency_code">other_fees</OtherFees>

      <Refundable available="[false|true]" refundable_until_days="number_of_days"
        refundable_until_time="time"/>
      <!-- Required -->
      <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency>
      <Occupancy>max_number_of_intended_occupants</Occupancy>
      <OccupancyDetails> <!-- optional info about the types of guests,
      whether adults or children --></OccupancyDetails>

      <BreakfastIncluded>boolean_value</BreakfastIncluded>
      <InternetIncluded>boolean_value</InternetIncluded>
      <ParkingIncluded>boolean_value</ParkingIncluded>

      <RatePlanID>rate_plan_ID</RatePlanID>

      <Rates>...</Rates>

      <Custom1>custom_value_1</Custom1>
      <Custom2>custom_value_2</Custom2>
      <Custom3>custom_value_3</Custom3>
      <Custom4>custom_value_4</Custom4>
      <Custom5>custom_value_5</Custom5>
    </RoomBundle>
    ...
  </Result>
</Transaction>

Wichtiger Hinweis :Sie können auch ein <PackageData>-Objekt und/oder <RoomData> in einem <RoomBundle> definieren. Dies ist jedoch weniger effizient, als sie separat zu definieren und mit <RoomID> und <PackageID> darauf zu verweisen. Daher wird davon abgeraten.

Attribute

Das <RoomBundle>-Element hat keine Attribute.

Untergeordnete Elemente

Das <RoomBundle>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element	Erforderlich?	Typ	Beschreibung
<Baserate>	Required	float	Definiert den Preis des Zimmerpakets für den Aufenthalt. Für dieses Element wird die gleiche Syntax wie für <Baserate> in <Result> verwendet, mit der folgenden Ausnahme: Wenn das Zimmer für den Reiseplan nicht verfügbar ist, entfernen Sie das Element <RoomBundle>, um anzugeben, dass das Zimmer nicht mehr im Inventar enthalten ist. Weitere Informationen finden Sie unter Zimmerpaket entfernen.
<BreakfastIncluded>	Optional	boolean	Gibt an, ob dieses Zimmerpaket Frühstück im Preis enthält.
<ChargeCurrency>	Optional	enum	Wann und wo der Nutzer für eine Buchung bezahlt. Für dieses Element wird dieselbe Syntax wie für <ChargeCurrency> in <Result> verwendet. Der Standardwert ist web.
<Custom[1‑5]>	Optional	string	Benutzerdefinierte Felder zur Weitergabe zusätzlicher Daten an die Landingpages für das Zimmerpaket. Für diese Elemente wird dieselbe Syntax wie für <Custom[1-5]> in <Result> verwendet. Pro benutzerdefiniertes Feld dürfen maximal 200 Zeichen verwendet werden. Weitere Informationen finden Sie unter Landingpage-Dateien. Wenn im Element <Result> <Custom>-Elemente angegeben sind, werden sie nicht im <RoomBundle>-Element übernommen und müssen für jede <RoomBundle> separat definiert werden oder können bei Bedarf in <PackageData> aufgenommen werden.
<InternetIncluded>	Optional	boolean	Wenn ein Zimmerpaket kostenlosen Internetzugang beinhaltet, während andere Pakete diese Ausstattung nicht beinhalten. Legen Sie dieses Element nicht für Zimmerpakete eines Hotels fest, die für alle Zimmer kostenlosen Internetzugang bieten. Dieses Element gilt nicht für einen kabelgebundenen oder kabellosen Internetzugang, der nicht in den Zimmern verfügbar ist.
<Occupancy>	Required	integer	Die maximale Anzahl von Gästen, für die ein Zimmerpaket vorgesehen ist. Eine große Suite kann beispielsweise physisch Platz für 6 Personen bieten, während das „Flitterwochenpaket“ nur für 2 Gäste vorgesehen ist. Dieser Wert muss kleiner oder gleich <Capacity> sein. Das ist die Anzahl der Personen, für die das Zimmer physisch Platz bietet. Verwenden Sie beim Definieren der Belegung in der Landingpage-URL die Variablen NUM-ADULTS und NUM-CHILDREN, wie unter Variablen und Bedingungen verwenden beschrieben. Der Standardwert ist 2 Erwachsene und 0 Kinder. Der Wert für <Occupancy> muss eine positive Ganzzahl im Bereich von 1 bis 99 sein. Hinweise: <Occupancy> für <RoomBundle> wird dringend empfohlen. Diese Angabe sollte daher als erforderlich gekennzeichnet werden. Wenn Sie keine Angabe machen, wird der Fehler 1097 ausgelöst. <Occupancy> stammt in der folgenden Reihenfolge aus dem Datenobjekt: <RoomBundle>, <PackageData> und dann <RoomData>. Wenn in keiner dieser Bereiche ein Wert vorhanden ist, wird der Standardwert 2 verwendet. <Occupancy> wird möglicherweise von <OccupancyDetails> begleitet, wodurch die Art der Gäste (Erwachsene oder Kinder) angegeben wird. Unter <OccupancyDetails> finden Sie Informationen zur Syntax und eine Beschreibung untergeordneter Elemente. Wenn Sie <Occupancy> sowohl in <RoomBundle> als auch in <PackageData> festlegen, hat der Wert in <RoomBundle> Vorrang.
<OtherFees>	Required	float	Abgesehen vom Basispreis und den Steuern anfallende Gebühren, die sich auf den endgültigen Zimmerpreis auswirken. Das Element <OtherFees> verwendet nur das Attribut currency, das den aus drei Buchstaben bestehenden Währungscode für die Gebühren angibt. Verwenden Sie beispielsweise USD für US-Dollar.
<PackageID>	Optional (recommended)	string	Die eindeutige ID für die Paketdaten. Mit dieser ID ordnen Sie die Daten des Zimmerpakets den Daten zu, die in <PackageData> gesendet wurden. Weitere Informationen finden Sie unter Zimmerpaket-Metadaten. Wenn Sie die Daten eines Zimmerpakets inline definieren, können Sie mit dieser ID auf eine allgemeine Definition für ein Zimmerpaket in einer einzelnen Transaktionsnachricht verweisen.
<ParkingIncluded>	Optional	boolean	Gibt an, ob ein Zimmerpaket kostenloses Parken beinhaltet, wenn das Parken in diesem Hotel ansonsten kostenpflichtig wäre. Geben Sie für dieses Element keinen Wert an, wenn das Hotel kostenlose Parkplätze anbietet. Gültige Werte sind 0 (oder false) und 1 (oder true). Der Standardwert ist false.
<RatePlanID>	Optional	string	Die Preisplan-ID ist die eindeutige Kennung für eine Kombination aus Zimmer und Paket. Beispiel: Bei einem <RoomID>-Wert von 5 und einem <PackageID>-Wert von ABC könnten Sie den Wert 5-ABC für <RatePlanID> verwenden. Wir empfehlen Ihnen dringend, RatePlanID als Variable zu verwenden, um Ihre dynamische Landingpage-URL (früher Point-of-Sale-URL) zu erstellen. Weitere Informationen finden Sie unter Variablen und Bedingungen verwenden.
<Rates>	Optional	<Rates>	Preise, die die Standardeinstellungen für dieses Zimmerpaket überschreiben. Für dieses Element wird dieselbe Syntax wie für <Rates> in <Result> verwendet.
<Refundable>	Optional	Object	Ermöglicht das Eintragen eines Preises als vollständig erstattungsfähig oder mit kostenloser Stornierung. Wenn nicht angegeben, werden keine Informationen zu einer Erstattung angezeigt. Eine Erstattungsrichtlinie auf <PackageData>-Ebene überschreibt die Erstattungsrichtlinie auf <Result>-Ebene. Eine Erstattungsrichtlinie auf <Rates>-Ebene überschreibt die Erstattungsrichtlinie auf <PackageData>-Ebene. Erstattungsfähige Preise können Nutzern auch durch alternative Optionen hervorgehoben werden, ohne das Schema für Transaktionsnachrichten direkt zu ändern. Weitere Informationen zu diesen Optionen Das folgende Beispiel zeigt das Element <Refundable> mit allen zugehörigen Attributen: <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Hinweis: Es wird empfohlen, alle Attribute festzulegen. Wenn ein oder mehrere Attribute nicht festgelegt wurden, wird eine Warnmeldung für den Feedstatus generiert. Wenn Sie keine Attribute festlegen, wird der Preis nicht als erstattungsfähig angezeigt. Folgende Attribute sind verfügbar: available: (Erforderlich) Legen Sie 1 (oder true) fest, um anzugeben, ob für den Preis eine vollständige Erstattung möglich ist. Andernfalls geben Sie 0 (oder false) an. refundable_until_days: (erforderlich, wenn available den Wert true hat) Gibt die Anzahl der Tage vor dem Check-in an, innerhalb derer eine vollständige Erstattung beantragt werden kann. Der Wert für refundable_until_days muss eine Ganzzahl im Bereich von 0 bis 330 sein. refundable_until_time: (dringend empfohlen, wenn available den Wert true hat) Gibt die späteste Uhrzeit in der Ortszeit des Hotels an, bis zu der ein Antrag auf eine vollständige Erstattung berücksichtigt wird. Dies kann mit refundable_until_days kombiniert werden, um beispielsweise anzugeben, dass „Erstattungen bis 16:00 Uhr zwei Tage vor dem Check-in möglich sind“. Wenn refundable_until_time nicht festgelegt ist, wird Mitternacht standardmäßig verwendet. Der Wert dieses Attributs wird im Zeitformat angegeben. Beachten Sie beim Festlegen der Attribute Folgendes: Wenn available oder refundable_until_days nicht festgelegt ist, wird der Preis nicht als erstattungsfähig angezeigt. Wenn available den Wert 0 (oder false) hat, werden die anderen Attribute ignoriert. Der Preis wird nicht als erstattungsfähig angezeigt, auch wenn eines oder beide der anderen Attribute festgelegt sind.
<RoomID>	Required	string	Die eindeutige ID für die Zimmerdaten. Mit dieser ID ordnen Sie die Daten des Zimmerpakets den Daten zu, die Sie in <RoomData> gesendet haben. Weitere Informationen finden Sie unter Zimmerpaket-Metadaten. Wenn Sie Zimmerdaten inline definieren, können Sie mit dieser ID in einer einzelnen Transaktionsnachricht auf eine allgemeine Zimmerdefinition verweisen.
<Tax>	Required	float	Die Steuern, die für den endgültigen Preis eines Zimmers berechnet werden. Das Element <Tax> verwendet das einzelne erforderliche Attribut currency, das den aus drei Buchstaben bestehenden Währungscode für die Steuern definiert. Verwenden Sie beispielsweise USD für Euro.

Beispiele

Einzelbelegung

Im folgenden Beispiel wird eine Antwort mit einem einzelnen Belegungspaket definiert. Wenn ein Nutzer 1 in der Belegungsauswahl auswählt, zeigt Google unabhängig von der Belegung den niedrigsten zulässigen Preis an.

Wenn kein Preis für eine Einzelbelegung verfügbar ist, zeigt Google den niedrigsten Preis für ein Doppelzimmer an. Preise für Einzelbelegungen werden nicht live abgefragt, wenn Preise für eine Doppelbelegung oder mehr für einen Reiseplan im Cache gespeichert werden.

In diesem Beispiel wird mit den Elementen <RoomID> und <PackageID> auf vordefinierte Zimmer- und Paketmetadaten verwiesen. Mit den Elementen <RoomData> und <PackageData> können Sie diese Informationen definieren.

<!-- Efficient method of defining Room Bundles-->
<!----- Occupancy of 1 example ----->

<Transaction timestamp="2017-07-18T16:20:00-04:00" id="12345678">
  <!-- Part1: Define RoomData and PackageData in PropertyDataSet -->
  <!-- Note:  Once defined it does not have to be repeated for future
              Transaction Messages.
              PropertyDataSets can also be defined and sent in their own
              Transaction Message separately from pricing. Google can be
              configured to pull just PropertyDataSets once per day
              (or on a predefined frequency). -->
  <PropertyDataSet>
    <Property>180054</Property>
    <!-- Can be reused by multiple Room Bundles -->
    <RoomData>
      <RoomID>060773</RoomID>
      <Name>
        <Text text="Single Queen Room - Non-Smoking" language="en"/>
        <Text text="Chambre de la Roi Premium - Pas de Fumeurs" language="fr"/>
      </Name>
      <!-- Room can accommodate up to 4, but package data specifies occupancy
           between 1 to 4 -->
      <Capacity>4</Capacity>
    </RoomData>
    <RoomData>
      <RoomID>436233</RoomID>
      <Name>
        <Text text="Premium King Room - Non-Smoking" language="en"/>
        <Text text="Chambre de le Roi Premium - Pas de Fumeurs" language="fr"/>
      </Name>
      <Capacity>4</Capacity>
    </RoomData>
    <!-- Can be reused by multiple Room Bundles -->
    <PackageData>
      <PackageID>P11111</PackageID>
      <Occupancy>1</Occupancy>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="1" refundable_until_days="7"
           refundable_until_time="18:00:00"/>
      <ParkingIncluded>1</ParkingIncluded>
      <InternetIncluded>1</InternetIncluded>
    </PackageData>
    <PackageData>
      <PackageID>P54321</PackageID>
      <Occupancy>2</Occupancy>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="1" refundable_until_days="7"
           refundable_until_time="18:00:00"/>
      <ParkingIncluded>1</ParkingIncluded>
      <InternetIncluded>1</InternetIncluded>
    </PackageData>
    <PackageData>
      <PackageID>P12345</PackageID>
      <Occupancy>4</Occupancy>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="1" refundable_until_days="1"
           refundable_until_time="18:00:00"/>
      <ParkingIncluded>1</ParkingIncluded>
      <InternetIncluded>1</InternetIncluded>
    </PackageData>
  </PropertyDataSet>

    <!-- Efficient method of defining Room Bundles -->
    <!-- Part 2: Reference RoomData and PackageData through ID -->
  <Result>
    <!-- Single occupancy pricing will be specified in a room bundle below -->
    <Property>180054</Property>
    <Checkin>2017-10-07</Checkin>
    <Nights>2</Nights>
    <!-- Base Room Bundle -->
    <RoomBundle>
      <RoomID>060773</RoomID>
      <PackageID>P54321</PackageID>
      <Baserate currency="USD">199.99</Baserate>
      <Tax currency="USD">25.12</Tax>
      <OtherFees currency="USD">2.00</OtherFees>
      <RatePlanID>060773-P54321</RatePlanID>
    </RoomBundle>
    <RoomBundle>
      <RoomID>060773</RoomID>
      <PackageID>P11111</PackageID>
      <!-- Price for 1 ("occupancy") is the lowest price and will be
           displayed -->
      <Baserate currency="USD">174.99</Baserate>
      <Tax currency="USD">22.08</Tax>
      <OtherFees currency="USD">2.00</OtherFees>
      <RatePlanID>060773-P11111</RatePlanID>
    </RoomBundle>
    <!-- Premium Room Bundle -->
    <RoomBundle>
      <RoomID>436233</RoomID>
      <PackageID>P12345</PackageID>
      <!-- Price for 4 ("occupancy"), any eligible room bundle with 1 or more
           occupancy will be displayed-->
      <Baserate currency="USD">298.88</Baserate>
      <Tax currency="USD">42.12</Tax>
      <OtherFees currency="USD">10.00</OtherFees>
      <RatePlanID>436233-P12345</RatePlanID>
    </RoomBundle>
    <!-- ..Continue providing all available RoomBundle rates under matched
         property for 1 or more occupancies..-->
  </Result>
</Transaction>

Zwei oder mehr Belegungen

Im folgenden Beispiel wird eine Antwort definiert, die zwei oder mehr Belegungen enthält.

In diesem Beispiel wird mit den Elementen <RoomID> und <PackageID> auf vordefinierte Zimmer- und Paketmetadaten verwiesen. Mit den Elementen <RoomData> und <PackageData> können Sie diese Informationen definieren.

<!-- Efficient method of defining Room Bundles-->
<!----- Occupancy of 3 example ----->

<Transaction timestamp="2017-07-18T16:20:00-04:00" id="12345678">
  <!-- Efficient method of defining Room Bundles-->
  <!-- Part1: Define RoomData and PackageData in PropertyDataSet -->
  <PropertyDataSet>
    <Property>180054</Property>
    <!-- Can be reused by multiple Room Bundles -->
    <RoomData>
      <RoomID>060773</RoomID>
      <Name>
        <Text text="Single Queen Room - Non-Smoking" language="en"/>
        <Text text="Chambre de la Roi Premium - Pas de Fumeurs" language="fr"/>
      </Name>
      <!-- Room can accommodate up to 4, but package data specifies occupancy
           between 1 to 4 -->
      <Capacity>4</Capacity>
    </RoomData>
    <RoomData>
      <RoomID>436233</RoomID>
      <Name>
        <Text text="Premium King Room - Non-Smoking" language="en"/>
        <Text text="Chambre de le Roi Premium - Pas de Fumeurs" language="fr"/>
      </Name>
      <Capacity>4</Capacity>
    </RoomData>
    <!-- Can be reused by multiple Room Bundles -->
    <PackageData>
      <PackageID>P33333</PackageID>
      <Occupancy>3</Occupancy>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="1" refundable_until_days="7"
           refundable_until_time="18:00:00"/>
      <ParkingIncluded>1</ParkingIncluded>
      <InternetIncluded>1</InternetIncluded>
    </PackageData>
    <PackageData>
      <PackageID>P12345</PackageID>
      <Occupancy>4</Occupancy>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="1" refundable_until_days="1"
           refundable_until_time="18:00:00"/>
      <ParkingIncluded>1</ParkingIncluded>
      <InternetIncluded>1</InternetIncluded>
    </PackageData>
  </PropertyDataSet>

  <Result>
    <Property>180054</Property>
    <Checkin>2017-10-07</Checkin>
    <Nights>2</Nights>
    <!-- Efficient method of defining Room Bundles -->
    <!-- Part 2: Reference RoomData and PackageData through ID -->
    <!-- Base Room Bundle -->
    <RoomBundle>
      <!-- Baserate above and attributes must match atleast one room bundle
           below -->
      <RoomID>060773</RoomID>
      <PackageID>P33333</PackageID>
      <Baserate currency="USD">499.99</Baserate>
      <Tax currency="USD">55.12</Tax>
      <OtherFees currency="USD">22.00</OtherFees>
    </RoomBundle>
    <!-- Premium Room Bundle -->
    <RoomBundle>
      <RoomID>436233</RoomID>
      <PackageID>P12345</PackageID>
      <!-- Lowest price for 3 ("occupancy"), shown below, will be displayed -->
      <Baserate currency="USD">598.88</Baserate>
      <Tax currency="USD">62.12</Tax>
      <OtherFees currency="USD">30.00</OtherFees>
    </RoomBundle>
    <!-- ..Continue providing all available RoomBundle rates under matched
         property for 2 or more occupancies..-->
  </Result>
</Transaction>

Pakete für mehrere Zimmer

Im folgenden Beispiel wird die Belegung in mehreren Zimmerpaketen festgelegt, um mögliche Hostel-Zimmerpreise zu zeigen.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <Result>
    ...
    <!-- Suite Room Bundle -->
    <RoomBundle>
      <RoomID>suite1</RoomID>
      <PackageID>standard</PackageID>
      <Occupancy>2</Occupancy>
      <!-- Price for room -->
      <Baserate currency="USD">80.00</Baserate>
      <Tax currency="USD">5.12</Tax>
      <OtherFees currency="USD">2.00</OtherFees>
      <RoomData>
        <Name>
          <Text text="Suite for 2" language="en"/>
        </Name>
      </RoomData>
    </RoomBundle>

    <!-- Small Dorm Room Bundle -->
    <RoomBundle>
      <RoomID>small_dorm</RoomID>
      <PackageID>economy</PackageID>
      <Occupancy>1</Occupancy>
      <!-- Price per bed -->
      <Baserate currency="USD">35.00</Baserate>
      <Tax currency="USD">3.50</Tax>
      <OtherFees currency="USD">2.00</OtherFees>
      <RoomData>
        <Name>
          <Text text="1 bed in small dorm" language="en"/>
        </Name>
      </RoomData>
    </RoomBundle>

    <!-- Large Dorm Room Bundle -->
    <RoomBundle>
      <RoomID>large_dorm</RoomID>
      <PackageID>economy</PackageID>
      <Occupancy>1</Occupancy>
      <!-- Price per bed -->
      <Baserate currency="USD">20.00</Baserate>
      <Tax currency="USD">2.50</Tax>
      <OtherFees currency="USD">2.00</OtherFees>
      <RoomData>
        <Name>
          <Text text="1 bed in large dorm" language="en"/>
        </Name>
      </RoomData>
    </RoomBundle>
    ...
  </Result>
</Transaction>

Mehrere nutzerabhängige Preise

Im folgenden Beispiel werden ein Basispreis und mehrere nutzerabhängige Preise in einem <RoomBundle> definiert:

<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2023-04-10</Checkin>
    <Nights>2</Nights>
    <!-- When Google receives new room bundle information for an itinerary, all
    previous room bundle pricing is dropped from Google's cache. Thus, if you
    want to delete a specific room bundle from Google's cache, you may do so
    by simply not providing that specific room bundle in subsequent transaction
    messages. -->
    <RoomBundle>
     ...
      <!-- RoomID is required, PackageID is recommended. -->
      <RoomID>5</RoomID>
      <PackageID>ABC</PackageID>
      <!-- Baserate is required. -->
      <Baserate currency="USD">275.00</Baserate>
      <Tax currency="USD">27.50</Tax>
      <OtherFees currency="USD">2.00</OtherFees>

      <!-- RatePlanID is optional and represents the unique identifier for a
      room and package data combination. We strongly recommend using RatePlanID
      as a variable to build your dynamic landing page (formerly Point of Sale)
      URL. For details, see Using Variables and Conditions. -->
      <RatePlanID>5-ABC</RatePlanID>

      <!-- Occupancy is mandatory for RoomBundle elements. -->
      <!-- Elements below will get inherited to nested rate elements. -->
      <Occupancy>2</Occupancy>
      <OccupancyDetails>
        <NumAdults>2</NumAdults>
      </OccupancyDetails>
      <InternetIncluded>1</InternetIncluded>


      <!-- Rate rule "mobile" overrides chargeCurrency, "us_or_gb" doesn't. -->
      <ChargeCurrency>web</ChargeCurrency>
      <Custom1>ratebasic</Custom1>
      <!-- Neither rate overrides Custom2. -->
      <Custom2>ratebasic</Custom2>

      <Rates>
        <Rate rate_rule_id="mobile">
          <Baserate currency="USD">258.33</Baserate>
          <Tax currency="USD">25.83</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
          <!-- The value below overrides ChargeCurrency from roombundle. -->
          <ChargeCurrency>hotel</ChargeCurrency>
          <!-- The value below overrides Custom1 from roombundle. -->
          <Custom1>ratecode321</Custom1>
          <!-- Custom2 is inherited from roombundle. -->
        </Rate>
        <Rate rate_rule_id="us_or_gb">
          <Baserate currency="USD">268.33</Baserate>
          <Tax currency="USD">26.83</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
          <!-- The value below overrides Custom1 from roombundle. -->
          <Custom1>ratecode432</Custom1>
          <!-- Custom2 is inherited from roombundle. -->
        </Rate>
      </Rates>
    </RoomBundle>
  </Result>
</Transaction>

<OccupancyDetails>

<Occupancy> in einer Transaktionsnachricht gibt die maximale Anzahl von Gästen für ein Zimmer oder ein Paket an. <OccupancyDetails> kann zusätzliche Informationen enthalten, z. B. die Anzahl und die Art der Gäste (Erwachsene oder Kinder).

Wenn <Occupancy> und <OccupancyDetails> im Element <Rates> von <Result> oder <RoomBundle> erscheinen, bedeutet dies, dass der Preis durch die Belegungsdetails eingeschränkt ist.

Syntax

Wenn <OccupancyDetails> angezeigt wird, ist immer <Occupancy> vorangestellt. Beachten Sie die folgende Syntax:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <Result>
  ...
    <Occupancy>max_number_of_intended_occupants</Occupancy>
    <OccupancyDetails>
      <NumAdults>number_of_adults</NumAdults>
      <Children>
        <Child age=age_of_one_child_guest/>
        <Child age=age_of_one_child_guest/>
      </Children>
    </OccupancyDetails>
  </Result>
</Transaction>

Untergeordnete Elemente

Das <OccupancyDetails>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element	Erforderlich?	Typ	Beschreibung
<NumAdults>	Required	integer	Die Anzahl der erwachsenen Gäste. Min.: 1, Max.: 20.
<Children>	Optional	Object	Ein Container für ein oder mehrere <Child>-Elemente.
<Child age>	Optional	integer	Das Höchstalter für dieses Kind, z. B. <Child age="17">.

Beispiele

Die folgenden Beispiele zeigen, wie <OccupancyDetails> in <Results>, <RoomBundle> oder dem untergeordneten Element <Rates> angezeigt werden kann.

Ergebnisantwort

Im folgenden Beispiel werden ein Reiseplan und dessen Preise für eine Unterkunft als Antwort auf eine Livepreisabfrage definiert, bei der der Nutzer die Anzahl und die Art der Gäste angegeben hat. Hier werden die <OccupancyDetails> (2 Erwachsene und ein untergeordnetes Element) in <Result> zurückgegeben.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
  <Result>
    <Property>060773</Property>
    <RoomID>RoomType101</RoomID>
    <PackageID>Package101</PackageID>
    <Checkin>2018-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">278.33</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="site1"/>
    </AllowablePointsOfSale>
    <Occupancy>3</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
      <Children>
        <Child age="17"/>
      </Children>
    </OccupancyDetails>
  </Result>
</Transaction>

Antwort auf Preisanfragen

Im folgenden Beispiel werden ein Reiseplan und dessen Preise für 1 Erwachsenen und 1 Kind definiert. Hier werden die <OccupancyDetails> im <Rates>-Element von <Result> zurückgegeben.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Transaction id="Wtdj8QoQIWcAAbaTGlIAAAC4" timestamp="2018-04-18T11:27:45-04:00">
  <Result>
    <Property>8251</Property>
    <Checkin>2018-06-20</Checkin>
    <Nights>1</Nights>
    <Baserate currency="USD">62.18</Baserate>
    <Tax currency="USD">2.45</Tax>
    <OtherFees currency="USD">0.00</OtherFees>
    <Rates>
      <Rate rate_rule_id="rule-951">
        <Occupancy>2</Occupancy>
        <OccupancyDetails>
          <NumAdults>1</NumAdults>
          <Children>
            <Child age="17"/>
          </Children>
        </OccupancyDetails>
        <Baserate currency="USD">42.61</Baserate>
        <Tax currency="USD">5.70</Tax>
        <OtherFees currency="USD">0.00</OtherFees>
        <Custom1>abc4</Custom1>
        <AllowablePointsOfSale>
          <PointOfSale id="yourhotelpartnersite.com"/>
        </AllowablePointsOfSale>
      </Rate>
    </Rates>
  </Result>
</Transaction>

Zimmerpaket

Im folgenden Beispiel ist eine Belegung von 2 Erwachsenen und 1 Kind für 2 Nächte mit einem erstattungsfähigen Preis definiert. Hier werden die <OccupancyDetails> innerhalb von <RoomBundle> angezeigt.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
  <Result>
    <Property>6781291</Property>
    <Checkin>2017-08-05</Checkin>
    <Nights>2</Nights>
    ...
    <RoomBundle>
      <RoomID>10291</RoomID>
      <RatePlanID>564739</RatePlanID>
      <PackageID>564739</PackageID>
      <Occupancy>3</Occupancy>
      <OccupancyDetails>
        <NumAdults>2</NumAdults>
        <Children>
          <Child age="17"/>
        </Children>
      </OccupancyDetails>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="true" refundable_until_days="1" refundable_until_time="23:59:00" />
      <Baserate currency="USD">185.34</Baserate>
      <Tax currency="USD">37.06</Tax>
      <OtherFees currency="USD">2.22</OtherFees>
    </RoomBundle>
  </Result>
</Transaction>

Pakete für mehrere Zimmer

Im folgenden Beispiel werden mehrere <RoomBundle>-Preise definiert, die auf eine Belegung von 2 Erwachsenen und 2 Kindern beschränkt sind. Hier werden die <OccupancyDetails> im Element <Rates> von <RoomBundle> angezeigt.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">275.00</Baserate>
    <Tax currency="USD">27.50</Tax>
    <OtherFees currency="USD">0</OtherFees>
    <RoomBundle>
      <RoomID>5</RoomID>
      <PackageID>STD</PackageID>
      <Baserate currency="USD">275.00</Baserate>
      <Tax currency="USD">27.50</Tax>
      <OtherFees currency="USD">0</OtherFees>
      <InternetIncluded>1</InternetIncluded>
      <ChargeCurrency>web</ChargeCurrency>
      <Custom1>ratebasic</Custom1>
      <Custom2>ratebasic</Custom2>
      <Occupancy>4</Occupancy>
      <OccupancyDetails>
          <NumAdults>2</NumAdults>
          <Children>
              <Child age="17"/>
              <Child age="17"/>
          </Children>
      </OccupancyDetails>
      <Rates>
        <Rate rate_rule_id="mobile">
          <Baserate currency="USD">258.33</Baserate>
          <Tax currency="USD">25.83</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
          <ChargeCurrency>hotel</ChargeCurrency>
          <Custom1>ratecode321</Custom1>
        </Rate>
        <Rate rate_rule_id="us_or_gb">
          <Baserate currency="USD">268.33</Baserate>
          <Tax currency="USD">26.83</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
          <Custom1>ratecode432</Custom1>
        </Rate>
      </Rates>
    </RoomBundle>
  </Result>
</Transaction>