İşlem (Tesis Verileri)

İstekler

Söz dizimi

Transaction (Property Data) mesajında aşağıdaki 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 bulunur ve özellikler:

Öğe / @Özellik Yineleme sayısı Tür Açıklama
Transaction 1 Complex element ARI uygulamasında bu, bir mesajın kök öğesidir Tek bir tesis için oda türlerini ve paketleri tanımlama.
Transaction / @timestamp 1 DateTime Bu mesajın oluşturulma tarihi ve saati.
Transaction / @id 1 string Bu istek mesajının benzersiz tanımlayıcısıdır. Bu değer döndürülür bu mesajdan yararlanabilirsiniz. İzin verilen karakterler a-z, A-Z, 0-9, _ şeklindedir (alt çizgi) ve - (kısa çizgi) tuşlarına basın.
Transaction / @partner 1 string Bu mesajın iş ortağı hesabıdır. Bu dize değeri "İş ortağı anahtarı" değeri şurada listelenir: Hotel Center'daki hesap ayarları sayfası.

Not: Aşağıdaki işlemler için feed sağlayan bir arka ucunuz varsa birden fazla hesap varsa bu değerin ID ile eşleşmesi gerekir <RequestorID> özelliğinde belirtilen özellik değeri <OTA_HotelRateAmountNotifRQ> ve Aynı hesap için <OTA_HotelAvailNotifRQ> mesaj.
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.

Geçerli değerler şunlardır:

  • overlay : Önceden tanımlanmış tüm öğeleri değiştirir <RoomData> <PackageData> belirtir. Yalnızca <RoomData> ve Mevcut iletideki <PackageData> geçerli değerler.
  • delta : Önceden tanımlanmamış öğeleri ekler <RoomData> <PackageData> veya mevcut olanları değiştirir.

Bu özellik isteğe bağlıdır ve değilse varsayılan olarak delta değerine ayarlanır belirtiliyor.
Transaction / PropertyDataSet / Property 1 string Tesisin benzersiz tanımlayıcısıdır. Bu değer, Otel kimliği, kullanılarak belirtildi <listing> öğesinde <id> otel listesi feed'inde görünür. 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ü için benzersiz tanımlayıcıdır. Bu değere, InvTypeCode özelliğini <StatusApplicationControl> öğesi <OTA_HotelAvailNotifRQ> ve <OTA_HotelRateAmountNotifRQ> mesaj.
Transaction / PropertyDataSet / RoomData / Name 1 Name Bir veya daha fazla odadaki oda kategorisi adının kapsayıcısıdır dil.
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 için de kullanılmaktadır.
Transaction / PropertyDataSet / RoomData / Description 1 Name Bir veya daha fazla odadaki oda kategorisi açıklamasının kapsayıcısı dil.
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 belirtilen dildeki açıklaması language özelliğine göre.
Transaction / PropertyDataSet / RoomData / Description / Text / @language 1..n string İki harfli dil kodu kullanabilirsiniz.
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs 0..1 AllowablePackageIDs <AllowablePackageID> öğelerinin kapsayıcısıdır.

<AllowablePackageIDs> belirtilmişse oda <RoomID> tarafından tanımlanan tür üst <RoomData> öğesinde yalnızca tarafından tanımlanan ücret planlarıyla birlikte <AllowablePackageID> öğeleri.

<AllowablePackageIDs> belirtilmezse oda üst öğede <RoomID> tarafından tanımlanan tür <RoomData> öğesi, herhangi bir ücret planı.

<AllowablePackageIDs> veya <AllowableRoomIDs> ancak her ikisi değil.
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs / AllowablePackageID 1..n AllowablePackageID Bu öğeyle birleştirilebilecek bir ücret planının PackageID'sini belirtir oda türü. Ücret planı, paket, fiyatlar ve stok durumu. PackageID RatePlanCode değerine karşılık gelir OTA_HotelRateAmountNotifRQ ve OTA_HotelAvailNotifRQ mesajları.
Transaction / PropertyDataSet / RoomData / Capacity 0..1 integer Bir odada bulunabilecek maksimum yetişkin ve çocuk sayısı fiziksel olarak uyum sağlaması gerekir. Bu değer, şundan büyük veya şuna eşit olmalıdır: Ücretlerle birlikte gönderdiğiniz tüm NumberOfGuests değerleridir.

<Capacity> değeri, pozitif bir tam sayı olmalıdır 1 ile 99 arasında (bu değerler dahil). Görüntüleyin burada bulabilirsiniz.

