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>
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 như sau:
Lưu ý: Mỗi loại giới hạn về thời gian lưu trú được đặt độ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 | Nội dung mô tả |
|---|---|---|---|
| OTA_HotelAvailNotifRQ | 1 | Complex element | Phần tử gốc của thông báo giúp xác định tình trạng phòng của giá phòng. |
| OTA_HotelAvailNotifRQ / @xmlns | 0..1 | string (URI) | Không gian tên 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 của 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. Giá trị này thường được dùng nếu phần 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 <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ư này. Giá trị 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ó 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 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> 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. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage | 1..n | AvailStatusMessage | Xác định tình trạng phòng và các quy định hạn chế của giá phòng trong nhiều khoảng thời gian cho một cơ sở lưu trú. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit | 1 | integer |
Lưu ý: Bạn nên ưu tiên sử dụng thông báo
OTA_HotelInvCountNotifRQ hơn việc đặt thuộc tính này. Số lượng phòng còn lại mà 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 là 0 nếu là giá trị â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 và 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 dựa trên múi giờ của cơ sở lưu trú và bao gồm cả phạm vi ngày. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End | 1 | Date | Ngày kết thúc (dựa trên múi giờ của cơ sở lưu trú), bao gồm cả
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 | Được đặt là true hoặc 1 để cho biết rõ việc có bao gồm các ngày thứ Hai.
Nếu bạn đặt giá trị này là |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue | 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ứ 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 | Được đặt là 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 | Được đặt là 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 | Được đặt là 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 duy nhất của gói giá. Giá trị nhận dạng này liên kết 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 <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 có 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 riêng. |
| 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 coi 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 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 trên thời gian lưu trú. 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 mẫu giới hạn về thời gian lưu trú.
Lưu ý: Phần tử này phải có mặt khi sử dụng |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS | 1 | string | Một chuỗi gồm Y và N ký tự cho biết liệu thời gian lưu trú có được phép hay không, từ một đêm đến giá trị trong FixedPatternLength. Mọi khoảng thời gian lưu trú lớn hơn
FixedPatternLength sẽ kế thừa giá trị ở vị trí cuối cùng. Ví dụ: với FixedPatternLength="4" và
FullPatternLOS="YNYN", bạn chỉ được phép lưu trú thời gian 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 có 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ế do thuộc tính Restriction chỉ định là mở hay đóng. Có các giá trị hợp lệ như sau:
Lưu ý:
|
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction | 0..1 | enum | Thuộc tính này là bắt buộc nếu bạn cung cấp Các giá trị hợp lệ là:
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ú) mà khách 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ú) mà khách có thể đặt phòng với giá phòng này.
Các loại giá trị hợp lệ là:
|
Ví dụ
Ngày đến LoS
Đặt thời gian lưu trú tối thiểu và tối đa (dựa trên 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 lượng LoS
Đặt thời gian lưu trú tối thiểu và tối đa (dựa trên thời gian lưu trú).
<?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>
Quy định hạn chế 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 vào những ngày đã chỉ đị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>
Giới hạn khi đến nơi
Đặ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 vào những ngày đã chỉ đị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>
Mở ngày có hàng
Mở thông tin 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 ý: Bạn cũng cần cung cấp giá mỗi đêm và số lượng phòng trống lớn hơn 0 cho loại phòng thì mới có thể sử dụng được giá hoàn toà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="Open" Restriction="Master"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Đóng ngày 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. (Đây còn được 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>
Giới hạn đặt trước
Đặt các quy định hạn chế về thời hạn đặt trước tối thiểu và tối đa, chỉ áp dụng vào 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 nhận đơn đặt hàng
Áp dụng hạn chót đặt phòng vào ngày đến lúc 18:00 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 tắc hạn chế
Đặt nhiều quy định hạn chế cho cùng một ngày đố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>
Hạn mức đặt trước
Đặt số lượng phòng trống cho một loại phòng trong những ngày nhất định.
Lưu ý: Bạn nên ưu tiên sử dụng thông báo OTA_HotelInvCountNotifRQ so với việc đặt 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
Thiết lập quy định hạn chế về thời gian lưu trú theo mẫu đầy đủ.
Đối với ngày 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ú từ 1, 3, 5 và 7 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 như sau:
| Phần tử / @Thuộc tính | Số lần xuất hiện | Loại | Nội dung mô tả |
|---|---|---|---|
| OTA_HotelAvailNotifRS | 1 | Complex element | Phần tử gốc của phản hồi cho thông báo về tình trạng rảnh/bận. |
| 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.
|
| 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.
|
| OTA_HotelAvailNotifRS / Errors / Error | 1..n | Error | Nội dung mô tả về lỗi gặp phải trong quá trình xử lý thông báo OTA_HotelAvailNotifRQ. Bạn có thể xem thông tin chi tiết về những lỗi này trong phần
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 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 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 của Google cho vấn đề. Bạn có thể xem thông tin chi tiết về những lỗi này trong phần 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
Sau đâ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>