OTA_HotelAvailNotifRQ

İstekler

Söz dizimi

OTA_HotelAvailNotifRQ mesajında şu söz dizimi kullanılır:

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

Önemli Nokta: Her <OTA_HotelAvailNotifRQ> mesajı bir delta güncellemesi olarak ele alınır. <StatusApplicationControl> politikasında belirtilen her tesis, tarih, oda ve paket için önceden tanımlanmış herhangi bir kısıtlamanın güncellenmesi yalnızca aynı kısıtlamanın değerinin yerini alır. Yeni kısıtlama eklenmesi ise önceden tanımlanmış diğer kısıtlamaları etkilemez. Örneğin, 2 gün için minimum konaklama süresi önceden tanımlanmışsa ve ardından yalnızca 7 gün için maksimum konaklama süresini içeren yeni bir mesaj güncellendiğinde bu işlem, önceki minimum konaklama süresi değerini silmez.

Öğeler ve Özellikler

OTA_HotelAvailNotifRQ mesajında aşağıdaki öğeler ve özellikler bulunur:

Not: Her konaklama süresi kısıtlaması türü bağımsız olarak ayarlanır. Örneğin, SetMaxLOS değerini ayarlayan bir mesaj SetForwardMaxStay için önceden tanımlanmış bir değerin üzerine yazılmaz.