Not: <Capacity> ayarlanmazsa kişi sayısı sınırsız kabul edilir. Bu alan ayarlanmadığında ExtraGuestCharges veya AdditionalGuestAmounts tanımlanmış, fiyatlar istenilen sayıda kişi için oluşturulabilir. Önerilerimiz: ExtraGuestCharges ise <Capacity> ayarını veya AdditionalGuestAmounts, fiyatların Geçersiz olan doluluk seçenekleri için gösterilmez.
Transaction / PropertyDataSet / RoomData / AdultCapacity 0..1 integer Bir odada fiziksel olarak bulunabilecek maksimum yetişkin sayısı uyum sağlamasıdır. Bu değer, minimum değerden büyük veya Ücretlerle birlikte gönderdiğiniz NumberOfGuests değer.

<AdultCapacity> değeri pozitif olmalıdır 1 ile 99 arasındaki (bu değerler dahil) tam sayı. Görüntüleyin burada bulabilirsiniz.
Transaction / PropertyDataSet / RoomData / ChildCapacity 0..1 integer Bir odanın fiziksel olarak yapabileceği maksimum çocuk sayısı uyum sağlamasıdır.

<ChildCapacity> değeri pozitif olmalıdır 1 ile 99 arasında (1 ve 99 dahil) tam sayı. Görüntüleyin burada bulabilirsiniz.
Transaction / PropertyDataSet / RoomData / OccupancySettings 0..1 OccupancySettings Bir reklamverenin doluluk gereksinimlerini kısıtlayabilen veya değiştirebilen ayarlar oda.

<OccupancySettings> öğesi, şu alt öğeleri kullanın:

  • <MinOccupancy>: Minimum konuk sayısı bir odada kalabilecektir. Örneğin, 2, bu oda tek bir konuk için rezerve edilemez.

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

  • <MinAge>: Tüm konuklar için minimum yaş sınırı bir odada kalmaya bayılıyorum. Örneğin, 18 olarak ayarlanırsa bu oda yalnızca tüm konukların 18 yaşında olduğu gruplar için rezerve edilebilir veya üst sınıra sahip olmalıdır.

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

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

Tüm alt öğelerin eklenmesi gerekmez.
Transaction / PropertyDataSet / RoomData / PhotoURL 0..n PhotoURL Belirtilen odanın veya ilgili odanın fotoğrafına ait URL ve isteğe bağlı başlık Oda Paketi. Birden fazla <PhotoURL> belirtebilirsiniz oda veya Oda Paketi için uygun.

