Inventarmitteilung

Übersicht

In der Inventarnachricht (OTA_HotelInvCountNotifRQ) wird die Anzahl der Inventareinheiten (Anzahl der physischen Zimmer) definiert, die für bestimmte Zimmertypen gebucht werden können. Wenn Sie eine Inventarnachricht senden, geben Sie an, wie viele Zimmer dieses Typs an einem bestimmten Datum verfügbar sind. Wenn keine Zimmer dieses Typs verfügbar sind, werden Produkte, die diesen Zimmertyp und dieses Datum enthalten, nicht angezeigt.

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

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

Erforderliche und optionale Elemente

In der XML-Referenz finden Sie 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 Inventarmitteilung erstellen, um sicherzustellen, dass Sie das richtige Format verwenden.

Sie können ein XML-Tool eines Drittanbieters wie xmllint verwenden, um Ihre Feeds mit den veröffentlichten Schemas zu validieren, bevor Sie sie an Google senden. Das Schema für Inventarnachrichten finden Sie unter Hotelanzeigenschemas.

Richtlinien

Beachten Sie bei Inventarnachrichten die folgenden Richtlinien:

• Das Inventar wird nach Hotel, Datum und Zimmertyp aufgeschlüsselt.

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

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

• CountType muss immer den Wert von 2 haben, um gültig zu sein, da es eine Anzahl von „definitiver Verfügbarkeit“ angibt.

• Senden Sie aktualisierte Inventardaten, wenn in Ihrem System eine Reservierung oder Stornierung für ein Zimmer erfolgt.

Hinweis :Senden Sie die Anzahl der Zimmerinventare entweder mit OTA_HotelInvCountNotifRQ (empfohlene Methode) oder mit der alternativen Methode über das Attribut <BookingLimit> der Nachricht OTA_HotelAvailNotifRQ.

Inventar im Vergleich zur Verfügbarkeit

Das Inventar ist die Anzahl der buchbaren Zimmer basierend auf der physischen Anzahl. Die Verfügbarkeit gibt an, ob die Kombination aus Zimmertyp und Preisplan gebucht werden darf. Bei ARI können sowohl Verfügbarkeit als auch Inventar je nach Datumsbereich oder Unterkunftstyp variieren. Für beide gibt es entsprechende Nachrichtentypen. Inventar und Verfügbarkeit werden nach Hotel, Datum und Zimmertyp sowie nach Preisplan für die Verfügbarkeit aufgeschlüsselt.

Auch wenn Inventar vorhanden ist, kann es sein, dass keine Verfügbarkeit angegeben wird, da Inventar und Verfügbarkeit unabhängig voneinander sind.

Es gibt zwei Konzepte für die Verfügbarkeit. Zuerst wird die allgemeine Verfügbarkeit eines Produkts für einen bestimmten Aufenthalt geprüft. Diese wird durch Faktoren wie einen definierten Preis für jede Nacht, das Inventar für den zugehörigen Zimmertyp und die Verfügbarkeitseinschränkung beeinflusst. 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. Das Schließen 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 werden kann.

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

Beispiel

In diesem Abschnitt finden Sie ein einfaches Beispiel für eine Inventarnachricht mit erforderlichen und optionalen Elementen. Nachdem Sie die Datei vorbereitet haben, müssen Sie sie über eine POST-Nachricht an diesen Endpunkt senden:

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

Weitere Informationen zum PUSH/POST-Vorgang für die Nachricht finden Sie unter Nachrichten pushen.

Wichtiger Hinweis: Senden Sie Google immer dann eine aktualisierte Inventarnachricht, wenn sich Ihr Inventar ändert, z. B. bei Buchungen und Stornierungen.

Verwenden Sie für HotelCode die eindeutige Hotel-ID, die Sie in Ihrem System zur Identifizierung des Hotels 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 Übereinstimmung mit Ihrem System ist entscheidend dafür, dass Ihre Daten korrekt bei Google angezeigt werden.

Hinweis :<CountType=2> ist die einzige gültige Option, da sie eine Anzahl mit „definitiver Verfügbarkeit“ angibt.

In diesem Beispiel wird gezeigt, wie Sie Inventar für 13 buchbare Zimmer 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 unter Inventarbeispiele.

Anleitungen

In diesem Abschnitt finden Sie ein Szenario, das beim Senden einer Inventarnachricht auftreten kann.

Szenario: Buchung von Räumen blockieren

Beschreibung

Sie müssen angeben, dass für diesen Zimmertyp an bestimmten Terminen keine Zimmer mehr gebucht werden können, in der Regel, weil 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 die angegebenen Daten (z. B. die ersten Wochen im Januar) auf 0 festlegen.

Hinweis :Wenn die Anzahl der verfügbaren Zimmer für einen Raum an einem Abend eines Aufenthalts 0 beträgt, kann der Aufenthalt für keine Produkte gebucht werden, die mit diesem Raum 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>