Dokumentacja XML dotycząca dostępności, stawek i zasobów reklamowych (ARI)

Ten przewodnik w formacie XML zawiera szczegółowe materiały referencyjne oraz przykłady kodu dla różnych komunikatów, elementów i atrybutów dostępnych w przypadku plików danych Dostępność, stawki i zasoby reklamowe (ARI).

ARI to tryb dostawy cen, który kontroluje stawki, dostępność i zasoby reklamowe za noc oraz określa ograniczenia dotyczące ich łączenia. ARI zapewnia też elastyczność w zakresie podatków, opłat i promocji.

W przypadku niektórych głównych typów wiadomości służących do definiowania dostępności i zasobów ARI ARI przestrzega standardowych protokołów OpenTravel Alliance (OTA).

Cena na podstawie LOS

Cena LOS-based pozwala określić stawki za datę zameldowania i długość pobytu, a nie za datę pobytu. Gdy określisz element <StatusApplicationControl> w przypadku ceny na podstawie LOS, atrybuty @Start i @End będą wskazywać zakres dat zameldowania, w których przypadku obowiązują stawki LOS.

Chociaż przy korzystaniu z cen opartych na LOS nie są już stosowane stawki za noc, wszystkie inne funkcje ARI (zasoby reklamowe, dostępność, reguły, promocje itp.) nadal mogą być stosowane do tych stawek i są określane na poziomie nocy. Oznacza to, że jeśli Twoje systemy są ściślej dopasowane do systemu cenowego opartego na LOS, nadal możesz korzystać z bogatego zestawu funkcji ARI (oprócz wydajności przepustowości zapewnianej dzięki conocnym aktualizacjom dostępności i ograniczeń).

Aby włączyć na koncie ceny na podstawie LOS, skontaktuj się z TAM lub z nami.

ARI używa następujących komunikatów z żądaniami:

  • Transaction (Dane usługi). Określa typ i informacje o pakiecie (abonamencie).

  • OTA_HotelRateAmountNotifRQ. Określa wartość obłożenia na dzień lub na podstawie LOS.

  • OTA_HotelAvailNotifRQ. Określa dostępność i ograniczenia na podstawie typu pomieszczeń i abonamentów. Za pomocą tej wiadomości można też aktualizować zasoby reklamowe, ale preferowana jest opcja OTA_HotelInvCountNotifRQ.

  • OTA_HotelInvCountNotifRQ. Określa zasoby fizycznych sal lub liczbę sal dostępnych do sprzedaży.

  • TaxFeeInfo. (Opcjonalnie) Określa podatki i opłaty obowiązujące w poszczególnych obiektach. Ta wiadomość nie jest wymagana, jeśli w komunikacie OTA_HotelRateAmountNotifRQ określono właściwość AmountAfterTax.

  • Promotions. (Opcjonalnie) Określa stawki promocyjne w przypadku określonych rezerwacji, pobytu i użytkowników.

  • RateModifications. (Opcjonalnie) Określa reguły zmiany cen w przypadku niektórych rezerwacji, pobytu i użytkowników.

  • ExtraGuestCharges. (Opcjonalnie) Określa, jak należy skonfigurować ceny dla dzieci i dodatkowych dorosłych.

Każda wiadomość zawiera podzbiór informacji, których Google używa do obliczania cen i dostępności wyświetlanych użytkownikom, którzy szukają Twoich miejsc zakwaterowania z określonymi datami zameldowania i wymeldowania oraz liczbą osób.

Historia zmian w pliku referencyjnym XML ARI

W tabeli poniżej znajdziesz tylko aktualizacje dokumentacji dotyczące zmian funkcji.

Data Zmiany
14 sierpnia 2020 r. Pierwsza wersja.
21 października 2020 r. Dodaliśmy typ wiadomości o promocjach.
17 listopada 2020 r. W przypadku komunikatów o transakcjach (dane usługi) zaktualizowaliśmy punkt końcowy i dodano atrybut action do elementów PropertyDataSet.
24 listopada 2020 r. Do komunikatów o transakcjach (dane usługi) dodano elementy <AllowablePackageIDs> i <AllowableRoomIDs>.
4 lutego 2021 r. Dodane odpowiedzi.
25 lutego 2021 r. Dodano: OTA_HotelInvCountNotifRQ.
21 października 2020 r. Dodaliśmy typ komunikatu dotyczącego modyfikacji stawek.