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>

Mỗi thông báo <OTA_HotelAvailNotifRQ> được coi là một bả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>, việc cập nhật bất kỳ quy định hạn chế nào đã xác định trước đó chỉ thay thế giá trị của chính 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 đó 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 đặt độc lập. Ví dụ: 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) 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 nối).
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 <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ị dạng chuỗi này là giá trị Partner key có trong danh sách trên trang Account settings (Cài đặt tài khoản) trong Hotel Center.

Lưu ý: Nếu bạn có phần phụ trợ là nguồn cấp dữ liệu cho nhiều tài khoản, thì giá trị này cần phải khớp với giá trị 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 có giá phòng hay không cũng như các 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 <StatusApplicationControl>. Nếu bạn chỉ định BookingLimit, thì <StatusApplicationControl> phải chỉ định InvTypeCode, còn <AvailStatusMessage> thì 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 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 <StatusApplicationControl> nhất định, thuộc tính BookingLimit phải được đặt í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ư 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ú 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à true, thì những ngày khác trong tuần không được đặt là "true" sẽ bị loại trừ (thực tế, những ngày đó sẽ bị lọc ra khỏi những ngày trong khoảng thời gian từ 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 là true, thì những ngày khác trong tuần không được đặt là true sẽ bị loại trừ (thực tế, những ngày đó 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 là true, thì những ngày khác trong tuần không được đặt là true sẽ bị loại trừ (thực tế, những ngày đó 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 là true, thì những ngày khác trong tuần không được đặt là true sẽ bị loại trừ (thực tế, những ngày đó 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 là true, thì những ngày khác trong tuần không được đặt là true sẽ bị loại trừ (thực tế, những ngày đó 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 là true sẽ bị loại trừ (thực tế, những ngày đó sẽ bị lọc ra khỏi những ngày trong khoảng thời gian từ ngày bắt đầu đến 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 là true, thì những ngày khác trong tuần không được đặt là true sẽ bị loại trừ (thực tế, những ngày đó 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 phần <StatusApplicationControl> của cả thông báo <OTA_HotelRateAmountNotifRQ> và <OTA_HotelAvailNotifRQ>.

Thuộc tính RatePlanCode không áp dụng và tuyệt đối 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ếu <RestrictionStatus> hoặc <LengthOfStay> được chỉ định.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay 0..1 LengthsOfStay Vùng chứa các quy định hạn chế về LOS (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 MinMaxMessageType="FullPatternLOS" và không được đặt nếu không 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ú. 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 sử 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 ý: Một đơn vị "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 mẫu hạn chế về thời gian lưu trú.

Lưu ý: Bạn phải có phần tử này khi sử dụng MinMaxMessageType="FullPatternLOS" và không được có phần tử này trong trường hợp khác.

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 thời gian lưu trú có được 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 đều 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à:
  • Open
  • Close

Giá trị Open và Close tương thích với tất cả giá trị của phần tử <Restriction>. Khi các giá trị Open và Close được sử dụng với các giá trị Arrival và Departure, các giá trị này sẽ hạn chế các ngày cụ thể trong lịch trình để nhận phòng và trả phòng tương ứng.

  • Open và Close với Arrival: Tổ hợp này chỉ định những ngày trong hành trình có thể nhận phòng
  • Open và Close với Departure: Tổ hợp này chỉ định những ngày trong hành trình có thể trả phòng

    • Ngày Arrival không hạn chế tình trạng còn phòng cho các đêm lưu trú sau ngày nhận phòng.

    Ví dụ: đối với kỳ 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 là ngày không nhận khách, bạn vẫn có thể đặt phòng.

    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ể định cấu hình thông tin này thông qua chế độ "Tình trạng phòng mặc định" trong phần Cài đặt giá trong Hotel Center. Giá trị "Đã đóng" trong Hotel Center tương ứng với giá trị Close tại đây.
    • Việc đặt Master thành Close được gọi là "ngừ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.

    Các giá trị hợp lệ là:

    • Arrival: Giá trị này không cho phép các lịch trình có ngày nhận phòng nằm trong phạm vi Start và End (bao gồm cả hai ngày này).
    • Departure: Giá trị này không cho phép các lịch trình có ngày trả phòng nằm trong phạm vi 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 không.

    Cả Arrival và Departure đều phải có tình trạng phòng trống cho hành trình đã cho. Giá trị mặc định cho cả Arrival và Departure là Open, trừ phi một thông báo trước đó đã được gửi cho biết rằng thông báo đó đã bị đóng. Ngoài ra, tổ hợp phòng/gói phải có sẵn cho tất cả các ngày trong hành trình, ngoại trừ ngày cuối cùng của kỳ lưu trú. Bạn có thể đặt tình trạng phòng trống này bằng chế độ cài đặt mặc định trong Hotel Center hoặc thông qua phần tử <Status> hoặc <Restriction>. Nếu chế độ cài đặt mặc định là Close, bạn phải gửi giá trị Status là Open và giá trị restriction là Master cho các ngày có liên quan để mở lại tình trạng còn hàng cho các ngày trong hành trình.

    Ví dụ: Đối với một kỳ lưu trú 3 đêm có ngày đến là ngày 1 tháng 4, hành trình đầy đủ là từ ngày 1 đến ngày 4 tháng 4. Bạn phải đặt giá trị Status thành Open và giá trị Restriction thành Master cho lượt lưu trú qua đêm từ ngày 1 đến ngày 3 tháng 4. Ngày lưu trú cuối cùng (ngày 4 tháng 4) đã đóng, vì chỉ những ngày lưu trú qua đêm mới yêu cầu trạng thái Open.

    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ú) để 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ị của 1 cho biết phải đặt phòng ít nhất là trước ngày đến một ngày để được hưởng mức giá này. Giá trị 0 (giá trị mặc định) cho biết không có quy định hạn chế về thời gian đặt phòng muộ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ị của P1D cho biết phải đặt phòng ít nhất là trước ngày đến một ngày để được hưởng mức giá này. Giá trị P0DT6H cho biết phải đặt phòng trước khi kết thúc ngày đến sáu tiếng (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ú) để 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 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ó quy định hạn chế về thời gian đặt phòng sớm 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ị P30D cho biết không thể đặt phòng với giá này trước ngày đến 30 ngày. Giá trị P30DT6H cho biết rằng không thể đặt phòng trước 18:00 vào ngày trước ngày đến 30 ngày.

    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 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 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ề tầm nhìn đường chân trời

    Việc đặ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ú đã 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 rời đi

    Đặ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ế về việc đế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 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. (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>

    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 phòng

    Áp dụng thời hạn đặt phòng vào lúc 18:00 theo giờ địa phương của khách sạn vào 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-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ộ mẫu.

    Đối với trường hợp nhận phòng vào ngày 26 tháng 7 năm 2023, bạn chỉ được phép lưu trú từ 2 đến 6 ngày. 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 từ thông báo OTA_HotelAvailNotifRQ tương ứng.
    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ó <Success> hoặc <Errors>.
    OTA_HotelAvailNotifRS / Errors 0..1 Errors Vùng chứa một hoặc nhiều sự cố xảy ra trong quá trình xử lý thông báo OTA_HotelAvailNotifRQ.

    Mỗi thông báo có <Success> hoặc <Errors>.
    OTA_HotelAvailNotifRS / Errors / Error 1..n Error Thông tin mô tả 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 Mã nhận dạng sự cố của Google. 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.

    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 được xử lý 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>