OTA_HotelAvailNotifRQ

要求

語法

OTA_HotelAvailNotifRQ 訊息使用以下語法:

<?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>

系統會將每則 <OTA_HotelAvailNotifRQ> 訊息視為差異更新。針對 <StatusApplicationControl> 中指定的每個房源、日期、房間和套裝行程,對先前定義的任何限制進行更新,只會取代相同限制的值,新增限制不會影響先前定義的其他限制。舉例來說,如果先前已定義最短住宿天數為 2 天,接著更新的新訊息只包含最長住宿天數為 7 天,那麼這項操作就不會清除先前的最短住宿天數值。

元素和屬性

OTA_HotelAvailNotifRQ 訊息包含下列元素和屬性:

注意:每種停留天數限制都會個別設定。舉例來說,設定 SetMaxLOS 的訊息不會覆寫先前定義的 SetForwardMaxStay 值。

元素 / @Attribute 發生次數 類型 說明
OTA_HotelAvailNotifRQ 1 Complex element 定義房價供應情形的訊息根元素。
OTA_HotelAvailNotifRQ / @xmlns 0..1 string (URI) XML 命名空間。
OTA_HotelAvailNotifRQ / @EchoToken 1 string 此要求訊息的專屬 ID。這個值會在回應訊息中傳回。允許的字元為 a-zA-Z0-9_ (底線) 和 - (連字號)。
OTA_HotelAvailNotifRQ / @TimeStamp 1 DateTime 這則訊息的建立日期和時間。
OTA_HotelAvailNotifRQ / @Version 1 decimal OpenTravel 訊息版本。
OTA_HotelAvailNotifRQ / POS 0..1 POS 用來指定此訊息的合作夥伴帳戶的容器。通常會在後端提供多個合作夥伴帳戶的價格動態饋給時使用。
OTA_HotelAvailNotifRQ / POS/ Source 1 Source 如果 <POS> 存在,則為必要欄位。<RequestorID> 的容器。
OTA_HotelAvailNotifRQ / POS / RequestorID 1 RequestorID 如果 <POS> 存在,則為必要欄位。定義合作夥伴帳戶。
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID 1 string 這封郵件的合作夥伴帳戶。這個字串值是 Hotel Center 帳戶設定頁面中列出的 Partner key 值。

注意:如果您有提供多個帳戶動態饋給的後端,這個值必須與交易 (資源資料) 訊息的 partner 屬性值相符,以及相同帳戶 <OTA_HotelRateAmountNotifRQ> 訊息的 <RequestorID> 元素中的 ID 屬性值相符。

OTA_HotelAvailNotifRQ / AvailStatusMessages 1 AvailStatusMessages 一或多個 <AvailStatusMessage> 元素的容器。
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode 1 string 房源的專屬 ID。這個值必須與飯店清單動態饋給中 <listing> 元素中使用 <id> 指定的飯店 ID 相符。Hotel Center 也會列出飯店 ID。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage 1..n AvailStatusMessage 定義單一房源的不同時間範圍,以及房價供應情形和限制。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit 1 integer 注意:建議使用 OTA_HotelInvCountNotifRQ 訊息,而非設定這個屬性。

<StatusApplicationControl> 的日期範圍內,可預訂的剩餘房間數量。如果指定 BookingLimit<StatusApplicationControl> 必須指定 InvTypeCode,且 <AvailStatusMessage> 不得包含 <LengthOfStay><RestrictionStatus>

必須等於或大於 0。如果為負值或未提供,則預設為 0。

注意:如要為特定 <StatusApplicationControl> 設定建立房間可訂情況,必須至少設定一次 BookingLimit 屬性。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl 1 StatusApplicationControl 定義日期範圍,以及房型 (InvTypeCode) 和房價方案 (RatePlanCode) 的 ID。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start 1 Date 根據資源所在時區計算的開始日期,包含日期範圍。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End 1 Date 結束日期 (以資源的時區為準),包括日期範圍。必須等於或大於 start 值。 如果 startend 相等,更新會套用至該日期。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon 0..1 boolean 設為 true1,即可明確納入星期一。

