İşlem (Tesis Verileri)

İstekler

Söz dizimi

Transaction (Property Data) mesajında şu söz dizimi kullanılır:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="timestamp"
             id="message_ID"
             partner="partner_key">
  <PropertyDataSet action="[overlay|delta]">
    <!-- (Required) ID that matches the Hotel List Feed -->
    <Property>HotelID</Property>
    <RoomData>
      <!-- (Required) One room ID per RoomData element -->
      <RoomID>RoomID</RoomID>
      <Name>
        <Text text="room_name" language="language_code"/>
      </Name>
      <Description>
        <Text text="room_description" language="language_code"/>
      </Description>
      <!-- (Optional) Restricts the rate plans allowed for this room type to
        those listed here. If specified, don't specify AllowableRoomIDs. -->
      <AllowablePackageIDs>
        <AllowablePackageID>PackageID</AllowablePackageID>
      </AllowablePackageIDs>
      <Capacity>max_number_of_occupants</Capacity>
      <AdultCapacity>max_number_of_adult_occupants</AdultCapacity>
      <ChildCapacity>max_number_of_child_occupants</ChildCapacity>
      <OccupancySettings>
        <MinOccupancy>min_number_of_occupants</MinOccupancy>
        <MinAge>min_age_of_occupants</MinAge>
      </OccupancySettings>
      <PhotoURL>
        <Caption>
          <Text text="photo_description" language="language_code"/>
        </Caption>
        <URL>photo_location</URL>
      </PhotoURL>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>[western|japanese|japanese_western]</JapaneseHotelRoomStyle>
        <Beds>
           <Bed size="[single|semi_double|double|queen|king]">
             <Width unit="cm" number="bed_width"/>
             <Length unit="cm" number="bed_length"/>
           </Bed>
           <!-- Include with any additional beds. -->
        </Beds>
        <Suite/>
        <Capsule/>
        <Roomsharing>[shared|private]</Roomsharing>
        <Outdoor/>
        <MobilityAccessible/>
        <Smoking>[smoking|non_smoking]</Smoking>
        <BathAndToilet relation="[together|separate]">
          <Bath bathtub="[false|true]" shower="[false|true]"/>
          <Toilet electronic_bidet="[false|true]" mobility_accessible="[false|true]"/>
        </BathAndToilet>
        <OpenAirBath/>
        <AirConditioning/>
        <Balcony/>
        <Views>
          <!-- (Optional) Defines the type of views from the room. -->
          <!-- Example: <OceanView/> -->
        </Views>
      </RoomFeatures>
    </RoomData>
    <PackageData>
      <!-- (Required) One package ID per PackageData element -->
      <PackageID>PackageID</PackageID>
      <Name>
        <Text text="package_name" language="language_code"/>
      </Name>
      <Description>
        <Text text="package_description" language="language_code"/>
      </Description>
      <!-- (Optional) Restricts the room types allowed for this rate plan to
        those listed here. If specified, don't specify AllowablePackageIDs. -->
      <AllowableRoomIDs>
        <AllowableRoomID>RoomID</AllowableRoomID>
      </AllowableRoomIDs>
      <Refundable available="[false|true]" refundable_until_days="number_of_days"
        refundable_until_time="time"/>
      <!-- For these next 3 elements, boolean_value can be 0/1 or true/false -->
      <BreakfastIncluded>boolean_value</BreakfastIncluded>
      <InternetIncluded>boolean_value</InternetIncluded>
      <ParkingIncluded>boolean_value</ParkingIncluded>
      <PhotoURL>
        <Caption>
          <Text text="photo_description" language="language_code"/>
          ...
        </Caption>
        <URL>photo_location</URL>
      </PhotoURL>
      ...
      <Meals>
        <Breakfast
          included="[true|false]" buffet="[true|false]"
          in_room="[true|false]" in_private_space="[true|false]"/>
        <Dinner
          included="[true|false]" buffet="[true|false]"
          in_room="[true|false]" in_private_space="[true|false]"/>
      </Meals>
      <CheckinTime>checkin_time</CheckinTime>
      <CheckoutTime>checkout_time</CheckoutTime>
    </PackageData>
  </PropertyDataSet>
</Transaction>

Öğeler ve Özellikler

Transaction (Tesis Verileri) mesajında aşağıdaki öğeler ve özellikler bulunur:

Öğe / @Özellik Yineleme sayısı Tür Açıklama
Transaction 1 Complex element Bir ARI uygulamasında bu, tek bir tesisteki oda türlerini ve paketleri tanımlayan mesajın kök öğesidir.
Transaction / @timestamp 1 DateTime Bu mesajın oluşturulma tarihi ve saatidir.
Transaction / @id 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.
Transaction / @partner 1 string Bu mesajın iş ortağı hesabıdır. Bu dize değeri, Hotel Center'ın Hesap ayarları sayfasında listelenen "İş ortağı anahtarı" değeridir.

