OTA_HotelAvailNotifRQ

Żądania

Składnia

Komunikat OTA_HotelAvailNotifRQ ma taką 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żdy komunikat <OTA_HotelAvailNotifRQ> jest traktowany jako aktualizacja delta. W przypadku poszczególnych właściwości, dat, sal i pakietów określonych w zasadzie <StatusApplicationControl> aktualizacja dowolnego wcześniej zdefiniowanego ograniczenia zastępuje tylko wartość tego samego ograniczenia, podczas gdy dodanie nowego ograniczenia nie wpływa na inne wcześniej zdefiniowane ograniczenia. Jeśli na przykład wcześniej zdefiniowano minimalną długość pobytu na 2 dni, a potem została zaktualizowana nowa wiadomość zawierająca tylko maksymalny okres pobytu na 7 dni, to działanie nie spowoduje usunięcia wcześniejszej 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 oddzielnie. Na przykład wiadomość, która ustawia SetMaxLOS, nie zastępuje wcześniej zdefiniowanej wartości dla SetForwardMaxStay.

Element / @Atrybut	Wystąpienia	Typ	Opis
OTA_HotelAvailNotifRQ	1	Complex element	Główny element 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 - (łą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 na potrzeby tej wiadomości. Jest on zwykle używany, gdy Twój backend dostarcza pliki danych z cenami dla wielu kont partnerów.
OTA_HotelAvailNotifRQ / POS/ Source	1	Source	Wymagane, jeśli występuje <POS>. Kontener dla: <RequestorID>.
OTA_HotelAvailNotifRQ / POS / RequestorID	1	RequestorID	Wymagany, jeśli występuje <POS>. Określa konto partnera.
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID	1	string	Konto partnera, z którego pochodzi ta 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 odpowiadać wartości atrybutu partner komunikatu transakcji (dane właściwości) 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ą elementu <id> w elemencie <listing> w pliku danych z listą hoteli. Identyfikator hotelu jest też podany 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 czasu w przypadku jednej usługi.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit	1	integer	Uwaga: komunikat OTA_HotelInvCountNotifRQ jest preferowany zamiast ustawiania tego atrybutu. Liczba pozostałych sal, które można zarezerwować w wybranym zakresie dat (<StatusApplicationControl>). Jeśli określono BookingLimit, <StatusApplicationControl> musi zawierać wartość InvTypeCode, a <AvailStatusMessage> nie może zawierać <LengthOfStay> ani <RestrictionStatus>. Wartość nie może być mniejsza niż 0. Jeśli nie podano wartości ujemnej lub nie podano żadnej wartości, domyślna wartość to 0. Uwaga: aby można było określić dostępność pokoju dla danego ustawienia <StatusApplicationControl>, atrybut BookingLimit musi zostać 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 określona na podstawie strefy czasowej usługi obejmującej 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ść nie może być mniejsza niż wartość start. Jeśli wartości start i end są równe, aktualizacja zostanie zastosowana do wybranego dnia.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon	0..1	boolean	Ustaw jako true lub 1, aby uwzględniać poniedziałki. Jeśli ma wartość true, inne dni tygodnia, które nie mają wartości „prawda”, są wykluczane (w efekcie są odfiltrowywane z dat podanych w argumencie Start and End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue	0..1	boolean	Ustaw jako true lub 1, by uwzględnić wtorki. Jeśli ma wartość true, pozostałe dni tygodnia, które nie mają przypisanej wartości true, są wykluczane (w efekcie są odfiltrowywane z dat podanych w parametrach Start i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds	0..1	boolean	Ustaw jako true lub 1, by uwzględnić środy. Jeśli ma wartość true, pozostałe dni tygodnia, które nie mają przypisanej wartości true, są wykluczane (w efekcie są odfiltrowywane z dat podanych w parametrach Start i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur	0..1	boolean	Aby uwzględniać czwartki, ustaw wartość true lub 1. Jeśli ma wartość true, pozostałe dni tygodnia, które nie mają przypisanej wartości true, są wykluczane (w efekcie są odfiltrowywane z dat podanych w parametrach Start i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri	0..1	boolean	Ustaw jako true lub 1, aby uwzględnić piątki. Jeśli ma wartość true, pozostałe dni tygodnia, które nie mają przypisanej wartości true, są wykluczane (w efekcie są odfiltrowywane z dat podanych w parametrach 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 ma wartość true, pozostałe dni tygodnia, które nie mają przypisanej wartości true, są wykluczane (w efekcie są odfiltrowywane z dat podanych na początku i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun	0..1	boolean	Ustaw jako true lub 1, aby uwzględniać niedziele. Jeśli ma wartość true, pozostałe dni tygodnia, które nie mają przypisanej wartości true, są wykluczane (w efekcie są odfiltrowywane z dat podanych w parametrach Start i End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode	1	string	Unikalny identyfikator zasobów reklamowych (typ pomieszczenia). Ta wartość jest mapowana na <RoomID> w komunikacie Transakcje (dane usługi).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode	0..1	string	Unikalny identyfikator abonamentu. Ten identyfikator jest mapowany na wartość <PackageID> w komunikacie transakcji (dane usługi). Plan stawek jest szczegółowo zdefiniowany i przywołany w <StatusApplicationControl> zarówno w komunikatach <OTA_HotelRateAmountNotifRQ>, jak i <OTA_HotelAvailNotifRQ>. Atrybut RatePlanCode nie ma zastosowania i nie należy go określać, gdy <AvailStatusMessage> zawiera atrybut BookingLimit. Wartość ta musi być określona, jeśli podano <RestrictionStatus> lub <LengthOfStay>.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay	0..1	LengthsOfStay	Kontener do definiowania ograniczeń LOS. Nie może być określony, jeśli <AvailStatusMessage> zawiera atrybut BookingLimit.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength	0..1	integer	Długość wzorca zdefiniowanego w polu FullPatternLOS. Uwaga: ten atrybut należy ustawić, jeśli używasz atrybutu MinMaxMessageType="FullPatternLOS". W przeciwnym razie 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 mieć inną wartość MinMaxMessageType.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time	0..1	integer	Wartość jednostkowa pomiaru długości pobytu. Pamiętaj, że wartość zerowa jest traktowana jako brak ograniczenia. 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 MinMaxMessageType="FullPatternLOS".
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit	0..1	enum	Jednostka czasu. Jeśli nie zostanie podana, domyślna wartość to "Day". Prawidłowa wartość to: Day Uwaga: 1 apartament "Day" kosztuje 1 nocleg.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType	1	enum	Różne rodzaje ograniczeń dotyczących długości pobytu. SetMaxLOS, SetMinLOS i FullPatternLOS są zależne od przyjazdu. Jednostki organizacyjne SetForwardMinStay i SetForwardMaxStay są objęte pobytem. Wartości maksymalne muszą być większe od wartości minimalnych lub 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 występować, jeśli stosowana jest właściwość MinMaxMessageType="FullPatternLOS". W przeciwnym razie go nie będzie.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS	1	string	Sekwencja znaków Y i N wskazująca, czy dozwolona jest każda długość pobytu – od jednej nocy do wartości z pola FixedPatternLength. Długość pobytu większa niż FixedPatternLength dziedziczy wartość w pozycji końcowej. 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 planu podróży. Nie może być określony, jeśli <AvailStatusMessage> zawiera atrybut BookingLimit.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status	0..1	enum	Wskazuje, czy ograniczenie określone w atrybucie Restriction jest otwarte czy zamknięte. 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ć za pomocą opcji „Domyślna dostępność” w ustawieniach cen w Hotel Center. Wartość „Zamknięta” w Hotel Center odpowiada tej wartości Close. Ustawienie Master na Close jest nazywane „przerwaniem 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ść uniemożliwia plany podróży z datą zameldowania w zakresie dat Start i End (włącznie). Departure: Ta wartość zapobiega planom podróży z datą wymeldowania w zakresie dat Start i End (włącznie). Master: Ta wartość wskazuje, czy stawka za pokój jest dostępna w danym dniu. Uwaga: jeśli Restriction nie jest 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 (według lokalnego czasu hotelu), w którym można zarezerwować tę stawkę za pokój. Prawidłowe typy wartości to: Integer: Liczba dni przed datą przybycia. Na przykład wartość 1 oznacza, że stawkę za pokój należy zarezerwować co najmniej 1 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 godziny/minuty) przed datą przybycia. Na przykład wartość P1D oznacza, że stawkę za pokój należy zarezerwować na 1 dzień przed datą przyjazdu. Wartość P0DT6H oznacza, że rezerwacja musi się odbyć 6 godzin przed 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 hotelu), w którym można zarezerwować tę stawkę za pokój. Prawidłowe typy wartości to: Integer: Liczba dni przed datą przybycia. Na przykład wartość 30 oznacza, że stawki za pokój nie można zarezerwować wcześniej niż na 30 dni przed datą przyjazdu. Wartość 0 (wartość domyślna) oznacza brak ograniczenia dotyczącego najwcześniejszego czasu rezerwacji. ISO 8601 Duration (days, hours, and minutes): Liczba dni (i opcjonalnie godziny lub minuty) przed datą przybycia. Na przykład wartość P30D oznacza, że stawki za pokój nie można zarezerwować wcześniej niż na 30 dni przed datą przyjazdu. Wartość P30DT6H oznacza, że rezerwacja nie może nastąpić wcześniej niż do 18:00, na 30 dni przed datą przyjazdu.

Przykłady

Data przybycia do 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 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>

Ograniczenie odlotu

Ustaw ograniczenie dla niedostępności materiału odjazdowego. (Uniemożliwia to realizację 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 dostępności. (w ten sposób unikniesz planów z zameldowaniem się 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

Dostępność dla danego typu pokoju i abonamentu w określonych dniach.

Uwaga: zanim ceny będą w pełni dostępne, wymagane są również stawki za noc i liczba zasobów reklamowych większa niż 0.

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

Zamknięcie dostępności dla danego typu pokoju i abonamentu w określonych dniach. (Jest to tak zwane „stopnie 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 wcześniejszej rezerwacji

Ustaw minimalne i maksymalne okresy rezerwacji z wyprzedzeniem 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

Ostateczny termin rezerwacji w dniu przyjazdu o 18:00 według lokalnego czasu 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ń

W przypadku danego typu pokoju i abonamentu możesz ustawić wiele ograniczeń dotyczących tych samych dat.

<?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 jest określony, domyślną wartością jest Master.

Limit rezerwacji

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

Uwaga: komunikat OTA_HotelInvCountNotifRQ jest preferowany zamiast ustawiania 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 przypadku zameldowania się 26 lipca 2023 r. można zameldować się tylko dla 2, 4 i 6 osób. Dane dotyczące długości pobytu 1, 3, 5 i 7 lub 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

Komunikat OTA_HotelAvailNotifRS ma taką 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 / @Atrybut	Wystąpienia	Typ	Opis
OTA_HotelAvailNotifRS	1	Complex element	Element główny odpowiedzi na komunikat o dostępności.
OTA_HotelAvailNotifRS / @TimeStamp	1	DateTime	Data i godzina utworzenia tej wiadomości.
OTA_HotelAvailNotifRS / @EchoToken	1	string	Unikalny identyfikator powiązanej wiadomości OTA_HotelAvailNotifRQ.
OTA_HotelAvailNotifRS / Success	0..1	Success	Wskazuje, że komunikat OTA_HotelAvailNotifRQ został przetworzony. Każda wiadomość zawiera element <Success> lub <Errors>.
OTA_HotelAvailNotifRS / Errors	0..1	Errors	Kontener rozwiązania co najmniej jednego problemu, który wystąpił podczas przetwarzania wiadomości OTA_HotelAvailNotifRQ. Każda wiadomość zawiera element <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 artykule Komunikaty o błędach stanu pliku danych.
OTA_HotelAvailNotifRS / Errors / Error / @Type	1	integer	Obiekt OpenTravel Alliance EWT (Error Warning Type) dotyczący błędu, który jest powiązany z błędem. Używana jest tylko wartość 12 (Processing exception).
OTA_HotelAvailNotifRS / Errors / Error / @Code	1	integer	Kod błędu OpenTravel Alliance ERR (kod błędu). Używana jest tylko wartość 450 (Unable to process).
OTA_HotelAvailNotifRS / Errors / Error / @Code	1	enum	Stan pierwotnej prośby. Używana jest tylko wartość NotProcessed.
OTA_HotelAvailNotifRS / Errors / Error / @ShortText	1	string	Identyfikator Google problemu. Szczegółowe informacje o tych błędach znajdziesz w artykule Komunikaty o błędach stanu pliku danych.

Przykłady

Gotowe

Poniżej znajdziesz odpowiedź na 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>