Trang này được dịch bởi Cloud Translation API.

OTA_HotelAvailNotifRQ (OTA_HotelAvailNotifRQ)

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>

Lưu ý quan trọng: 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 đượ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 đó sẽ chỉ thay thế giá trị của cùng quy tắc hạn chế đó, còn 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 trước đó thời gian lưu trú tối thiểu là 2 ngày đã được xác định và sau đó 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 giới hạn về thời gian lưu trú được đặt một cách độc lập. Ví dụ: thông báo thiết lập 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 của 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: `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. Thuộc tính 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 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ị 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 cần phải khớp với giá trị thuộc tính `partner` của thông báo Giao dịch (Dữ liệu của cơ sở lưu trú) và giá trị thuộc tính `ID` trong phần tử `<RequestorID>` của thông báo `<OTA_HotelRateAmountNotifRQ>` cho cùng một tài khoản.
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 phần tử <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ế về giá phòng cho nhiều khoảng thời gian của một cơ sở lưu trú.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit	1	integer	Lưu ý: Ưu tiên thông báo OTA_HotelInvCountNotifRQ hơn là việc đặt thuộc tính này. Số phòng còn lại có thể đặt trước trong phạm vi ngày tại `<StatusApplicationControl>`. Nếu bạn chỉ định `BookingLimit`, thì `<StatusApplicationControl>` phải chỉ định `InvTypeCode` và `<AvailStatusMessage>` không được chứa `<LengthOfStay>` hoặc `<RestrictionStatus>`. Phải bằng hoặc lớn hơn 0. Giá trị mặc định là 0 nếu 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 `<StatusApplicationControl>` nhất định, bạn phải đặt thuộc tính `BookingLimit` ít nhất một lần.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl	1	StatusApplicationControl	Xác định phạm vi ngày, cũng như giá trị nhận dạng cho 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à có bao gồm 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 thành `true`, thì những ngày khác trong tuần không được đặt rõ ràng là "true" sẽ bị loại trừ (thực tế, các ngày đó sẽ bị lọc ra khỏi những ngày trong phạm vi `Start and End).`
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 `true`, thì những ngày khác trong tuần không được đặt rõ ràng là `true` sẽ bị loại trừ (thực tế, những ngày khác trong tuần sẽ bị lọc ra khỏi những ngày trong khoảng thời gian từ `Start` đến `End`).
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 `true`, thì những ngày khác trong tuần không được đặt rõ ràng là `true` sẽ bị loại trừ (thực tế, những ngày khác trong tuần sẽ bị lọc ra khỏi những ngày trong khoảng thời gian từ `Start` đến `End`).
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 `true`, thì những ngày khác trong tuần không được đặt rõ ràng là `true` sẽ bị loại trừ (thực tế, những ngày khác trong tuần sẽ bị lọc ra khỏi những ngày trong khoảng thời gian từ `Start` đến `End`).
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 `true`, thì những ngày khác trong tuần không được đặt rõ ràng là `true` sẽ bị loại trừ (thực tế, những ngày khác trong tuần sẽ bị lọc ra khỏi những ngày trong khoảng thời gian từ `Start` đến `End`).
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à `true`, thì những ngày khác trong tuần không được đặt rõ ràng là `true` sẽ bị loại trừ (thực tế, những ngày khác trong tuần sẽ bị lọc ra khỏi những ngày trong khoảng thời gian Bắt đầu và `End`).
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 `true`, thì những ngày khác trong tuần không được đặt rõ ràng là `true` sẽ bị loại trừ (thực tế, những ngày khác trong tuần sẽ bị lọc ra khỏi những ngày trong khoảng thời gian từ `Start` đến `End`).
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 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 `<StatusApplicationControl>` trong cả thông báo `<OTA_HotelRateAmountNotifRQ>` và `<OTA_HotelAvailNotifRQ>`. Thuộc tính `RatePlanCode` không áp dụng và không được chỉ định khi `<AvailStatusMessage>` chứa thuộc tính `BookingLimit`. Bạn phải chỉ định thuộc tính này nếu đã chỉ định `<RestrictionStatus>` hoặc `<LengthOfStay>`.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay	0..1	LengthsOfStay	Vùng chứa để xác định các quy định hạn chế về LOS. Không được sử dụng 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 `MinMaxMessageType="FullPatternLOS"` và vắng mặt nếu không sử dụng thuộc tính này.
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ị của số đo thời gian lưu trú. 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 dùng `MinMaxMessageType="FullPatternLOS"`.
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` Lưu ý: 1 đơn vị `"Day"` bằng 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 lượt 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 xuất hiện khi sử dụng `MinMaxMessageType="FullPatternLOS"` và sẽ không có nếu không có.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS	1	string	Một chuỗi gồm các ký tự `Y` và `N` cho biết liệu từng thời gian lưu trú có được cho phép hay không, từ một đêm đến giá trị trong `FixedPatternLength`. Mọi thời gian lưu trú lớn hơn `FixedPatternLength` sẽ kế thừa giá trị tại vị trí cuối cùng. Ví dụ: Với `FixedPatternLength="4"` và `FullPatternLOS="YNYN"`, bạn chỉ được phép lưu trú theo thời gian 1 và 3.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus	0..1	RestrictionStatus	Xác định các quy định hạn chế của hành trình. Không được sử dụng nếu `<AvailStatusMessage>` bao gồm 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ác giá trị hợp lệ như sau: `Open` `Close` Lưu ý: Theo mặc định, Google giả định rằng chế độ cài đặt `Master` cho tất cả sản phẩm là `Close`. Bạn có thể thiết lập chế độ này thông qua mục "Tình trạng phòng mặc định" trong phần cài đặt giá của Hotel Center. Giá trị "Đã đóng" trong Hotel Center tương ứng với giá trị `Close` ở đây. Việc đặt `Master` thành `Close` được gọi là "dừng bán".
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 `Status`. Các giá trị hợp lệ là: `Arrival:` Giá trị này không cho phép những hành trình có ngày nhận phòng nằm trong phạm vi ngày `Start` và `End`. `Departure:` Giá trị này không cho phép những hành trình có ngày trả phòng nằm trong phạm vi ngày `Start` và `End` (bao gồm cả hai ngày này). `Master:` Giá trị này cho biết liệu có giá phòng để đặt vào ngày này hay không. Lưu ý: Nếu bạn không chỉ định `Restriction` thì giá trị mặc định sẽ là `Master`.
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à: `Integer:` Số ngày trước ngày đến. Ví dụ: Giá trị `1` cho biết phải đặt phòng với giá này ít nhất 1 ngày trước ngày đến. Giá trị `0` (giá trị mặc định) cho biết không có hạn chế về thời gian đặt phòng gần nhất. `ISO 8601 Duration (days, hours, and minutes):` Số ngày (và giờ/phút (không bắt buộc)) trước ngày đến. Ví dụ: Giá trị `P1D` cho biết phải đặt phòng với giá này 1 ngày trước ngày đến. Giá trị `P0DT6H` cho biết phải đặt phòng trước khi kết thúc ngày đến 6 giờ (tức là 18:00) hoặc sớm hơn.
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 mức giá này. Các loại giá trị hợp lệ là: `Integer:` Số ngày trước ngày đến. Ví dụ: Giá trị `30` cho biết không thể đặt phòng với mức giá này trước ngày đến 30 ngày. Giá trị `0` (giá trị mặc định) cho biết không có hạn chế về thời gian đặt trước sớm nhất. `ISO 8601 Duration (days, hours, and minutes):` Số ngày (và số giờ/phút (không bắt buộc)) trước ngày đến. Ví dụ: Giá trị `P30D` cho biết không thể đặt phòng với mức giá này trước ngày đến 30 ngày. Giá trị `P30DT6H` cho biết không thể đặt phòng sớm hơn 18:00, 30 ngày trước ngày đến.

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>

