OTA_HotelInvCountNotifRQ

Anfragen

Syntax

Die Nachricht OTA_HotelInvCountNotifRQ verwendet die folgende Syntax:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="message_ID"
                          TimeStamp="timestamp"
                          Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="integer" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Elemente und Attribute

Die Nachricht OTA_HotelInvCountNotifRQ enthält folgende Elemente und Attribute:

Element / @Attribut Häufigkeit Typ Beschreibung
OTA_HotelInvCountNotifRQ 1 Complex element Das Stammelement für eine Nachricht, die die Verfügbarkeit des Zimmerpreises definiert.
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) Der XML-Namespace.
OTA_HotelInvCountNotifRQ / @EchoToken 1 string Eine eindeutige Kennung für diese Anfragenachricht. Dieser Wert wird in der Antwortnachricht zurückgegeben. Zulässige Zeichen sind a–z, A–Z, 0–9, _ (Unterstrich) und - (Bindestrich).
OTA_HotelInvCountNotifRQ / @TimeStamp 1 DateTime Erstellungsdatum und -uhrzeit der Nachricht.
OTA_HotelInvCountNotifRQ / @Version 1 decimal Die Nachrichtenversion von OpenTravel.
OTA_HotelInvCountNotifRQ / POS 0..1 POS Ein Container zum Angeben des Partnerkontos für diese Nachricht. Wird normalerweise verwendet, wenn Ihr Backend Preisfeeds für mehrere Partnerkonten bereitstellt.
OTA_HotelInvCountNotifRQ / POS/ Source 1 Source Erforderlich, wenn <POS> vorhanden ist. Ein Container für die <RequestorID>.
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID Erforderlich, wenn <POS> vorhanden ist. Definiert das Partnerkonto.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string Das Partnerkonto für diese Nachricht. Dieser Stringwert ist der Wert Partnerschlüssel, der im Hotel Center auf der Seite „Kontoeinstellungen“ aufgeführt ist.

Hinweis: Wenn Sie ein Backend haben, das Feeds für mehrere Konten bereitstellt, muss dieser Wert mit dem Attributwert partner der Nachricht „Transaktion (Unterkunftsdaten)“ und dem Attributwert ID im Element <RequestorID> der Nachricht <OTA_HotelRateAmountNotifRQ> für dasselbe Konto übereinstimmen.
OTA_HotelInvCountNotifRQ / Inventories 1 Inventories Ein Container für ein oder mehrere <Inventory>-Elemente.
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode 1 string Die eindeutige Kennung der Unterkunft. Dieser Wert muss mit der Hotel-ID übereinstimmen, die mit <id> im Element <listing> im Hotellistenfeed angegeben wird. Die Hotel-ID ist auch im Hotel Center aufgelistet.
OTA_HotelInvCountNotifRQ / Inventories / Inventory 1..n Inventory Definiert die verfügbare Zimmeranzahl für verschiedene Zeiträume für eine einzelne Unterkunft.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl 1 StatusApplicationControl Definiert den Zeitraum sowie die ID für den Zimmertyp (InvTypeCode).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start 1 Date Das einschließliche Startdatum (basierend auf der Zeitzone der Unterkunft) des Zeitraums.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date Das einschließliche Enddatum (basierend auf der Zeitzone der Unterkunft) des Zeitraums. Muss gleich oder größer als der Wert start sein. Wenn start und end gleich sind, gilt die Aktualisierung für dieses Datum.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon 0..1 boolean Geben Sie true oder 1 an, um Montagen explizit einzubeziehen.

Wird der Wert auf true gesetzt, werden andere Tage der Woche, die nicht explizit auf true gesetzt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start und End herausgefiltert.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue 0..1 boolean Geben Sie true oder 1 an, um Dienstage explizit einzubeziehen.

Wird der Wert auf true gesetzt, werden andere Tage der Woche, die nicht explizit auf true gesetzt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start und End herausgefiltert.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds 0..1 boolean Geben Sie true oder 1 an, um Mittwoche explizit einzubeziehen.

Wird der Wert auf true gesetzt, werden andere Tage der Woche, die nicht explizit auf true gesetzt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start und End herausgefiltert.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur 0..1 boolean Geben Sie true oder 1 an, um Donnerstage explizit einzubeziehen.

Wird der Wert auf true gesetzt, werden andere Tage der Woche, die nicht explizit auf true gesetzt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start und End herausgefiltert.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri 0..1 boolean Geben Sie true oder 1 an, um Freitage ausdrücklich einzubeziehen.