Not: Birden fazla hesap için feed sağlayan bir arka ucunuz varsa bu değerin aynı hesap için <OTA_HotelRateAmountNotifRQ> ve <OTA_HotelAvailNotifRQ> mesajlarınızın <RequestorID> öğesinde belirtilen ID özellik değeriyle eşleşmesi gerekir.
Transaction / PropertyDataSet 1.. PropertyDataSet Tek bir tesise ait oda türlerini ve paketleri tanımlayan kapsayıcıdır.
Transaction / PropertyDataSet / @action 0..1 enum

Oda fiyatı tanımlarına uygulanacak güncelleme türüdür.

Valid values are:

  • overlay : Bu özellik için daha önce tanımlanan tüm <RoomData> ve <PackageData> öğelerini değiştirir. Geçerli mesajdaki yalnızca <RoomData> ve <PackageData> geçerlidir.
  • delta : Önceden tanımlanmayan <RoomData> ve <PackageData> öğelerini ekler veya mevcut olanları değiştirir.

Bu özellik isteğe bağlıdır ve belirtilmezse varsayılan olarak delta değerine ayarlanır.
Transaction / PropertyDataSet / Property 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.
Transaction / PropertyDataSet / RoomData 0..n RoomData

Bir odayı tanımlar.

Not: En az bir <RoomData> veya <PackageData> gereklidir.

Transaction / PropertyDataSet / RoomData / RoomID 1 RoomID Bir oda türünün benzersiz tanımlayıcısıdır. Bu değer, <OTA_HotelAvailNotifRQ> ve <OTA_HotelRateAmountNotifRQ> mesajlarındaki <StatusApplicationControl> öğesinde bulunan InvTypeCode özelliği kullanılarak belirtilir.
Transaction / PropertyDataSet / RoomData / Name 1 Name Bir veya daha fazla dilde oda kategorisi adının kapsayıcısıdır.
Transaction / PropertyDataSet / RoomData / Name / Text 1..n Text Bir dilde oda kategorisi adını belirtir.
Transaction / PropertyDataSet / RoomData / Name / Text / @text 1..n string Oda kategorisinin language özelliği tarafından belirtilen dildeki adıdır.
Transaction / PropertyDataSet / RoomData / Description 1 Name Bir veya daha fazla dilde oda kategorisi açıklamasının kapsayıcısıdır.
Transaction / PropertyDataSet / RoomData / Description / Text 1..n Text Bir dilde oda kategorisi açıklamasını belirtir.
Transaction / PropertyDataSet / RoomData / Description / Text / @text 1..n string Oda kategorisinin language özelliği tarafından belirtilen dildeki açıklamasıdır.
Transaction / PropertyDataSet / RoomData / Description / Text / @language 1..n string İki harfli dil kodudur.
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs 0..1 AllowablePackageIDs <AllowablePackageID> öğelerinin kapsayıcısıdır.

<AllowablePackageIDs> belirtilirse üst <RoomData> öğesindeki <RoomID> tarafından belirtilen oda türü yalnızca <AllowablePackageID> öğeleri tarafından tanımlanan ücret planlarıyla birleştirilebilir.

<AllowablePackageIDs> belirtilmezse üst <RoomData> öğesindeki <RoomID> tarafından belirtilen oda türü herhangi bir ücret planıyla birleştirilebilir.

<AllowablePackageIDs> ve <AllowableRoomIDs> kullanın ancak ikisini birden kullanmayın.
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs / AllowablePackageID 1..n AllowablePackageID Bu oda türüyle birleştirilebilecek bir ücret planının PackageID'sini belirtir. Ücret planı; paket, ücret ve stok durumu kombinasyonu ile tanımlanır. PackageID, OTA_HotelRateAmountNotifRQ ve OTA_HotelAvailNotifRQ mesajlarındaki RatePlanCode öğesine karşılık gelir.
Transaction / PropertyDataSet / RoomData / Capacity 0..1 integer Bir odada fiziksel olarak konaklayabilecek maksimum yetişkin ve çocuk sayısıdır. Ücretlerle birlikte gönderdiğiniz tüm NumberOfGuests değerlerinden büyük veya bu değerlere eşit olmalıdır.

<Capacity> değeri, 1 ile 99 arasında (bu değerler dahil) pozitif bir tam sayı olmalıdır. Örnek için buraya göz atın.

Not: <Capacity> ayarlanmazsa izin verilen kişi sayısı sınırsız olarak kabul edilir. Bu alan ayarlanmazsa ve ExtraGuestCharges veya AdditionalGuestAmounts tanımlanırsa istenilen sayıda kişi için fiyat oluşturulabilir. Geçersiz doluluk seçeneklerinde fiyatların gösterilmemesini sağlamak için ExtraGuestCharges veya AdditionalGuestAmounts tanımlanmışsa <Capacity> özelliğini ayarlamanızı öneririz.
Transaction / PropertyDataSet / RoomData / AdultCapacity 0..1 integer Bir odada fiziksel olarak konaklayabilecek maksimum yetişkin sayısıdır. Ücretlerle birlikte gönderdiğiniz tüm NumberOfGuests değerlerinden büyük veya bu değerlere eşit olmalıdır.

