OTA_HotelInvCountNotifRQ,

Żądania

Składnia

Wiadomość OTA_HotelInvCountNotifRQ używa tej składni:

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

Elementy i atrybuty

Wiadomość OTA_HotelInvCountNotifRQ zawiera te elementy i atrybuty:

Element / @Attribute Wystąpienia Typ Opis
OTA_HotelInvCountNotifRQ 1 Complex element Element główny wiadomości określający dostępność stawki za pokój.
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) Przestrzeń nazw XML.
OTA_HotelInvCountNotifRQ / @EchoToken 1 string Unikalny identyfikator tego komunikatu żądania. Ta wartość jest zwracana w wiadomości z odpowiedzią. Dozwolone znaki to a–z, A–Z, 0–9, _ (podkreślenie) i – (łącznik).
OTA_HotelInvCountNotifRQ / @TimeStamp 1 DateTime Data i godzina utworzenia tej wiadomości.
OTA_HotelInvCountNotifRQ / @Version 1 decimal Wersja wiadomości OpenTravel.
OTA_HotelInvCountNotifRQ / POS 0..1 POS Kontener do określania konta partnera dla tego komunikatu (zazwyczaj używany, jeśli backend udostępnia pliki danych o cenach dla wielu kont partnerów).
OTA_HotelInvCountNotifRQ / POS/ Source 1 Source Wymagane, jeśli występuje właściwość <POS>. Kontener <RequestorID>.
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID Wymagane, jeśli występuje właściwość <POS>. Definiuje konto partnera.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string Konto partnera, na którym jest wysyłana wiadomość. Ta wartość ciągu znaków to wartość klucza partnera podana na stronie Ustawienia konta w Hotel Center.

Uwaga: jeśli masz backend, który udostępnia pliki danych dla wielu kont, ta wartość musi być zgodna z wartością atrybutu partner w wiadomości o transakcji (danych o obiekcie) oraz wartością atrybutu ID w elemencie <RequestorID> wiadomości <OTA_HotelRateAmountNotifRQ> na tym samym koncie.
OTA_HotelInvCountNotifRQ / Inventories 1 Inventories Kontener dla co najmniej 1 elementu <Inventory>.
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode 1 string Unikalny identyfikator usługi. Ta wartość musi być zgodna z identyfikatorem hotelu określonym za pomocą atrybutu <id> w elemencie <listing> w pliku danych z listą hoteli. Identyfikator hotelu jest też widoczny w Hotel Center.
OTA_HotelInvCountNotifRQ / Inventories / Inventory 1..n Inventory Określa liczbę dostępnych pokoi w różnych przedziałach czasowych w przypadku jednej usługi.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl 1 StatusApplicationControl Określa zakres dat oraz identyfikator typu pokoju (InvTypeCode).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start 1 Date Data rozpoczęcia (według strefy czasowej usługi) obejmująca zakres dat.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date Data końcowa (zgodnie ze strefą czasową usługi) zakresu dat. Musi być równa lub większa niż wartość start. Jeśli wartości start i end są takie same, aktualizacja dotyczy tej daty.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon 0..1 boolean Aby uwzględnić poniedziałki, ustaw wartość na true lub 1.