Wird der Wert auf true gesetzt, werden andere Tage der Woche, die nicht explizit auf true gesetzt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start und End herausgefiltert.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat 0..1 boolean Geben Sie true oder 1 an, um Samstage explizit einzubeziehen.

Wird der Wert auf true gesetzt, werden andere Tage der Woche, die nicht explizit auf true gesetzt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start und End herausgefiltert.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean Geben Sie true oder 1 an, um Sonntage explizit einzubeziehen.

Wird der Wert auf true gesetzt, werden andere Tage der Woche, die nicht explizit auf true gesetzt sind, ausgeschlossen. Sie werden also aus den Datumsangaben zwischen Start und End herausgefiltert.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode 1 string Die eindeutige Kennung für das Inventar (Zimmertyp). Dieser Wert ist <RoomID> in einer Nachricht Transaktionen (Unterkunftsdaten) zugeordnet.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts Ein Container, um eine einzelne Inventarzahl zu definieren.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount 1 InvCount Definiert die Anzahl der verfügbaren Zimmer, die gebucht werden können.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count 1 integer Die Anzahl der verfügbaren Zimmer, die für den Zimmertyp gebucht werden können. Der Wert Null gibt an, dass der Zimmertyp ausverkauft ist. Ein negativer Wert wird als Null behandelt.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

Der Typ der angegebenen Inventarzahl. Gültiger Wert:

  • 2: Unbefristete Verfügbarkeit.

Beispiele

Verbleibendes Inventar

Legt 5 Räume für für die angegebenen Termine fest.RoomID_1

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="5" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Ausverkauftes Inventar

Markieren Sie RoomID_1 zu den angegebenen Terminen als ausverkauft.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Antworten

Syntax

Die Nachricht OTA_HotelInvCountNotifRS verwendet die folgende Syntax:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="timestamp"
                          EchoToken="echo_token"
                          Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>

Elemente und Attribute

Die Nachricht OTA_HotelInvCountNotifRS enthält folgende Elemente und Attribute:

Element / @Attribut Häufigkeit Typ Beschreibung
1 Complex element Das Stammelement für eine Antwort auf eine Verfügbarkeitsnachricht.
OTA_HotelInvCountNotifRS / @TimeStamp 1 DateTime Erstellungsdatum und -uhrzeit der Nachricht.
OTA_HotelInvCountNotifRS / @EchoToken 1 string Die eindeutige Kennung der zugehörigen OTA_HotelInvCountNotifRQ-Nachricht.
OTA_HotelInvCountNotifRS / Success 0..1 Success Gibt an, dass die Nachricht OTA_HotelInvCountNotifRQ erfolgreich verarbeitet wurde.

Entweder <Success> oder <Errors> ist in jeder Nachricht enthalten.
OTA_HotelInvCountNotifRS / Errors 0..1 Errors Ein Container für ein oder mehrere Probleme, die bei der Verarbeitung der Nachricht OTA_HotelInvCountNotifRQ aufgetreten sind.

Entweder <Success> oder <Errors> ist in jeder Nachricht enthalten.
OTA_HotelInvCountNotifRS / Errors / Error 1..n Error Die Beschreibung eines Fehlers, der bei der Verarbeitung der Nachricht OTA_HotelInvCountNotifRQ aufgetreten ist. Details zu diesen Fehlern finden Sie unter Fehlercodes für den Feedstatus.
OTA_HotelInvCountNotifRS / Errors / Error / @Type 1 integer Der mit dem Fehler verknüpfte OpenTravel Alliance EWT (Error Warning Type, Art der Fehlerwarnung). Nur der Wert 12 (Processing exception) wird verwendet.
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 integer Der mit dem Fehler verknüpfte OpenTravel Alliance ERR (Error Code, Fehlercode). Nur der Wert 450 (Unable to process) wird verwendet.
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 enum Der Status der ursprünglichen Anfrage. Nur der Wert NotProcessed wird verwendet.
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText 1 string Die Google-Kennung für das Problem. Details zu diesen Fehlern finden Sie unter Fehlercodes für den Feedstatus.

Beispiele

Erfolg

Im Folgenden finden Sie eine Antwort auf eine erfolgreich verarbeitete OTA_HotelInvCountNotifRQ-Nachricht.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Success/>
</OTA_HotelInvCountNotifRS>

Fehler

Im Folgenden finden Sie eine Antwort auf eine OTA_HotelInvCountNotifRQ-Nachricht, die aufgrund von Fehlern nicht verarbeitet wurde.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>