XML-Referenz für Verfügbarkeit, Preise und Bestand (ARI)

Dieser XML-Referenzleitfaden enthält detaillierte Referenzinhalte und Codebeispiele für die verschiedenen Nachrichten, Elemente und Attribute, die für ARI-Feeds (Availability, Rates, and Inventory, Verfügbarkeit, Preise und Inventar) verfügbar sind.

ARI ist ein Preisübermittlungsmodus, mit dem Übernachtungspreise, Verfügbarkeit und Bestand gesteuert werden. Außerdem werden Einschränkungen für die Kombination dieser Elemente festgelegt. ARI bietet auch die Flexibilität, Steuern, Gebühren und Angebote einzubeziehen.

ARI folgt den Standardprotokollen der OpenTravel Alliance (OTA) für einige der wichtigsten Nachrichtentypen zur Definition von Verfügbarkeit und Inventar.

Preise je nach Aufenthaltsdauer

Mit LOS-based-Preisen können Sie Preise pro Check-in-Datum und Aufenthaltsdauer anstelle von Preisen pro Aufenthaltsdatum angeben. Wenn Sie ein <StatusApplicationControl>-Element für auf der Aufenthaltsdauer basierende Preise angeben, geben die Attribute @Start und @End einen Bereich von Check-in-Daten an, für die die Aufenthaltsdauerpreise gelten.

Bei der Verwendung von auf der Aufenthaltsdauer basierenden Preisen gibt es zwar keine Übernachtungspreise mehr, aber alle anderen ARI-Funktionen (Inventar, Verfügbarkeit, Regeln, Angebote usw.) können weiterhin auf diese Preise angewendet werden und werden auf Übernachtungsebene angegeben. Wenn Ihre Systeme also eher auf einem LOS-basierten Preissystem basieren, können Sie trotzdem die umfangreichen ARI-Funktionen nutzen. Außerdem profitieren Sie von der Bandbreiteneffizienz, die durch die Nutzung der nächtlichen Verfügbarkeits- und Einschränkungsaktualisierungen erreicht wird.

Wichtiger Hinweis: Für jede Property in Ihrem Konto sollten entweder Raten basierend auf der Aufenthaltsdauer oder Raten pro Datum verwendet werden.

Wenn Sie aufenthaltsdauerbasierte Preise für Ihr Konto aktivieren möchten, wenden Sie sich an Ihren TAM oder kontaktieren Sie uns.

Wichtig: Sie müssen die vier Nachrichtentypen (Transaktion, Preis, Inventar und Verfügbarkeit) senden, bevor Preise verfügbar sind. Es wird empfohlen, die Größe von ARI-Nachrichten, insbesondere <OTA_HotelRateAmountNotifRQ>, auf 5 MB zu begrenzen. Die Uploadrate sollte maximal 400 Dateien pro Sekunde betragen. Senden Sie nicht mehrere sich überschneidende datumsbezogene Reiseplaninformationen innerhalb von 3 Sekunden nach der letzten Nachricht.

ARI verwendet die folgenden Anfragenachrichten:

• Transaction (Unterkunftsdaten). Definiert den Typ und die Paketinformationen (Preisplan).

• OTA_HotelRateAmountNotifRQ: Definiert die Beträge für die Belegungsrate pro Datum oder Aufenthaltsdauer für jedes Produkt (Kombination aus Zimmertyp und Preisplan) für bestimmte Zeiträume.

• OTA_HotelAvailNotifRQ: Definiert Verfügbarkeit und Einschränkungen basierend auf Zimmertyp und Preisplänen. Das Inventar kann auch mit dieser Nachricht aktualisiert werden. OTA_HotelInvCountNotifRQ wird jedoch bevorzugt.

• OTA_HotelInvCountNotifRQ: Definiert das physische Zimmerinventar oder die Anzahl der Zimmer, die verkauft werden können.

• TaxFeeInfo: (Optional) Definiert auf der Unterkunft beruhende Steuern und Gebühren. Diese Nachricht ist nicht erforderlich, wenn AmountAfterTax in der Nachricht OTA_HotelRateAmountNotifRQ angegeben ist.

• Promotions (Optional) Definiert Angebotspreise für bestimmte Buchungen, Aufenthalte und Nutzer.

• RateModifications (Optional) Definiert Regeln für die Ratenänderung für bestimmte Buchungen, Aufenthalte und Nutzer.

• ExtraGuestCharges: (Optional) Definiert, wie Preise für Kinder und zusätzliche Erwachsene konfiguriert werden sollen.

Jede Nachricht enthält eine Teilmenge von Informationen, anhand derer Google die Preise und Verfügbarkeit für Nutzer berechnet, wenn sie nach Ihren Unterkünften mit bestimmten Ab- und Anreiseterminen und der gewünschten Belegung suchen.

Wichtiger Hinweis :Die ARI-Funktionen sind auf die Nachrichten und Elemente beschränkt, die in dieser XML-Referenz zu Inventar und Preisen (ARI) und im ARI-Leitfaden beschrieben sind. Alle OTA-Meldungen, Elemente oder Attribute, die hier nicht explizit dokumentiert werden, werden in unserer ARI-Implementierung nicht unterstützt.

Außerdem werden andere Transaktionsnachrichten-Elemente, die nicht in dieser XML-Referenz zu Inventar und Preisen (ARI) behandelt werden, bei Verwendung des ARI-Feedtyps nicht unterstützt.

Google aktualisiert und verbessert die API kontinuierlich. Wenn Sie zusätzliche Preisfunktionen in Ihrem System verwenden, benachrichtigen Sie Ihren Technology Account Manager(TAM), damit diese Funktionen priorisiert werden können oder Sie darüber informiert werden, ob diese Funktionen für eine Veröffentlichung geplant sind.

Überarbeitungsverlauf der ARI XML-Referenz

In der folgenden Tabelle werden Dokumentationsaktualisierungen nur für Funktionsänderungen aufgelistet.

Datum	Änderungen
14. August 2020	Erste Version
21. Oktober 2020	Der Nachrichtentyp „Angebote“ wurde hinzugefügt.
17. November 2020	Für Nachrichten vom Typ „Transaktion (Unterkunftsdaten)“ wurde der Endpunkt aktualisiert und das Attribut action den PropertyDataSet-Elementen hinzugefügt.
24. November 2020	Für Nachrichten vom Typ „Transaktion (Unterkunftsdaten)“ wurden die Elemente <AllowablePackageIDs> und <AllowableRoomIDs> hinzugefügt.
4. Februar 2021	Antwortnachrichten wurden hinzugefügt.
25. Februar 2021	OTA_HotelInvCountNotifRQ wurde hinzugefügt.
21. Oktober 2020	Der Nachrichtentyp „Preisänderungen“ wurde hinzugefügt.