Żądania
Składnia
Komunikat OTA_HotelInvCountNotifRQ
korzysta z 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
ma te elementy i atrybuty:
Element / @Atrybut | Wystąpienia | Typ | Opis |
---|---|---|---|
OTA_HotelInvCountNotifRQ | 1 | Complex element | Element główny 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 są znaki 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 komunikatu 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 z cenami dla wielu kont partnerów). |
OTA_HotelInvCountNotifRQ / POS/ Source | 1 | Source | Wymagane, jeśli występuje <POS> . Kontener na <RequestorID> . |
OTA_HotelInvCountNotifRQ / POS / RequestorID | 1 | RequestorID | Wymagane, jeśli występuje <POS> . Definiuje 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ść klucza partnera podana na
stronie 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ą atrybutu |
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> pliku danych z listą hoteli. Identyfikator hotelu znajduje się też w Hotel Center. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory | 1..n | Inventory | Określa liczbę dostępnych sal w różnych przedziałach czasowych w pojedynczej usłudze. |
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 (na podstawie strefy czasowej usługi) włącznie z zakresem dat. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End | 1 | Date | Data zakończenia (na podstawie strefy czasowej usługi), włącznie z zakresem dat. Wartość nie może być mniejsza 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 | Aby uwzględnić poniedziałki, ustaw wartość true lub 1 .
Jeśli ustawiona jest wartość |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue | 0..1 | boolean | Aby uwzględnić wtorki, ustaw wartość true lub 1 .
Jeśli ustawiona jest wartość |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds | 0..1 | boolean | Ustaw jako true lub 1 , aby wyraźnie uwzględniać środy.
Jeśli ustawiona jest wartość |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur | 0..1 | boolean | Ustaw wartość true lub 1 , aby uwzględnić czwartki.
Jeśli ustawiona jest wartość |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri | 0..1 | boolean | Ustaw na true lub 1 , aby wyraźnie uwzględnić piątki.
Jeśli ustawiona jest wartość |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat | 0..1 | boolean | Ustaw jako true lub 1 , aby wyraźnie uwzględniać soboty.
Jeśli ustawiona jest wartość |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun | 0..1 | boolean | Aby uwzględnić niedziele, ustaw wartość true lub 1 .
Jeśli ustawiona jest wartość |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode | 1 | string | Unikalny identyfikator zasobów reklamowych (typ sali). Ta wartość jest mapowana na <RoomID> w komunikacie Transakcje (dane usługi). |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts | 1 | InvCounts | Kontener służący 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 dany rodzaj pokoju 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:
|
Przykłady
Pozostałe zasoby
Ustawia wartość 5
rooms left for
RoomID_1` na podane daty.
<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
– wyprzedane bilety w określonych 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
Komunikat OTA_HotelInvCountNotifRS
korzysta z 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
ma te elementy i 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 z powiązanej wiadomości OTA_HotelInvCountNotifRQ . |
OTA_HotelInvCountNotifRS / Success | 0..1 | Success | Wskazuje, że komunikat OTA_HotelInvCountNotifRQ został przetworzony.
W każdej wiadomości występuje właściwość |
OTA_HotelInvCountNotifRS / Errors | 0..1 | Errors | Kontener na co najmniej 1 problem napotkany podczas przetwarzania komunikatu OTA_HotelInvCountNotifRQ .
W każdej wiadomości występuje właściwość |
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 sekcji Komunikaty o błędach stanu pliku danych. |
OTA_HotelInvCountNotifRS / Errors / Error / @Type | 1 | integer | Organizacja OpenTravel Alliance EWT (typ ostrzeżenia o błędzie) powiązana z błędem. Używana jest tylko wartość 12 (Processing exception) . |
OTA_HotelInvCountNotifRS / Errors / Error / @Code | 1 | integer | Błąd – kod błędu – ERR (kod błędu) OpenTravel Alliance.
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 Google problemu. Szczegółowe informacje o tych błędach znajdziesz w sekcji Komunikaty o błędach stanu pliku danych. |
Przykłady
Ukończono
Ta wiadomość jest odpowiedzią 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
To jest 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>