Öğe / @Özellik	Yineleme sayısı	Tür	Açıklama
OTA_HotelAvailNotifRQ	1	Complex element	Oda fiyatının müsaitlik durumunu tanımlayan bir mesajın kök öğesidir.
OTA_HotelAvailNotifRQ / @xmlns	0..1	string (URI)	XML ad alanıdır.
OTA_HotelAvailNotifRQ / @EchoToken	1	string	Bu istek mesajının benzersiz tanımlayıcısıdır. Bu değer, yanıt mesajında döndürülür. İzin verilen karakterler a-z, A-Z, 0-9, _ (alt çizgi) ve - (kısa çizgi) şeklindedir.
OTA_HotelAvailNotifRQ / @TimeStamp	1	DateTime	Bu mesajın oluşturulma tarihi ve saatidir.
OTA_HotelAvailNotifRQ / @Version	1	decimal	OpenTravel mesaj sürümüdür.
OTA_HotelAvailNotifRQ / POS	0..1	POS	Bu mesaj için iş ortağı hesabını belirten kapsayıcıdır. Genellikle arka ucunuz birden fazla iş ortağı hesabı için fiyat feed'leri sağlıyorsa kullanılır.
OTA_HotelAvailNotifRQ / POS/ Source	1	Source	<POS> mevcutsa gereklidir. <RequestorID> öğesinin kapsayıcısıdır.
OTA_HotelAvailNotifRQ / POS / RequestorID	1	RequestorID	<POS> mevcutsa gereklidir. İş ortağı hesabını tanımlar.
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID	1	string	Bu mesajın iş ortağı hesabıdır. Bu dize değeri, Hotel Center'ın Hesap ayarları sayfasında listelenen Partner key değeridir. Not: Birden fazla hesap için feed sağlayan bir arka ucunuz varsa bu değerin Transaction (Tesis Verileri) mesajınızın partner özellik değeri ve aynı hesap için <OTA_HotelRateAmountNotifRQ> mesajınızın <RequestorID> öğesindeki ID özellik değeriyle eşleşmesi gerekir.
OTA_HotelAvailNotifRQ / AvailStatusMessages	1	AvailStatusMessages	Bir veya daha fazla <AvailStatusMessage> öğesinin kapsayıcısıdır.
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode	1	string	Tesisin benzersiz tanımlayıcısıdır. Bu değer, Otel Listesi Feed'indeki <listing> öğesinde <id> kullanılarak belirtilen Otel Kimliği ile eşleşmelidir. Otel Kimliği, Hotel Center'da da listelenir.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage	1..n	AvailStatusMessage	Tek bir tesisin farklı zaman aralıklarındaki oda fiyatı kullanılabilirliğini ve kısıtlamalarını tanımlar.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit	1	integer	Not: Bu özelliğin ayarlanması yerine OTA_HotelInvCountNotifRQ mesajı tercih edilir. <StatusApplicationControl> öğesindeki tarih aralığında rezervasyon yapılabilecek kalan oda sayısıdır. BookingLimit belirtilirse <StatusApplicationControl>, InvTypeCode öğesini belirtmelidir ve <AvailStatusMessage>, <LengthOfStay> veya <RestrictionStatus> içeremez. 0'a eşit veya 0'dan büyük olmalıdır. Negatifse veya sağlanmamışsa varsayılan olarak 0'dır. Not: Belirli bir <StatusApplicationControl> ayarında odanın müsaitlik durumunu belirlemek için BookingLimit özelliğinin en az bir kez ayarlanması gerekir.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl	1	StatusApplicationControl	InvTypeCode ve ücret planı (RatePlanCode) oda türü tanımlayıcılarının yanı sıra tarih aralığını tanımlar.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start	1	Date	Tesisin, tarih aralığını kapsayan saat dilimine dayalı başlangıç tarihi.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End	1	Date	Tarih aralığı dahil olmak üzere bitiş tarihidir (tesisin bulunduğu saat dilimine göre). start değerine eşit veya ondan büyük olmalıdır. start ve end eşitse güncelleme ilgili tarihe uygulanır.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon	0..1	boolean	Pazartesi günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın. true olarak ayarlanırsa haftanın açıkça "true" olarak ayarlanmayan diğer günleri hariç tutulur (geçerli olduğunda Start and End). içindeki tarihlerden filtrelenir.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue	0..1	boolean	Salı günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın. true olarak ayarlanırsa haftanın açıkça true olarak ayarlanmayan diğer günleri hariç tutulur (geçerli olduğunda Start ve End içindeki tarihlerden filtrelenir).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds	0..1	boolean	Çarşamba günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın. true olarak ayarlanırsa haftanın açıkça true olarak ayarlanmayan diğer günleri hariç tutulur (geçerli olduğunda Start ve End içindeki tarihlerden filtrelenir).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur	0..1	boolean	Perşembe günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın. true olarak ayarlanırsa haftanın açıkça true olarak ayarlanmayan diğer günleri hariç tutulur (geçerli olduğunda Start ve End içindeki tarihlerden filtrelenir).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri	0..1	boolean	Cuma günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın. true olarak ayarlanırsa haftanın açıkça true olarak ayarlanmayan diğer günleri hariç tutulur (geçerli olduğunda Start ve End içindeki tarihlerden filtrelenir).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat	0..1	boolean	Cumartesi günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın. true olarak ayarlanırsa haftanın açıkça true olarak ayarlanmayan diğer günleri hariç tutulur (geçerli olduğunda Başlangıç ve End içindeki tarihlerden filtrelenir).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun	0..1	boolean	Pazar günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın. true olarak ayarlanırsa haftanın açıkça true olarak ayarlanmayan diğer günleri hariç tutulur (geçerli olduğunda Start ve End içindeki tarihlerden filtrelenir).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode	1	string	Envanterin benzersiz tanımlayıcısıdır (oda türü). Bu değer, Transaction (Tesis Verileri) mesajlarındaki <RoomID> ile eşlenir.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode	0..1	string	Ücret planının benzersiz tanımlayıcısıdır. Bu tanımlayıcı, Transaction (Tesis Verileri) mesajlarındaki <PackageID> değeriyle eşlenir. Ücret planı, hem <OTA_HotelRateAmountNotifRQ> hem de <OTA_HotelAvailNotifRQ> mesajlarındaki <StatusApplicationControl> öğesinde ayrıntılı olarak tanımlanır ve belirtilir. <AvailStatusMessage>, BookingLimit özelliğini içerdiğinde RatePlanCode özelliği geçerli olmaz ve belirtilmemelidir. <RestrictionStatus> veya <LengthOfStay> belirtilirse belirtilmelidir.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay	0..1	LengthsOfStay	LOS kısıtlamalarını tanımlayan kapsayıcıdır. <AvailStatusMessage>, BookingLimit özelliğini içeriyorsa bu öğe kullanılmamalıdır.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength	0..1	integer	FullPatternLOS içinde tanımlanan kalıbın uzunluğu. Not: Bu özellik, MinMaxMessageType="FullPatternLOS" kullanılırken ayarlanmalı, aksi takdirde kullanılmamalıdır.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay	1..n	LengthOfStay	Konaklama süresine ilişkin kısıtlamaları tanımlar. Birden fazla <LengthOfStay> öğesi kullanırken her birinin farklı bir MinMaxMessageType değeri belirtmesi gerekir.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time	0..1	integer	Konaklama süresi ölçümünün birim değeridir. Değerin sıfır olarak kabul edildiğini unutmayın. Örneğin <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS">, maksimum konaklama süresinin olmadığı anlamına gelir. Not: MinMaxMessageType="FullPatternLOS" kullanılmıyorsa bu özellik ayarlanmalıdır.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit	0..1	enum	Zaman birimidir. Sağlanmazsa varsayılan olarak "Day" değerine ayarlanır. Geçerli değer: Day Not: Bir "Day" birimi, 1 gece konaklamaya eşittir.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType	1	enum	Konaklama süresi kısıtlamalarının çeşitli türleridir. SetMaxLOS, SetMinLOS ve FullPatternLOS varış tarihini temel alır. SetForwardMinStay ve SetForwardMaxStay konaklama süresini temel alır. Maksimum değerler, minimum değerlerden büyük veya bu değerlere eşit olmalıdır.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern	0..1	LOS_Pattern	Konaklama kısıtlaması kalıbının uzunluğunu tanımlar. Not: Bu öğe, MinMaxMessageType="FullPatternLOS" kullanılırken mevcut olmalı, aksi takdirde kullanılmamalıdır.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS	1	string	Bir geceden FixedPatternLength değerindeki değere kadar her konaklama süresine izin verilip verilmediğini gösteren Y ve N karakter dizisi. FixedPatternLength değerinden büyük konaklama süreleri son konumdaki değeri devralır. Örneğin, FixedPatternLength="4" ve FullPatternLOS="YNYN" için yalnızca konaklama süresi 1 ve 3'e izin verilir.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus	0..1	RestrictionStatus	Seyahat planı kısıtlamalarını tanımlar. <AvailStatusMessage>, BookingLimit özelliğini içeriyorsa bu öğe kullanılmamalıdır.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status	0..1	enum	Restriction özelliği tarafından belirtilen kısıtlama türünün açık mı yoksa kapalı mı olduğunu belirtir. Geçerli değerler şunlardır: Open Close Not: Google, varsayılan olarak tüm ürünler için Master ayarının Close olduğunu varsayar. Bunu, Hotel Center fiyatlandırma ayarlarındaki "Varsayılan müsaitlik durumunuz" aracılığıyla yapılandırabilirsiniz. Hotel Center'daki "Closed" değeri, buradaki Close değerine karşılık gelir. Master öğesinin Close değerine ayarlanması "satışı durdurma" olarak bilinir.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction	0..1	enum	Status sağlanırsa bu özellik gereklidir. Valid values are: Arrival: Bu değer, Start ve End tarih aralığı dahil olmak üzere check-in tarihine sahip seyahat planlarını önler. Departure: Bu değer, Start ve End tarih aralığında (iki tarih de dahil) çıkış yapma tarihine sahip seyahat planlarını önler. Master: Bu değer, oda fiyatının belirtilen tarihte rezervasyon için uygun olup olmadığını gösterir. Not: Restriction belirtilmezse varsayılan değer Master olur.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset	0..1	integer or duration	Bu oda fiyatından rezervasyon yapabilmek için varış tarihinden önceki minimum süredir (tesisin yerel saatine göre). Geçerli değer türleri şunlardır: Integer: Varış tarihinden önceki gün sayısıdır. Örneğin, 1 değeri, oda fiyatının varış tarihinden en az bir gün önce rezerve edilmesi gerektiğini belirtir. 0 değeri (varsayılan değer), en son rezervasyon zamanıyla ilgili kısıtlama olmadığını gösterir. ISO 8601 Duration (days, hours, and minutes): Varış tarihinden önceki gün sayısıdır (ve isteğe bağlı olarak saat/dakika). Örneğin, P1D değeri, oda fiyatının varış tarihinden bir gün önce rezerve edilmesi gerektiğini belirtir. P0DT6H değeri, rezervasyonun varış tarihi bitiminden altı saat önce (ör. 18:00) veya daha erken yapılması gerektiğini belirtir.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset	0..1	integer or duration	Bu oda fiyatından rezervasyon yapabilmek için varış tarihinden önceki maksimum süredir (tesisin yerel saatine göre). Geçerli değer türleri şunlardır: Integer: Varış tarihinden önceki gün sayısıdır. Örneğin, 30 değeri, oda fiyatının varış tarihinden en fazla 30 gün önce rezerve edilebileceğini belirtir. 0 değeri (varsayılan değer), en erken rezervasyon zamanı için kısıtlama olmadığını gösterir. ISO 8601 Duration (days, hours, and minutes): Varış tarihinden önceki gün sayısıdır (ve isteğe bağlı olarak saat/dakika cinsinden). Örneğin, P30D değeri, oda fiyatının varış tarihinden en fazla 30 gün önce rezerve edilebileceğini belirtir. P30DT6H değeri, rezervasyonun varış tarihinden 30 gün önce 18:00'dan önce yapılamayacağını belirtir.

