Inventarnachricht

Übersicht

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

In den folgenden Abschnitten finden Sie allgemeine Richtlinien, ein einfaches Beispiel und eine Anleitung. um Ihnen den Einstieg in das Hinzufügen und Aktualisieren von Inventar sowie Inventarnachrichten.

Beispiele für verschiedene inventarbezogene Szenarien finden Sie unter Anleitungen

Erforderliche und optionale Elemente

Die XML-Referenz enthält Beschreibungen der erforderlichen und optionalen Elemente. Weitere Informationen zu Attributen und untergeordneten Elementen, siehe Inventarelemente und Attribute enthalten.

Syntax und Schemas

Orientieren Sie sich beim Erstellen der Inventarnachricht an dem Beispiel für die Inventarsyntax, um sicherzustellen, dass Sie das richtige Format verwenden.

Sie können ein XML-Tool eines Drittanbieters wie xmllint verwenden, um Ihre Feeds mit veröffentlichten Schemas vor der Übermittlung an Google zu prüfen. Für das Inventar Weitere Informationen

Richtlinien

Beachten Sie für Inventarnachrichten die folgenden Richtlinien:

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

  • Die Inventaranzahl muss für alle Nächte des Aufenthalts größer als 0 sein um den Preis für den zugehörigen Preisplan und die entsprechende Belegung anzuzeigen.

  • Wenn die Inventaranzahl gleich 0 ist, sind Räume für diese Personen nicht verfügbar für die angegebene Zimmer-ID und den angegebenen Zeitraum.

  • CountType muss immer den Wert 2 haben, um gültig zu sein, die Anzahl der „Definitiv“

  • Bei jeder Reservierung oder Stornierung eines Raums aktualisiertes Inventar senden in Ihrem System auftritt.

Inventar und Verfügbarkeit

Das Inventar ist die Anzahl der buchbaren Räume basierend auf der physischen Anzahl und Verfügbarkeit gibt an, ob die Kombination aus Zimmertyp und Preisplan gebucht werden können. Für ARI können Verfügbarkeit und Inventar je nach an einem bestimmten Datum oder einer Art von Unterkunft. Beide haben entsprechende Nachrichtentypen. Inventar und Verfügbarkeit hängen von Hotel, Datum und Zimmer ab. Typ und fügen Sie einen Preisplan für die Verfügbarkeit hinzu.

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

Es gibt zwei Konzepte der Verfügbarkeit. Zunächst zur Gesamtverfügbarkeit eines Produkts für einen bestimmten Aufenthalt, der von Faktoren wie unabhängig davon, ob für jede Nacht ein festgelegter Preis, das Inventar für den zugehörigen Zimmertyp, und die Verfügbarkeitsbeschränkung ist offen. Zweitens gibt es die spezifischen Einschränkung für ein Produkt an einem bestimmten Datum, dargestellt durch <RestrictionStatus Restriction="Master" Status="Open"/> in OTA_HotelAvailNotifRQ, und wird diese Verfügbarkeit als „Stopp-Sell“ bezeichnet.

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

Beispiel

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

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

Weitere Informationen zum Übertragen/Posten der Nachricht finden Sie unter Senden von Nachrichten.

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 mithilfe von <id> in <listing> Element im Hotellistenfeed. Verwenden Sie für <RoomID> dieselbe ID, die Sie in Ihrem System für Zimmertypen. Die Einheitlichkeit mit Ihrem System ist entscheidend, Ihre Daten korrekt dargestellt werden.

In diesem Beispiel wird das Inventar für 13 buchbare Räume für den Monat Dezember:

<?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 Inventar Beispiele.

Anleitungen

Dieser Abschnitt beschreibt ein Szenario, das beim Senden einer Inventarnachricht.

Szenario: Buchung von Räumen blockieren

Beschreibung

Sie müssen angeben, dass keine Räume mehr gebucht werden können. an einem bestimmten Datum angezeigt. Das liegt meistens daran, ausverkauft ist.

Lösung

Sie setzen <InvCount Count> auf den Wert 0 und fügen den gewünschten Zeitraum hinzu.

Beispiel

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

<?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>