Giới hạn 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>

Quy định hạn chế về việc đến nơi

Đặt quy định hạn chế khi gần đến nơi đế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 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ó phò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 cụ thể.

Lưu ý: Bạn cũng cần phải cung cấp giá mỗi đêm và số lượng quỹ phòng lớn hơn 0 đối với loại phòng thì mới có thể 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ó phòng

Đóng tình trạng phòng đối với một loại phòng và gói giá vào những ngày cụ thể. (Đâ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>

Quy định hạn chế đặt trước

Đặt các giới hạn thời hạn đặt trước tối thiểu và tối đa, chỉ áp dụng vào 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 nhận phòng khi đặ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 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 đối với một loại phòng trong những ngày được chỉ định.

Lưu ý: Việc gửi thông báo 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

Đặt giới hạn 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, bạn chỉ được phép lưu trú 2, 4 và 6. Không hỗ trợ thời gian lưu trú 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 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 còn hà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` 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. `<Success>` hoặc `<Errors>` xuất hiện trong mỗi thông báo.
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`. `<Success>` hoặc `<Errors>` xuất hiện trong mỗi thông báo.
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ề các lỗi này trong bài viết 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 Liên minh 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 của Google của vấn đề. Bạn có thể xem thông tin chi tiết về các lỗi này trong bài viết 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 một 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 xảy ra 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>