Żą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
zawiera te elementy oraz
atrybuty:
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 - (myślnik). |
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żywane, jeśli backend dostarcza pliki danych z cenami dla 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> . Definiuje partnera
koncie. |
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID | 1 | string | Konto partnera, z którego pochodzi ta wiadomość. Ta wartość ciągu znaków to parametr
Wartość klucza partnera podana w
Strona Ustawienia konta w Hotel Center.
Uwaga: jeśli masz backend, który dostarcza pliki danych dla wielu
kont, ta wartość musi być zgodna z wartością |
OTA_HotelInvCountNotifRQ / Inventories | 1 | Inventories | Kontener na co najmniej 1 <Inventory>
. |
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode | 1 | string | Unikalny identyfikator usługi. Ta wartość musi pasować do Identyfikator hotelu określony za pomocą elementu <id> na liście <wykaz> w pliku danych Lista hoteli. Identyfikator hotelu znajduje się też w Hotel Center. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory | 1..n | Inventory | Określa liczbę dostępnych sal dla różnych zakresów czasu dla jednej osoby usłudze. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl | 1 | StatusApplicationControl | Definiuje 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 zakres dat. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End | 1 | Date | Data zakończenia (na podstawie strefy czasowej usługi) włącznie z datą zakończenia
zakresu dat. Wartość nie może być mniejsza 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 jako true lub 1 , aby uwzględniać poniedziałki.
Jeśli ma wartość |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue | 0..1 | boolean | Ustaw jako true lub 1 , by uwzględnić wtorki.
Jeśli ma wartość |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds | 0..1 | boolean | Ustaw jako true lub 1 , by uwzględnić środy.
Jeśli ma wartość |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur | 0..1 | boolean | Aby uwzględniać czwartki, ustaw wartość true lub 1 .
Jeśli ma wartość |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri | 0..1 | boolean | Ustaw jako true lub 1 , aby uwzględnić piątki.
Jeśli ma wartość |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat | 0..1 | boolean | Ustaw jako true lub 1 , aby wyraźnie uwzględnić soboty.
Jeśli ma wartość |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun | 0..1 | boolean | Ustaw jako true lub 1 , aby uwzględniać niedziele.
Jeśli ma wartość |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode | 1 | string | Unikalny identyfikator zasobów reklamowych (typ pomieszczenia). Ta wartość jest mapowana
do <RoomID> w transakcjach
(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. A minus jest traktowana jako zero. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType | 1 | enum | Typ określonej liczby zasobów reklamowych. Prawidłowa wartość to:
|
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
zawiera te elementy oraz
atrybuty:
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ązanego elementu
OTA_HotelInvCountNotifRQ wiadomość. |
OTA_HotelInvCountNotifRS / Success | 0..1 | Success | Wskazuje, że wiadomość typu OTA_HotelInvCountNotifRQ została
udało się przetworzyć.
Dozwolone wartości |
OTA_HotelInvCountNotifRS / Errors | 0..1 | Errors | Kontener dla co najmniej jednego problemu napotkanego podczas przetwarzania
OTA_HotelInvCountNotifRQ wiadomość.
Dozwolone wartości |
OTA_HotelInvCountNotifRS / Errors / Error | 1..n | Error | Opis błędu, który wystąpił podczas przetwarzania
OTA_HotelInvCountNotifRQ wiadomość. Szczegóły dotyczące tych błędów
znaleźć w komunikatach o błędach dotyczących stanu pliku danych. |
OTA_HotelInvCountNotifRS / Errors / Error / @Type | 1 | integer | OpenTravel Alliance EWT (Error Ostrzeżenie Type) powiązane z
. 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. Tylko wartość
Zajęte miejsce: NotProcessed . |
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText | 1 | string | Identyfikator Google problemu. Szczegółowe informacje o tych błędach można znaleźć znaleziono w komunikatach o błędach dotyczących stanu pliku danych. |
Przykłady
Sukces
To jest odpowiedź na przesłane żądanie
OTA_HotelInvCountNotifRQ
wiadomość.
<?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
Ta odpowiedź jest odpowiedzią na wiadomość z kategorii OTA_HotelInvCountNotifRQ
, która nie została
przetworzono 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>