Wiadomość o dostępności

Przegląd

Komunikat o dostępności (OTA_HotelAvailNotifRQ) określa, czy produkt (typ pokoju w połączeniu z planem cenowym) w przypadku danego planu podróży może być sprzedawany w odpowiednich terminach. Wysyłając wiadomość o dostępności, wskazujesz, czy zmieniła się dostępność lub ograniczenia dotyczące produktu.

Ważne: zasoby reklamowe można też aktualizować za pomocą typu wiadomości Dostępność, ale preferowaną metodą jest typ wiadomości Zasoby reklamowe (OTA_HotelInvCountNotifRQ).

W sekcjach poniżej znajdziesz ogólne wytyczne, podstawowy przykład oraz scenariusze, które pomogą Ci zacząć dodawać i aktualizować dostępność za pomocą wiadomości o dostępności.

Ograniczenie dostępności w nocy

Komunikat o dostępności pozwala określić ograniczenia, które kontrolują ogólną dostępność rezerwacji. Jednym z rodzajów ograniczeń jest „dostępność w nocy”, czyli możliwość sprzedaży produktu w określonym dniu. Aby pobyt (od zameldowania do wymeldowania) można było zarezerwować, musi być dostępny w każdym terminie, a także muszą być spełnione wszystkie inne ograniczenia dotyczące rezerwacji i pobytu.

Uwaga: więcej informacji o pojęciu dostępności i różnicach między zasobami reklamowymi a dostępnością znajdziesz w artykule Zasoby reklamowe a dostępność.

Ustawienia ograniczeń

Domyślnie sekcja RestrictionStatus dla Restriction="Master" jest zamknięta. Innymi słowy, domyślnie każdej nocy obowiązuje „stop sell”.

Aby produkt był dostępny w sprzedaży, musi mieć wartość <RestrictionStatus Restriction="Master" Status="Open"> dla wszystkich kombinacji produktów we wszystkie noce pobytu. Musisz wysłać do Google wyraźny Open dla każdego produktu lub zmienić ustawienie domyślne w Hotel Center. Aby to zrobić, otwórz w Hotel Center stronę Ceny > Ustawienia i edytuj pole „Dostępność domyślna”.

Inne ograniczenia

Przylot/wylot

Zapobiega sprzedaży planu podróży, który rozpoczyna się lub kończy w określonym dniu. Domyślnie jest to Open.

Minimalne i maksymalne przesunięcie rezerwacji

Wymaga, aby plan podróży został kupiony co najmniej lub co najwyżej określoną liczbę dni przed przybyciem.

Minimalna i maksymalna długość pobytu

Ogranicza długość pobytu w przypadku planów podróży z tą datą przyjazdu.

Minimalny i maksymalny okres pobytu (lub „stay-through”)

Ogranicza długość pobytu w przypadku planów podróży, które zawierają tę datę pobytu.

Wzór długości pobytu

Umożliwia dokładne określenie, jakie długości pobytu są dozwolone w przypadku tej daty przyjazdu.

Ogólne wskazówki

• Ograniczenia dostępności są powiązane z hotelem, datą, typem pokoju i planem cenowym.

• Produkt można zarezerwować tylko wtedy, gdy nie ma żadnych ograniczeń dotyczących pobytu (od zameldowania do wymeldowania) ani czasu, w którym użytkownik może dokonać rezerwacji.

• Wysyłaj do Google aktualizację wiadomości o dostępności za każdym razem, gdy zmienią się ograniczenia dostępności produktu w określonych datach.

Przykład

W tej sekcji znajdziesz podstawowy przykład wiadomości o dostępności z elementami wymaganymi i opcjonalnymi. Po przygotowaniu pliku musisz wysłać go do Google za pomocą wiadomości POST na ten punkt końcowy:

https://www.google.com/travel/hotels/uploads/ota/hotel_avail_notif

Więcej informacji o wysyłaniu wiadomości metodą push/POST znajdziesz w artykule Wysyłanie wiadomości.

Ważne: za każdym razem, gdy zmieni się dostępność, wysyłaj do Google zaktualizowaną wiadomość.

W przypadku HotelCode użyj unikalnego identyfikatora hotelu, którego używasz w systemie do identyfikacji obiektu. Ta wartość musi być zgodna z identyfikatorem hotelu określonym za pomocą elementu <id> w elemencie <listing> w pliku danych z listą hoteli. Spójność z systemem jest kluczowa, aby Google prawidłowo wyświetlało Twoje dane.

Ten przykład pokazuje, jak ustawić ograniczenia dostępności:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <AvailStatusMessages HotelCode="HOTELID">
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="202X-03-20"
                                End="202X-03-25"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay MinMaxMessageType="SetMinLOS" Time="2" TimeUnit="Day" />
      </LengthsOfStay>
      <RestrictionStatus Restriction="Master" Status="Open" />
    </AvailStatusMessage>
</OTA_HotelAvailNotifRQ>

Więcej przykładów znajdziesz w artykule Przykłady dotyczące dostępności.

Instrukcje

W tej sekcji znajdziesz rozwiązania problemów, które mogą wystąpić podczas wysyłania wiadomości o dostępności, a w szczególności informacje o ograniczeniu dostępności w nocy (znanym też jako „wstrzymanie sprzedaży”).

Scenariusz 1. Jak sprzedawać produkty w określonych terminach

Opis

Chcesz udostępnić kombinację typu pokoju i planu cenowego (produktu) w określonych terminach.

Uwaga: domyślnie Google traktuje produkty jako mające włączoną opcję „stop sell” (dostępność w nocy jest wyłączona), ale możesz skonfigurować, czy ograniczenie dostępności w nocy jest domyślnie włączone czy wyłączone. Musisz wysłać do Google Open dla każdego produktu lub zmienić ustawienie domyślne w Hotel Center.

Rozwiązanie

Ustaw ograniczenie Master na Open i określ daty.

Przykład

Ten przykład pokazuje, jak otworzyć dostępność noclegów w przypadku produktu na kilka tygodni w marcu.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-03-20"
                                End="2022-03-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Uwaga: aby wyświetlać cenę produktu, ograniczenie dostępności w nocy musi mieć wartość Open (a asortyment musi być liczbą całkowitą większą niż 0 w przypadku pokoju).

Więcej informacji o ustalaniu cen znajdziesz w artykule Rozwiązywanie problemów z brakującymi lub niekompletnymi cenami.

Scenariusz 2. Jak przestać sprzedawać produkty w określonych terminach

Opis

chcesz wyraźnie zatrzymać sprzedaż produktu (a nie tylko poinformować o jego niedostępności) w określonych terminach.

Uwaga: jeśli produkt jest całkowicie dezaktywowany, ponieważ typ pokoju, plan cenowy lub ich kombinacja są wyłączone, zalecamy użycie wiadomości Transakcja (dane obiektu) do usunięcia mapowania produktu, ponieważ nie jest on zależny od daty.

Rozwiązanie

Ustaw ograniczenie Master na Close i określ daty.

Przykład

Ten przykład pokazuje, jak „wstrzymać sprzedaż” lub zamknąć dostępność noclegów w przypadku produktu w określonych terminach.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-04-20"
                                End="2022-04-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>