OTA_HotelAvailNotifRQ

Prośby

Składnia

Komunikat OTA_HotelAvailNotifRQ używa następującej 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>

Ważne: każda wiadomość <OTA_HotelAvailNotifRQ> jest traktowana jako aktualizacja zmian. Zmiana dowolnego wcześniej zdefiniowanego ograniczenia w przypadku każdej właściwości, daty, pokoju i pakietu zastępuje tylko wartość tego samego ograniczenia. Dodanie nowego ograniczenia nie ma wpływu na inne wcześniej zdefiniowane ograniczenia.<StatusApplicationControl> Jeśli na przykład wcześniej zdefiniowano minimalną długość pobytu na 2 dni, a potem została zaktualizowana nowa wiadomość zawierająca wyłącznie maksymalny czas pobytu na 7 dni, to działanie nie spowoduje usunięcia poprzedniej minimalnej wartości pobytu.

Elementy i atrybuty

Komunikat OTA_HotelAvailNotifRQ ma te elementy i atrybuty:

Uwaga: każdy rodzaj ograniczenia długości pobytu jest ustalany oddzielnie. Na przykład komunikat ustawiający SetMaxLOS nie zastępuje wcześniej zdefiniowanej wartości SetForwardMaxStay.

Element / @Atrybut	Wystąpienia	Typ	Opis
OTA_HotelAvailNotifRQ	1	Complex element	Element główny wiadomości, który określa dostępność stawki za pokój.
OTA_HotelAvailNotifRQ / @xmlns	0..1	string (URI)	Przestrzeń nazw XML.
OTA_HotelAvailNotifRQ / @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_HotelAvailNotifRQ / @TimeStamp	1	DateTime	Data i godzina utworzenia tej wiadomości.
OTA_HotelAvailNotifRQ / @Version	1	decimal	Wersja komunikatu OpenTravel.
OTA_HotelAvailNotifRQ / POS	0..1	POS	Kontener służący do określania konta partnera dla tej wiadomości. Zwykle jest używany, gdy backend dostarcza pliki danych z cenami dla wielu kont partnerów.
OTA_HotelAvailNotifRQ / POS/ Source	1	Source	Wymagane, jeśli podano <POS>. Kontener na <RequestorID>.
OTA_HotelAvailNotifRQ / POS / RequestorID	1	RequestorID	Wymagane, jeśli podano <POS>. Definiuje konto partnera.
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID	1	string	Konto partnera, do którego należy ta wiadomość. Jest to wartość Partner key 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 partner komunikatu transakcji (dane usługi) i wartością atrybutu ID w elemencie <RequestorID> komunikatu <OTA_HotelRateAmountNotifRQ> dla tego samego konta.
OTA_HotelAvailNotifRQ / AvailStatusMessages	1	AvailStatusMessages	Kontener na co najmniej 1 element <AvailStatusMessage>.
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode	1	string	Unikalny identyfikator usługi. Ta wartość musi być zgodna z identyfikatorem hotelu określonym za pomocą parametru <id> w elemencie <listing> w pliku danych z listą hoteli. Identyfikator hotelu znajdziesz też w Hotel Center.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage	1..n	AvailStatusMessage	Określa dostępność stawki za pokój i ograniczenia dla różnych przedziałów czasowych w jednej usłudze.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit	1	integer	Uwaga: zamiast ustawiania tego atrybutu lepiej będzie używać komunikatu OTA_HotelInvCountNotifRQ. Liczba pozostałych sal, które można zarezerwować na zakres dat w miesiącu: <StatusApplicationControl>. Jeśli jest określony BookingLimit, <StatusApplicationControl> musi określać wartość InvTypeCode, a <AvailStatusMessage> nie może zawierać <LengthOfStay> ani <RestrictionStatus>. Wartość nie może być mniejsza niż 0. W przypadku wartości ujemnej lub niepodanej domyślnie przyjmuje wartość 0. Uwaga: aby określić dostępność sal 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 abonamentu – RatePlanCode.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start	1	Date	Data rozpoczęcia oparta na strefie czasowej usługi, która obejmuje zakres dat.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End	1	Date	Data zakończenia (na podstawie strefy czasowej usługi) włącznie z zakresem dat. Wartość musi być równa lub większa od wartości start. Jeśli wartości start i end są równe, aktualizacja dotyczy tej daty.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon	0..1	boolean	Ustaw jako true lub 1, aby wyraźnie uwzględniać poniedziałki. Jeśli ma wartość true, inne dni tygodnia, które nie mają wartości prawda, są wykluczane (dzięki temu są odfiltrowywane z dat w funkcji Start and End).).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue	0..1	boolean	Ustaw jako true lub 1, aby jawnie uwzględniać wtorki. Jeśli zasada ma wartość true, inne dni tygodnia, które nie mają wartości true, są wykluczane (dzięki temu są odfiltrowywane z dat podanych w polach Start i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds	0..1	boolean	Aby wyraźnie uwzględniać środy, ustaw wartość true lub 1. Jeśli zasada ma wartość true, inne dni tygodnia, które nie mają wartości true, są wykluczane (dzięki temu są odfiltrowywane z dat podanych w polach Start i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur	0..1	boolean	Ustaw jako true lub 1, aby jawnie uwzględniać czwartki. Jeśli zasada ma wartość true, inne dni tygodnia, które nie mają wartości true, są wykluczane (dzięki temu są odfiltrowywane z dat podanych w polach Start i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri	0..1	boolean	Ustaw jako true lub 1, aby wyraźnie uwzględniać piątki. Jeśli zasada ma wartość true, inne dni tygodnia, które nie mają wartości true, są wykluczane (dzięki temu są odfiltrowywane z dat podanych w polach Start i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat	0..1	boolean	Ustaw jako true lub 1, aby wyraźnie uwzględnić soboty. Jeśli ustawisz wartość true, inne dni tygodnia, które nie mają wartości true, zostaną wykluczone (dzięki temu będą odfiltrowywane z dat w polach Początek i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun	0..1	boolean	Ustaw jako true lub 1, aby wyraźnie uwzględniać niedziele. Jeśli zasada ma wartość true, inne dni tygodnia, które nie mają wartości true, są wykluczane (dzięki temu są odfiltrowywane z dat podanych w polach Start i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode	1	string	Unikalny identyfikator zasobów reklamowych (typ sali). Ta wartość jest mapowana na <RoomID> w komunikacie Transakcje (dane usługi).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode	0..1	string	Unikalny identyfikator planu stawek. Ten identyfikator jest mapowany na wartość <PackageID> w wiadomości transakcji (dane usługi). Abonament jest dokładniej zdefiniowany i odwołuje się do niego w opisie <StatusApplicationControl> zarówno w wiadomościach <OTA_HotelRateAmountNotifRQ>, jak i <OTA_HotelAvailNotifRQ>. Atrybut RatePlanCode nie ma zastosowania i nie należy go określać, gdy <AvailStatusMessage> zawiera atrybut BookingLimit. Ta wartość musi być określona, jeśli określono <RestrictionStatus> lub <LengthOfStay>.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay	0..1	LengthsOfStay	Kontener do definiowania ograniczeń LOS. Nie może być podany, jeśli atrybut <AvailStatusMessage> zawiera atrybut BookingLimit.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength	0..1	integer	Długość wzorca zdefiniowanego w polu FullPatternLOS. Uwaga: ten atrybut musi być ustawiony, jeśli używasz atrybutu MinMaxMessageType="FullPatternLOS", a w innym przypadku go nie ma.
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 określać inną wartość MinMaxMessageType.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time	0..1	integer	Wartość jednostkowa miary 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 należy ustawić, chyba że używasz atrybutu MinMaxMessageType="FullPatternLOS".
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit	0..1	enum	Jednostka czasu. Jeśli nie zostanie podany, domyślna wartość to "Day". Prawidłowa wartość to: Day Uwaga: 1 jednostka typu "Day" jest równa 1 noclegowi.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType	1	enum	Różne rodzaje ograniczeń dotyczących długości pobytu. SetMaxLOS, SetMinLOS i FullPatternLOS zależą od przyjazdu. SetForwardMinStay i SetForwardMaxStay są uzależnione od pobytu. Wartości maksymalne muszą być większe od wartości minimalnych lub im równe.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern	0..1	LOS_Pattern	Określa wzorzec ograniczenia długości pobytu. Uwaga: ten element musi być obecny, gdy używa się atrybutu MinMaxMessageType="FullPatternLOS", a w innym przypadku go nie ma.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS	1	string	Sekwencja znaków Y i N wskazujących, czy dozwolona jest każda długość pobytu – od jednej nocy do wartości podanej w polu FixedPatternLength. Każda długość pobytu większa niż FixedPatternLength dziedziczy wartość na ostatniej pozycji. Na przykład w polach 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 być podany, jeśli atrybut <AvailStatusMessage> zawiera atrybut BookingLimit.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status	0..1	enum	Wskazuje, czy rodzaj ograniczenia określony w atrybucie Restriction jest otwarty czy zamknięty. Prawidłowe wartości to: Open Close Uwaga: Domyślnie Google zakłada, że ustawienie Master dla wszystkich usług ma wartość Close. Możesz to skonfigurować w sekcji „Domyślna dostępność” w ustawieniach cen Hotel Center. Wartość „Zamknięte” w Hotel Center odpowiada tu wartości Close. Ustawienie dla elementu Master wartości Close jest nazywane „przerywaniem sprzedaży”.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction	0..1	enum	Ten atrybut jest wymagany, jeśli podano Status. Prawidłowe wartości to: Arrival: Ta wartość zapobiega planom podróży z datą zameldowania przypadającą na zakres dat Start i End włącznie. Departure: Ta wartość zapobiega planom podróży z datą wymeldowania z zakresu dat Start i End włącznie. Master: Ta wartość wskazuje, czy dana stawka za pokój jest dostępna w danym dniu. Uwaga: jeśli Restriction nie został określony, domyślną wartością jest Master.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset	0..1	integer or duration	Minimalny czas trwania przed datą przyjazdu (w lokalnym czasie obiektu), na który można zarezerwować pokój. Prawidłowe typy wartości to: Integer: Liczba dni przed datą przyjazdu. Na przykład wartość 1 oznacza, że stawka za pokój należy zarezerwować co najmniej 1 dzień przed datą przyjazdu. Wartość 0 (wartość domyślna) oznacza brak ograniczeń ostatniej godziny rezerwacji. ISO 8601 Duration (days, hours, and minutes): Liczba dni (i opcjonalnie godziny/minuty) przed datą przyjazdu. Na przykład wartość P1D oznacza, że stawkę za pokój należy zarezerwować na dzień przed datą przyjazdu. Wartość P0DT6H oznacza, że rezerwacja musi nastąpić 6 godzin przed planowaną datą przyjazdu (tj. 18:00) lub wcześniej.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset	0..1	integer or duration	Maksymalny czas trwania przed datą przyjazdu (według lokalnego czasu obiektu), na który można zarezerwować pokój. Prawidłowe typy wartości to: Integer: Liczba dni przed datą przyjazdu. Na przykład wartość 30 oznacza, że stawki za pokój nie można zarezerwować wcześniej niż 30 dni przed datą przyjazdu. Wartość 0 (wartość domyślna) oznacza brak ograniczeń dotyczących najwcześniejszej rezerwacji. ISO 8601 Duration (days, hours, and minutes): Liczba dni (i opcjonalnie godziny/minuty) przed datą przyjazdu. Na przykład wartość P30D oznacza, że stawki za pokój nie można zarezerwować wcześniej niż 30 dni przed datą przyjazdu. Wartość P30DT6H oznacza, że rezerwacja nie może przypadać wcześniej niż 18:00, 30 dni przed datą przyjazdu.

Przykłady

Data przylotu LoS

Ustaw minimalną i maksymalną długość pobytu (w zależności od 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 utraty danych

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

<?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>

Ograniczenia dotyczące wylotów

Ustaw ograniczenie dotyczące czasu odjazdu do momentu dotarcia na miejsce. Zapobiega to realizacji planów podróży z wymeldowaniem w określonych dniach.

<?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 przylotu

Ustaw ograniczenie do czasu przyjazdu. Zapobiega to planom podróży z zameldowaniem w określonych dniach.

<?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>

Otwarte daty dostępności

Otwórz dostępność typu pokoju i abonamentu w określonych dniach.

Uwaga: zanim ceny będą w pełni dostępne, potrzebne są również stawki za noc oraz liczba zasobów reklamowych większa 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ść typu pokoju i abonamentu w określonych dniach. (tzw. „przerwij sprzedaż”).

<?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 wcześniejszej rezerwacji

Ustaw minimalne i maksymalne ograniczenia dotyczące okresu rezerwacji z wyprzedzeniem, które będą stosowane 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>

Ostateczny termin rezerwacji

Zastosuj ostateczny termin rezerwacji od dnia przyjazdu o 18:00 czasu lokalnego.

<?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 wiele ograniczeń w tym samym okresie dla typu pokoju i abonamentu.

<?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>

Uwaga: jeśli Restriction nie został określony, domyślną wartością będzie Master.

Limit rezerwacji

Ustaw liczbę zasobów reklamowych dla danego typu pokoju w określonych dniach.

Uwaga: zamiast ustawiania tego atrybutu preferujemy komunikat OTA_HotelInvCountNotifRQ.

<?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 ograniczenie dotyczące długości pobytu.

W przypadku zameldowania 26 lipca 2023 r. dozwolony jest tylko pobyt 2, 4 lub 6 osób. Długość pobytu 1, 3, 5 i 7+ jest niedostępna.

<?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

Komunikat OTA_HotelAvailNotifRS używa następującej 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

Komunikat OTA_HotelAvailNotifRS ma te elementy i atrybuty:

Element / @Atrybut	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 z powiązanej wiadomości OTA_HotelAvailNotifRQ.
OTA_HotelAvailNotifRS / Success	0..1	Success	Wskazuje, że komunikat OTA_HotelAvailNotifRQ został przetworzony. W każdej wiadomości znajduje się <Success> lub <Errors>.
OTA_HotelAvailNotifRS / Errors	0..1	Errors	Kontener zawierający co najmniej 1 problem napotkany podczas przetwarzania wiadomości OTA_HotelAvailNotifRQ. W każdej wiadomości znajduje się <Success> lub <Errors>.
OTA_HotelAvailNotifRS / Errors / Error	1..n	Error	Opis błędu, który wystąpił podczas przetwarzania komunikatu OTA_HotelAvailNotifRQ. Szczegółowe informacje o tych błędach znajdziesz w sekcji Komunikaty o błędach stanu pliku danych.
OTA_HotelAvailNotifRS / Errors / Error / @Type	1	integer	Identyfikator OpenTravel Alliance EWT (typ ostrzeżenia o błędzie) powiązany z błędem. Używana jest tylko wartość 12 (Processing exception).
OTA_HotelAvailNotifRS / Errors / Error / @Code	1	integer	Błąd ERR (kod błędu) OpenTravel Alliance. 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 Google dotyczący problemu. Szczegółowe informacje o tych błędach znajdziesz w sekcji Komunikaty o błędach stanu pliku danych.

Przykłady

Gotowe

To jest odpowiedź na pomyślnie przetworzony komunikat 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 znajdziesz odpowiedź na komunikat OTA_HotelAvailNotifRQ, który nie został przetworzony 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>