Bu öğe aşağıdaki alt öğeleri alır:

  • <URL>: Fotoğrafın konumunu belirtir. İlgili içeriği oluşturmak için kullanılan konum herkese açık olmalı (güvenlik duvarı arkasında olmamalıdır) ve protokolü (http://).
  • <Caption>: Fotoğrafın başlığını tanımlar. Bu öğede tek bir alt öğe (<Text>) yer alır. Bu değerin iki gerekli özelliğe sahip olması gerekir: Text ve language. Text özelliği başlıktır. language özelliği de iki harfli bir en gibi bir dil kodu kullanabilirsiniz.
<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

Bir Japon otel odasının tarzını belirtir.

Geçerli değerler şunlardır:

  • western: Yataklı, Batı tarzı bir oda.
  • japanese: Futon yatak bulunan Japon tarzı bir oda.
  • japanese_western: Japon ve kovboy tarzı bir oda ve Japon tarzı futon yataklar vardır.
Transaction / PropertyDataSet / RoomData / RoomFeatures / Beds 0..1 Object Odadaki kadar <Bed> bulunur. Not Japon futonları burada sayılmaz.

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

  • size (isteğe bağlı): Geçerli değerler şunlardır: single, semi_double, double, queen ve king.
Her <Bed> aşağıdaki alt öğelere sahiptir:
  • <Width> (isteğe bağlı): Yatak genişliğini belirtir. cm değerine sahip unit özelliği bulunmalıdır Ayrıca, Yatağın genişliği, tam sayı santimetre olacak şekilde number.
  • <Length> (isteğe bağlı): Yatak uzunluğunu belirtir. cm değerine sahip unit özelliği bulunmalıdır ve yatağın uzunluğuyla number özelliği tam sayı santimetre.
Ö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üitse bu öğeyi sağlayın.
Transaction / PropertyDataSet / RoomData / RoomFeatures / Capsule 0..1 enum Bu oda, kapsül oda olduğunda bu öğeyi sağlayın.
Transaction / PropertyDataSet / RoomData / RoomFeatures / Roomsharing 0..1 enum Bu odanın, tesis sahibi gibi diğer kişilerle paylaşılıp paylaşılmayacağı veya diğer davetlileri kullanabilirsiniz. Geçerli değerler shared ve private değerleridir.
Transaction / PropertyDataSet / RoomData / RoomFeatures / Outdoor 0..1 enum Bu oda, şu özelliklere sahip olmayan bir açık hava konaklama tesisiyse bu öğeyi sağlayın: Sabit duvarlara, sıhhi tesisata ve klimaya sahip. Örneğin, otel odaları konukların çadırda kaldığı ve çadırda kaldığı kamp alanları Konukların kendi karavanlarıyla geldiği karavan parkları, açık hava konaklama yerleridir.
Transaction / PropertyDataSet / RoomData / RoomFeatures / MobileAccessible 0..1 enum Bu oda, hareket kabiliyetine 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 bilgisi. Geçerli değerleri non_smoking ve smoking şeklindedir.
Transaction / PropertyDataSet / RoomData / RoomFeatures / BathAndToilet 0..1 Object Odadaki banyo ve tuvalet hakkında bilgiler içerir.

Özellik:

  • relation (isteğe bağlı): Banyo ve banyonun bağlantılı olarak yerleştirilmelidir. Geçerli değerler: together; örneğin, iki banyonun da bulunduğu bir banyo ve tuvalet aynı odada, ve separate, banyo ve tuvalet ayrı ayrı alanlar'a dokunun. Odada şunlar olmadığında bu özellik ayarlanmamalıdır: ve tuvalet var.

Öğ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 banyoda küvet var. Geçerli değerler: 0 (veya false) ve 1 (veya true).
    • shower (isteğe bağlı): Banyoda duş. Geçerli değerler 0 (veya false) ve 1 (veya true).
  • <Toilet> (isteğe bağlı): Bu öğenin varlığı bu odada tuvalet olduğunu gösterir.

    Özellikler şunlardır:

    • electronic_bidet (isteğe bağlı): tuvalette elektronik Bide bulunur. Geçerli değerler 0 (veya false) ve 1 (veya true).
    • mobility_accessible (isteğe bağlı): tuvalet, engellilere uygun. Geçerli değerler: 0 (veya false) ve 1 (veya true).

Ö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 sağlayın.
Transaction / PropertyDataSet / RoomData / RoomFeatures / AirConditioning 0..1 enum Bu odada klima varsa bu öğeyi sağlayın.
Transaction / PropertyDataSet / RoomData / RoomFeatures / Balcony 0..1 enum Bu odada balkon veya veranda varsa bu öğeyi sağlayı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

Ücret özelliklerini ve şu özelliklere sahip terimleri açıklayan öğelerin kapsayıcısı: fiziksel oda açıklamasının bir parçası değildir.

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

Transaction / PropertyDataSet / PackageData / PackageID 1 string Bu mesajlardaki PackageID değerine karşılık gelir OTA_HotelRateAmountNotifRQ içinde RatePlanCode ve OTA_HotelAvailNotifRQ mesajları.
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 Paketin adını bir dilde belirtir.
Transaction / PropertyDataSet / PackageData / Name / Text / @text 1..n string Paketin, language özelliği için de kullanılmaktadır.
Transaction / PropertyDataSet / PackageData / Description 1 Description Bir veya daha fazla dilde paketin açıklamasının kapsayıcısıdır.
Transaction / PropertyDataSet / PackageData / Description / Text 1..n Text Paketin açıklamasını bir dilde belirtir.
Transaction / PropertyDataSet / PackageData / Description / Text / @text 1..n string Paketin, language özelliği için de kullanılmaktadır.
Transaction / PropertyDataSet / PackageData / Description / Text / @language 1..n string İki harfli dil kodu kullanabilirsiniz.
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs 0..1 AllowableRoomIDs <AllowableRoomID> öğelerinin kapsayıcısıdır.

<AllowableRoomIDs> belirtilirse ücret planı <PackageID> tarafından belirlendi üst <PackageData> öğesinde yalnızca tarafından tanımlanan oda türleriyle birlikte <AllowableRoomID> öğeleri.

<AllowableRoomIDs> belirtilmezse ücret ebeveynde <PackageID> tarafından tanımlanmış plan <PackageData> öğesi, herhangi bir oda türü.

<AllowablePackageIDs> veya <AllowableRoomIDs> ancak her ikisi değil.
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs / AllowableRoomID 1..n AllowableRoomID Bununla birleştirilebilecek bir oda türünün RoomID'sini belirtir ücret planı. Oda türü <RoomData> içinde tanımlanır. öğesine dokunun.
Transaction / PropertyDataSet / PackageData / Refundable 0..1 Refundable Bir ücretin tamamen geri ödenebilir veya iptal edilebilir olarak listelenmesini sağlar. Sağlanmazsa geri ödemeyle ilgili hiçbir bilgi gösterilmez.

Not: Tüm özellikleri ayarlamanızı öneririz. Feed bir veya daha fazla özellik eklendiğinde durum uyarı mesajı oluşturulur ayarlanmadı.

Hiçbir özelliği ayarlamazsanız ücret geri ödeme yapılabilir.

Özellikleri ayarlarken aşağıdakilere dikkat edin:

  • Eğer 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. Ücret şu şekilde görüntülenmez: diğer özelliklerden biri veya her ikisi de ayarlanmış olsa bile geri ödenebilir.
Transaction / PropertyDataSet / PackageData / Refundable / @available 1 boolean (Zorunlu) 1 olarak ayarlayın veya Fiyatın tam değere izin verip vermediğini belirtmek için true refund; aksi takdirde 0 veya false olarak ayarlanır.
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days 0..1 integer (Aşağıdaki durumlarda gereklidir: available: true) Belirtir Eksiksiz geri ödeme alınabileceği gün sayısı check-in işleminden önce istendi. 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 (Aşağıdaki durumlarda özellikle available: true) Belirtir günün en son saatine, otelin yerel saatine göre, geri ödeme isteği dikkate alınır. Bu, Belirtmek için refundable_until_days, Örneğin, "geri ödemeler iki gün önce saat 16:00'a kadar yapılabilir. check-in" yazın. refundable_until_time ayarlanmazsa varsayılan olarak gece yarısına ayarlanır.
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'dir (veya true).

<Meals> kullanmanız tercih edilir. (<BreakfastIncluded>) içeriyor.
Transaction / PropertyDataSet / PackageData / CheckinTime 0..1 Time Otelin yerel saatine göre mümkün olan en erken giriş saati. Saat 24:00'ten az olmalıdır.
Transaction / PropertyDataSet / PackageData / CheckoutTime 0..1 Time Otelin yerel saatine göre mümkün olan en geç çıkış saati.
Transaction / PropertyDataSet / PackageData / InternetIncluded 0..1 boolean Odada ücretsiz internet erişimi olup olmadığını belirtir diğer odalarda bu imkan yoktur. Bu öğeyi Tüm odalarda ücretsiz internet imkanı sunan otel. Bu öğe oda içi kablolu internet veya şurada bulunan kablosuz internet için geçerli değildir: oda seçeneği yoktur. Geçerli değerler 0 (veya false) ve 1 (veya true).
Transaction / PropertyDataSet / PackageData / Meals 0..1 Object Bu paketteki yemeklerle ilgili bilgiler içerir.

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

  • included (gerekli): 1 (veya true) fiyata kahvaltı/akşam yemeği dahilse; aksi takdirde 0 veya false olarak ayarlandı.
  • in_room (isteğe bağlı): 1 (veya true) (konuklara kahvaltı/akşam yemeği seçeneği sunuluyorsa) kaldıkları odada, aksi takdirde 0 (veya false) tıklayın.
  • in_private_space (isteğe bağlı): 1 olarak ayarlayın (veya true) konuklara kahvaltı imkanı sunuluyorsa. (kaldıkları oda hariç) yemekten kaçabileceklerini diğer konuklarla iletişim kurma; aksi takdirde 0 (veya false) tıklayın.
  • buffet (isteğe bağlı): 1 (veya true) kahvaltı/akşam yemeği açık büfe olarak servis ediliyorsa; aksi takdirde 0 (veya false) olarak ayarlanır.

İsteğe bağlı özellikler yalnızca included aşağıdaki durumlarda kullanılır: doğru.

Yemek filtreleri için (no meals, breakfast only, dinner only ve breakfast and dinner) iş yerine, hem <Breakfast> hem de <Dinner> gerekiyor included özelliğiyle sağlanacak.
Transaction / PropertyDataSet / PackageData / ParkingIncluded 0..1 boolean Odaya ücretsiz otopark dahil olup olmadığı, Aksi takdirde bu otelde otopark ücretlidir. Belirtme ücretsiz otopark sunan bir otelde bu öğe için bir değer. Geçerli değerler 0 (veya false) ve 1 (veya true). 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ı) bakın.