Örnekler

KS varış tarihi

Minimum ve maksimum konaklama süreleri belirleme (varış tarihine göre).

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

KS süresi

Minimum ve maksimum konaklama süreleri belirleme (konaklama süresine göre).

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

Kalkış kısıtlaması

Gidiş kapalı kısıtlaması ayarlayın. (Bu, belirtilen tarihlerde çıkış yapılan seyahat planlarını engeller.)

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

Varış Kısıtlaması

"Varış kapalı" kısıtlaması ayarlayın. (Bu, belirtilen tarihlerde check-in yapılan seyahat planlarını engeller.)

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

Kullanıma sunulma tarihleri açık

Belirtilen tarihlerde oda türü ve ücret planı için müsaitlik durumunu açın.

Not: Fiyatlar tamamen kullanıma sunulmadan önce gecelik ücretlerle birlikte oda türü için 0'dan büyük bir envanter sayısı belirtilmesi gerekir.

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

Satın alınabileceği tarihleri kapat

Belirtilen tarihlerde oda türü ve ücret planı için müsaitlik durumu kapatma. (Buna "satış durdurma" da denir.)

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

Erken rezervasyon kısıtlamaları

Yalnızca hafta sonları uygulanan minimum ve maksimum ön rezervasyon aralığı kısıtlamalarını ayarlayın.

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

