OTA_HotelAvailNotifRQ

Żądania

Składnia

Wiadomość OTA_HotelAvailNotifRQ używa tej składni:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="message_ID"
                       TimeStamp="timestamp"
                       Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <AvailStatusMessages HotelCode="HotelID">
    <AvailStatusMessage BookingLimit="integer">
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID"/>
      <LengthsOfStay FixedPatternLength="integer">
        <LengthOfStay Time="integer"
                      TimeUnit="[Day]"
                      MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
                      SetForwardMinStay|FullPatternLOS]">
          <LOS_Pattern FullPatternLOS="pattern"/>
        </LengthOfStay>
      </LengthsOfStay>
      <RestrictionStatus Status="[Close|Open]"
                         Restriction="[Arrival|Departure|Master]"
                         MaxAdvancedBookingOffset="integer_or_duration"
                         MinAdvancedBookingOffset="integer_or_duration"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Każda wiadomość <OTA_HotelAvailNotifRQ> jest traktowana jako aktualizacja delta. W przypadku każdej usługi, daty, pokoju i pakietu określonego w elemencie <StatusApplicationControl> aktualizacja wcześniej zdefiniowanego ograniczenia zastępuje tylko wartość tego samego ograniczenia, natomiast dodanie nowego ograniczenia nie wpływa na inne zdefiniowane wcześniej ograniczenia. Jeśli na przykład wcześniej zdefiniowano minimalną długość pobytu wynoszącą 2 dni, a następnie przesłano nową wiadomość zawierającą tylko maksymalną długość pobytu wynoszącą 7 dni, to ta czynność nie spowoduje usunięcia poprzedniej wartości minimalnej długości pobytu.

Elementy i atrybuty

Wiadomość OTA_HotelAvailNotifRQ zawiera te elementy i atrybuty:

Uwaga: każdy typ ograniczenia długości pobytu jest ustawiany niezależnie. Na przykład wiadomość, która ustawia wartość SetMaxLOS, nie zastąpi wcześniej zdefiniowanej wartości SetForwardMaxStay.

Element / @Attribute Wystąpienia Typ Opis
OTA_HotelAvailNotifRQ 1 Complex element Element główny wiadomości określający dostępność stawki za pokój.
OTA_HotelAvailNotifRQ / @xmlns 0..1 string (URI) Przestrzeń nazw XML.
OTA_HotelAvailNotifRQ / @EchoToken 1 string Unikalny identyfikator tego komunikatu żądania. Ta wartość jest zwracana w wiadomości z odpowiedzią. Dozwolone znaki to a-z, A-Z, 0-9, _ (podkreślenie) i - (łącznik).
OTA_HotelAvailNotifRQ / @TimeStamp 1 DateTime Data i godzina utworzenia tej wiadomości.
OTA_HotelAvailNotifRQ / @Version 1 decimal Wersja wiadomości OpenTravel.
OTA_HotelAvailNotifRQ / POS 0..1 POS Kontener do określania konta partnera dla tej wiadomości. Jest ona zazwyczaj używana, jeśli backend udostępnia pliki danych o cenach dla wielu kont partnerów.
OTA_HotelAvailNotifRQ / POS/ Source 1 Source Wymagane, jeśli występuje właściwość <POS>. Kontener <RequestorID>.
OTA_HotelAvailNotifRQ / POS / RequestorID 1 RequestorID Wymagane, jeśli występuje właściwość <POS>. Definiuje konto partnera.
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID 1 string Konto partnera, na którym jest wysyłana wiadomość. Ta wartość ciągu znaków to wartość Partner key 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 być zgodna z wartością atrybutu partner w wiadomości o transakcji (danych o obiekcie) oraz wartością atrybutu ID w elemencie <RequestorID> wiadomości <OTA_HotelRateAmountNotifRQ> na tym samym koncie.
OTA_HotelAvailNotifRQ / AvailStatusMessages 1 AvailStatusMessages Kontener dla co najmniej 1 elementu <AvailStatusMessage>.
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode 1 string Unikalny identyfikator usługi. Ta wartość musi być zgodna z identyfikatorem hotelu określonym za pomocą elementu <id> w elemencie <listing> w pliku danych z listą hoteli. Identyfikator hotelu jest też widoczny w Hotel Center.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage 1..n AvailStatusMessage Określa dostępność i ograniczenia stawek za pokój w różnych przedziałach czasowych w przypadku jednej usługi.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit 1 integer Uwaga: w związku z tym atrybutem zalecamy użycie wiadomości OTA_HotelInvCountNotifRQ.