<AdultCapacity> değeri, 1 ile 99 arasında (bu değerler dahil) pozitif bir tam sayı olmalıdır. Örnek için buraya göz atın.
Transaction / PropertyDataSet / RoomData / ChildCapacity 0..1 integer Bir odada fiziksel olarak konaklayabilecek maksimum çocuk sayısıdır.

<ChildCapacity> değeri, 1 ile 99 arasında (1 ve 99 dahil) pozitif bir tam sayı olmalıdır. Örnek için buraya göz atın.
Transaction / PropertyDataSet / RoomData / OccupancySettings 0..1 OccupancySettings Bir odanın doluluk gereksinimlerini kısıtlayan veya değiştirebilen ayarlar.

<OccupancySettings> öğesi şu alt öğeleri alır:

  • <MinOccupancy>: Bir odada kalabilecek minimum konuk sayısı. Örneğin, bu özellik 2 olarak ayarlanırsa bu oda tek bir konuk için rezerve edilemez.

    <MinOccupancy> değeri, 1 ile 99 arasında (1 ve 99 dahil) pozitif bir tam sayı olmalıdır.

  • <MinAge>: Bir odada kalan tüm konuklar için minimum yaştır. Örneğin, bu oda 18 olarak ayarlanırsa bu oda yalnızca tüm davetlilerin 18 yaşında veya daha büyük olduğu gruplar için rezerve edilebilir.

    <MinAge> değeri, 0 ile 99 arasında (0 ve 99 dahil) pozitif bir tam sayı olmalıdır.

<OccupancySettings>
  <MinOccupancy>2</MinOccupancy>
  <MinAge>16</MinAge>
</OccupancySettings>

Tüm alt öğelerin dahil edilmesi gerekmez.
Transaction / PropertyDataSet / RoomData / PhotoURL 0..n PhotoURL Belirtilen odanın ya da Oda Paketinin fotoğrafına ait URL ve isteğe bağlı başlıktır. Bir oda veya Oda Paketi için birden fazla <PhotoURL> belirtebilirsiniz.