Jeśli ustawisz wartość true, inne dni tygodnia, które nie mają wyraźnie ustawionej wartości true, zostaną wykluczone (w efekcie zostaną odfiltrowane z daty w zakresie Start i End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue 0..1 boolean Aby uwzględnić w ramach kampanii w piątek tylko wtorek, ustaw wartość na true lub 1.

Jeśli ustawisz wartość true, inne dni tygodnia, które nie mają wyraźnie ustawionej wartości true, zostaną wykluczone (w efekcie zostaną odfiltrowane z daty w zakresie Start i End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds 0..1 boolean Ustaw jako true lub 1, aby wyraźnie uwzględnić środy.

Jeśli ustawisz wartość true, inne dni tygodnia, które nie mają wyraźnie ustawionej wartości true, zostaną wykluczone (w efekcie zostaną odfiltrowane z daty w zakresie Start i End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur 0..1 boolean Aby uwzględnić czwartki, ustaw wartość true lub 1.

Jeśli ustawisz wartość true, inne dni tygodnia, które nie mają wyraźnie ustawionej wartości true, zostaną wykluczone (w efekcie zostaną odfiltrowane z daty w zakresie Start i End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri 0..1 boolean Aby uwzględnić piątki, ustaw wartość na true lub 1.

Jeśli ustawisz wartość true, inne dni tygodnia, które nie mają wyraźnie ustawionej wartości true, zostaną wykluczone (w efekcie zostaną odfiltrowane z daty w zakresie Start i End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat 0..1 boolean Aby uwzględnić soboty, ustaw opcję na true lub 1.

Jeśli ustawisz wartość true, inne dni tygodnia, które nie mają wyraźnie ustawionej wartości true, zostaną wykluczone (w efekcie zostaną odfiltrowane z daty w zakresie Start i End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean Aby uwzględnić niedziele, ustaw wartość true lub 1.

Jeśli ustawisz wartość true, inne dni tygodnia, które nie mają wyraźnie ustawionej wartości true, zostaną wykluczone (w efekcie zostaną odfiltrowane z daty w zakresie Start i End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode 1 string Unikalny identyfikator asortymentu (typ pokoju). Ta wartość jest mapowana na <RoomID> w wiadomości Transakcje (dane usługi).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts Kontenery służące do definiowania pojedynczej liczby zasobów reklamowych.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount 1 InvCount Określa liczbę dostępnych pokoi, które można zarezerwować.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count 1 integer Liczba dostępnych pokoi, które można zarezerwować w przypadku danego typu pokoju. Wartość 0 oznacza, że dany typ pokoju jest niedostępny. Wartość ujemna jest traktowana jako 0.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

Typ zliczania zasobów reklamowych. Prawidłowa wartość to:

  • 2: dostępność bezwzględna.

Przykłady

Pozostałe zasoby reklamowe

Ustawia 5 sal dostępnych w danych dniach.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>

Zasoby reklamowe wyprzedane

Oznacz RoomID_1 jako wyprzedane w podanych datach.

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

Odpowiedzi

Składnia

Wiadomość OTA_HotelInvCountNotifRS używa tej składni:

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

Elementy i atrybuty

Wiadomość OTA_HotelInvCountNotifRS zawiera te elementy i atrybuty:

Element / @Attribute Wystąpienia Typ Opis
1 Complex element Element główny odpowiedzi na wiadomość o dostępności.
OTA_HotelInvCountNotifRS / @TimeStamp 1 DateTime Data i godzina utworzenia tej wiadomości.
OTA_HotelInvCountNotifRS / @EchoToken 1 string Unikalny identyfikator powiązany z wiadomością OTA_HotelInvCountNotifRQ.
OTA_HotelInvCountNotifRS / Success 0..1 Success Wskazuje, że wiadomość OTA_HotelInvCountNotifRQ została przetworzona.

W każdej wiadomości występuje element <Success> lub <Errors>.
OTA_HotelInvCountNotifRS / Errors 0..1 Errors Kontener dla co najmniej 1 problemu napotkanego podczas przetwarzania wiadomości OTA_HotelInvCountNotifRQ.

W każdej wiadomości występuje element <Success> lub <Errors>.
OTA_HotelInvCountNotifRS / Errors / Error 1..n Error Opis błędu, który wystąpił podczas przetwarzania wiadomości OTA_HotelInvCountNotifRQ. Szczegółowe informacje o tych błędach znajdziesz w artykule Komunikaty o błędach stanu pliku danych.
OTA_HotelInvCountNotifRS / Errors / Error / @Type 1 integer OpenTravel Alliance EWT (Error Warning Type) powiązany z błędem. Używana jest tylko wartość 12 (Processing exception).
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 integer ERR (kod błędu) OpenTravel Alliance powiązany z błędem. Używana jest tylko wartość 450 (Unable to process).
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 enum Stan pierwotnego żądania. Używana jest tylko wartość NotProcessed.
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText 1 string Identyfikator problemu w Google. Szczegółowe informacje o tych błędach znajdziesz w artykule Komunikaty o błędach stanu pliku danych.

Przykłady

Sukces

Poniżej znajduje się odpowiedź na pomyślnie przetworzoną wiadomość OTA_HotelInvCountNotifRQ.

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

Błędy

Poniżej przedstawiamy odpowiedź na wiadomość OTA_HotelInvCountNotifRQ, która nie została przetworzona z powodu błędów.

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