OTA_HotelAvailNotifRQ

İstekler

Söz dizimi

OTA_HotelAvailNotifRQ mesajında aşağıdaki 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ı delta güncellemesi olarak değerlendirilir. <StatusApplicationControl> içinde belirtilen her tesis, tarih, oda ve paket için daha önce tanımlanmış bir kısıtlamaya yapılan güncelleme yalnızca aynı kısıtlamanın değerini değiştirir. Yeni kısıtlama eklemek ise önceden tanımlanmış diğer kısıtlamaları etkilemez. Örneğin, 2 günlük minimum konaklama süresi önceden tanımlanmışsa ve ardından yalnızca 7 günlük maksimum konaklama süresi içeren yeni bir mesaj güncellendiyse bu işlem, önceki minimum konaklama süresi değerini silmez.

Öğeler ve Özellikler

OTA_HotelAvailNotifRQ mesajı aşağıdaki öğelere ve özelliklere sahiptir:

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

Öğ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. a-z, A-Z, 0-9, _ (alt çizgi) ve - (kısa çizgi) karakterlerine izin verilir.
OTA_HotelAvailNotifRQ / @TimeStamp	1	DateTime	Bu mesajın oluşturulma tarihi ve saati.
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 bir 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> varsa gereklidir. <RequestorID> öğesinin kapsayıcısıdır.
OTA_HotelAvailNotifRQ / POS / RequestorID	1	RequestorID	<POS> varsa 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, aynı hesap için <OTA_HotelRateAmountNotifRQ> mesajınızın <RequestorID> öğesindeki ID özellik değeriyle ve Transaction (Tesis Verileri) mesajınızın partner ö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> konumundaki tarih aralığı için rezerve edilebilecek kalan oda sayısı. BookingLimit belirtilirse <StatusApplicationControl>, InvTypeCode öğesini belirtmelidir. <AvailStatusMessage>, <LengthOfStay> veya <RestrictionStatus> öğesini içeremez. 0'a eşit veya 0'dan büyük olmalıdır. Negatifse veya sağlanmamışsa varsayılan olarak 0 değerine ayarlanır. Not: Belirli bir <StatusApplicationControl> ayarında oda müsaitlik durumunu belirlemek için BookingLimit özelliğinin en az bir kez ayarlanması gerekir.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl	1	StatusApplicationControl	Tarih aralığının yanı sıra oda türü (InvTypeCode) ve ücret planı (RatePlanCode) tanımlayıcıları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 bitiş tarihi (tesisin bulunduğu saat dilimine göre). start değerine eşit veya değerden 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" (doğru) değerine ayarlanmayan diğer günleri hariç tutulur (geçerli olduğunda bu günler filtrelenerek Start and End). içindeki tarihlerden çıkarılır)
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 arasındaki 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 değildir ve belirtilmemelidir. <RestrictionStatus> veya <LengthOfStay> belirtilmişse belirtilmelidir.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay	0..1	LengthsOfStay	KS 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 halde bulunmamalıdır.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay	1..n	LengthOfStay	Konaklama süresiyle ilgili kısıtlamaları tanımlar. Birden fazla <LengthOfStay> öğesi kullanılı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ğer sıfır olarak ayarlandığında kısıtlama uygulanmaz. Örneğin, <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> maksimum konaklama süresinin olmadığı anlamına gelir. Not: Bu özellik, MinMaxMessageType="FullPatternLOS" kullanılmıyorsa 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: 1 "Day" birimi, 1 gece konaklamaya eşittir.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType	1	enum	Çeşitli konaklama süresi kısıtlamaları. SetMaxLOS, SetMinLOS ve FullPatternLOS, varışa göredir. 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 süresi kısıtlama kalıbını tanımlar. Not: Bu öğe, MinMaxMessageType="FullPatternLOS" kullanılırken mevcut olmalı, aksi halde bulunmamalıdır.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS	1	string	Bir geceden FixedPatternLength değerine kadar her konaklama süresine izin verilip verilmediğini gösteren Y ve N karakterlerinden oluşan bir dizi. FixedPatternLength değerinden uzun konaklama süreleri, son konumdaki değeri devralır. Örneğin, FixedPatternLength="4" ve FullPatternLOS="YNYN" için yalnızca 1 ve 3 konaklama sürelerine 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. Bu seçeneği, Hotel Center fiyatlandırma ayarlarındaki "Varsayılan müsaitlik durumu" bölümünden yapılandırabilirsiniz. Hotel Center'daki "Kapalı" değeri, buradaki Close değerine karşılık gelir. Master politikasını Close olarak ayarlamak, "satışı durdur" 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 - End tarih aralığı da dahil olmak üzere check-in tarihine sahip seyahat planlarını önler. Departure: Bu değer, Start - End tarih aralığı da dahil olmak üzere çıkış tarihi olan 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ında rezervasyon yapabilmek için varış tarihinden önceki minimum süredir (tesisin yerel saatiyle). Geçerli değer türleri şunlardır: Integer: Varış tarihinden önceki gün sayısı. Ö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), son rezervasyon zamanında kısıtlama olmadığını gösterir. ISO 8601 Duration (days, hours, and minutes): Varış tarihinden önceki gün sayısı (ve isteğe bağlı olarak saat/dakika cinsinden). Ö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ış tarihinin 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	Varış tarihinden önceki maksimum süredir (tesisin yerel saatinde). Bu oda fiyatında rezervasyon yapabilirsiniz. Geçerli değer türleri şunlardır: Integer: Varış tarihinden önceki gün sayısı. Ö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ı (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, en erken 18:00'dan önce yapılamayacağını gösterir.

Örnekler

Kayıp varış tarihi

Minimum ve maksimum konaklama süreleri belirleyin (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 belirleyin (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ıtlama belirleme (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ı belirleyin. (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>

Satın alınabileceği tarihler

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

Not: Fiyatlar tamamen kullanıma sunulmadan önce, gecelik ücretlerin yanı sıra oda türü için 0'dan büyük bir envanter sayısının da eklenmesi 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 durumunu kapat. (Bu, "satışı durdurma" olarak da bilinir.)

<?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ı belirleyin.

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

Otelin yerel saatiyle varış tarihinde saat 18:00'deki rezervasyon için son sipariş saati uygulayı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"
                                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 ayarlayabilirsiniz.

<?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 tarihlere göre bir oda türü için envanter sayısı ayarlama.

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'teki check-in işlemleri için yalnızca 2, 4 ve 6 konaklama süresine izin verilir. 1, 3, 5 ve 7 ve üstü konaklama süreleri bilgisi yok.

<?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 aşağıdaki 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ı aşağıdaki öğelere ve özelliklere sahiptir:

Öğ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 saati.
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ü). 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 durumu. Yalnızca NotProcessed değeri kullanılır.
OTA_HotelAvailNotifRS / Errors / Error / @ShortText	1	string	Sorunun Google tanımlayıcısı. Bu hatalarla ilgili ayrıntılar Feed Durumu Hata Mesajları konusunda bulunabilir.

Örnekler

Başarılı

Aşağıda, başarıyla işlenmiş birOTA_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şlenmeyen 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>