OTA_HotelInvCountNotifRQ

Żądania

Składnia

Wiadomość OTA_HotelInvCountNotifRQ ma taką 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 ma te elementy i atrybuty:

Element / @Atrybut Wystąpienia Typ Opis
OTA_HotelInvCountNotifRQ 1 Complex element Element główny wiadomości, która określa 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 Wersja wiadomości OpenTravel.
OTA_HotelInvCountNotifRQ / POS 0..1 POS Kontener do określania konta partnera dla tej wiadomości (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 element <POS>. Kontener elementu <RequestorID>.
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID Wymagany, jeśli występuje element <POS>. Określa konto partnera.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string Konto partnera dla tej wiadomości. Ta wartość ciągu znaków to Klucz 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 partner wartością atrybutu w wiadomości Transaction (Property Data) oraz z ID wartością atrybutu w <RequestorID> elemencie wiadomości <OTA_HotelRateAmountNotifRQ> dla tego samego konta.
OTA_HotelInvCountNotifRQ / Inventories 1 Inventories Kontener co najmniej 1 elementu <Inventory> elementów.
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 przedziałach czasu 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 zakresu dat (włącznie) według strefy czasowej usługi.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date Data zakończenia zakresu dat (włącznie) według strefy czasowej usługi. Musi być równa lub większa niż wartość start. Jeśli wartości start i end są równe, aktualizacja dotyczy 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 wartość 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 zasobów reklamowych (typu pokoju). Ta wartość jest mapowana na <RoomID> w wiadomości Transactions (Property Data).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts Kontener do określania liczby dostępnych pokoi.
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 dostępnych pokoi. Prawidłowa wartość:

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

Przykłady

Pozostałe zasoby reklamowe

Ustawia 5 pokoi pozostałych dla elementu RoomID_1 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="5" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Wyprzedane zasoby reklamowe

Oznacz element RoomID_1 jako wyprzedany 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 ma taką 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 ma 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ązanej OTA_HotelInvCountNotifRQ wiadomości.
OTA_HotelInvCountNotifRS / Success 0..1 Success Wskazuje, że wiadomość OTA_HotelInvCountNotifRQ została przetworzona.

Każda wiadomość zawiera element <Success> lub <Errors>.
OTA_HotelInvCountNotifRS / Errors 0..1 Errors Kontener co najmniej 1 problemu napotkanego podczas przetwarzania wiadomości OTA_HotelInvCountNotifRQ.

Każda wiadomość zawiera element <Success> lub <Errors>.
OTA_HotelInvCountNotifRS / Errors / Error 1..n Error Opis błędu napotkanego 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 Typ ostrzeżenia o błędzie (EWT) OpenTravel Alliance powiązany z błędem. Używana jest tylko wartość 12 (Processing exception).
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 integer Kod błędu (ERR) 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 jest używana.
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

Oto odpowiedź na wiadomość OTA_HotelInvCountNotifRQ przetworzoną.

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

Oto odpowiedź na wiadomość OTA_HotelInvCountNotifRQ, której nie udało się przetworzyć 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>