Ta strona została przetłumaczona przez Cloud Translation API.

OTA_HotelInvCountNotifRQ,

Żądania

Składnia

Komunikat 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 składa się z tych elementów i atrybutów:

Element / @Atrybut	Wystąpienia	Typ	Opis
OTA_HotelInvCountNotifRQ	1	Complex element	Główny element wiadomości, który określa dostępność stawki 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 na potrzeby tej wiadomości (zwykle używany, gdy backend udostępnia pliki danych z cenami dla kilku kont partnerów).
OTA_HotelInvCountNotifRQ / POS/ Source	1	Source	Wymagane, jeśli występuje `<POS>`. Kontener dla: `<RequestorID>`.
OTA_HotelInvCountNotifRQ / POS / RequestorID	1	RequestorID	Wymagane, jeśli występuje `<POS>`. Określa konto partnera.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID	1	string	Konto partnera, z którego pochodzi ta wiadomość. Ta wartość ciągu znaków to wartość 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 odpowiadać wartości atrybutu `partner` komunikatu transakcji (dane właściwości) i wartości atrybutu `ID` w elemencie `<RequestorID>` komunikatu `<OTA_HotelRateAmountNotifRQ>` dla tego samego konta.
OTA_HotelInvCountNotifRQ / Inventories	1	Inventories	Kontener na co najmniej 1 element `<Inventory>`.
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode	1	string	Unikalny identyfikator usługi. Ta wartość musi być zgodna z identyfikatorem hotelu określonym za pomocą parametru <id> w elemencie <listing> w pliku danych z listą hoteli. Identyfikator hotelu jest też wymieniony w Hotel Center.
OTA_HotelInvCountNotifRQ / Inventories / Inventory	1..n	Inventory	Określa liczbę dostępnych sal dla różnych zakresów czasu w jednej usłudze.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl	1	StatusApplicationControl	Określa zakres dat oraz identyfikator typu sali (`InvTypeCode`).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start	1	Date	Data rozpoczęcia (na podstawie strefy czasowej usługi) włącznie z datą rozpoczęcia zakresu dat.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End	1	Date	Data końcowa z zakresu dat (na podstawie strefy czasowej usługi). Wartość nie może być mniejsza niż wartość `start`. Jeśli wartości `start` i `end` są równe, aktualizacja zostanie zastosowana do wybranego dnia.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon	0..1	boolean	Ustaw jako `true` lub `1`, aby uwzględniać poniedziałki. Jeśli ma wartość `true`, pozostałe dni tygodnia, które nie mają przypisanej wartości `true`, są wykluczane (w efekcie są odfiltrowywane z dat podanych w parametrach `Start` i `End`).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue	0..1	boolean	Ustaw jako `true` lub `1`, by uwzględnić wtorki. Jeśli ma wartość `true`, pozostałe dni tygodnia, które nie mają przypisanej wartości `true`, są wykluczane (w efekcie są odfiltrowywane z dat podanych w parametrach `Start` i `End`).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds	0..1	boolean	Ustaw jako `true` lub `1`, by uwzględnić środy. Jeśli ma wartość `true`, pozostałe dni tygodnia, które nie mają przypisanej wartości `true`, są wykluczane (w efekcie są odfiltrowywane z dat podanych w parametrach `Start` i `End`).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur	0..1	boolean	Aby uwzględniać czwartki, ustaw wartość `true` lub `1`. Jeśli ma wartość `true`, pozostałe dni tygodnia, które nie mają przypisanej wartości `true`, są wykluczane (w efekcie są odfiltrowywane z dat podanych w parametrach `Start` i `End`).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri	0..1	boolean	Ustaw jako `true` lub `1`, aby uwzględnić piątki. Jeśli ma wartość `true`, pozostałe dni tygodnia, które nie mają przypisanej wartości `true`, są wykluczane (w efekcie są odfiltrowywane z dat podanych w parametrach `Start` i `End`).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat	0..1	boolean	Ustaw jako `true` lub `1`, aby wyraźnie uwzględnić soboty. Jeśli ma wartość `true`, pozostałe dni tygodnia, które nie mają przypisanej wartości `true`, są wykluczane (w efekcie są odfiltrowywane z dat podanych w parametrach `Start` i `End`).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun	0..1	boolean	Ustaw jako `true` lub `1`, aby uwzględniać niedziele. Jeśli ma wartość `true`, pozostałe dni tygodnia, które nie mają przypisanej wartości `true`, są wykluczane (w efekcie są odfiltrowywane z dat podanych w parametrach `Start` i `End`).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode	1	string	Unikalny identyfikator zasobów reklamowych (typ pomieszczenia). Ta wartość jest mapowana na `<RoomID>` w komunikacie Transakcje (dane usługi).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts	1	InvCounts	Kontener do definiowania pojedynczej liczby zasobów reklamowych.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount	1	InvCount	Określa liczbę dostępnych sal, które można zarezerwować.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count	1	integer	Liczba dostępnych sal, które można zarezerwować dla danego typu pokoju. Wartość 0 oznacza, że pokój został 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`: konkretna dostępność.

Przykłady

Pozostałe zasoby

Ustawia 5 sal zarezerwowanych dla 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 produkty (RoomID_1) jako wyprzedane w określonym terminie.

<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

Komunikat 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 składa się z tych elementów i atrybutów:

Element / @Atrybut	Wystąpienia	Typ	Opis
	1	Complex element	Element główny odpowiedzi na komunikat o dostępności.
OTA_HotelInvCountNotifRS / @TimeStamp	1	DateTime	Data i godzina utworzenia tej wiadomości.
OTA_HotelInvCountNotifRS / @EchoToken	1	string	Unikalny identyfikator powiązanej wiadomości `OTA_HotelInvCountNotifRQ`.
OTA_HotelInvCountNotifRS / Success	0..1	Success	Wskazuje, że komunikat `OTA_HotelInvCountNotifRQ` został przetworzony. Każda wiadomość zawiera element `<Success>` lub `<Errors>`.
OTA_HotelInvCountNotifRS / Errors	0..1	Errors	Kontener rozwiązania co najmniej jednego problemu, który wystąpił podczas przetwarzania wiadomości `OTA_HotelInvCountNotifRQ`. Każda wiadomość zawiera element `<Success>` lub `<Errors>`.
OTA_HotelInvCountNotifRS / Errors / Error	1..n	Error	Opis błędu, który wystąpił podczas przetwarzania komunikatu `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	Obiekt OpenTravel Alliance EWT (Error Warning Type) dotyczący błędu, który jest 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 (kod błędu). 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 Google problemu. Szczegółowe informacje o tych błędach znajdziesz w artykule Komunikaty o błędach stanu pliku danych.

Przykłady

Gotowe

Poniżej znajduje się odpowiedź na pomyślnie przetworzony komunikat 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 znajdziesz odpowiedź na komunikat OTA_HotelInvCountNotifRQ, który nie został przetworzony 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>