Liczba pozostałych pokoi, które można zarezerwować na zakres dat w <StatusApplicationControl>. Jeśli określono wartość BookingLimit, element <StatusApplicationControl> musi zawierać wartość InvTypeCode, a element <AvailStatusMessage> nie może zawierać wartości <LengthOfStay> ani <RestrictionStatus>.

Musi być równa lub większa od 0. Jeśli wartość jest ujemna lub nie zostanie podana, przyjmuje domyślnie wartość 0.

Uwaga: aby określić dostępność pokoju dla danego ustawienia <StatusApplicationControl>, atrybut BookingLimit musi być ustawiony co najmniej raz.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl 1 StatusApplicationControl Określa zakres dat oraz identyfikatory typu pokoju —InvTypeCode i planu cenowego —RatePlanCode.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start 1 Date Data rozpoczęcia według strefy czasowej usługi, która obejmuje zakres dat.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End 1 Date Data zakończenia (według strefy czasowej usługi), w tym zakres dat. Musi być równa lub większa niż wartość start. Jeśli wartości start i end są takie same, aktualizacja dotyczy tej daty.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon 0..1 boolean Aby uwzględnić poniedziałki, ustaw wartość na true lub 1.

Jeśli ustawiona jest wartość true, inne dni tygodnia, które nie są jawnie ustawione jako „true”, są wykluczane (w efekcie są odfiltrowywane z daty w zakresie Start and End).).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue 0..1 boolean Aby uwzględnić w ramach kampanii w piątek tylko wtorek, ustaw wartość na true lub 1.

