Yêu cầu
Cú pháp
Thông báo Transaction (Property Data)
sử dụng cú pháp sau:
<?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>
Phần tử và thuộc tính
Thông báo Giao dịch (Dữ liệu của cơ sở lưu trú) có các phần tử và thuộc tính sau:
Phần tử / @Thuộc tính | Số lần xuất hiện | Loại | Mô tả |
---|---|---|---|
Transaction | 1 | Complex element | Trong một lần triển khai ARI, đây là phần tử gốc của thông báo xác định loại phòng và gói dịch vụ cho cơ sở lưu trú. |
Transaction / @timestamp | 1 | DateTime | Ngày và giờ tạo thông báo này. |
Transaction / @id | 1 | string | Giá trị nhận dạng duy nhất cho thông báo yêu cầu này. Giá trị này được trả về trong thông báo phản hồi. Ký tự được phép sử dụng là a – z, A – Z, 0 – 9, _ (dấu gạch dưới) và - (dấu gạch nối). |
Transaction / @partner | 1 | string | Tài khoản đối tác dùng cho thông báo này. Giá trị của chuỗi này là giá trị của "Khoá đối tác" được liệt kê trên
trang Cài đặt tài khoản trong Hotel Center.
Lưu ý: Nếu bạn có phần phụ trợ là nguồn cấp dữ liệu cho nhiều tài khoản, thì giá trị này cần phải khớp với giá trị của thuộc tính |
Transaction / PropertyDataSet | 1.. | PropertyDataSet | Vùng chứa xác định loại phòng và gói dịch vụ cho một cơ sở lưu trú. |
Transaction / PropertyDataSet / @action | 0..1 | enum | Loại nội dung cập nhật được áp dụng cho định nghĩa về giá phòng. Các giá trị hợp lệ là:
Thuộc tính này không bắt buộc và mặc định sẽ được đặt là |
Transaction / PropertyDataSet / Property | 1 | string | Giá trị nhận dạng duy nhất của cơ sở lưu trú. Giá trị này phải khớp với Mã khách sạn được chỉ định bằng phần tử
<id> trong phần tử <listing> của Nguồn cấp dữ liệu danh sách khách sạn. Mã khách sạn cũng có trong Hotel Center. |
Transaction / PropertyDataSet / RoomData | 0..n | RoomData | Mô tả về phòng. Lưu ý: Bạn phải cung cấp |
Transaction / PropertyDataSet / RoomData / RoomID | 1 | RoomID | Giá trị nhận dạng duy nhất cho một loại phòng. Giá trị này được tham chiếu bằng cách sử dụng thuộc tính InvTypeCode trong phần tử <StatusApplicationControl> của các thông báo <OTA_HotelAvailNotifRQ> , <OTA_HotelRateAmountNotifRQ> và <OTA_HotelInvCountNotifRQ> . |
Transaction / PropertyDataSet / RoomData / Name | 1 | Name | Vùng chứa tên của danh mục phòng bằng một hoặc nhiều ngôn ngữ. |
Transaction / PropertyDataSet / RoomData / Name / Text | 1..n | Text | Xác định tên của danh mục phòng bằng một ngôn ngữ. |
Transaction / PropertyDataSet / RoomData / Name / Text / @text | 1..n | string | Tên của danh mục phòng bằng ngôn ngữ do thuộc tính language xác định. |
Transaction / PropertyDataSet / RoomData / Description | 1 | Name | Vùng chứa thông tin mô tả của danh mục phòng bằng một hoặc nhiều ngôn ngữ. |
Transaction / PropertyDataSet / RoomData / Description / Text | 1..n | Text | Xác định thông tin mô tả của danh mục phòng bằng một ngôn ngữ. |
Transaction / PropertyDataSet / RoomData / Description / Text / @text | 1..n | string | Thông tin mô tả của danh mục phòng bằng ngôn ngữ do thuộc tính language xác định. |
Transaction / PropertyDataSet / RoomData / Description / Text / @language | 1..n | string | Mã ngôn ngữ gồm hai chữ cái. |
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs | 0..1 | AllowablePackageIDs | Vùng chứa các phần tử <AllowablePackageID> .
Nếu Nếu không xác định Sử dụng |
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs / AllowablePackageID | 1..n | AllowablePackageID | Xác định PackageID của một gói giá có thể kết hợp được với loại phòng này. Gói giá được xác định là tổng hợp các gói dịch vụ, đơn giá và tình trạng phòng. PackageID tương ứng với RatePlanCode trong các thông báo OTA_HotelRateAmountNotifRQ và OTA_HotelAvailNotifRQ.
|
Transaction / PropertyDataSet / RoomData / Capacity | 0..1 | integer | Số lượng người lớn và trẻ em tối đa mà một phòng có thể chứa được trên thực tế. Giá trị này phải lớn hơn hoặc bằng mọi giá trị NumberOfGuests mà bạn gửi cùng với giá.
Giá trị của Lưu ý: Nếu bạn không đặt |
Transaction / PropertyDataSet / RoomData / AdultCapacity | 0..1 | integer | Số lượng người lớn tối đa mà một phòng có thể chứa được trên thực tế. Giá trị này phải lớn hơn hoặc bằng các giá trị NumberOfGuests mà bạn gửi cùng với giá.
Giá trị của |
Transaction / PropertyDataSet / RoomData / ChildCapacity | 0..1 | integer | Số trẻ em tối đa mà một phòng có thể phục vụ trên thực tế.
Giá trị của |
Transaction / PropertyDataSet / RoomData / OccupancySettings | 0..1 | OccupancySettings | Các chế độ cài đặt có thể hạn chế hoặc sửa đổi yêu cầu về số người lưu trú của một phòng.
Phần tử
<OccupancySettings> <MinOccupancy>2</MinOccupancy> <MinAge>16</MinAge> </OccupancySettings> Không phải phần tử con nào cũng cần được đưa vào. |
Transaction / PropertyDataSet / RoomData / PhotoURL | 0..n | PhotoURL | URL và nội dung chú thích không bắt buộc về hình ảnh của phòng hoặc Gói dịch vụ phòng đã chọn. Bạn có thể chỉ định nhiều <PhotoURL> cho một phòng hoặc Gói dịch vụ phòng.
Phần tử này có các phần tử con sau đây:
<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> |
Chứa thông tin về các tính năng của phòng. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / JapaneseHotelRoomStyle | 0..1 | enum | Cho biết phong cách của phòng khách sạn Nhật Bản. Các giá trị hợp lệ là:
|
Transaction / PropertyDataSet / RoomData / RoomFeatures / Beds | 0..1 | Object | Chứa nhiều <Bed> như số lượng phòng. Xin lưu ý rằng bạn không được tính giường futon Nhật Bản ở đây.
Mỗi
<Bed> có các phần tử con sau:
<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 | Cung cấp phần tử này khi phòng này là một căn hộ. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Capsule | 0..1 | enum | Cung cấp phần tử này khi phòng này là phòng capsule. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Roomsharing | 0..1 | enum | Liệu phòng này có được dùng chung với những người lưu trú khác như chủ sở hữu hoặc khách lưu trú khác hay không. Các giá trị hợp lệ là shared và private . |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Outdoor | 0..1 | enum | Cung cấp phần tử này khi phòng này là nhà nghỉ dưỡng ngoài trời không có tường cố định, hệ thống cấp thoát nước và điều khiển khí hậu. Ví dụ: phòng khách sạn không phải là chỗ ở ngoài trời, trong khi khu cắm trại nơi khách ở trong lều và khu đỗ xe RV nơi khách đem xe dã ngoại của mình đến được phân loại là chỗ ở ngoài trời. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / MobileAccessible | 0..1 | enum | Cung cấp phần tử này khi phòng này có thể tiếp cận được bằng phương tiện di chuyển. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Smoking | 0..1 | enum | Phòng này có phải là phòng không hút thuốc hay phòng hút thuốc. Các giá trị hợp lệ là non_smoking và smoking . |
Transaction / PropertyDataSet / RoomData / RoomFeatures / BathAndToilet | 0..1 | Object | Chứa thông tin về phòng tắm và nhà vệ sinh trong phòng.
Thuộc tính này là:
Phần tử này có thể có các phần tử con sau đây:
Ví dụ: <BathAndToilet relation="separate"> <Bath bathtub="1" shower="1"/> <Toilet electronic_bidet="1" mobility_accessible="1"/> </BathAndToilet> |
Transaction / PropertyDataSet / RoomData / RoomFeatures / OpenAirBath | 0..1 | enum | Cung cấp phần tử này khi phòng có bồn tắm ngoài trời riêng. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / AirConditioning | 0..1 | enum | Cung cấp phần tử này khi phòng này có máy điều hoà. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Balcony | 0..1 | enum | Cung cấp phần tử này khi phòng có ban công hoặc lanai. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Views | 0..1 | Object | Các tuỳ chọn hợp lệ bao gồm:
|
Transaction / PropertyDataSet / PackageData | 0..n | PackageData | Vùng chứa các phần tử mô tả những dịch vụ theo đơn giá và điều khoản không thuộc nội dung mô tả của căn phòng thực tế. Lưu ý: Bạn phải cung cấp |
Transaction / PropertyDataSet / PackageData / PackageID | 1 | string | PackageID trong các thông báo này tương ứng với RatePlanCode trong các thông báo OTA_HotelRateAmountNotifRQ và OTA_HotelAvailNotifRQ. |
Transaction / PropertyDataSet / PackageData / Name | 1 | Name | Vùng chứa tên của gói bằng một hoặc nhiều ngôn ngữ. |
Transaction / PropertyDataSet / PackageData / Name / Text | 1..n | Text | Xác định tên của gói bằng một ngôn ngữ. |
Transaction / PropertyDataSet / PackageData / Name / Text / @text | 1..n | string | Tên của gói bằng ngôn ngữ do thuộc tính language xác định. |
Transaction / PropertyDataSet / PackageData / Description | 1 | Description | Vùng chứa thông tin mô tả của gói bằng một hoặc nhiều ngôn ngữ. |
Transaction / PropertyDataSet / PackageData / Description / Text | 1..n | Text | Xác định thông tin mô tả của gói dịch vụ bằng một ngôn ngữ. |
Transaction / PropertyDataSet / PackageData / Description / Text / @text | 1..n | string | Thông tin mô tả của gói bằng ngôn ngữ do thuộc tính language xác định. |
Transaction / PropertyDataSet / PackageData / Description / Text / @language | 1..n | string | Mã ngôn ngữ gồm hai chữ cái. |
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs | 0..1 | AllowableRoomIDs | Vùng chứa các phần tử <AllowableRoomID> .
Nếu Nếu không xác định Sử dụng |
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs / AllowableRoomID | 1..n | AllowableRoomID | Xác định RoomID của loại phòng có thể kết hợp được với gói giá này. Loại phòng được xác định trong phần tử <RoomData> .
|
Transaction / PropertyDataSet / PackageData / Refundable | 0..1 | Refundable | Cho phép niêm yết giá dịch vụ là có thể hoàn tiền đầy đủ hoặc huỷ đặt phòng. Nếu bạn không cung cấp thông tin về vấn đề hoàn tiền thì sẽ không có thông tin nào được hiển thị.
Lưu ý: Bạn nên thiết lập tất cả các thuộc tính. Thông báo cảnh báo trạng thái của nguồn cấp dữ liệu được tạo khi bạn không thiết lập một hoặc nhiều thuộc tính. Nếu bạn không thiết lập thuộc tính thì giá sẽ không xuất hiện dưới dạng có thể hoàn tiền. Khi bạn thiết lập thuộc tính, hãy lưu ý những điều sau:
|
Transaction / PropertyDataSet / PackageData / Refundable / @available | 1 | boolean | (Bắt buộc) Đặt là 1 hoặc true để cho biết giá cho phép hoàn tiền toàn bộ; nếu không, hãy đặt là 0 hoặc false . |
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days | 0..1 | integer | (Bắt buộc nếu available là true ) Xác định số ngày trước khi nhận phòng mà người dùng có thể yêu cầu hoàn tiền toàn bộ. Giá trị của refundable_until_days phải là số nguyên từ 0 đến 330. |
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_time | 0.. | Time | (Nên áp dụng nếu available là true ) Xác định thời gian mới nhất trong ngày theo giờ địa phương của khách sạn mà tại thời điểm đó, yêu cầu hoàn tiền đầy đủ sẽ được chấp nhận. Bạn có thể kết hợp thuộc tính này với refundable_until_days để xác định. Ví dụ: "được phép hoàn tiền đến 4 giờ chiều hai ngày trước khi nhận phòng". Nếu bạn không đặt refundable_until_time thì giá trị mặc định là nửa đêm. |
Transaction / PropertyDataSet / PackageData / BreakfastIncluded | 0..1 | boolean | Xác định loại phòng này có bao gồm bữa sáng hay không.
Các giá trị hợp lệ là 0 (hoặc false ) và 1 (hoặc true ).
Bạn nên sử dụng |
Transaction / PropertyDataSet / PackageData / CheckinTime | 0..1 | Time | Thời gian nhận phòng sớm nhất có thể theo giờ địa phương của khách sạn. Thời gian phải nhỏ hơn 24:00. |
Transaction / PropertyDataSet / PackageData / CheckoutTime | 0..1 | Time | Giờ trả phòng muộn nhất có thể theo giờ địa phương của khách sạn. |
Transaction / PropertyDataSet / PackageData / InternetIncluded | 0..1 | boolean | Xác định xem phòng có cho phép truy cập dịch vụ Internet miễn phí hay không trong khi các phòng khác không có tiện nghi này. Đừng đặt phần tử này trong một khách sạn cung cấp Internet miễn phí cho tất cả các phòng. Phần tử này không áp dụng cho dịch vụ Internet có dây trong phòng hoặc dịch vụ Internet không dây không có trong phòng khách. Các giá trị hợp lệ là 0 (hoặc false ) và 1 (hoặc true ).
|
Transaction / PropertyDataSet / PackageData / Meals | 0..1 | Object | Chứa thông tin về các bữa ăn trong gói này.
Phần tử
Các thuộc tính không bắt buộc chỉ được sử dụng khi Để bộ lọc bữa ăn ( |
Transaction / PropertyDataSet / PackageData / ParkingIncluded | 0..1 | boolean | Xác định phòng có bao gồm chỗ đỗ xe miễn phí hay không. Nếu không, bãi đỗ xe tại khách sạn này sẽ là dịch vụ trả phí. Đừng chỉ định giá trị cho phần tử này đối với khách sạn cung cấp chỗ đỗ xe miễn phí.
Các giá trị hợp lệ là 0 (hoặc false ) và 1 (hoặc true ). Giá trị mặc định là false .
|
Transaction / PropertyDataSet / PackageData / PhotoURL | 0..1 | Object | (Tương tự như <PhotoURL> trong <RoomData> , nhưng dành cho gói (ví dụ: ảnh bữa ăn).)
|
Ví dụ
Dữ liệu về phòng và gói
Sau đây là ví dụ cơ bản về cách xác định dữ liệu phòng và gói dịch vụ của cơ sở lưu trú trong thông báo Giao dịch (Dữ liệu của cơ sở lưu trú). Thuộc tính overlay
được dùng để đảm bảo rằng nếu có dữ liệu tồn tại nhưng chưa được biết đến thì mọi dữ liệu hiện có sẽ bị xoá và thay thế bằng dữ liệu trong thông báo này:
<?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>
Thêm loại phòng
Sau đây là ví dụ về cách thêm một loại phòng và gói dịch vụ vào dữ liệu <Transaction>
hiện có:
<?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>
Xoá loại phòng
Sau đây là ví dụ về cách xoá loại phòng và gói dịch vụ hiện có. Trong trường hợp này, nếu trước đó các thông báo trong phần "Dữ liệu về phòng và gói" và "Thêm loại phòng" đã được gửi tới Google, thì sẽ không còn các loại phòng King
và Double
khi Google nhận được thông báo hiển thị. Xin lưu ý rằng việc xoá dữ liệu gói sẽ ảnh hưởng đến gói giá tổng thể được xác định trong các thông báo Giao dịch (Dữ liệu của cơ sở lưu trú), OTA_HotelRateAmountNotifRQ và OTA_HotelAvailNotifRQ
(bằng cách tham chiếu cùng một giá trị PackageID
). Do đó, bạn có thể phải cập nhật tương ứng bằng các loại thông báo khác để phản ánh rằng PackageID_2
và PackageID_3
không còn được xác định ở đây.
<?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>
Hạn chế gói giá
Sau đây là ví dụ về cách sử dụng phần tử <AllowablePackageIDs>
để hạn chế gói giá cho phép đối với một loại phòng. Trong ví dụ này, loại phòng Queen
(RoomID_2
) chỉ có thể kết hợp với gói dịch vụ và gói giá được xác định là 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>
Giới hạn sức chứa của phòng
Sau đây là ví dụ về cách sử dụng các phần tử <Capacity>
, <AdultCapacity>
, <ChildCapacity>
để đặt các quy định hạn chế về sức chứa phòng.
<?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>
Loại phòng đôi (RoomID_1) có thể có tối đa 4 khách. Ngoài ra, phòng này có thể chứa tối đa 4 người lớn và tối đa 3 trẻ em. Bạn phải đáp ứng cả 3 yêu cầu về sức chứa thì mới có thể đặt phòng này. Cấu hình này đại diện cho một phòng thông thường có hai giường, mỗi giường dành cho hai người. Số trẻ em ít hơn một so với tổng số người vì phòng phải có ít nhất một người lớn.
Ví dụ mở rộng với <RoomFeatures>
và bữa ăn
JapaneseHotelRoomStyle
không có giá trị mặc định.
Việc bỏ qua một giá trị sẽ không dẫn đến lỗi XML, nhưng trang thông tin của bạn sẽ không xuất hiện trong kết quả tìm kiếm khi người dùng lọc theo kiểu phòng hoặc số giường.
Hai giường đơn
Ví dụ sau đây cho thấy cách sử dụng <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>
Hai giường đôi
Sau đây là ví dụ về phòng kiểu western
có hai giường 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>
Phòng kiểu Nhật không có giường
Sau đây là ví dụ về một phòng theo phong cách Nhật Bản không có giường. Không bắt buộc phải cung cấp thông tin về giường cho phòng kiểu 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>
Phòng kiểu Nhật pha trộn phương Tây có giường
Sau đây là ví dụ về một phòng theo phong cách japanese_western
có giường kích thước 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>
Nếu đối tác không có thông tin về số lượng giường trong phòng japanese_western
, hãy tham khảo ví dụ sau:
<?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>
Bữa ăn
Ví dụ sau đây xác định siêu dữ liệu của phòng và gói dịch vụ cho bữa ăn, ảnh, cũng như thời gian nhận phòng và trả phòng:
<?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>
Chỉ có bữa sáng
<?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>
Phản hồi
Cú pháp
Thông báo TransactionResponse (Property Data)
sử dụng cú pháp sau:
<?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>
Phần tử và thuộc tính
Thông báo TransactionResponse (Property Data)
có các phần tử và thuộc tính sau:
Phần tử / @Thuộc tính | Số lần xuất hiện | Loại | Mô tả |
---|---|---|---|
TransactionResponse | 1 | Complex element | Phần tử gốc cho biết thông báo yêu cầu Giao dịch nhận được đã thành công hay gặp lỗi. |
TransactionResponse / @timestamp | 1 | DateTime | Ngày và giờ tạo thông báo này. |
TransactionResponse / @id | 1 | string | Giá trị nhận dạng duy nhất lấy từ thông báo Giao dịch tương ứng. |
TransactionResponse / @partner | 1 | string | Tài khoản đối tác dùng cho thông báo này. |
TransactionResponse / Success | 0..1 | Success | Cho biết rằng thông báo Giao dịch đã được xử lý thành công mà không có cảnh báo, lỗi hoặc lần xử lý hỏng nào.
Mỗi thông báo có |
TransactionResponse / Issues | 0..1 | Issues | Vùng chứa một hoặc nhiều lỗi gặp phải trong quá trình xử lý thông báo Giao dịch.
Mỗi thông báo có |
TransactionResponse / Issues / Issue | 1..n | Issue | Thông tin mô tả về cảnh báo, lỗi hoặc lần xử lý hỏng gặp phải trong quá trình xử lý thông báo Giao dịch. Bạn có thể xem thông tin chi tiết về các vấn đề này trong Thông báo lỗi về trạng thái của nguồn cấp dữ liệu. |
TransactionResponse / Issues / Issue / @code | 1 | integer | Giá trị nhận dạng của vấn đề. |
TransactionResponse / Issues / Issue / @status | 1 | enum | Loại vấn đề gặp phải. Các giá trị hợp lệ là |
Ví dụ
Thành công
Dưới đây là phản hồi cho một thông báo Giao dịch được xử lý thành công.
<?xml version="1.0" encoding="UTF-8"?>
<TransactionResponse timestamp="2020-05-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<Success/>
</TransactionResponse>
Vấn đề
Dưới đây là phản hồi cho thông báo Giao dịch không được xử lý do gặp lỗi.
<?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>