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 önceden 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 önceden tanımlanmış diğer kısıtlamaları etkilemez. Örneğin, daha önce 2 günlük minimum konaklama süresi tanımlanmışsa ve ardından yalnızca 7 günlük maksimum konaklama süresini içeren yeni bir mesaj güncellenmişse 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 özelliğini 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ı. 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 İşlem (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ğiyle 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 Tarih aralığının başlangıç tarihidir (tesisin bulunduğu saat dilimine göre).
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). 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 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ıç 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 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, 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 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 içinde tanımlanan kalıbın uzunluğu.

Not: Bu özellik, MinMaxMessageType="FullPatternLOS" kullanılırken ayarlanmalı, aksi takdirde mevcut olmamalı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ğeri. 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: Bu özellik, MinMaxMessageType="FullPatternLOS" kullanılmadığı sürece ayarlanmalıdır.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit 0..1 enum Zaman birimi. 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ışa göre belirlenir. 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 modelini tanımlar.

Not: Bu öğe, MinMaxMessageType="FullPatternLOS" kullanılırken mevcut olmalı, aksi takdirde mevcut olmamalıdır.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS 1 string Bir geceden başlayıp FixedPatternLength değerine kadar olan her konaklama süresine izin verilip verilmediğini Y ve N karakterleriyle belirten bir dizi. FixedPatternLength değerinden büyük olan konaklama süreleri, son konumdaki değeri devralır. Örneğin, FixedPatternLength="4" ve FullPatternLOS="YNYN" ile yalnızca 1 ve 3 günlük 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:
  • 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 tarihler sırasıyla check-in ve check-out için kısıtlanır.

  • Open ve Close ile Arrival: Bu kombinasyon, seyahat planındaki hangi tarihlerde check-in yapılabileceğini belirtir.
  • Open ve Close ile Departure: Bu kombinasyon, seyahat planındaki hangi tarihlerde çıkış yapılabileceğini belirtir.

    • Arrival tarihi, giriş tarihinden sonraki konaklama gecelerinde müsaitliği kısıtlamaz.

    Örneğin, 1-4 Nisan tarihleri arasındaki bir konaklama için 2-4 Nisan tarihleri arasında varışa kapalı olmasına rağmen 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 uygunluk" bölümünden yapılandırabilirsiniz. Hotel Center'daki "Kapalı" değeri, buradaki Close değerine karşılık gelir.
    • Master ayarını Close olarak ayarlamaya "satış durdurma" denir.
    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 müsait olmalıdır. Önceki bir mesajda kapatıldığı belirtilmediği sürece hem Arrival hem de Departure için varsayılan değer Open'dir. Ayrıca, konaklamanın son günü hariç olmak üzere, seyahat planının tüm tarihleri için oda/paket kombinasyonu müsait olmalıdır. Bu kullanılabilirlik, Hotel Center'daki varsayılan ayarlar veya <Status> ya da <Restriction> öğesi aracılığıyla ayarlanabilir. Varsayılan ayar Close ise seyahat planı tarihlerinde stok durumunu yeniden açmak için ilgili tarihlerde Open değerine sahip bir Status değeri ve Master değerine sahip bir restriction değeri göndermeniz gerekir.

    Örneğin, varış tarihi 1 Nisan olan üç gecelik konaklamanın tam seyahat planı 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 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 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ı (ve isteğe bağlı olarak saat/dakika sayısı). Ö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üre (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 (isteğe bağlı olarak saat/dakika da eklenebilir). Ö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'nin kullanıma sunulma 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>

    LoS kısıtlamalarını kaldırma

    <LengthOfStay> öğesinde Time="0" olarak ayarlamak, 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>

    Ayrılma 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ıtlama 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>

    Kullanılabilirlik tarihlerini kapatma

    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>

    Rezervasyon son tarihi

    Otel rezervasyonları için, otelin yerel saatine göre varış tarihinde saat 18:00'de son tarih 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 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 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+ gecelik 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 durumu. 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>