Son sipariş saati

Varış tarihinde otelin yerel saatiyle 18:00'de rezervasyon için son sipariş saati uygulanır.

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

Birden çok kısıtlama

Bir oda türü ve ücret planı için aynı tarihlerde birden fazla kısıtlama ayarlama.

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

Not: Restriction belirtilmezse varsayılan değer Master olur.

Rezervasyon sınırı

Belirtilen tarihler arasında bir oda türü için envanter sayılarını ayarlayın.

Not: Bu özelliğin ayarlanması yerine OTA_HotelInvCountNotifRQ mesajı tercih edilir.

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

Tam kalıp konaklama süresi kısıtlaması ayarlayın.

26 Temmuz 2023 tarihinde check-in yapmak için yalnızca 2, 4 ve 6 konaklama süresine izin verilir. 1, 3, 5 ve 7+ konaklama süreleri mevcut değil.

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

Yanıtlar

Söz dizimi

OTA_HotelAvailNotifRS mesajında şu söz dizimi kullanılır:

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

Öğeler ve Özellikler

OTA_HotelAvailNotifRS mesajında aşağıdaki öğeler ve özellikler bulunur:

Öğe / @Özellik	Yineleme sayısı	Tür	Açıklama
OTA_HotelAvailNotifRS	1	Complex element	Müsaitlik durumu mesajı yanıtının kök öğesidir.
OTA_HotelAvailNotifRS / @TimeStamp	1	DateTime	Bu mesajın oluşturulma tarihi ve saatidir.
OTA_HotelAvailNotifRS / @EchoToken	1	string	İlişkilendirilmiş OTA_HotelAvailNotifRQ mesajındaki benzersiz tanımlayıcıdır.
OTA_HotelAvailNotifRS / Success	0..1	Success	OTA_HotelAvailNotifRQ mesajının başarıyla işlendiğini belirtir. Her mesajda <Success> veya <Errors> bulunur.
OTA_HotelAvailNotifRS / Errors	0..1	Errors	OTA_HotelAvailNotifRQ mesajı işlenirken karşılaşılan bir veya daha fazla sorun için kullanılan bir kapsayıcıdır. Her mesajda <Success> veya <Errors> bulunur.
OTA_HotelAvailNotifRS / Errors / Error	1..n	Error	OTA_HotelAvailNotifRQ mesajı işlenirken karşılaşılan hatanın açıklamasıdır. Bu hatalarla ilgili ayrıntılar Feed Durumu Hata Mesajları konusunda bulunabilir.
OTA_HotelAvailNotifRS / Errors / Error / @Type	1	integer	Hatayla ilişkili OpenTravel Alliance EWT (Hata Uyarı Türü) öğesidir. Yalnızca 12 (Processing exception) değeri kullanılır.
OTA_HotelAvailNotifRS / Errors / Error / @Code	1	integer	Hatayla ilişkili OpenTravel Alliance ERR (Hata Kodu). Yalnızca 450 (Unable to process) değeri kullanılır.
OTA_HotelAvailNotifRS / Errors / Error / @Code	1	enum	Orijinal isteğin durumudur. Yalnızca NotProcessed değeri kullanılır.
OTA_HotelAvailNotifRS / Errors / Error / @ShortText	1	string	Sorunun Google tanımlayıcısıdır. Bu hatalarla ilgili ayrıntılar Feed Durumu Hata Mesajları konusunda bulunabilir.

Örnekler

Başarılı

Aşağıda, başarıyla işlenmiş bir OTA_HotelAvailNotifRQ mesajına yanıt yer almaktadır.

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

Hatalar

Aşağıda, hatalar nedeniyle işlenmemiş bir OTA_HotelAvailNotifRQ mesajına yanıt yer almaktadır.

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