如果設為 true,系統會排除一週中未明確設為 `true` 的其他日期 (實際上,系統會從 Start and End). 中的日期篩除這些日期)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue 0..1 boolean 設為 true1,即可明確納入星期二。

如果設為 true,則會排除一週中未明確設為 true 的其他日期 (實際上,會從 StartEnd 中的日期篩除這些日期)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean 設為 true1,即可明確納入星期三。

如果設為 true,則會排除一週中未明確設為 true 的其他日期 (實際上,會從 StartEnd 中的日期篩除這些日期)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean 設為 true1,即可明確納入星期四。

如果設為 true,則會排除一週中未明確設為 true 的其他日期 (實際上,會從 StartEnd 中的日期篩除這些日期)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0..1 boolean 設為 true1,即可明確納入週五。

如果設為 true,則會排除一週中未明確設為 true 的其他日期 (實際上,會從 StartEnd 中的日期篩除這些日期)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat 0..1 boolean 設為 true1,即可明確納入週六。

如果設為 true,則會排除一週中未明確設為 true 的其他日期 (實際上,會從「開始」和 End 之間的日期篩除這些日期)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun 0..1 boolean 設為 true1,即可明確納入週日。

如果設為 true,則會排除一週中未明確設為 true 的其他日期 (實際上,會從 StartEnd 中的日期篩除這些日期)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode 1 string 房源 (房型) 的專屬 ID。這個值會對應至 交易 (資源資料) 訊息中的 <RoomID>
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode 0..1 string 費率方案的專屬 ID。這個 ID 會對應至交易 (資源資料) 訊息中的 <PackageID> 值。在 <OTA_HotelRateAmountNotifRQ><OTA_HotelAvailNotifRQ> 訊息中,費率方案會進一步定義並在 <StatusApplicationControl> 中參照。

如果 <AvailStatusMessage> 包含 BookingLimit 屬性,RatePlanCode 屬性就不適用,且不得指定。如果指定 <RestrictionStatus><LengthOfStay>,則必須指定此屬性。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay 0..1 LengthsOfStay 用於定義 LOS 限制的容器。如果 <AvailStatusMessage> 包含 BookingLimit 屬性,則不得出現此屬性。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength 0..1 integer FullPatternLOS 中定義的模式長度。

注意:使用 MinMaxMessageType="FullPatternLOS" 時必須設定這個屬性,否則請不要設定。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay 1..n LengthOfStay 定義住宿天數限制。使用多個 <LengthOfStay> 元素時,每個元素都必須指定不同的 MinMaxMessageType 值。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time 0..1 integer 入住天數度量單位的值。請注意,系統會將值為零視為未設限制。例如,<LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> 表示沒有住宿天數上限。

注意:除非使用 MinMaxMessageType="FullPatternLOS",否則必須設定這個屬性。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit 0..1 enum 時間單位。如果沒有提供,則預設值為 "Day"。有效值如下:
  • Day
注意:一個 "Day" 單位等於 1 晚住宿。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType 1 enum 各種入住天數限制。SetMaxLOSSetMinLOSFullPatternLOS 是根據抵達時間。SetForwardMinStay SetForwardMaxStay 是根據停留時間計算。最大值必須大於或等於最小值。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern 0..1 LOS_Pattern 定義入住天數限制模式。

注意:使用 MinMaxMessageType="FullPatternLOS" 時,必須提供這個元素,否則請略過。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS 1 string 一系列 YN 字元,用於指出是否允許每個住宿天數,從一晚到 FixedPatternLength 中的值。任何長度大於 FixedPatternLength 的住宿天數都會繼承最終位置的值。舉例來說,FixedPatternLength="4" FullPatternLOS="YNYN" 只允許停留天數 1 和 3。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus 0..1 RestrictionStatus 定義行程限制。如果 <AvailStatusMessage> 包含 BookingLimit 屬性,則不得出現此屬性。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status 0..1 enum 指出 Restriction 屬性指定的限制類型是開放還是封閉。有效值如下:
  • Open
  • Close

OpenClose 值與 <Restriction> 元素的所有值相容。當 OpenClose 值與 ArrivalDeparture 值搭配使用時,會分別限制行程中的特定日期,分別用於辦理入住和退房。

  • OpenCloseArrival: 這個組合會指定行程中可供入住的日期
  • OpenCloseDeparture: 這個組合會指定行程中可供退房的日期
  • Arrival 日期不會限制入住日期後的住宿晚數。

    舉例來說,如果預訂期間為 4 月 1 日至 4 日,且 4 月 2 日至 4 日無法入住,仍可預訂。

    注意:

    • 根據預設,Google 會假設所有產品的 Master 設定為 Close。你可以在 Hotel Center 價格設定中,透過「預設供應情形」設定這項資訊。Hotel Center 中的「Closed」值對應至此處的 Close 值。
    • Master 設為 Close 稱為「停止銷售」。
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction 0..1 enum

    如果提供 Status,就必須使用這個屬性。

    有效值如下:

    • Arrival: 這個值可避免行程包含 StartEnd 日期範圍內的入住日期。
    • Departure: 這個值可避免行程的退房日期介於 StartEnd 日期範圍內 (含頭尾)。
    • Master: 這個值會指出房價是否可在該日期預訂。

    ArrivalDeparture 都必須是開放的供應情形,才能提供指定行程。ArrivalDeparture 的預設值皆為 Open,除非先前已傳送訊息表示已關閉。此外,房型/套裝組合必須在行程的所有日期 (不含入住的最後一天) 提供。你可以透過 Hotel Center 的預設設定,或透過 <Status> 或 <Restriction> 元素設定可預訂日期。如果預設設定為 Close,您必須針對相關日期傳送 StatusOpenrestrictionMaster,才能重新開放行程日期的供應情形。

    舉例來說,如果入住日期為 4 月 1 日,且住宿天數為三晚,完整行程日期為 4 月 1 日至 4 日。Status 值應設為 OpenRestriction 值應設為 Master,以便在 4 月 1 日至 3 日期間入住。入住最後一天 (4 月 4 日) 已關閉,因為只有住宿日期需要 Open 狀態。

    注意:如果未指定 Restriction,則預設值為 Master

    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset 0..1 integer or duration 在抵達日期前 (以住宿地點當地時間計算),最晚可預訂此房價的時間長度。

    有效的值類型包括:

    • Integer: 到達日期前的天數。舉例來說,如果值為 1,表示房價必須在抵達日期前至少一天預訂。如果值為 0 (預設值),表示沒有最新預訂時間限制。
    • ISO 8601 Duration (days, hours, and minutes): 到達日期前的天數 (以及選填的小時/分鐘)。舉例來說,如果值為 P1D,表示房價必須在抵達日期的前一天預訂。值為 P0DT6H 表示預訂必須在抵達日期結束前六小時 (即 18:00) 或更早完成。
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset 0..1 integer or duration 這個房價方案可預訂的到達日期前 (以飯店當地時間計算) 最長天數。

    有效的值類型包括:

    • Integer: 到達日期前的天數。舉例來說,如果值為 30,表示房價必須在抵達日期前 30 天才能預訂。如果值為 0 (預設值),表示最早預訂時間沒有限制。
    • ISO 8601 Duration (days, hours, and minutes): 到達日期前的天數 (以及選填的時數/分鐘)。舉例來說,如果值為 P30D,表示房價必須在抵達日期前 30 天才能預訂。值為 P30DT6H 表示預訂時間必須在抵達日期前 30 天的 18:00 之後。

    範例

    LoS 抵達日期

    設定最短和最長入住天數 (以抵達日期為準)。

    <?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>
    
    

    LoS 時間長度

    設定最短和最長入住天數 (以住宿天數為準)。

    <?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>
    
    

    移除 LoS 限制

    <LengthOfStay> 上將 Time="0" 表示指定入住天數沒有限制。例如,<LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> 表示沒有入住天數上限限制。

    <?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>
    

    出境限制

    設定關閉至出發時間的限制。(這樣可避免行程中包含指定日期的退房時間)。

    <?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>
    
    

    抵達限制

    設定「不接受到達」限制。(這可避免行程中包含指定日期的入住時間)。

    <?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>
    
    


    開放預訂日期

    在指定日期開放房型和房價方案的預訂。

    注意:你必須提供每晚房價,並確保房型庫存數量大於 0,系統才能完全顯示價格。

    <?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>
    
    

    關閉可訂日期

    在指定日期關閉某個房型和房價方案的可訂房數。(這也稱為「停止銷售」)。

    <?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>
    
    

    提前預訂限制

    設定最短和最長的提前預訂期限制,僅適用於週末。

    <?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>
    
    

    預訂截止時間

    在抵達當天,以飯店當地時間 18:00 為基準,套用訂房截止時間。

    <?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>
    
    

    多項限制

    針對房型和費率方案,在相同日期設定多個限制。

    <?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>
    
    


    預訂上限

    設定房型在指定日期的房源數量。

    注意:建議使用 OTA_HotelInvCountNotifRQ 訊息,而非設定這項屬性。

    <?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

    設定完整的住宿天數限制。

    如果入住日期為 2023 年 7 月 26 日,則只允許 2、4 和 6 天的入住天數。無法選擇 1、3、5 和 7 天以上的入住天數。

    <?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>
    
    
    

    回應

    語法

    OTA_HotelAvailNotifRS 訊息使用以下語法:

    <?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>
    

    元素和屬性

    OTA_HotelAvailNotifRS 訊息包含下列元素和屬性:

    元素 / @Attribute 發生次數 類型 說明
    OTA_HotelAvailNotifRS 1 Complex element 回應可用性訊息的根元素。
    OTA_HotelAvailNotifRS / @TimeStamp 1 DateTime 這則訊息的建立日期和時間。
    OTA_HotelAvailNotifRS / @EchoToken 1 string 相關聯 OTA_HotelAvailNotifRQ 訊息的專屬 ID。
    OTA_HotelAvailNotifRS / Success 0..1 Success 表示 OTA_HotelAvailNotifRQ 訊息已順利處理。

    每則訊息都會提供 <Success><Errors>

    OTA_HotelAvailNotifRS / Errors 0..1 Errors 處理 OTA_HotelAvailNotifRQ 訊息時遇到一或多個問題的容器。

    每則訊息都會提供 <Success><Errors>

    OTA_HotelAvailNotifRS / Errors / Error 1..n Error 處理 OTA_HotelAvailNotifRQ 訊息時發生錯誤的說明。如要瞭解這些錯誤的詳細資訊,請參閱「 動態饋給狀態錯誤訊息」。
    OTA_HotelAvailNotifRS / Errors / Error / @Type 1 integer 與錯誤相關聯的 OpenTravel Alliance EWT (錯誤警告類型)。只會使用 12 (Processing exception) 值。
    OTA_HotelAvailNotifRS / Errors / Error / @Code 1 integer 與錯誤相關的 OpenTravel Alliance ERR (錯誤代碼)。 只會使用 450 (Unable to process) 值。
    OTA_HotelAvailNotifRS / Errors / Error / @Code 1 enum 原始要求的狀態。只會使用 NotProcessed 的值。
    OTA_HotelAvailNotifRS / Errors / Error / @ShortText 1 string 問題的 Google 識別碼。如要瞭解這些錯誤的詳細資訊,請參閱「 動態饋給狀態錯誤訊息」。

    範例

    成功

    以下是已成功處理的 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>
    
    

    錯誤

    以下是 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">
      <Errors>
        <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
      </Errors>
    </OTA_HotelAvailNotifRS>