OTA_HotelInvCountNotifRQ

Żądania

Składnia

Wiadomość OTA_HotelInvCountNotifRQ ma tę 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 / @Atrybut Wystąpienia Typ Opis
OTA_HotelInvCountNotifRQ 1 Complex element Element główny wiadomości określającej dostępność stawek za pokój.
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) Przestrzeń nazw XML.
OTA_HotelInvCountNotifRQ / @EchoToken 1 string Unikalny identyfikator tej wiadomości z żądaniem. 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 wersję wiadomości OpenTravel;
OTA_HotelInvCountNotifRQ / POS 0..1 POS Kontener do określania konta partnera dla tego komunikatu (zwykle używany, jeśli backend udostępnia pliki danych o cenach dla wielu kont partnerów).
OTA_HotelInvCountNotifRQ / POS/ Source 1 Source Wymagany, jeśli występuje <POS>. Kontener na potrzeby elementu <RequestorID>.
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID Wymagany, jeśli występuje <POS>. Określa konto partnera.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string Konto partnera, do którego należy ta 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 Transakcja (dane usługi) oraz z wartością atrybutu ID w elemencie <RequestorID> wiadomości <OTA_HotelRateAmountNotifRQ> dla tego samego konta.
OTA_HotelInvCountNotifRQ / Inventories 1 Inventories Kontener 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ą <id> w elemencie <listing> pliku danych z listą hoteli. Identyfikator hotelu jest też podany w Hotel Center.
OTA_HotelInvCountNotifRQ / Inventories / Inventory 1..n Inventory Określa liczbę dostępnych pokoi w różnych zakresach czasowych dla pojedynczego obiektu.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl 1 StatusApplicationControl Określa zakres dat, a także identyfikator typu pokoju (InvTypeCode).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start 1 Date Data rozpoczęcia zakresu dat (włącznie) w strefie czasowej usługi.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date Data zakończenia zakresu dat (włącznie) w strefie czasowej usługi. Musi być równa lub większa niż wartość start. Jeśli wartości start i end są równe, aktualizacja zostanie zastosowana do tej daty.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon 0..1 boolean Ustaw wartość true lub 1, aby wyraźnie uwzględnić poniedziałki.

Jeśli ustawisz wartość true, inne dni tygodnia, które nie są wyraźnie ustawione na true, zostaną wykluczone (w efekcie zostaną odfiltrowane z dat w zakresie Start i End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue 0..1 boolean Ustaw wartość true lub 1, aby wyraźnie uwzględnić wtorki.

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

Jeśli ustawisz wartość true, inne dni tygodnia, które nie są wyraźnie ustawione na true, zostaną wykluczone (w efekcie zostaną odfiltrowane z dat w zakresie Start i End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur 0..1 boolean Ustaw wartość true lub 1, aby wyraźnie uwzględnić czwartki.

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

Jeśli ustawisz wartość true, inne dni tygodnia, które nie są wyraźnie ustawione na true, zostaną wykluczone (w efekcie zostaną odfiltrowane z dat w zakresie Start i End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat 0..1 boolean Ustaw na true lub 1, aby wyraźnie uwzględnić soboty.

Jeśli ustawisz wartość true, inne dni tygodnia, które nie są wyraźnie ustawione na true, zostaną wykluczone (w efekcie zostaną odfiltrowane z dat w zakresie Start i End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean Ustaw wartość true lub 1, aby wyraźnie uwzględnić niedziele.

Jeśli ustawisz wartość true, inne dni tygodnia, które nie są wyraźnie ustawione na true, zostaną wykluczone (w efekcie zostaną odfiltrowane z dat w zakresie Start i End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode 1 string Unikalny identyfikator asortymentu (rodzaju pokoju). Ta wartość jest mapowana na <RoomID> w wiadomości Transakcje (dane usługi).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts Kontener do określania 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ść zero oznacza, że dany typ pokoju jest wyprzedany. Wartość ujemna jest traktowana jako zero.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

Typ określonej liczby zasobów reklamowych. Prawidłowa wartość to:

  • 2: określona dostępność.

Przykłady

Pozostałe zasoby reklamowe

Ustawia 5 pokoi pozostałych na RoomID_1 w podanych terminach.

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

Wyprzedane zasoby reklamowe

Oznacz RoomID_1 jako wyprzedane w podanych terminach.

<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 ma tę 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 / @Atrybut 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 z powiązanejOTA_HotelInvCountNotifRQ wiadomości.
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 na co najmniej 1 problem napotkany 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ściOTA_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 Typ błędu lub ostrzeżenia 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 Kod błędu OpenTravel Alliance ERR powiązany z błędem. Używana jest tylko wartość 450 (Unable to process).
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 enum Stan pierwotnej prośby. 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 znajdziesz odpowiedź na prawidłowo 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 znajduje się 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>