Jeśli ustawisz wartość true, inne dni tygodnia, które nie mają wyraźnie ustawionej wartości true, zostaną wykluczone (w efekcie zostaną odfiltrowane z daty w zakresie Start i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean Ustaw jako true lub 1, aby wyraźnie uwzględnić środy.

Jeśli ustawisz wartość true, inne dni tygodnia, które nie mają wyraźnie ustawionej wartości true, zostaną wykluczone (w efekcie zostaną odfiltrowane z daty w zakresie Start i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean Aby uwzględnić czwartki, ustaw wartość true lub 1.

Jeśli ustawisz wartość true, inne dni tygodnia, które nie mają wyraźnie ustawionej wartości true, zostaną wykluczone (w efekcie zostaną odfiltrowane z daty w zakresie Start i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0..1 boolean Aby uwzględnić piątki, ustaw wartość na true lub 1.

Jeśli ustawisz wartość true, inne dni tygodnia, które nie mają wyraźnie ustawionej wartości true, zostaną wykluczone (w efekcie zostaną odfiltrowane z daty w zakresie Start i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat 0..1 boolean Aby uwzględnić soboty, ustaw opcję na true lub 1.

Jeśli ustawisz wartość true, inne dni tygodnia, które nie zostały wyraźnie ustawione na true, zostaną wykluczone (w efekcie zostaną odfiltrowane z daty w zakresie dat rozpoczęcia i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun 0..1 boolean Aby uwzględnić niedziele, ustaw wartość true lub 1.

Jeśli ustawisz wartość true, inne dni tygodnia, które nie mają wyraźnie ustawionej wartości true, zostaną wykluczone (w efekcie zostaną odfiltrowane z daty w zakresie Start i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode 1 string Unikalny identyfikator asortymentu (typ pokoju). Ta wartość jest mapowana na <RoomID> w wiadomości Transakcje (dane usługi).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode 0..1 string Unikalny identyfikator planu taryfowego. Ten identyfikator jest mapowany na wartość parametru <PackageID> w wiadomości dotyczącej transakcji (danych obiektu). Abonament jest dalej definiowany i wymieniony w <StatusApplicationControl> w komunikatach <OTA_HotelRateAmountNotifRQ> i <OTA_HotelAvailNotifRQ>.

Atrybut RatePlanCode nie ma zastosowania i nie należy go podawać, gdy element <AvailStatusMessage> zawiera atrybut BookingLimit. Musi być określony, jeśli określono <RestrictionStatus> lub <LengthOfStay>.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay 0..1 LengthsOfStay Kontener do definiowania ograniczeń LOS. Nie może występować, jeśli element <AvailStatusMessage> zawiera atrybut BookingLimit.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength 0..1 integer Długość wzoru zdefiniowanego w sekcji FullPatternLOS.

Uwaga: ten atrybut musi być ustawiony, gdy używasz atrybutu MinMaxMessageType="FullPatternLOS", a w przeciwnym razie nie musi być obecny.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay 1..n LengthOfStay określa ograniczenia dotyczące długości pobytu; Jeśli używasz więcej niż 1 elementu <LengthOfStay>, każdy z nich musi mieć inną wartość MinMaxMessageType.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time 0..1 integer Jednostkowa wartość pomiaru długości pobytu. Pamiętaj, że wartość 0 jest traktowana jako brak ograniczeń. Na przykład <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> oznacza brak maksymalnej długości pobytu.

Uwaga: ten atrybut musi być ustawiony, chyba że używasz atrybutu MinMaxMessageType="FullPatternLOS".

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit 0..1 enum Jednostka czasu. Jeśli nie podano żadnej wartości, domyślnie "Day". Prawidłowa wartość to:
  • Day
Uwaga: 1 jednostka "Day" odpowiada 1 nocy pobytu.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType 1 enum różne typy ograniczeń dotyczących długości pobytu; Parametry SetMaxLOS, SetMinLOS i FullPatternLOS są oparte na czasie przybycia. Wartości SetForwardMinStay i  SetForwardMaxStay są obliczane na podstawie czasu spędzonego na stronie. Wartości maksymalne muszą być równe lub większe od wartości minimalnych.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern 0..1 LOS_Pattern Określa wzór ograniczenia długości pobytu.

Uwaga: ten element musi być obecny, gdy używasz elementu MinMaxMessageType="FullPatternLOS", a w przeciwnym razie nie musi być obecny.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS 1 string Sekwencja znaków Y i N wskazująca, czy dozwolony jest każdy czas pobytu, od jednej nocy do wartości w FixedPatternLength. Każda długość pobytu większa niż FixedPatternLength dziedziczy wartość na ostatniej pozycji. Na przykład w przypadku FixedPatternLength="4" i FullPatternLOS="YNYN" dozwolone są tylko długości pobytu 1 i 3.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus 0..1 RestrictionStatus Określa ograniczenia dotyczące planu podróży. Nie może występować, jeśli element <AvailStatusMessage> zawiera atrybut BookingLimit.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status 0..1 enum Wskazuje, czy typ ograniczenia określony przez atrybut Restriction jest otwarty czy zamknięty. Prawidłowe wartości to:
  • Open
  • Close

Wartości Open i Close są zgodne ze wszystkimi wartościami elementu <Restriction>. Gdy wartości Open i Close są używane z wartościami Arrival i Departure, ograniczają one konkretne daty w planie podróży odpowiednio do zameldowania i wymeldowania.

  • Open i Close z Arrival: ta kombinacja określa, które daty w planie podróży są dostępne do zameldowania
  • Open i Close z Departure: Ta kombinacja określa, które daty w planie podróży są dostępne do zameldowania

    • Data Arrival nie ogranicza dostępności na noce po dacie zameldowania.

    Na przykład w przypadku pobytu od 1 do 4 kwietnia, gdy w dniach 2–4 kwietnia obowiązuje zakaz wstępu, można nadal zarezerwować pobyt.

    Uwaga:

    • Domyślnie Google zakłada, że ustawienie Master we wszystkich usługach to Close. Możesz to skonfigurować w sekcji „Domyślna dostępność” w ustawieniach cen w Hotel Center. Wartość „Closed” (zamknięty) w Hotel Center odpowiada wartości Close.
    • Ustawienie wartości Master na Close nazywa się „zatrzymaniem sprzedaży”.
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction 0..1 enum

    Ten atrybut jest wymagany, jeśli podano wartość Status.

    Prawidłowe wartości to:

    • Arrival: Ta wartość uniemożliwia rezerwacje z datą zameldowania w zakresie dat Start–End.
    • Departure: Ta wartość uniemożliwia planowanie podróży z datą wymeldowania w zakresie dat Start–End.
    • Master: Ta wartość wskazuje, czy cena pokoju jest dostępna do rezerwacji w wybranym dniu.

    Zarówno Arrival, jak i Departure są wymagane, aby mieć dostępne pokoje w danym planie podróży. Wartością domyślną zarówno w przypadku Arrival, jak i Departure jest Open, chyba że wcześniej wysłano wiadomość wskazującą, że sprawa została zamknięta. Dodatkowo kombinacja pokój/pakiet musi być dostępna we wszystkie dni pobytu, z wyjątkiem ostatniego dnia. Dostępność można ustawić za pomocą ustawień domyślnych w Hotel Center lub za pomocą elementu <Status> lub <Restriction>. Jeśli domyślne ustawienie to Close, musisz przesłać wartość Status Open i wartość restriction Master dla odpowiednich dat, aby ponownie otworzyć dostępność dla dat w harmonogramie.

    Na przykład w przypadku pobytu na 3 noce z datą przyjazdu 1 kwietnia pełny plan podróży obejmuje 1–4 kwietnia. Wartość Status powinna być ustawiona na Open, a wartość Restriction powinna być ustawiona na Master za pobyt w nocy z 1 na 2 kwietnia. Ostatni dzień pobytu (4 kwietnia) jest zamknięty, ponieważ tylko daty pobytu wymagają stanu Open.

    Uwaga: jeśli nie podasz wartości Restriction, domyślnie zostanie użyta wartość Master.
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset 0..1 integer or duration Minimalny czas przed datą przyjazdu (według lokalnego czasu obiektu), przez jaki można zarezerwować pokój w tej cenie.

    Prawidłowe typy wartości:

    • Integer: Liczba dni przed datą przyjazdu. Na przykład wartość 1 oznacza, że cena pokoju musi zostać zarezerwowana co najmniej jeden dzień przed datą przyjazdu. Wartość 0 (wartość domyślna) oznacza brak ograniczeń dotyczących ostatniego czasu rezerwacji.
    • ISO 8601 Duration (days, hours, and minutes): Liczba dni (i opcjonalnie godzin/minut) przed datą przyjazdu. Na przykład wartość P1D oznacza, że pokój można zarezerwować dzień przed datą przyjazdu. Wartość P0DT6H oznacza, że rezerwacja musi nastąpić na 6 godzin przed końcem daty przyjazdu (czyli do godziny 18:00) lub wcześniej.
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset 0..1 integer or duration Maksymalny czas przed datą przyjazdu (według lokalnego czasu obiektu), w którym można zarezerwować pokój w tej cenie.

    Prawidłowe typy wartości:

    • Integer: Liczba dni przed datą przyjazdu. Na przykład wartość 30 oznacza, że cena pokoju nie może zostać zarezerwowana wcześniej niż 30 dni przed datą przyjazdu. Wartość 0 (wartość domyślna) oznacza brak ograniczeń dotyczących najkrótszego czasu rezerwacji.
    • ISO 8601 Duration (days, hours, and minutes): Liczba dni (i opcjonalnie godzin/minut) przed datą przybycia. Na przykład wartość P30D oznacza, że ceny pokoju nie można zarezerwować wcześniej niż 30 dni przed datą przyjazdu. Wartość P30DT6H oznacza, że rezerwacji nie można dokonać wcześniej niż o godzinie 18:00, 30 dni przed datą przyjazdu.

    Przykłady

    Data przybycia LoS

    Ustaw minimalną i maksymalną długość pobytu (na podstawie daty przyjazdu).

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

    Czas trwania LoS

    Ustaw minimalną i maksymalną długość pobytu (na podstawie współczynnika utrzymania).

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

    Usuwanie ograniczeń związanych z LOS

    Ustawienie wartości „0” w atrybucie <LengthOfStay> oznacza, że nie ma żadnych ograniczeń dotyczących określonej długości pobytu. Na przykład: <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> oznacza, że nie ma maksymalnego limitu długości pobytu.

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2024-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2024-07-26"
                                End="2024-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

    Ograniczenie dotyczące odlotu

    Ustaw ograniczenie dotyczące zamknięcia lotniska. (uniemożliwia to plany podróży z check-outem w określonych datach).

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

    Ograniczenie dotyczące przyjazdu

    Ustaw ograniczenie czasu przyjazdu. (zapobiega to tworzeniu planów podróży z zameldowaniem w określonych terminach).

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


    Daty dostępności

    Otwórz dostępność pokoju danego typu i planu cenowego w określonych terminach.

    Uwaga: zanim ceny staną się w pełni dostępne, musisz podać ceny za noc oraz liczbę dostępnych pokoi większą niż 0 dla danego typu pokoju.

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

    Zamknij daty dostępności

    Zamknij dostępność pokoju danego typu i planu cenowego w określonych terminach. (jest to tzw. „zatrzymanie sprzedaży”).

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

    Ograniczenia dotyczące rezerwacji z wyprzedzeniem

    Ustaw minimalny i maksymalny okres rezerwacji z wyprzedzeniem, który będzie stosowany tylko w weekendy.

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                Mon=”false”
                                Tue=”false”
                                Weds=”false”
                                Thur=”false”
                                Fri=”false”
                                Sat=”true”
                                Sun=”true”
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MaxAdvancedBookingOffset="30"
                         MinAdvancedBookingOffset="2"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

    Rezerwacja z ostatecznym terminem

    Zastosować limit rezerwacji na dzień przyjazdu o godz. 18:00 czasu lokalnego hotelu.

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MinAdvancedBookingOffset="P0DT6H0M"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

    Wiele ograniczeń

    Ustaw kilka ograniczeń na te same daty dla typu pokoju i planu cenowego.

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


    Limit rezerwacji

    Ustaw liczbę dostępnych pokoi danego typu w określone dni.

    Uwaga: w związku z tym, że wiadomość OTA_HotelInvCountNotifRQ jest preferowana, nie trzeba ustawiać tego atrybutu.

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage BookingLimit="5">
      <!-- Note: RatePlanCode must not be specified here when setting inventory counts. -->
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

    FullPatternLoS

    Ustaw pełne ograniczenie długości pobytu w ramach wzorca.

    W przypadku zameldowania 26 lipca 2023 r. dozwolone są tylko długości pobytu 2, 4 i 6. Długości pobytu 1, 3, 5 i 7 i więcej są niedostępne.

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-26"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay FixedPatternLength="7">
        <LengthOfStay MinMaxMessageType="FullPatternLOS">
          <LOS_Pattern FullPatternLOS="NYNYNYN"/>
        </LengthOfStay>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

    Odpowiedzi

    Składnia

    Wiadomość OTA_HotelAvailNotifRS używa tej składni:

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS 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_HotelAvailNotifRS>

    Elementy i atrybuty

    Wiadomość OTA_HotelAvailNotifRS zawiera te elementy i atrybuty:

    Element / @Attribute Wystąpienia Typ Opis
    OTA_HotelAvailNotifRS 1 Complex element Element główny odpowiedzi na wiadomość o dostępności.
    OTA_HotelAvailNotifRS / @TimeStamp 1 DateTime Data i godzina utworzenia tej wiadomości.
    OTA_HotelAvailNotifRS / @EchoToken 1 string Unikalny identyfikator powiązany z wiadomością OTA_HotelAvailNotifRQ.
    OTA_HotelAvailNotifRS / Success 0..1 Success Wskazuje, że wiadomość OTA_HotelAvailNotifRQ została przetworzona.

    W każdej wiadomości występuje element <Success> lub <Errors>.
    OTA_HotelAvailNotifRS / Errors 0..1 Errors Kontener dla co najmniej 1 problemu napotkanego podczas przetwarzania wiadomości OTA_HotelAvailNotifRQ.

    W każdej wiadomości występuje element <Success> lub <Errors>.
    OTA_HotelAvailNotifRS / Errors / Error 1..n Error Opis błędu, który wystąpił podczas przetwarzania wiadomości OTA_HotelAvailNotifRQ. Szczegółowe informacje o tych błędach znajdziesz w artykule Komunikaty o błędach w stanie pliku danych.
    OTA_HotelAvailNotifRS / Errors / Error / @Type 1 integer OpenTravel Alliance EWT (Error Warning Type) powiązany z błędem. Używana jest tylko wartość 12 (Processing exception).
    OTA_HotelAvailNotifRS / Errors / Error / @Code 1 integer ERR (kod błędu) OpenTravel Alliance powiązany z błędem. Używana jest tylko wartość 450 (Unable to process).
    OTA_HotelAvailNotifRS / Errors / Error / @Code 1 enum Stan pierwotnego żądania. Używana jest tylko wartość NotProcessed.
    OTA_HotelAvailNotifRS / Errors / Error / @ShortText 1 string Identyfikator problemu w Google. Szczegółowe informacje o tych błędach znajdziesz w artykule Komunikaty o błędach w stanie pliku danych.

    Przykłady

    Sukces

    Poniżej znajduje się odpowiedź na pomyślnie przetworzone wiadomość OTA_HotelAvailNotifRQ.

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Success/>
</OTA_HotelAvailNotifRS>

    Błędy

    Poniżej znajduje się odpowiedź na wiadomość OTA_HotelAvailNotifRQ, która nie została przetworzona z powodu błędów.

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelAvailNotifRS>