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 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 partner giá trị thuộc tính của thông báo Giao dịch (Dữ liệu của cơ sở lưu trú) và ID trong <RequestorID> phần tử của <OTA_HotelRateAmountNotifRQ> tin nhắn cho cùng một kết quả tài khoản.

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 &lt;id&gt; 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 <StatusApplicationControl>. Nếu Đã chỉ định BookingLimit, Bạn phải chỉ định <StatusApplicationControl> InvTypeCode<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 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ể <StatusApplicationControl>, 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ư 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 startend 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 true thì những ngày khác trong tuần sẽ không được đặt được loại trừ một cách rõ ràng thành "true" (trên thực tế, chúng sẽ được lọc khỏi các ngày trong 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 sẽ không được đặt được đặt rõ ràng thành true sẽ bị loại trừ (trên thực tế, chúng sẽ được lọc khỏi các ngày trong phạm vi StartEnd).

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 sẽ không được đặt được đặt rõ ràng thành true sẽ bị loại trừ (trên thực tế, chúng sẽ được lọc khỏi các ngày trong phạm vi StartEnd).

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 sẽ không được đặt được đặt rõ ràng thành true sẽ bị loại trừ (trên thực tế, chúng sẽ được lọc khỏi các ngày trong phạm vi StartEnd).

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 sẽ không được đặt được đặt rõ ràng thành true sẽ bị loại trừ (trên thực tế, chúng sẽ được lọc khỏi các ngày trong phạm vi StartEnd).

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 true thì những ngày khác trong tuần sẽ không được đặt được đặt rõ ràng thành true sẽ bị loại trừ (trên thực tế, chúng sẽ được lọc khỏi các ngày trong cột 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 sẽ không được đặt được đặt rõ ràng thành true sẽ bị loại trừ (trên thực tế, chúng sẽ được lọc khỏi các ngày trong phạm vi StartEnd).

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 xác định thêm và được đề cập đến trong <StatusApplicationControl> ở cả hai <OTA_HotelRateAmountNotifRQ><OTA_HotelAvailNotifRQ> tin nhắn.

Thuộc tính RatePlanCode không áp dụng được và phải không được chỉ định, khi <AvailStatusMessage> chứa Thuộc tính BookingLimit. Phải được chỉ định nếu <RestrictionStatus> hoặc Đã chỉ định <LengthOfStay>.

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 MinMaxMessageType="FullPatternLOS" và sẽ vắng mặt.

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 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. Hợp lệ giá trị là:
  • Day
Lưu ý: Một căn hộ "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, SetMinLOSFullPatternLOS sắp đến dựa trên cơ sở. SetForwardMinStay 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 MinMaxMessageType="FullPatternLOS" và sẽ vắng mặt.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS 1 string Một chuỗi gồm YN 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. Để ví dụ: với FixedPatternLength="4" 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à:
  • 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ể định cấu hình chế độ cài đặt này thông qua "Tình trạng rảnh/bận mặc định" inch Khách sạn Chế độ cài đặt trung tâm về giá. Giai đoạn "Đã đóng" giá trị trong Hotel Center tương ứng với giá trị Close ở đâ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 ngăn hành trình có ngày nhận phòng trong khoảng thời gian StartEnd phạm vi.
  • Departure: Giá trị này ngăn hành trình có ngày trả phòng trong khoảng thời gian StartEnd phạm vi ngày.
  • Master: Giá trị này cho biết phòng có giá để đặt phòng vào ngày này.

Lưu ý: Nếu bạn không chỉ định Restriction thì giá trị mặc định 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 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à:

  • Integer: Số ngày trước khi đến nơi ngày. Ví dụ: Giá trị của 1 cho biết giá phòng phải được đặt trước ít nhất 1 ngày trước ngày đến. Giá trị là 0 (giá trị mặc định) cho biết không có quy định hạn chế nào đối với thời gian đặt trước muộn nhất.
  • ISO 8601 Duration (days, hours, and minutes): Các số ngày (và giờ/phút, không bắt buộc) trước khi đến nơi ngày. Ví dụ: giá trị của P1D cho biết phòng phải đặt trước mức giá một ngày trước ngày đến. Giá trị là P0DT6H cho biết phải đặt phòng trong vòng 6 giờ trước ngày kết thúc ngày đến (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 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à:

  • Integer: Số ngày trước khi đến nơi ngày. Ví dụ: Giá trị của 30 cho biết giá phòng không thể đặt trước quá 30 ngày trước ngày đến. Đáp giá trị của 0 (giá trị mặc định) cho biết không có hạn chế vào thời điểm đặt trước sớm nhất.
  • ISO 8601 Duration (days, hours, and minutes): Các số ngày (và số giờ/phút, không bắt buộc) trước khi khách đến ngày. Ví dụ: giá trị của P30D cho biết phòng không thể đặt phòng với mức giá này sớm hơn 30 ngày trước ngày đến. Giá trị P30DT6H cho biết không thể đặt phòng sớm hơn 18 giờ, 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>

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 ngày được 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 về 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>

Quy định hạn chế khi đặ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 cho việc đặt phòng vào ngày đến lúc 18:00 tại địa phương của khách sạn 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.

<Success> hoặc <Errors> là xuất hiện trong mỗi thông điệp.

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.

<Success> hoặc <Errors> là xuất hiện trong mỗi thông điệp.

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>