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 lần cập nhật delta.
Đố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>, một bản cập nhật cho mọi quy định hạn chế đã xác định trước đó
chỉ thay thế giá trị của cùng một quy định hạn chế, trong khi việc thêm quy tắc 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 tối thiểu
thời gian lưu trú trong 2 ngày đã được xác định trước đó, sau đó là một thông báo mới
chỉ chứa thời gian lưu trú tối đa là 7 ngày đã được cập nhật, thì thuộc tính 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 như sau:
Lưu ý: Mỗi loại quy định hạn chế về thời gian lưu trú đều
đều được đặt một cách độc lập. Ví dụ: một thông báo đặt
SetMaxLOS không ghi đè giá trị đã xác định trước đó
trong 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 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 tin nhắn 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. Đó là 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 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 đối tác
tài khoản. |
| 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, giá trị này cần phải khớp với |
| OTA_HotelAvailNotifRQ / AvailStatusMessages | 1 | AvailStatusMessages | Vùng chứa một hoặc nhiều <AvailStatusMessage>
phần tử. |
| 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à các quy định hạn chế của giá phòng cho các khoảng thời gian khác nhau cho một tài sản. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit | 1 | integer |
Lưu ý:
Nên ưu tiên sử dụng thông báo OTA_HotelInvCountNotifRQ thay vì chế độ cài đặt này
. Số phòng còn lại khách có thể đặt trước cho
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 khách hàng cụ thể
|
| 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 dựa trên múi giờ của cơ sở lưu trú (tính cả ngày) của 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ẽ được áp dụng
cho đến 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 thành |
| 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 thành |
| 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 thành |
| 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 thành |
| 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 thành |
| 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 thành |
| 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 thành |
| 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 liên kết
đến <RoomID> trong trang 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 một giao dịch (Dữ liệu của cơ sở lưu trú)
. Gói giá được định nghĩa thêm và được đề cập đến
trong <StatusApplicationControl> ở cả hai
<OTA_HotelRateAmountNotifRQ> và
<OTA_HotelAvailNotifRQ> tin nhắn.
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> bao gồm
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 thiết bị
<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ú. Lưu ý rằng giá trị của
0 được coi là không có hạn chế. Ví dụ: <LengthOfStay
Time="0" MinMaxMessageType="SetMaxLOS"> có nghĩa là không có tối đa
thời gian lưu trú.
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. Hợp lệ
giá trị 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 sắp đến
dựa trên cơ sở. SetForwardMinStay và
SetForwardMaxStay là dựa trên thời gian lưu trú. Giá trị lớn nhất phải là
lớn hơn hoặc bằng giá trị nhỏ nhất. |
| 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ải có phần tử này 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 mỗi thời gian lưu trú có được phép hay không, từ một đêm đến giá trị (
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. Cho
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> bao gồm
Thuộc tính BookingLimit. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status | 0..1 | enum | Cho biết liệu loại hạn chế được chỉ định bởi
Thuộc tính Restriction đang mở hoặc đóng. Giá trị hợp lệ
là:
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 thông tin địa phương của cơ sở lưu trú
thời gian) để đặt phòng với giá phòng 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 thông tin địa phương của cơ sở lưu trú
thời gian) để đặ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 ngăn chặn các hành trình có trả phòng vào các ngày cụ thể.)
<?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 ngăn chặn các hành trình có nhận phòng vào các ngày cụ thể.)
<?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 đối với loại phòng, trước khi có thông tin về 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. (Kết quả nà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 tại khách sạn địa phương bất cứ lúc nào.
<?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 ý: Thẻ OTA_HotelInvCountNotifRQ được ưu tiên hơn 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 lần nhận phòng vào ngày 26 tháng 7 năm 2023, chỉ thời gian lưu trú là 2, 4 và 6 là được phép. 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 | 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 từ
OTA_HotelAvailNotifRQ tin nhắn. |
| OTA_HotelAvailNotifRS / Success | 0..1 | Success | Cho biết 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 khi xử lý
OTA_HotelAvailNotifRQ tin nhắn.
|
| OTA_HotelAvailNotifRS / Errors / Error | 1..n | Error | Mô tả lỗi gặp phải trong khi xử lý
OTA_HotelAvailNotifRQ tin nhắn. Bạn có thể xem thông tin chi tiết về các lỗi này
ở
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 liên kết vớ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ỉ giá trị
NotProcessed được dùng. |
| 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 được tìm thấ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
Sau đây là phản hồi cho một sự kiện đã được xử lý thành công Thông báo OTA_HotelAvailNotifRQ.
<?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 được xử lý do 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>