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

Dieses XML-Referenzhandbuch enthält ausführliche Referenzinhalte und Codebeispiele für die verschiedenen Nachrichten, Elemente und Attribute, die für ARI-Feeds (Verfügbarkeits-, Preis- und Inventarfeeds) verfügbar sind.

ARI ist ein Preisübermittlungsmodus, mit dem die Übernachtungspreise, die Verfügbarkeit und das Inventar gesteuert und Einschränkungen für deren Kombination festgelegt werden. ARI bietet auch die Flexibilität, Steuern, Gebühren und Angebote einzubeziehen.

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

Auf der Aufenthaltsdauer basierende Preise

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

Obwohl es bei auf der Aufenthaltsdauer basierenden Preisen keine Übernachtungspreise mehr gibt, können alle anderen ARI-Funktionen (Inventar, Verfügbarkeit, Regeln, Angebote usw.) weiterhin auf diese Preise angewendet werden und werden pro Nacht angegeben. Wenn Ihre Systeme also eher an ein auf der Aufenthaltsdauer basierendes Preissystem ausgerichtet sind, können Sie neben der Bandbreiteneffizienz, die durch die Nutzung der nächtlichen Verfügbarkeits- und Einschränkungsaktualisierungen gewährt wird, weiterhin den umfassenden ARI-Funktionsumfang nutzen.

Wichtiger Hinweis: Für jede Unterkunft in Ihrem Konto sollten auf der Aufenthaltsdauer basierende Preise oder Preise pro Datum verwendet werden.

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

Wichtiger Hinweis :Sie müssen die vier Nachrichtentypen (Transaktion, Preis, Inventar und Verfügbarkeit) senden, damit Preise verfügbar sind. Es wird empfohlen, die Größe von ARI-Nachrichten <OTA_HotelRateAmountNotifRQ> auf 5 MB zu beschränken und die Uploadrate auf 400 Dateien pro Sekunde zu beschränken.

ARI verwendet die folgenden Anfragenachrichten:

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

• OTA_HotelRateAmountNotifRQ: Definiert die Preise pro Datum oder auf der Aufenthaltsdauer basierend auf der Belegung pro Produkt (Kombination aus Zimmertyp und Preisplan) für bestimmte Zeiträume.

• OTA_HotelAvailNotifRQ. Definiert Verfügbarkeit und Einschränkungen basierend auf dem Zimmertyp und den Preisplänen. Inventar kann auch mit dieser Nachricht aktualisiert werden, aber OTA_HotelInvCountNotifRQ wird bevorzugt.

• OTA_HotelInvCountNotifRQ: Definiert das physische Zimmerinventar oder die Anzahl der zum Verkauf verfügbaren Zimmer.

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

• Promotions (optional): Definiert Aktionspreise für bestimmte Buchungen, Aufenthalte und Nutzer.

• RateModifications (optional): Definiert Regeln für die Preisänderung für bestimmte Buchungen, Aufenthalte und Nutzer.

• ExtraGuestCharges (optional): Definiert, wie Preise für Kinder und weitere Erwachsene konfiguriert werden sollen.

Jede Nachricht enthält eine Teilmenge von Informationen, mit denen Google die Preise und Verfügbarkeit berechnet, die Nutzern angezeigt werden, wenn sie nach Ihren Unterkünften mit bestimmten Check-in- und Check-out-Datumsangaben sowie Belegung suchen.

Wichtiger Hinweis: 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-Nachrichten, -Elemente oder -Attribute, die hier nicht ausdrücklich dokumentiert sind, werden in unserer ARI-Implementierung nicht unterstützt.

Andere Elemente des Typs Transaktionsnachricht, die nicht in dieser XML-Referenz zu Inventar und Preisen (ARI) behandelt werden, werden bei Verwendung des ARI-Feedtyps nicht unterstützt.

Google aktualisiert und verbessert die API kontinuierlich. Wenn Sie in Ihrem System zusätzliche Preisfeatures verwenden, benachrichtigen Sie Ihre Technology Account Manager(TAM), damit sie mit diesen Features priorisiert werden kann, oder teilt Ihnen mit, ob diese Funktionen für ein Release geplant sind.

Überarbeitungsverlauf der ARI-XML-Referenz

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

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.