Permintaan
Sintaksis
Pesan Transaction (Property Data)
menggunakan sintaksis berikut:
<?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>
Elemen dan Atribut
Pesan Transaksi (Data Properti) memiliki elemen dan atribut berikut:
Elemen / @Atribut | Kejadian | Jenis | Deskripsi |
---|---|---|---|
Transaction | 1 | Complex element | Dalam implementasi ARI, ini adalah elemen root untuk pesan yang menentukan jenis dan paket kamar untuk satu properti. |
Transaction / @timestamp | 1 | DateTime | Tanggal dan waktu pembuatan pesan ini. |
Transaction / @id | 1 | string | ID unik untuk pesan permintaan ini. Nilai ini ditampilkan dalam pesan respons. Karakter yang diizinkan adalah a-z, A-Z, 0-9, _ (garis bawah), dan - (tanda hubung). |
Transaction / @partner | 1 | string | Akun partner untuk pesan ini. Nilai string ini adalah nilai "Kunci partner" yang tercantum di
halaman Setelan akun di Pusat Pengelolaan Hotel.
Catatan: Jika Anda memiliki backend yang menyediakan feed untuk beberapa akun, nilai ini harus cocok dengan nilai atribut |
Transaction / PropertyDataSet | 1.. | PropertyDataSet | Container untuk menentukan jenis dan paket kamar untuk satu properti. |
Transaction / PropertyDataSet / @action | 0..1 | enum | Jenis pembaruan yang akan diterapkan ke definisi tarif kamar. Nilai yang valid adalah:
Atribut ini bersifat opsional dan ditetapkan secara default ke |
Transaction / PropertyDataSet / Property | 1 | string | ID unik untuk properti. Nilai ini harus cocok dengan ID Hotel yang ditentukan menggunakan
<id> di elemen <listing> di Feed Daftar Hotel. ID Hotel juga tercantum di Pusat Pengelolaan Hotel. |
Transaction / PropertyDataSet / RoomData | 0..n | RoomData | Menjelaskan kamar. Catatan: Setidaknya salah satu dari |
Transaction / PropertyDataSet / RoomData / RoomID | 1 | RoomID | ID unik untuk jenis kamar. Nilai ini direferensikan menggunakan
atribut InvTypeCode di
elemen <StatusApplicationControl> di
pesan <OTA_HotelAvailNotifRQ> dan
<OTA_HotelRateAmountNotifRQ> . |
Transaction / PropertyDataSet / RoomData / Name | 1 | Name | Container untuk nama kategori kamar dalam satu atau beberapa bahasa. |
Transaction / PropertyDataSet / RoomData / Name / Text | 1..n | Text | Menentukan nama kategori kamar dalam satu bahasa. |
Transaction / PropertyDataSet / RoomData / Name / Text / @text | 1..n | string | Nama kategori kamar dalam bahasa yang ditentukan oleh atribut language . |
Transaction / PropertyDataSet / RoomData / Description | 1 | Name | Container untuk deskripsi kategori kamar dalam satu atau beberapa bahasa. |
Transaction / PropertyDataSet / RoomData / Description / Text | 1..n | Text | Menentukan deskripsi kategori kamar dalam satu bahasa. |
Transaction / PropertyDataSet / RoomData / Description / Text / @text | 1..n | string | Deskripsi kategori kamar dalam bahasa yang ditentukan
oleh atribut language . |
Transaction / PropertyDataSet / RoomData / Description / Text / @language | 1..n | string | Kode bahasa dua huruf. |
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs | 0..1 | AllowablePackageIDs | Penampung untuk elemen <AllowablePackageID> .
Jika Jika Gunakan salah satu dari |
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs / AllowablePackageID | 1..n | AllowablePackageID | Menentukan PackageID dari paket tarif yang dapat digabungkan dengan jenis kamar ini. Paket tarif ditentukan oleh kombinasi paket, tarif, dan ketersediaan. PackageID sesuai dengan RatePlanCode di pesan OTA_HotelRateAmountNotifRQ dan OTA_HotelAvailabilityNotifRQ.
|
Transaction / PropertyDataSet / RoomData / Capacity | 0..1 | integer | Jumlah maksimum orang dewasa dan anak-anak yang dapat diakomodasi secara fisik oleh kamar. Nilai ini harus lebih besar dari atau sama dengan
nilai NumberOfGuests apa pun yang Anda kirim dengan tarif.
Nilai Catatan: Jika |
Transaction / PropertyDataSet / RoomData / AdultCapacity | 0..1 | integer | Jumlah maksimum orang dewasa yang dapat diakomodasi secara fisik oleh kamar. Nilai ini harus lebih besar dari atau sama dengan nilai
NumberOfGuests apa pun yang Anda kirim dengan tarif.
Nilai |
Transaction / PropertyDataSet / RoomData / ChildCapacity | 0..1 | integer | Jumlah maksimum turunan yang dapat diakomodasi secara fisik oleh kamar.
Nilai |
Transaction / PropertyDataSet / RoomData / OccupancySettings | 0..1 | OccupancySettings | Setelan yang dapat membatasi atau mengubah persyaratan jumlah tamu di kamar.
Elemen
<OccupancySettings> <MinOccupancy>2</MinOccupancy> <MinAge>16</MinAge> </OccupancySettings> Tidak semua elemen turunan harus disertakan. |
Transaction / PropertyDataSet / RoomData / PhotoURL | 0..n | PhotoURL | URL dan teks opsional untuk foto kamar atau Paket Kamar tertentu. Anda dapat menentukan lebih dari satu <PhotoURL> untuk sebuah kamar atau Paket Kamar.
Elemen ini menggunakan elemen turunan berikut:
<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> |
Berisi informasi tentang fitur kamar. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / JapaneseHotelRoomStyle | 0..1 | enum | Menunjukkan gaya kamar hotel Jepang. Nilai yang valid adalah:
|
Transaction / PropertyDataSet / RoomData / RoomFeatures / Beds | 0..1 | Object | Berisi <Bed> sebanyak yang dimiliki ruang. Harap diperhatikan
bahwa futon Jepang seharusnya tidak dihitung di sini.
Setiap
<Bed> memiliki elemen turunan berikut:
<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 | Berikan elemen ini jika kamar ini merupakan suite. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Capsule | 0..1 | enum | Berikan elemen ini jika ruangan ini adalah ruang kapsul. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Roomsharing | 0..1 | enum | Apakah kamar ini digunakan bersama oleh tamu lain seperti pemilik
atau tamu lain. Nilai yang valid adalah shared dan private . |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Outdoor | 0..1 | enum | Berikan elemen ini saat ruangan ini merupakan penginapan outdoor yang tidak memiliki dinding tetap, sistem pipa, dan kontrol iklim. Misalnya, kamar hotel bukanlah penginapan outdoor, sedangkan bumi perkemahan tempat tamu menginap di tenda dan taman RV tempat tamu membawa RV sendiri adalah penginapan outdoor. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / MobileAccessible | 0..1 | enum | Berikan elemen ini saat kamar ini dapat diakses mobilitas. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Smoking | 0..1 | enum | Apakah kamar ini merupakan kamar bebas rokok atau ruangan merokok. Nilai yang valid adalah non_smoking dan smoking . |
Transaction / PropertyDataSet / RoomData / RoomFeatures / BathAndToilet | 0..1 | Object | Berisi informasi tentang kamar mandi dan toilet di dalam kamar.
Atributnya adalah:
Secara opsional, elemen ini mengambil elemen turunan berikut:
Contoh: <BathAndToilet relation="separate"> <Bath bathtub="1" shower="1"/> <Toilet electronic_bidet="1" mobility_accessible="1"/> </BathAndToilet> |
Transaction / PropertyDataSet / RoomData / RoomFeatures / OpenAirBath | 0..1 | enum | Berikan elemen ini saat kamar ini memiliki pemandian pribadi terbuka. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / AirConditioning | 0..1 | enum | Berikan elemen ini saat kamar ini dilengkapi AC. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Balcony | 0..1 | enum | Berikan elemen ini saat kamar ini memiliki balkon atau beranda. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Views | 0..1 | Object | Opsi yang valid meliputi:
|
Transaction / PropertyDataSet / PackageData | 0..n | PackageData | Container untuk elemen yang menjelaskan persyaratan dan fitur tarif yang bukan bagian dari deskripsi kamar fisik. Catatan: Setidaknya salah satu dari |
Transaction / PropertyDataSet / PackageData / PackageID | 1 | string | PackageID dalam pesan ini sesuai dengan RatePlanCode di pesan OTA_HotelRateAmountNotifRQ dan OTA_HotelAvailabilityNotifRQ. |
Transaction / PropertyDataSet / PackageData / Name | 1 | Name | Container untuk nama paket dalam satu atau beberapa bahasa. |
Transaction / PropertyDataSet / PackageData / Name / Text | 1..n | Text | Menentukan nama paket dalam satu bahasa. |
Transaction / PropertyDataSet / PackageData / Name / Text / @text | 1..n | string | Nama paket dalam bahasa yang ditentukan oleh
atribut language . |
Transaction / PropertyDataSet / PackageData / Description | 1 | Description | Container untuk deskripsi paket dalam satu atau beberapa bahasa. |
Transaction / PropertyDataSet / PackageData / Description / Text | 1..n | Text | Menentukan deskripsi paket dalam satu bahasa. |
Transaction / PropertyDataSet / PackageData / Description / Text / @text | 1..n | string | Deskripsi paket dalam bahasa yang ditentukan oleh
atribut language . |
Transaction / PropertyDataSet / PackageData / Description / Text / @language | 1..n | string | Kode bahasa dua huruf. |
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs | 0..1 | AllowableRoomIDs | Penampung untuk elemen <AllowableRoomID> .
Jika Jika Gunakan salah satu dari |
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs / AllowableRoomID | 1..n | AllowableRoomID | Menentukan RoomID jenis kamar yang dapat digabungkan dengan paket tarif ini. Jenis kamar ditentukan di elemen <RoomData> .
|
Transaction / PropertyDataSet / PackageData / Refundable | 0..1 | Refundable | Memungkinkan listingan tarif sebagai dapat dikembalikan sepenuhnya atau dapat dibatalkan. Jika tidak diberikan, tidak ada informasi tentang pengembalian dana yang akan ditampilkan.
Catatan: Sebaiknya tetapkan semua atribut. Pesan peringatan status feed dibuat saat satu atau beberapa atribut tidak ditetapkan. Jika Anda tidak menetapkan atribut apa pun, tarif tersebut tidak akan ditampilkan sebagai dapat dikembalikan. Saat menetapkan atribut, perhatikan hal-hal berikut:
|
Transaction / PropertyDataSet / PackageData / Refundable / @available | 1 | boolean | (Wajib) Tetapkan ke 1 atau true untuk menunjukkan apakah tarif memungkinkan pengembalian dana penuh; jika tidak, tetapkan ke 0 atau false . |
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days | 0..1 | integer | (Wajib jika available adalah true ) Menentukan jumlah hari sebelum check in saat pengembalian dana penuh dapat diminta. Nilai refundable_until_days
harus berupa bilangan bulat antara 0 dan 330, inklusif. |
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_time | 0.. | Time | (Sangat direkomendasikan jika available adalah true ) Menentukan waktu terakhir dalam sehari, dalam waktu lokal hotel, saat permintaan pengembalian dana penuh akan dipenuhi. Nilai ini dapat digabungkan dengan refundable_until_days untuk menentukan, misalnya, "pengembalian dana tersedia hingga pukul 16.00 dua hari sebelum check-in". Jika refundable_until_time tidak ditetapkan, nilai akan ditetapkan secara default ke tengah malam. |
Transaction / PropertyDataSet / PackageData / BreakfastIncluded | 0..1 | boolean | Menentukan apakah jenis kamar ini mencakup sarapan.
Nilai yang valid adalah 0 (atau false ) dan 1 (atau true ).
Sebaiknya Anda menggunakan |
Transaction / PropertyDataSet / PackageData / CheckinTime | 0..1 | Time | Waktu check-in paling awal dalam waktu lokal hotel. Waktu harus kurang dari 24.00. |
Transaction / PropertyDataSet / PackageData / CheckoutTime | 0..1 | Time | Waktu check-out terbaru yang memungkinkan dalam waktu lokal hotel. |
Transaction / PropertyDataSet / PackageData / InternetIncluded | 0..1 | boolean | Menentukan apakah kamar memiliki akses internet bebas biaya, sedangkan kamar lain tidak menyertakan fasilitas ini. Jangan setel elemen ini di hotel yang menyediakan internet bebas biaya untuk semua kamar. Elemen ini
tidak berlaku untuk internet kabel dalam kamar atau internet nirkabel yang
tidak tersedia di kamar tamu. Nilai yang valid adalah 0 (atau false ) dan 1 (atau true ).
|
Transaction / PropertyDataSet / PackageData / Meals | 0..1 | Object | Berisi informasi tentang makanan dalam paket ini.
Elemen
Atribut opsional hanya digunakan jika Agar filter makanan ( |
Transaction / PropertyDataSet / PackageData / ParkingIncluded | 0..1 | boolean | Apakah kamar mencakup parkir gratis, di mana tempat parkir akan menjadi layanan berbayar di hotel ini. Jangan tentukan nilai untuk elemen ini untuk hotel yang menawarkan parkir gratis.
Nilai yang valid adalah 0 (atau false ) dan 1 (atau true ). Nilai defaultnya adalah false .
|
Transaction / PropertyDataSet / PackageData / PhotoURL | 0..1 | Object | (Sama seperti <PhotoURL> di <RoomData> ,
tetapi untuk paket (misalnya foto makanan).)
|
Contoh
Data kamar dan paket
Berikut adalah contoh dasar tentang cara menentukan data paket dan kamar properti di pesan Transaksi (Data Properti). Atribut overlay
digunakan untuk memastikan bahwa, jika ada data yang tidak terduga,
semua data yang ada akan dihapus dan diganti dengan data dalam pesan ini:
<?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>
Tambahkan jenis kamar
Berikut adalah contoh cara menambahkan jenis kamar dan paket ke data <Transaction>
yang ada:
<?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>
Hapus jenis kamar
Berikut adalah contoh cara menghapus jenis kamar dan paket yang ada. Dalam skenario ini, jika pesan dalam "Data kamar dan paket" dan "Tambahkan jenis kamar" telah dikirim ke Google sebelumnya, jenis kamar King
dan Double
tidak akan ada lagi setelah Google menerima pesan yang ditampilkan. Perhatikan bahwa menghapus data paket akan memengaruhi keseluruhan paket tarif
seperti yang ditentukan di seluruh pesan Transaksi (Data Properti), OTA_HotelRateAmountNotifRQ,
dan OTA_HotelAvailNotifRQ
(dengan mereferensikan nilai PackageID
yang sama), sehingga pembaruan yang sesuai menggunakan jenis pesan lainnya mungkin
diperlukan untuk menunjukkan bahwa PackageID_2
dan PackageID_3
tidak lagi
ditentukan di sini.
<?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>
Batasi paket tarif
Berikut adalah contoh cara menggunakan elemen <AllowablePackageIDs>
untuk membatasi paket tarif yang diizinkan untuk jenis kamar. Dalam contoh ini,
jenis kamar Queen
(RoomID_2
) hanya dapat digabungkan dengan paket dan
paket tarif yang diidentifikasi sebagai PackageID_1.
<?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>
Membatasi kapasitas ruang
Berikut adalah contoh cara menggunakan elemen <Capacity>
, <AdultCapacity>
,
<ChildCapacity>
untuk menetapkan batasan kapasitas kamar.
<?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>
Kamar tipe Double (RoomID_1) dapat menampung hingga 4 tamu. Selain itu, aplikasi ini mungkin memiliki hingga 4 orang dewasa dan hingga 3 anak-anak. Ketiga persyaratan kapasitas harus dipenuhi agar ruang ini dapat dipesan. Konfigurasi ini mewakili ruangan biasa dengan dua tempat tidur yang masing-masing dapat menampung dua orang. Kapasitas anak kurang satu dari kapasitas total karena ruangan harus memiliki minimal satu orang dewasa.
Contoh yang diperluas dengan <RoomFeatures>
dan makanan
JapaneseHotelRoomStyle
tidak memiliki nilai default.
Menghapus nilai tidak akan mengakibatkan error XML, tetapi listingan Anda tidak
ditampilkan dalam hasil penelusuran, saat pengguna memfilter menurut gaya kamar atau tempat tidur.
Dua tempat tidur single
Contoh berikut menunjukkan cara menggunakan <RoomFeatures>
:
<?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>
Dua tempat tidur double
Berikut adalah contoh kamar bergaya western
dengan dua
tempat tidur double
.
<?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>
Gaya Jepang tanpa tempat tidur
Berikut adalah contoh kamar bergaya Jepang tanpa tempat tidur. Informasi
tempat tidur tidak diperlukan untuk kamar bergaya japanese
.
<?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>
Barat Jepang dengan tempat tidur
Berikut adalah contoh kamar gaya japanese_western
dengan tempat tidur
ukuran king
.
<?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>
Jika partner tidak memiliki informasi jumlah tempat tidur di kamar japanese_western
, lihat contoh berikut:
<?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>
Makanan
Contoh berikut menentukan metadata paket dan kamar untuk makanan, foto, serta waktu check in dan check-out:
<?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>
Hanya sarapan
<?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>
Respons
Sintaksis
Pesan TransactionResponse (Property Data)
menggunakan sintaksis berikut:
<?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>
Elemen dan atribut
Pesan TransactionResponse (Property Data)
memiliki elemen dan atribut berikut:
Elemen / @Atribut | Kejadian | Jenis | Deskripsi |
---|---|---|---|
TransactionResponse | 1 | Complex element | Elemen root yang menunjukkan keberhasilan atau masalah untuk pesan permintaan Transaksi yang diterima. |
TransactionResponse / @timestamp | 1 | DateTime | Tanggal dan waktu pembuatan pesan ini. |
TransactionResponse / @id | 1 | string | ID unik dari pesan Transaksi yang terkait. |
TransactionResponse / @partner | 1 | string | Akun partner untuk pesan ini. |
TransactionResponse / Success | 0..1 | Success | Menunjukkan bahwa pesan Transaksi berhasil diproses tanpa peringatan, error, atau kegagalan.
|
TransactionResponse / Issues | 0..1 | Issues | Penampung untuk satu atau beberapa masalah yang ditemukan saat memproses pesan Transaksi.
|
TransactionResponse / Issues / Issue | 1..n | Issue | Deskripsi dari peringatan, error, atau kegagalan yang dialami saat memproses pesan Transaksi. Detail tentang masalah ini dapat ditemukan di Pesan Error Status Feed. |
TransactionResponse / Issues / Issue / @code | 1 | integer | ID untuk masalah. |
TransactionResponse / Issues / Issue / @status | 1 | enum | Jenis masalah yang ditemukan. Nilai yang valid adalah |
Contoh
Berhasil
Berikut adalah respons terhadap pesan Transaksi yang berhasil diproses.
<?xml version="1.0" encoding="UTF-8"?>
<TransactionResponse timestamp="2020-05-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<Success/>
</TransactionResponse>
Masalah
Berikut adalah respons terhadap pesan Transaksi yang tidak diproses karena terjadi error.
<?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>