Örnekler

Oda ve paket verileri

Aşağıda, tesisin odasının ve odanın nasıl tanımlanacağını gösteren Transaction (Tesis Verileri) mesajındaki verileri paketleyecektir. overlay özelliği, beklenmedik şekilde herhangi bir verinin mevcut olması durumunda Tüm mevcut veriler silinir ve bu mesajdaki verilerle değiştirilir:

<?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 oda türü ve paketin nasıl ekleneceğine dair bir örnek verilmiştir: mevcut <Transaction> verileri:

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

Aşağıda, mevcut oda türlerini kaldırma ve paketlerini ekleyebilirsiniz. Bu senaryoda, "Oda ve paket verileri"ndeki mesajlar ve "Oda türü ekle"yi seçin. daha önce Google'a gönderilmişse, King ve Google, mesajı aldıktan sonra Double oda türü artık mevcut olmayacak gösteriliyor. Paket verilerinin kaldırılması, genel ücret planını etkiler. Transaction (Tesis Verileri), OTA_HotelRateAmountNotifRQ, ve OTA_HotelAvailNotifRQ mesaj (aynı PackageID öğesine başvuruda bulunarak) değeri), dolayısıyla diğer mesaj türlerini kullanan ilgili güncellemeler PackageID_2 ve PackageID_3 öğelerinin artık geçerli olmadığını yansıtmak için tanımlanmalıdır.

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

