Yêu cầu
Cú pháp
Thông báo OTA_HotelAvailNotifRQ sử dụng cú pháp sau:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="message_ID"
TimeStamp="timestamp"
Version="3.0">
<POS>
<Source>
<RequestorID ID="partner_key"/>
</Source>
</POS>
<AvailStatusMessages HotelCode="HotelID">
<AvailStatusMessage BookingLimit="integer">
<StatusApplicationControl Start="YYYY-MM-DD"
End="YYYY-MM-DD"
Mon="boolean"
Tue="boolean"
Weds="boolean"
Thur="boolean"
Fri="boolean"
Sat="boolean"
Sun="boolean"
InvTypeCode="RoomID"/>
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="YYYY-MM-DD"
End="YYYY-MM-DD"
Mon="boolean"
Tue="boolean"
Weds="boolean"
Thur="boolean"
Fri="boolean"
Sat="boolean"
Sun="boolean"
InvTypeCode="RoomID"
RatePlanCode="PackageID"/>
<LengthsOfStay FixedPatternLength="integer">
<LengthOfStay Time="integer"
TimeUnit="[Day]"
MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
SetForwardMinStay|FullPatternLOS]">
<LOS_Pattern FullPatternLOS="pattern"/>
</LengthOfStay>
</LengthsOfStay>
<RestrictionStatus Status="[Close|Open]"
Restriction="[Arrival|Departure|Master]"
MaxAdvancedBookingOffset="integer_or_duration"
MinAdvancedBookingOffset="integer_or_duration"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Mỗi thông báo <OTA_HotelAvailNotifRQ> được coi là một bản cập nhật gia tăng.
Đối với mỗi cơ sở lưu trú, ngày, phòng và gói dịch vụ được chỉ định trong <StatusApplicationControl>, nội dung cập nhật cho mọi quy định hạn chế đã xác định trước đó chỉ thay thế giá trị của quy định hạn chế đó, trong khi việc thêm quy định hạn chế mới không ảnh hưởng đến các quy định hạn chế khác đã xác định trước đó. Ví dụ: nếu trước đó bạn đã xác định thời gian lưu trú tối thiểu là 2 ngày, sau đó bạn cập nhật một thông báo mới chỉ chứa thời gian lưu trú tối đa là 7 ngày, thì thao tác này sẽ không xoá giá trị thời gian lưu trú tối thiểu trước đó.
Phần tử và thuộc tính
Thông báo OTA_HotelAvailNotifRQ có các phần tử và thuộc tính sau:
Lưu ý: Mỗi loại quy định hạn chế về thời gian lưu trú được thiết lập độc lập. Ví dụ: một thông báo đặt SetMaxLOS sẽ không ghi đè giá trị đã xác định trước đó cho SetForwardMaxStay.
| Phần tử / @Thuộc tính | Số lần xuất hiện | Loại | Mô tả |
|---|---|---|---|
| OTA_HotelAvailNotifRQ | 1 | Complex element | Phần tử gốc của thông báo giúp xác định có giá phòng hay không. |
| OTA_HotelAvailNotifRQ / @xmlns | 0..1 | string (URI) | Vùng chứa tên tệp XML. |
| OTA_HotelAvailNotifRQ / @EchoToken | 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. Các ký tự được phép là a-z, A-Z, 0-9, _ (dấu gạch dưới) và - (dấu gạch ngang). |
| OTA_HotelAvailNotifRQ / @TimeStamp | 1 | DateTime | Ngày và giờ tạo thông báo này. |
| OTA_HotelAvailNotifRQ / @Version | 1 | decimal | Phiên bản thông báo trên OpenTravel. |
| OTA_HotelAvailNotifRQ / POS | 0..1 | POS | Vùng chứa để chỉ định tài khoản đối tác cho thông báo này. Thông thường, bạn sử dụng thuộc tính này nếu hệ thống phụ trợ của bạn cung cấp nguồn cấp dữ liệu về giá cho nhiều tài khoản đối tác. |
| OTA_HotelAvailNotifRQ / POS/ Source | 1 | Source | Bắt buộc nếu có <POS>. Vùng chứa cho <RequestorID>. |
| OTA_HotelAvailNotifRQ / POS / RequestorID | 1 | RequestorID | Bắt buộc nếu có <POS>. Xác định tài khoản đối tác. |
| OTA_HotelAvailNotifRQ / POS / RequestorID / @ID | 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ị Partner key được liệt kê trên
trang Cài đặt tài khoản trong Hotel Center.
Lưu ý: Nếu bạn có một phần phụ trợ cung cấp 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ị thuộc tính |
| OTA_HotelAvailNotifRQ / AvailStatusMessages | 1 | AvailStatusMessages | Vùng chứa một hoặc nhiều phần tử <AvailStatusMessage>. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode | 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 <id> trong phần tử <listing> trong 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. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage | 1..n | AvailStatusMessage | Xác định tình trạng phòng và quy định hạn chế về giá phòng cho nhiều khoảng thời gian đối với một cơ sở lưu trú. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit | 1 | integer |
Lưu ý: Bạn nên sử dụng thông báo
OTA_HotelInvCountNotifRQ thay vì thiết lập thuộc tính này. Số phòng còn lại khách có thể đặt trước trong phạm vi ngày trong Phải bằng hoặc lớn hơn 0. Giá trị mặc định sẽ là 0 nếu giá trị là âm hoặc không được cung cấp. Lưu ý: Để thiết lập tình trạng phòng cho một chế độ cài đặt |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl | 1 | StatusApplicationControl | Xác định phạm vi ngày, cũng như các giá trị nhận dạng loại phòng – InvTypeCode và gói giá – RatePlanCode. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start | 1 | Date | Ngày bắt đầu (sử dụng múi giờ của cơ sở lưu trú) trong phạm vi ngày. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End | 1 | Date | Ngày kết thúc (sử dụng múi giờ của cơ sở lưu trú) trong phạm vi ngày. Phải bằng hoặc lớn hơn giá trị start.
Nếu start và end bằng nhau, nội dung cập nhật sẽ áp dụng cho ngày đó. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon | 0..1 | boolean | Đặt là true hoặc 1 để thể hiện rõ là có bao gồm các ngày thứ Hai.
Nếu bạn đặt là |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue | 0..1 | boolean | Đặt thành true hoặc 1 để cho biết rõ việc có bao gồm các ngày thứ Ba.
Nếu bạn đặt là |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds | 0..1 | boolean | Được đặt là true hoặc 1 để cho biết rõ việc có bao gồm các ngày thứ Tư.
Nếu bạn đặt là |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur | 0..1 | boolean | Đặt thành true hoặc 1 để cho biết rõ việc có bao gồm các ngày thứ Năm.
Nếu bạn đặt là |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri | 0..1 | boolean | Đặt thành true hoặc 1 để cho biết rõ việc có bao gồm các ngày thứ Sáu.
Nếu bạn đặt là |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat | 0..1 | boolean | Được đặt là true hoặc 1 để cho biết rõ việc có bao gồm các ngày thứ Bảy.
Nếu bạn đặt là |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun | 0..1 | boolean | Đặt thành true hoặc 1 để cho biết rõ việc có bao gồm các ngày Chủ Nhật.
Nếu bạn đặt là |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode | 1 | string | Giá trị nhận dạng duy nhất của quỹ phòng (loại phòng). Giá trị này tương ứng với <RoomID> trong thông báo Giao dịch (Dữ liệu của cơ sở lưu trú). |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode | 0..1 | string | Giá trị nhận dạng riêng biệt của gói giá. Giá trị nhận dạng này tương ứng với giá trị của <PackageID> trong thông báo Giao dịch (Dữ liệu của cơ sở lưu trú). Gói giá còn được xác định thêm và được đề cập đến trong phần <StatusApplicationControl> của cả thông báo <OTA_HotelRateAmountNotifRQ> và <OTA_HotelAvailNotifRQ>.
Thuộc tính |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay | 0..1 | LengthsOfStay | Vùng chứa để xác định các quy định hạn chế về thời gian lưu trú. Không được sử dụng nếu <AvailStatusMessage> chứa thuộc tính BookingLimit. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength | 0..1 | integer | Độ dài của mẫu được xác định trong FullPatternLOS.
Lưu ý: Bạn phải đặt thuộc tính này khi sử dụng |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay | 1..n | LengthOfStay | Xác định các quy định hạn chế về thời gian lưu trú. Khi sử dụng nhiều phần tử <LengthOfStay>, mỗi phần tử phải chỉ định một giá trị MinMaxMessageType khác nhau. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time | 0..1 | integer | Giá trị đơn vị đo lường của thời gian lưu trú. Xin lưu ý rằng giá trị 0 được xem là không có quy định hạn chế. Ví dụ: <LengthOfStay
Time="0" MinMaxMessageType="SetMaxLOS"> có nghĩa là không có thời gian lưu trú tối đa.
Lưu ý: Bạn phải đặt thuộc tính này, trừ phi bạn sử dụng |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit | 0..1 | enum | Đơn vị thời gian. Giá trị mặc định là "Day" nếu không được cung cấp. Giá trị hợp lệ là:
"Day" tương đương với 1 đêm lưu trú.
|
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType | 1 | enum | Các loại quy định hạn chế về thời gian lưu trú. SetMaxLOS, SetMinLOS và FullPatternLOS dựa trên thời gian đến. SetForwardMinStay và
SetForwardMaxStay là dựa theo ngày ở. Giá trị tối đa phải lớn hơn hoặc bằng giá trị tối thiểu. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern | 0..1 | LOS_Pattern | Xác định kiểu quy định hạn chế về thời gian lưu trú.
Lưu ý: Phần tử này phải xuất hiện khi sử dụng |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS | 1 | string | Một chuỗi ký tự Y và N cho biết liệu mỗi khoảng thời gian lưu trú có được phép hay không, từ 1 đêm cho đến giá trị trong FixedPatternLength. Mọi khoảng thời gian lưu trú dài hơn
FixedPatternLength sẽ kế thừa giá trị ở vị trí cuối cùng. Ví dụ: với FixedPatternLength="4" và
FullPatternLOS="YNYN", chỉ cho phép thời gian lưu trú là 1 và 3.
|
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus | 0..1 | RestrictionStatus | Xác định các quy định hạn chế của lịch trình. Không được sử dụng nếu <AvailStatusMessage> chứa thuộc tính BookingLimit. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status | 0..1 | enum | Cho biết loại quy định hạn chế mà thuộc tính Restriction chỉ định là mở hay đóng. Các giá trị hợp lệ là:
Giá trị Open và Close có Arrival:
Tổ hợp này chỉ định những ngày trong hành trình mà khách có thể nhận phòngOpen và Close có Departure:
Tổ hợp này chỉ định những ngày nào trong hành trình có thể trả phòngNgày Ví dụ: đối với một lượt lưu trú từ ngày 1 đến ngày 4 tháng 4, trong đó ngày 2 đến ngày 4 tháng 4 không nhận khách đến vẫn có thể đặt phòng. Lưu ý:
|
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction | 0..1 | enum | Bạn phải cung cấp thuộc tính này nếu cung cấp Các giá trị hợp lệ là:
Cả Ví dụ: đối với thời gian lưu trú 3 đêm có ngày đến là ngày 1 tháng 4, toàn bộ hành trình là từ ngày 1 tháng 4 đến ngày 4 tháng 4. Bạn phải đặt giá trị Lưu ý: Nếu bạn không chỉ định |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset | 0..1 | integer or duration | Thời gian tối thiểu trước ngày đến (theo giờ địa phương của cơ sở lưu trú) để có thể đặt phòng với mức giá này.
Các loại giá trị hợp lệ là:
|
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset | 0..1 | integer or duration | Thời gian tối đa trước ngày đến (theo giờ địa phương của cơ sở lưu trú) để có thể đặt phòng với mức giá này.
Các loại giá trị hợp lệ là:
|
Ví dụ
Ngày đến của LoS
Đặt thời gian lưu trú tối thiểu và tối đa (dựa theo ngày đến).
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay>
<LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/>
<LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Thời gian lưu trú
Đặt thời gian lưu trú tối thiểu và tối đa (dựa theo ngày ở).
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay>
<LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/>
<LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Xoá các hạn chế về LoS
Đặt Time="0" trên <LengthOfStay> cho biết không có quy định hạn chế nào đối với thời gian lưu trú được chỉ định. Ví dụ: <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> có nghĩa là không có quy định hạn chế về thời gian lưu trú tối đa.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2024-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2024-07-26"
End="2024-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay>
<LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Quy định hạn chế về việc khởi hành
Đặt quy định hạn chế khi gần đến ngày đi. (Điều này giúp loại bỏ những lịch trình có ngày trả phòng rơi vào những ngày đã xác định).
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Departure"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Hạn chế khi đến
Đặt quy định hạn chế khi gần đến ngày đến. (Điều này giúp loại bỏ những lịch trình có ngày nhận phòng rơi vào những ngày đã xác định).
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Arrival"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Ngày có phòng
Mở thông báo phòng trống đối với một loại phòng và gói giá vào những ngày nhất định.
Lưu ý: Ngoài ra, bạn cũng cần cung cấp mức giá theo đêm và số lượng phòng trống của loại phòng đó phải lớn hơn 0 thì giá mới có thể sử dụng được.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Open" Restriction="Master"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Ngày không có hàng
Tắt thông báo phòng trống đối với một loại phòng và gói giá vào những ngày nhất định. (Còn gọi là "ngừng bán".)
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Master"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Quy định hạn chế về việc đặt trước
Đặt các quy định hạn chế cho thời gian đặt trước tối thiểu và tối đa, chỉ áp dụng cho các ngày cuối tuần.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-01-01"
End="2023-06-30"
Mon=”false”
Tue=”false”
Weds=”false”
Thur=”false”
Fri=”false”
Sat=”true”
Sun=”true”
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus MaxAdvancedBookingOffset="30"
MinAdvancedBookingOffset="2"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Hạn chót đặt chỗ
Áp dụng thời hạn đặt phòng là 18:00 vào ngày đến theo giờ địa phương của khách sạn.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-01-01"
End="2023-06-30"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus MinAdvancedBookingOffset="P0DT6H0M"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Nhiều quy định hạn chế
Đặt nhiều quy định hạn chế cho một số ngày nhất định đối với một loại phòng và gói giá.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Open" Restriction="Master"/>
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Arrival"/>
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Departure"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Giới hạn đặt phòng
Đặt số lượng phòng trống đối với một loại phòng trong những ngày nhất định.
Lưu ý: Bạn nên sử dụng thông báo OTA_HotelInvCountNotifRQ thay vì thiết lập thuộc tính này.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage BookingLimit="5">
<!-- Note: RatePlanCode must not be specified here when setting inventory counts. -->
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
FullPatternLoS
Đặt quy định hạn chế về thời gian lưu trú cho toàn bộ kiểu lưu trú.
Đối với lượt nhận phòng vào ngày 26 tháng 7 năm 2023, chỉ cho phép thời gian lưu trú là 2, 4 và 6. Không có thời gian lưu trú là 1, 3, 5 và 7 ngày trở lên.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-26"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay FixedPatternLength="7">
<LengthOfStay MinMaxMessageType="FullPatternLOS">
<LOS_Pattern FullPatternLOS="NYNYNYN"/>
</LengthOfStay>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Phản hồi
Cú pháp
Thông báo OTA_HotelAvailNotifRS sử dụng cú pháp sau:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
TimeStamp="timestamp"
EchoToken="echo_token"
Version="3.0">
<!-- Either Success or Errors will be populated. -->
<Success/>
<Errors>
<Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
</Errors>
</OTA_HotelAvailNotifRS>
Phần tử và thuộc tính
Thông báo OTA_HotelAvailNotifRS 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ả |
|---|---|---|---|
| OTA_HotelAvailNotifRS | 1 | Complex element | Phần tử gốc của phản hồi cho thông báo kiểm tra tình trạng phòng. |
| OTA_HotelAvailNotifRS / @TimeStamp | 1 | DateTime | Ngày và giờ tạo thông báo này. |
| OTA_HotelAvailNotifRS / @EchoToken | 1 | string | Giá trị nhận dạng duy nhất lấy từ thông báo OTA_HotelAvailNotifRQ được liên kết. |
| OTA_HotelAvailNotifRS / Success | 0..1 | Success | Cho biết rằng thông báo OTA_HotelAvailNotifRQ đã được xử lý thành công.
Mỗi thông báo có |
| OTA_HotelAvailNotifRS / Errors | 0..1 | Errors | Vùng chứa một hoặc nhiều vấn đề gặp phải trong quá trình xử lý thông báo OTA_HotelAvailNotifRQ.
Mỗi thông báo có |
| OTA_HotelAvailNotifRS / Errors / Error | 1..n | Error | Thông tin mô tả về lỗi xảy ra trong quá trình xử lý thông báo OTA_HotelAvailNotifRQ. Bạn có thể xem thông tin chi tiết về các lỗi này trong
Thông báo lỗi về trạng thái của nguồn cấp dữ liệu. |
| OTA_HotelAvailNotifRS / Errors / Error / @Type | 1 | integer | Loại cảnh báo lỗi (EWT) của Hiệp hội OpenTravel Alliance tương ứng với lỗi. Chỉ sử dụng giá trị 12 (Processing exception). |
| OTA_HotelAvailNotifRS / Errors / Error / @Code | 1 | integer | Mã lỗi (ERR) của Hiệp hội OpenTravel Alliance tương ứng với lỗi.
Chỉ sử dụng giá trị 450 (Unable to process). |
| OTA_HotelAvailNotifRS / Errors / Error / @Code | 1 | enum | Trạng thái của yêu cầu ban đầu. Chỉ sử dụng giá trị NotProcessed. |
| OTA_HotelAvailNotifRS / Errors / Error / @ShortText | 1 | string | Giá trị nhận dạng sự cố của Google. Bạn có thể xem chi tiết về các lỗi này trong Thông báo lỗi về trạng thái của nguồn cấp dữ liệu. |
Ví dụ
Thành công
Dưới đây là phản hồi cho thông báo OTA_HotelAvailNotifRQ đã được xử lý thành công.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<Success/>
</OTA_HotelAvailNotifRS>
Lỗi
Dưới đây là phản hồi cho thông báo OTA_HotelAvailNotifRQ không xử lý được do gặp lỗi.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<Errors>
<Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
</Errors>
</OTA_HotelAvailNotifRS>