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>

Her <OTA_HotelAvailNotifRQ> mesajı, delta güncellemesi olarak kabul edilir. <StatusApplicationControl> içinde belirtilen her tesis, tarih, oda ve paket için daha önce tanımlanmış bir kısıtlamada yapılan güncelleme yalnızca aynı kısıtlamanın değerini değiştirir. Yeni kısıtlama eklemek ise daha önce tanımlanmış diğer kısıtlamaları etkilemez. Örneğin, daha önce 2 gün için minimum konaklama süresi tanımlandıysa ve daha sonra yalnızca 7 gün için 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ında aşağıdaki öğeler ve özellikler bulunur:

Not: Konaklama süresi kısıtlamalarının her türü bağımsız olarak ayarlanır. Örneğin, SetMaxLOS değerini ayarlayan bir ileti, 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 kullanılabilirliğini tanımlayan bir mesajın kök öğesidir.
OTA_HotelAvailNotifRQ / @xmlns 0..1 string (URI) XML ad alanı.
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 mesajdaki iş ortağı hesabını belirten kapsayıcıdır. Arka ucunuz birden fazla iş ortağı hesabı için fiyat feed'leri sağlıyorsa genellikle bunu kullanırsınız.
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 genelinde Transaction (Tesis Verileri) mesajınızın partner özellik değeriyle ve <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ı. 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. Ayrıca <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 odanın müsaitlik durumunu belirlemek için BookingLimit özelliğinin en az bir kez ayarlanması gerekir.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl 1 StatusApplicationControl Oda türü (InvTypeCode) ve ücret planı (RatePlanCode) tanımlayıcılarının yanı sıra tarih aralığını tanımlar.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start 1 Date Tesisin saat dilimine göre tarih aralığını kapsayan başlangıç tarihi.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End 1 Date Tarih aralığının (girilen tarihler dahil) bitiş tarihidir (tesisin bulunduğu saat dilimine göre). start değerine eşit veya değerden daha 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). ile arasındaki 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 ile End arasındaki 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 ile End arasındaki 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 ile End arasındaki 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 ile End arasındaki 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ıç ile 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 ile End arasındaki tarihlerden filtrelenir).

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode 1 string Envanterin benzersiz tanımlayıcısıdır (oda türü). Bu değer, Transactions (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 bu özellik de 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 adresinde tanımlanan kalıbın uzunluğu.

Not: Bu özellik, MinMaxMessageType="FullPatternLOS" kullanıldığında ayarlanmalı, aksi takdirde 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ğerini 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 olmayacağını 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" olur. Geçerli değer:
  • Day
Not: Bir "Day" birimi 1 gecelik 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ışa göredir. SetForwardMinStay ve SetForwardMaxStay ise 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ıtlaması kalıbını tanımlar.

Not: Bu öğe, MinMaxMessageType="FullPatternLOS" kullanıldığında mevcut olmalıdır. Aksi takdirde 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 belirten Y ve N karakterlerinden oluşan bir dizi. FixedPatternLength'ten uzun konaklama süreleri, son konumdaki değeri devralır. Örneğin, FixedPatternLength="4" ve FullPatternLOS="YNYN" ile yalnızca 1 ve 3 konaklama süresine 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:
  • Open
  • Close

Open ve Close değerleri, <Restriction> öğesinin tüm değerleriyle uyumludur. Open ve Close değerleri, Arrival ve Departure değerleriyle birlikte kullanıldığında seyahat planındaki belirli tarihleri sırasıyla giriş ve çıkış için kısıtlar.

  • Open ve Close ile Arrival: Bu kombinasyon, seyahat planındaki hangi tarihlerin check-in için uygun olduğunu belirtir
  • Open ve Close ile Departure: Bu kombinasyon, seyahat planındaki hangi tarihlerin çıkış yapmak için uygun olduğunu belirtir
  • Arrival tarihi, giriş tarihinden sonraki konaklama gecelerinin müsaitlik durumunu kısıtlamaz.

    Örneğin, 1-4 Nisan tarihleri arasında yapılacak bir konaklama için 2-4 Nisan tarihlerinin varış için kapalı olduğu durumlarda rezervasyon yapılabilir.

    Not:

    • Google, varsayılan olarak tüm ürünler için Master ayarının Close olduğunu varsayar. Bu ayarı Hotel Center fiyatlandırma ayarlarındaki "Varsayılan müsaitlik durumu" üzerinden yapılandırabilirsiniz. Hotel Center'daki "Kapalı" değeri, buradaki Close değerine karşılık gelir.
    • Master değerini Close olarak ayarlamak "satış durdurma" olarak bilinir.
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction 0..1 enum

    Status sağlanırsa bu özellik gereklidir.

    Geçerli değerler şunlardır:

    • Arrival: Bu değer, Start - End tarih aralığındaki (iki tarih de dahil) check-in tarihine sahip seyahat planlarını önler.
    • Departure: Bu değer, Start - End tarih aralığındaki (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.

    Belirtilen seyahat planı için hem Arrival hem de Departure'un müsaitlik durumunun açık olması gerekir. Kapatıldığını belirten bir mesaj gönderilmediği sürece, hem Arrival hem de Departure için varsayılan değer Open'dir. Ayrıca oda/paket kombinasyonu, konaklamanın son günü hariç olmak üzere seyahat planının tüm tarihlerinde müsait olmalıdır. Bu müsaitlik durumu, Hotel Center'daki varsayılan ayarlar veya <Status> ya da <Restriction> öğesi aracılığıyla ayarlanabilir. Varsayılan ayar Close ise seyahat planı tarihleri için stok durumunu yeniden açmak üzere ilgili tarihler için Status değerini Open ve restriction değerini Master olarak göndermeniz gerekir.

    Örneğin, varış tarihi 1 Nisan olan üç gecelik bir konaklama için seyahat planının tamamı 1-4 Nisan'dır. 1-3 Nisan tarihleri arasındaki gecelik konaklama için Status değeri Open, Restriction değeri ise Master olarak ayarlanmalıdır. Yalnızca gecelik konaklama tarihleri için Open durumu gerektiğinden, konaklamanın son günü (4 Nisan) kapalıdır.

    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 saatinde).

    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 geç 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ını (ve isteğe bağlı olarak saat/dakika sayısını) belirtir. Ö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 6 saat önce (ör. saat 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 saatinde).

    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ını (ve isteğe bağlı olarak saat/dakika sayısını) belirtir. Ö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 saat 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>
    
    

    Görüş hattı kısıtlamalarını kaldırma

    <LengthOfStay> için Time="0" ayarını yapmak, belirtilen konaklama süresi için kısıtlama olmadığını gösterir. Örneğin, <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> maksimum konaklama süresi kısıtlaması olmadığı anlamına gelir.

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

    Kalkış kısıtlaması

    "Gidiş kapalı" kısıtlaması 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ı belirleme (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>
    
    


    Müsaitlik durumu tarihleri

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

    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 tarihler için kapanış

    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ı 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-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 rezervasyon tarihi

    Varış tarihinde otelin yerel saatinde 18:00'e kadar rezervasyon yapılabilir.

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


    Rezervasyon sınırı

    Belirtilen tarihler arasında 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 desen konaklama süresi kısıtlaması ayarlayın.

    26 Temmuz 2023'te giriş için yalnızca 2, 4 ve 6 gecelik konaklamalara izin verilir. 1, 3, 5 ve 7 gecenin üzerindeki konaklama süreleri kullanılamaz.

    <?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) öğesidir. 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>