Bu öğe şu alt öğeleri alır:

  • <URL>: Fotoğrafın konumunu belirtir. Konum herkese açık olmalıdır (güvenlik duvarı arkasında olmamalıdır) ve protokolü (http://) içermelidir.
  • <Caption>: Fotoğrafın başlığını tanımlar. Bu öğede, iki gerekli özelliğe (Text ve language) sahip tek bir alt öğe (<Text>) kullanılır. Text özelliği başlıktır ve language özelliği de en gibi iki harfli dil kodunu belirtir.
<PhotoURL>
 <URL>http://www.example.com/image1.jpg</URL>
 <Caption>
  <Text text="A bright way to enjoy your
   mornin' cuppa tea." language="en"/>
  <Text text="Une façon lumineuse pour profiter
   de votre tasse de thé." language="fr"/>
 </Caption>
</PhotoURL>
Transaction / PropertyDataSet / RoomData / RoomFeatures 0..1 <RoomFeatures> Oda özellikleriyle ilgili bilgileri içerir.
Transaction / PropertyDataSet / RoomData / RoomFeatures / JapaneseHotelRoomStyle 0..1 enum

Japon otel odasının tarzını gösterir.

Valid values are:

  • western: Yataklı, batı tarzı bir oda.
  • japanese: Japon tarzı bir oda ve futon yatak.
  • japanese_western: Batı tarzı yataklar ve Japon tarzı futonlar bulunan Batı tarzı Japon tarzı oda.
Transaction / PropertyDataSet / RoomData / RoomFeatures / Beds 0..1 Object Odadaki sayıda <Bed> içeriyor. Burada Japon futonlarının sayılmaması gerektiğini lütfen unutmayın.

Her <Bed> aşağıdaki özelliklere sahiptir:

  • size (isteğe bağlı): Geçerli değerler single, semi_double, double, queen ve king değerleridir.
Her <Bed> aşağıdaki alt öğelere sahiptir:
  • <Width> (isteğe bağlı): Yatak genişliğini belirtir. unit özelliği cm değerine ve number özelliği yatağın santimetre cinsinden genişliğine sahip olmalıdır.
  • <Length> (isteğe bağlı): Yatak uzunluğunu belirtir. cm değerine sahip unit özelliği ve santimetre cinsinden yatağın uzunluğu ile number özelliği bulunmalıdır.
Örnek: 
<Beds>
  <Bed size="double">
    <Width unit="cm" number="140"/>
    <Length unit="cm" number="195"/>
  </Bed>
  <Bed/> <!-- Size unknown -->
</Beds>
Transaction / PropertyDataSet / RoomData / RoomFeatures / Suite 0.. enum Bu oda bir süit olduğunda bu öğeyi sağlayın.
Transaction / PropertyDataSet / RoomData / RoomFeatures / Capsule 0..1 enum Oda bir kapsül odaysa bu öğeyi kullanın.
Transaction / PropertyDataSet / RoomData / RoomFeatures / Roomsharing 0..1 enum Bu odanın, sahipler veya diğer konuklar gibi diğer konuklarla paylaşılıp paylaşılmadığıdır. Geçerli değerler shared ve private'dir.
Transaction / PropertyDataSet / RoomData / RoomFeatures / Outdoor 0..1 enum Bu oda sabit duvarları, su tesisatı ve klima kontrolü olmayan açık hava konaklama tesisiyse bu öğeyi kullanın. Örneğin, otel odaları açık hava konaklama yeri değildir. Konukların çadırda kaldığı kamp alanları ve konukların kendi karavanlarını getirdiği karavan parkları açık hava konaklama yerleridir.
Transaction / PropertyDataSet / RoomData / RoomFeatures / MobileAccessible 0..1 enum Bu oda engellilere uygun olduğunda bu öğeyi sağlayın.
Transaction / PropertyDataSet / RoomData / RoomFeatures / Smoking 0..1 enum Bu odanın sigara içilmeyen oda mı yoksa sigara içilen oda mı olduğu. Geçerli değerler non_smoking ve smoking'dir.
Transaction / PropertyDataSet / RoomData / RoomFeatures / BathAndToilet 0..1 Object Odadaki banyo ve tuvalet hakkında bilgi içerir.

Özellik:

  • relation (isteğe bağlı): Banyo ve tuvaletin birbirine göre nasıl yerleştirildiğini gösterir. Geçerli değerler together (örneğin, banyo ve tuvaletin aynı odada bulunduğu banyo) ve banyo ile tuvaletin her birinin ayrı alanları olduğu separate değerleridir. Odada hem banyo hem de tuvalet yoksa bu özellik ayarlanmamalıdır.

Öğe isteğe bağlı olarak aşağıdaki alt öğeleri alır:

  • <Bath> (isteğe bağlı): Bu öğenin varlığı odada banyo olduğunu gösterir.

    Özellikler şunlardır:

    • bathtub (isteğe bağlı): Banyoda küvet olduğunu gösterir. Geçerli değerler 0 (veya false) ve 1 (veya true) şeklindedir.
    • shower (isteğe bağlı): Banyoda duş olduğunu gösterir. Geçerli değerler 0 (veya false) ve 1 (veya true) şeklindedir.
  • <Toilet> (isteğe bağlı): Bu öğenin varlığı odada tuvalet olduğunu gösterir.

    Özellikler şunlardır:

    • electronic_bidet (isteğe bağlı): Tuvalette elektronik bide olduğunu belirtir. Geçerli değerler 0 (veya false) ve 1 (veya true) şeklindedir.
    • mobility_accessible (isteğe bağlı): Tuvaletin engellilere uygun olduğunu belirtir. Geçerli değerler 0 (veya false) ve 1 (veya true) şeklindedir.

Örnek:

<BathAndToilet relation="separate">
  <Bath bathtub="1" shower="1"/>
  <Toilet
    electronic_bidet="1"
    mobility_accessible="1"/>
</BathAndToilet>
Transaction / PropertyDataSet / RoomData / RoomFeatures / OpenAirBath 0..1 enum Bu odada özel açık hava banyosu varsa bu öğeyi kullanın.
Transaction / PropertyDataSet / RoomData / RoomFeatures / AirConditioning 0..1 enum Odada klima varsa bu öğeyi kullanın.
Transaction / PropertyDataSet / RoomData / RoomFeatures / Balcony 0..1 enum Bu oda balkonlu veya verandalıysa bu öğeyi kullanın.
Transaction / PropertyDataSet / RoomData / RoomFeatures / Views 0..1 Object Geçerli seçenekler şunlardır:

<AirportView/>
<BayView/>
<BeachView>/>
<CastleView/>
<CityView/>
<CountrysideView/>
<CourtyardView/>
<DuneView/>
<ForestView/>
<GardenView/>
<GolfCourseView/>
<HarborView/>
<LagoonView/>
<LakeView/>
<MarinaView/>
<MountainView/>
<NatureView/>
<OceanView/>
<ParkView/>
<PartialOceanView/>
<PisteView/>
<PoolView/>
<PyramidView/>
<RiverView/>
<StreetView/>
Transaction / PropertyDataSet / PackageData 0..n PackageData

Fiziksel oda açıklamasında yer almayan ücret özelliklerini ve şartlarını açıklayan öğelerin kapsayıcısıdır.

Not: En az bir <RoomData> veya <PackageData> gereklidir.

Transaction / PropertyDataSet / PackageData / PackageID 1 string Bu mesajlardaki PackageID, OTA_HotelRateAmountNotifRQ ve OTA_HotelAvailNotifRQ mesajlarındaki RatePlanCode değerine karşılık gelir.
Transaction / PropertyDataSet / PackageData / Name 1 Name Bir veya daha fazla dilde paket adının kapsayıcısıdır.
Transaction / PropertyDataSet / PackageData / Name / Text 1..n Text Bir dilde paketin adını belirtir.
Transaction / PropertyDataSet / PackageData / Name / Text / @text 1..n string Paketin, language özelliği tarafından belirtilen dildeki adı.
Transaction / PropertyDataSet / PackageData / Description 1 Description Bir veya daha fazla dilde paket açıklamasının kapsayıcısıdır.
Transaction / PropertyDataSet / PackageData / Description / Text 1..n Text Paketin bir dilde açıklamasını belirtir.
Transaction / PropertyDataSet / PackageData / Description / Text / @text 1..n string Paketin, language özelliği tarafından belirtilen dildeki açıklamasıdır.
Transaction / PropertyDataSet / PackageData / Description / Text / @language 1..n string İki harfli dil kodudur.
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs 0..1 AllowableRoomIDs <AllowableRoomID> öğelerinin kapsayıcısıdır.

<AllowableRoomIDs> belirtilirse üst <PackageData> öğesindeki <PackageID> tarafından belirtilen ücret planı yalnızca <AllowableRoomID> öğeleri tarafından tanımlanan oda türleriyle birleştirilebilir.

<AllowableRoomIDs> belirtilmezse üst <PackageData> öğesindeki <PackageID> tarafından belirtilen ücret planı herhangi bir oda türüyle birleştirilebilir.

<AllowablePackageIDs> ve <AllowableRoomIDs> kullanın ancak ikisini birden kullanmayın.
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs / AllowableRoomID 1..n AllowableRoomID Bu ücret planıyla birleştirilebilecek bir oda türünün RoomID değerini belirtir. Oda türü, <RoomData> öğesinde tanımlanır.
Transaction / PropertyDataSet / PackageData / Refundable 0..1 Refundable Bir ücretin tamamen geri ödenebilir veya iptal edilebilir olarak listelenmesini etkinleştirir. Sağlanmazsa geri ödemeyle ilgili hiçbir bilgi gösterilmez.

Not: Tüm özellikleri ayarlamanızı öneririz. Bir veya daha fazla özellik ayarlanmadığında feed durumu uyarı mesajı oluşturulur.

Hiçbir özelliği ayarlamazsanız ücret geri ödenebilir olarak gösterilmez.

Özellikleri ayarlarken aşağıdakileri göz önünde bulundurun:

  • available veya refundable_until_days ayarlanmazsa ücret geri ödenebilir olarak gösterilmez.
  • available değeri, 0 veya false ise diğer özellikler yoksayılır. Diğer özelliklerden biri veya her ikisi de ayarlanmış olsa bile ücret geri ödenebilir olarak gösterilmez.
Transaction / PropertyDataSet / PackageData / Refundable / @available 1 boolean (Zorunlu) Ücretin eksiksiz şekilde geri ödenebildiğini belirtmek için 1 veya true olarak ayarlayın. Aksi takdirde 0 veya false olarak ayarlayın.
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days 0..1 integer (available değeri true ise zorunludur) Eksiksiz geri ödeme isteğinin, check-in tarihinden kaç gün önce yapılabileceğini belirtir. refundable_until_days değeri, 0 ile 330 arasında (0 ve 330 dahil) bir tam sayı olmalıdır.
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_time 0.. Time (available değeri, true ise önemle tavsiye edilir) Eksiksiz geri ödeme isteğinin dikkate alınacağı, günün son saatini (otelin yerel saatine göre) belirtir. Örneğin, "geri ödemelerin check-in'den iki gün önce saat 16:00'ya kadar alınabileceğini" belirtmek için refundable_until_days ile birleştirilebilir. refundable_until_time ayarlanmazsa değer varsayılan olarak gece yarısı olur.
Transaction / PropertyDataSet / PackageData / BreakfastIncluded 0..1 boolean Bu oda türünde kahvaltının dahil olup olmadığını belirtir. Geçerli değerler 0 (veya false) ve 1 (veya true) şeklindedir.

<BreakfastIncluded> yerine <Meals> kullanmanız tercih edilir.
Transaction / PropertyDataSet / PackageData / CheckinTime 0..1 Time Otelin yerel saatinde mümkün olan en erken giriş saati. Saat 24:00'dan kısa olmalıdır.
Transaction / PropertyDataSet / PackageData / CheckoutTime 0..1 Time Otelin yerel saatinde olası en geç çıkış saati.
Transaction / PropertyDataSet / PackageData / InternetIncluded 0..1 boolean Diğer odalarda bu imkanın bulunmadığı ancak odada ücretsiz internet erişimi olup olmadığını belirtir. Tüm odalarda ücretsiz internet sunan otellerde bu öğeyi ayarlamayın. Bu öğe, oda içi kablolu internet ya da konuk odalarında kullanılamayan kablosuz internet için geçerli değildir. Geçerli değerler 0 (veya false) ve 1 (veya true) şeklindedir.
Transaction / PropertyDataSet / PackageData / Meals 0..1 Object Bu paketteki yemekler hakkında bilgi içerir.

<Meals> öğesi, aşağıdaki özelliklere sahip iki isteğe bağlı alt öğe (<Breakfast> ve <Dinner>) alır:

  • included (gerekli): Fiyata kahvaltı/akşam yemeği dahilse 1 (veya true) olarak ayarlayın. Aksi takdirde 0 veya false olarak ayarlayın.
  • in_room (isteğe bağlı): Konukların kaldığı odada kahvaltı/akşam yemeği seçeneği varsa 1 (veya true) olarak ayarlayın. Aksi takdirde 0 (veya false) olarak ayarlayın.
  • in_private_space (isteğe bağlı): Konuklar, diğer konuklarla temas etmekten kaçınabilecekleri bir alanda (kaldıkları oda hariç) kahvaltı/akşam yemeği yiyebiliyorsa 1 (veya true) olarak ayarlayın. Aksi takdirde 0 (veya false) olarak ayarlayın.
  • buffet (isteğe bağlı): Kahvaltı/akşam yemeği, açık büfe olarak sunuluyorsa 1 (veya true) olarak; aksi takdirde 0 (veya false) olarak ayarlanır.

İsteğe bağlı özellikler yalnızca included doğru olduğunda kullanılır.

Yemek filtrelerinin (no meals, breakfast only, dinner only ve breakfast and dinner) çalışması için hem <Breakfast> hem de <Dinner>, included özelliğiyle sağlanmalıdır.
Transaction / PropertyDataSet / PackageData / ParkingIncluded 0..1 boolean Otopark hizmetinin ücretli olduğu otellerde oda ücretine ücretsiz otopark hizmetinin dahil olup olmadığını belirtir. Ücretsiz otopark sunan otellerde bu öğe için bir değer belirtmeyin. Geçerli değerler 0 (veya false) ve 1 (veya true) değerleridir. Varsayılan değer: false.
Transaction / PropertyDataSet / PackageData / PhotoURL 0..1 Object (<RoomData> içindeki <PhotoURL> ile aynı ancak paket için (ör. yemek fotoğrafları) geçerlidir.)

Örnekler

Oda ve paket verileri

Aşağıda, tesisin oda ve paket verilerinin Transaction (Tesis Verileri) mesajında nasıl tanımlanacağına dair temel bir örnek verilmiştir. overlay özelliği, beklenmedik şekilde önceden mevcut olan tüm verilerin silinmesini ve bu mesajdaki verilerle değiştirilmesini sağlamak için kullanılır:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-05-18T16:20:00-04:00"
             id="12345678"
             partner="partner_key">
  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Description>
        <Text text="Room with a king bed" language="en"/>
      </Description>
      <Capacity>2</Capacity>
      <PhotoURL>
        <URL>http://www.foo.com/static/bar/image.jpg</URL>
        <Caption>
          <Text text="Room with a king bed" language="en"/>
        </Caption>
      </PhotoURL>
    </RoomData>
    <RoomData>
      <RoomID>RoomID_2</RoomID>
      <Name>
        <Text text="Double" language="en"/>
      </Name>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
    <PackageData>
      <PackageID>PackageID_2</PackageID>
      <Name>
        <Text text="Free Breakfast" language="en"/>
      </Name>
      <Description>
        <Text text="Free breakfast rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>

Oda türü ekleyin

Aşağıda, mevcut <Transaction> verilerine oda türü ve paketin nasıl ekleneceğiyle ilgili bir örnek verilmiştir:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-07-18T16:20:00-04:00"
             id="12345678"
             partner="partner_key">
  <PropertyDataSet action="delta">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>RoomID_3</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
    <PackageData>
      <PackageID>PackageID_3</PackageID>
      <Name>
        <Text text="Non-Refundable" language="en"/>
      </Name>
      <!-- Additional PackageData child elements omitted. -->
      <Refundable available="false"/>
    </PackageData>
  </PropertyDataSet>
</Transaction>

Oda türlerini kaldırın

Aşağıda, mevcut oda türlerini ve paketleri nasıl kaldıracağınıza dair bir örnek verilmiştir. Bu senaryoda, "Oda ve paket verileri" ve "Oda türü ekle" alanlarındaki mesajlar daha önce Google'a gönderilmişse Google gösterilen mesajı aldıktan sonra King ve Double oda türü artık mevcut olmaz. Paket verilerinin kaldırılmasının Transaction (Tesis Verileri), OTA_HotelRateAmountNotifRQ ve OTA_HotelAvailNotifRQ mesajlarında tanımlanan genel ücret planını etkilediğini (aynı PackageID değerini referans alarak) unutmayın. Bu nedenle, diğer mesaj türlerini kullanan ilgili güncellemelerin PackageID_2 ve PackageID_3 öğelerinin artık burada tanımlanmadığını yansıtması gerekebilir.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-08-18T16:20:00-04:00"
             id="12345678"
             partner="partner_key">
  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <!-- Additional RoomData child elements omitted. -->
      <Capacity>2</Capacity>
      <PhotoURL>
        <URL>http://www.foo.com/static/bar/image.jpg</URL>
        <Caption>
          <Text text="Room with a queen bed" language="en"/>
        </Caption>
      </PhotoURL>
    </RoomData>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Refundable" language="en"/>
      </Name>
      <!-- Additional PackageData child elements omitted. -->
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>


Ücret planlarını kısıtla

Aşağıda, bir oda türünde izin verilen ücret planlarını kısıtlamak için <AllowablePackageIDs> öğesinin nasıl kullanılacağına dair bir örnek verilmiştir. Bu örnekte, Queen oda türü (RoomID_2) yalnızca PackageID_1 olarak tanımlanan paket ve ücret planıyla birleştirilebilir.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-12-18T16:20:00-04:00"
             id="12345678"
             partner="partner_key">
  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
    <RoomData>
      <RoomID>RoomID_2</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <AllowablePackageIDs>
        <AllowablePackageID>PackageID_1</AllowablePackageID>
      </AllowablePackageIDs>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <!-- Additional PackageData child elements omitted. -->
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
    <PackageData>
      <PackageID>PackageID_2</PackageID>
      <Name>
        <Text text="Free Breakfast" language="en"/>
      </Name>
      <!-- Additional PackageData child elements omitted. -->
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>

Oda kapasitesini kısıtla

Aşağıda <Capacity>, <AdultCapacity> ve <ChildCapacity> öğelerinin oda kapasiteleriyle ilgili kısıtlamalar belirlemek için nasıl kullanılacağına dair bir örnek verilmiştir.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-12-18T16:20:00-04:00"
             id="12345678"
             partner="partner_key">
  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <Name>
        <Text text="Double" language="en"/>
      </Name>
      <Capacity>4</Capacity>
      <AdultCapacity>4</AdultCapacity>
      <ChildCapacity>3</ChildCapacity>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
  </PropertyDataSet>
</Transaction>

Çift kişilik oda türünde (RoomID_1) toplamda en fazla 4 konuk olabilir. Ayrıca, tesiste en fazla 4 yetişkin ve 3 çocuk bulunabilir. Bu odanın rezerve edilebilir olması için üç kapasite gereksiniminin de karşılanması gerekir. Bu yapılandırma, her biri iki kişinin sığabileceği iki yataklı tipik bir odayı temsil eder. Odada en az bir yetişkin bulunması gerektiğinden çocuk kapasitesi toplam kapasiteden bir azdır.

<RoomFeatures> ve yemekler içeren daha uzun örnekler

JapaneseHotelRoomStyle, varsayılan bir değere sahip değil. Değerin atlanması XML hatasına neden olmaz ancak kullanıcı oda stiline veya yataklara göre filtreleme yaptığında girişiniz arama sonuçlarında gösterilmez.

İki adet tek kişilik yatak

Aşağıdaki örnekte, <RoomFeatures> özelliğinin nasıl kullanılacağı gösterilmektedir:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
        <Beds> <!-- Two single beds -->
          <Bed size="single">
            <Width unit="cm" number="97"/>
            <Length unit="cm" number="195"/>
          </Bed>
          <Bed size="single">
            <Width unit="cm" number="97"/>
            <Length unit="cm" number="195"/>
          </Bed>
        </Beds>
        <Suite/>
        <Capsule/>
        <Roomsharing>private</Roomsharing>
        <Outdoor/>
        <MobilityAccessible/>
        <Smoking>non_smoking</Smoking>
        <BathAndToilet relation="separate">
          <Bath bathtub="1" shower="1"/>
          <Toilet electronic_bidet="1" mobility_accessible="1"/>
        </BathAndToilet>
        <OpenAirBath/>
        <AirConditioning/>
        <Balcony/>
        <Views>
          <LakeView/>
          <MarinaView/>
          <BeachView/>
          <ForestView/>
          <MountainView/>
          <NatureView/>
        </Views>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

İki adet çift kişilik yatak

Aşağıda, iki double yataklı western tarzı bir oda örneği verilmiştir.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
        <Beds> <!-- Two double beds-->
          <Bed size="double"></Bed>
          <Bed size="double"></Bed>
        </Beds>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

Yataksız Japon tarzı

Aşağıda Japon tarzı yataksız bir oda örneği gösterilmektedir. japanese tarzı oda için yatak bilgisi gerekli değildir.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>japanese</JapaneseHotelRoomStyle>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

Yataklı Japon kovboy müziği

Aşağıda king boyutunda yatak bulunan japanese_western tarzı bir oda örneği verilmiştir.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
        <Beds>
          <Bed size="king"></Bed>
        </Beds>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

İş ortağı, japanese_western odalarda yatak sayısı hakkında bilgi sahibi değilse aşağıdaki örneğe bakın:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>


Yemekler

Aşağıdaki örnekte yemekler, fotoğraflar, giriş ve çıkış saatleri için oda ve paket meta verileri tanımlanmaktadır:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Meals Included" language="en"/>
      </Name>
      <PhotoURL>
        <Caption>
          <Text text="Breakfast" language="en"/>
          <Text text="朝食" language="ja"/>
        </Caption>
        <URL>http://example.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <Meals>
        <!-- Guests can choose to have breakfast in their room or in another
        space to avoid contact with other guests. -->
        <Breakfast included="1" in_room="1" in_private_space="1"/>
        <Dinner included="1" buffet="1"/>
      </Meals>
      <CheckinTime>15:00</CheckinTime>
      <CheckoutTime>11:00</CheckoutTime>
    </PackageData>
  </PropertyDataSet>
</Transaction>

Yalnızca kahvaltı

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Breakfast Included" language="en"/>
      </Name>
      <PhotoURL>
        <Caption>
          <Text text="Breakfast" language="en"/>
          <Text text="朝食" language="ja"/>
        </Caption>
        <URL>http://example.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <Meals>
        <Breakfast included="true"/>
        <!-- Dinner not included needs to be explicitly specified -->
        <Dinner included="false"/>
      </Meals>
      <CheckinTime>15:00</CheckinTime>
      <CheckoutTime>11:00</CheckoutTime>
    </PackageData>
  </PropertyDataSet>
</Transaction>

Yanıtlar

Söz dizimi

TransactionResponse (Property Data) mesajında şu söz dizimi kullanılır:

<?xml version="1.0" encoding="UTF-8"?>
<TransactionResponse timestamp="timestamp"
                     id="message_ID"
                     partner="partner_key">
  <!-- Either Success or Issues will be populated. -->
  <Success/>
  <Issues>
    <Issue code="issue_code" status="issue_type">issue_description</Issue>
  </Issues>
</TransactionResponse>

Öğeler ve özellikler

TransactionResponse (Property Data) mesajında aşağıdaki öğeler ve özellikler bulunur:

Öğe / @Özellik Yineleme sayısı Tür Açıklama
TransactionResponse 1 Complex element Alınan Transaction istek mesajının başarısını veya sorunlarını gösteren kök öğedir.
TransactionResponse / @timestamp 1 DateTime Bu mesajın oluşturulma tarihi ve saatidir.
TransactionResponse / @id 1 string İlişkilendirilmiş Transaction mesajındaki benzersiz tanımlayıcıdır.
TransactionResponse / @partner 1 string Bu mesajın iş ortağı hesabıdır.
TransactionResponse / Success 0..1 Success Transaction mesajının uyarı, hata veya sorun olmadan başarıyla işlendiğini belirtir.

Her mesajda <Success> veya <Issues> bulunur.
TransactionResponse / Issues 0..1 Issues Transaction mesajı işlenirken karşılaşılan bir veya daha fazla sorun için kullanılan bir kapsayıcıdır.

Her mesajda <Success> veya <Issues> bulunur.
TransactionResponse / Issues / Issue 1..n Issue Transaction mesajı işlenirken karşılaşılan uyarı, hata veya sorunun açıklamasıdır. Bu sorunlarla ilgili ayrıntıları Feed Durumu Hata Mesajları konusunda bulabilirsiniz.
TransactionResponse / Issues / Issue / @code 1 integer Sorunun tanımlayıcısı.
TransactionResponse / Issues / Issue / @status 1 enum

Karşılaşılan sorunun türü.

Geçerli değerler warning, error ve failure'dir.

Örnekler

Başarılı

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

<?xml version="1.0" encoding="UTF-8"?>
<TransactionResponse timestamp="2020-05-18T16:20:00-04:00"
                     id="12345678"
                     partner="partner_key">
  <Success/>
</TransactionResponse>

Sorunlar

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

<?xml version="1.0" encoding="UTF-8"?>
<TransactionResponse timestamp="2020-05-18T16:20:00-04:00"
                     id="12345678"
                     partner="partner_key">
  <Issues>
    <Issue code="1001" status="error">Example</Issue>
  </Issues>
</TransactionResponse>