Aşağıda, <AllowablePackageIDs> özelliğinin nasıl kullanılacağına dair bir örnek verilmiştir. öğesini tıklayın. Bu örnekte Queen oda türü (RoomID_2) yalnızca paket ve ücret planı PackageID_1 olarak tanımlanmıştır.

<?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>, Oda kapasiteleriyle ilgili kısıtlamalar ayarlamak için <ChildCapacity> öğesi.

<?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, Etkinlikte en fazla 4 yetişkin ve 3 çocuk yer alabilir. Üç kapasite bu odanın rezervasyon yapılabilir olması için koşulların karşılanması gerekir. Bu her biri iki yatak odasına sahip tipik bir odayı sığmasını sağlar. Alt çocuk kapasitesi, toplam kapasiteden bir az azdır. çünkü odada en az bir yetişkin bulunmalıdır.

<RoomFeatures> ve yemekler için genişletilmiş örnekler

JapaneseHotelRoomStyle öğesinin varsayılan değeri yok. Bir değerin atlanması XML hatasına neden olmaz, ancak girişiniz kullanıcı oda stiline veya yataklara göre filtrelendiğinde gösterilen arama sonuçlarında gösterilir.

İki adet tek kişilik yatak

Aşağıdaki örnekte <RoomFeatures> hizmetinin 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 kişilik western tarzı oda örneği verilmiştir. double yatak.

<?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 yataksız Japon tarzı bir oda örneği verilmiştir. Yatak japanese stili oda için bilgi gerekmiyor.

<?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ı kovboy Japon tarzı

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

<?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 içindeki yatak sayısı hakkında bilgiye sahip değilse oda varsa 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 ve öğeler için oda ve paket meta verileri tanımlanmaktadır. ve check-in ile çıkış saatlerini öğrenin:

<?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 aşağıdaki 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 şunlar var: öğeler ve özellikler:

Öğe / @Özellik Yineleme sayısı Tür Açıklama
TransactionResponse 1 Complex element Alınan bir öğenin başarısını veya sorunlarını gösteren kök öğe İşlem istek mesajı.
TransactionResponse / @timestamp 1 DateTime Bu mesajın oluşturulma tarihi ve saati.
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 başarıyla işlendiğini belirtir uyarı, hata veya sorun yok.

<Success> veya <Issues> her iletide yer alır.
TransactionResponse / Issues 0..1 Issues işlenirken karşılaşılan bir veya daha fazla sorun için bir kapsayıcı İşlem mesajı.

<Success> veya <Issues> her iletide yer alır.
TransactionResponse / Issues / Issue 1..n Issue Güncelleme sırasında karşılaşılan uyarı, hata veya sorunun Transaction mesajının işlenmesiyle ilgilidir. Bu sorunlarla ilgili ayrıntılar şurada bulunabilir: Feed Durumu Hata Mesajları başlıklı bölüme bakın.
TransactionResponse / Issues / Issue / @code 1 integer Sorunun tanımlayıcısıdır.
TransactionResponse / Issues / Issue / @status 1 enum

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

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

Ö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.

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