Inventarnachricht

Überblick

Die Inventarnachricht (OTA_HotelInvCountNotifRQ) definiert die Inventaranzahl (Anzahl der physischen Räume), die für bestimmte Zimmertypen gebucht werden können. Wenn Sie eine Inventarnachricht senden, geben Sie an, wie viele Räume dieses Typs an einem bestimmten Datum verfügbar sind. Wenn keine Zimmer dieses Typs verfügbar sind, werden Produkte mit diesem Zimmertyp und Datum nicht angezeigt.

In den folgenden Abschnitten finden Sie allgemeine Richtlinien, ein einfaches Beispiel und Szenarien mit Anleitungen, die Ihnen den Einstieg in das Hinzufügen und Aktualisieren von Inventar sowie das Senden von Inventarnachrichten erleichtern.

Beispiele für verschiedene inventarbezogene Szenarien finden Sie in Anleitungen.

Erforderliche und optionale Elemente

Die XML-Referenz enthält Beschreibungen der erforderlichen und optionalen Elemente. Weitere Informationen zu Attributen und untergeordneten Elementen finden Sie unter Inventarelemente und Attribute.

Syntax und Schemas

Verwenden Sie das Beispiel für die Inventarsyntax als Referenz, wenn Sie die Inventarnachricht erstellen, um sicherzustellen, dass Sie das richtige Format verwenden.

Sie können Ihre Feeds mit einem Drittanbieter-XML-Tool wie xmllint mit den veröffentlichten Schemas validieren, bevor Sie sie an Google senden. Informationen zum Nachrichtenschema für das Inventar finden Sie unter Schemas für Hotelanzeigen.

Richtlinien

Beachten Sie die folgenden Richtlinien für Inventarmitteilungen:

• Das Inventar wird nach Hotel, Datum und Zimmertyp bestimmt.

• Die Inventaranzahl muss für alle Nächte des Aufenthalts größer als 0 sein, damit der Preis für den zugehörigen Preisplan und die Belegung angezeigt wird.

• Wenn die Inventarzahl gleich 0 ist, können für die angegebene Zimmer-ID und den angegebenen Zeitraum keine Räume gebucht werden.

• CountType muss immer den Wert 2 haben, um gültig zu sein, da die Anzahl der "bestimmten Verfügbarkeiten" angegeben wird.

• Senden Sie immer dann aktualisiertes Inventar, wenn in Ihrem System ein Zimmer reserviert oder storniert wird.

Hinweis: Senden Sie Zimmerinventarzahlen entweder mit OTA_HotelInvCountNotifRQ (empfohlene Methode) oder mit der alternativen Methode mit dem Attribut <BookingLimit> der OTA_HotelAvailNotifRQ-Nachricht.

Inventar versus Verfügbarkeit

„Inventar“ ist die Anzahl der buchbaren Zimmer. Die Anzahl der Zimmer basiert auf der Anzahl der physischen Räume und die Verfügbarkeit gibt an, ob die Kombination aus Zimmertyp und Preisplan gebucht werden kann. Bei ARI können Verfügbarkeit und Inventar je nach Datum oder Art der Unterkunft variieren. Beide haben entsprechende Mitteilungstypen. Inventar und Verfügbarkeit sind nach Hotel, Datum und Zimmertyp sortiert, wobei der Preisplan für die Verfügbarkeit hinzugefügt wird.

Es kann auch dann „keine Verfügbarkeit“ geben, wenn Inventar vorhanden ist, da Inventar und Verfügbarkeit voneinander unabhängig sind.

Es gibt zwei Konzepte der Verfügbarkeit. Zum einen gibt es die Gesamtverfügbarkeit eines Produkts für einen bestimmten Aufenthalt, die von Faktoren beeinflusst wird, z. B. ob es für jede Nacht einen bestimmten Preis gibt, das Inventar für den zugehörigen Zimmertyp und die Verfügbarkeitsbeschränkung ist offen. Zweitens gibt es die spezifische Einschränkung für ein Produkt an einem bestimmten Datum, die durch <RestrictionStatus Restriction="Master" Status="Open"/> in OTA_HotelAvailNotifRQ dargestellt wird. Der Abschluss dieser Verfügbarkeit wird als „Stopp-Sell“ bezeichnet.

Das Inventar muss eine Ganzzahl größer als 0 für das Zimmer sein und die Verfügbarkeitsbeschränkung muss offen sein, damit der Preis für ein Produkt angezeigt wird.

Hinweis: Wenn ein Zimmer ausverkauft ist, können die mit diesem Zimmer verknüpften Preispläne nicht mehr verkauft werden.

Beispiel

Dieser Abschnitt enthält ein einfaches Beispiel für eine Inventarnachricht mit erforderlichen und optionalen Elementen. Nachdem Sie Ihre Datei vorbereitet haben, müssen Sie sie über eine POST-Nachricht an diesen Endpunkt an Google senden:

https://www.google.com/travel/hotels/uploads/ota/hotel_inv_count_notif

Weitere Informationen zum Übertragen/POSTen von Nachrichten per Push/POST finden Sie unter Nachrichten per Push übertragen.

Wichtiger Hinweis :Sende Google bei jeder Änderung deines Inventars (z. B. bei Buchungen oder Stornierungen) eine aktualisierte Inventarnachricht.

Verwenden Sie für HotelCode die eindeutige Hotel-ID, die Sie in Ihrem System zur Identifizierung der Unterkunft verwendet haben. Dieser Wert muss mit der Hotel-ID übereinstimmen, die mit <id> im Element <listing> im Hotellistenfeed angegeben wird. Verwenden Sie für <RoomID> dieselbe ID, die Sie in Ihrem System für Zimmertypen verwendet haben. Die Konsistenz mit Ihrem System ist entscheidend dafür, dass Google Ihre Daten korrekt anzeigt.

Hinweis: <CountType=2> ist die einzige gültige Option, da sie die Anzahl der "bestimmten Verfügbarkeit" angibt.

In diesem Beispiel wird gezeigt, wie Sie das Inventar für 13 buchbare Räume für den Monat Dezember festlegen:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Weitere Beispiele finden Sie in Inventarbeispiele.

Anleitungen

In diesem Abschnitt wird ein Szenario beschrieben, dem Sie beim Senden einer Inventarnachricht begegnen können.

Szenario: Buchung von Räumen blockieren

Beschreibung

Sie müssen angeben, dass für diesen Zimmertyp für einen bestimmten Zeitraum keine Räume mehr gebucht werden können. Das liegt meistens daran, dass sie ausverkauft sind.

Lösung

Sie legen <InvCount Count> auf einen 0-Wert fest und fügen den gewünschten Zeitraum hinzu.

Beispiel

In diesem Beispiel wird gezeigt, wie Sie mit InvCount das Inventar für das angegebene Zimmer und Datum (z. B. die ersten Wochen im Januar) auf 0 setzen.

Hinweis: Wenn die Inventarzahl für ein Zimmer für eine Nacht eines Aufenthalts 0 beträgt, kann der Aufenthalt nicht für Produkte gebucht werden, die mit diesem Zimmer verknüpft sind.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>