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)。

元素 / @屬性 發生次數 類型 說明
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 這則訊息的合作夥伴帳戶。這個字串值為 Partner key值列在 Hotel Center 的「帳戶設定」頁面

注意:如果您的後端為多個 帳戶,這個值必須符合 partner 屬性值和「交易」(資源資料) 訊息的 ID 屬性值 您的 <RequestorID> 元素 <OTA_HotelRateAmountNotifRQ> 則訊息相同 讓他們使用服務帳戶

OTA_HotelAvailNotifRQ / AvailStatusMessages 1 AvailStatusMessages 一或多個 <AvailStatusMessage> 的容器 元素。
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode 1 string 房源的專屬 ID。這個值必須符合 使用 &lt;id&gt;飯店清單動態饋給中的 <listing> 元素中。 飯店 ID 也會列在 Hotel Center 中。
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 用於定義日期範圍和客房類型的 ID -InvTypeCode 和房價方案 -RatePlanCode
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」會遭到排除 (實際上 已從 Start 中的日期和 End)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean 如要明確包含星期三,請設為 true1

如果設為 true,表示其他日子的日子: 明確設為「true」會遭到排除 (實際上 已從 Start 中的日期和 End)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean 如要明確包含星期四,請設為 true1

如果設為 true,表示其他日子的日子: 明確設為「true」會遭到排除 (實際上 已從 Start 中的日期和 End)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0..1 boolean 如要明確包含週五,請設為 true1

如果設為 true,表示其他日子的日子: 明確設為「true」會遭到排除 (實際上 已從 Start 中的日期和 End)。

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」會遭到排除 (實際上 已從 Start 中的日期和 End)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode 1 string 商品目錄 (客房類型) 的專屬 ID。這個值對應 透過交易資料傳送至 <RoomID> (資源資料) 訊息。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode 0..1 string 房價方案的專屬 ID。這個識別碼對應至 值 交易 (資源資料) 中的 <PackageID> 撰寫新的電子郵件訊息費率方案進一步定義,請參閱 <StatusApplicationControl> (兩者皆有) 「<OTA_HotelRateAmountNotifRQ>」和 <OTA_HotelAvailNotifRQ> 則訊息。

RatePlanCode 屬性不適用,必須 未指定; <AvailStatusMessage> 包含 BookingLimit 屬性。如果符合下列情況,就必須指定 <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
,瞭解如何調查及移除這項存取權。 注意:1 個 "Day" 單位等於 1 晚住宿。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType 1 enum 各種入住天數限制類型。SetMaxLOS, SetMinLOSFullPatternLOS將抵達 基於這個原因。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

注意:

  • 根據預設,Google 會假設 所有產品的Master設定都是Close。 您可以透過「預設可用性」進行設定英吋 飯店 中心定價設定。「已關閉」Hotel Center 中的值 對應這裡的 Close 值。
  • Master 設為 Close 也就是 「停止銷售」。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction 0..1 enum

如果提供了 Status,則必須提供這項屬性。

有效值如下:

  • Arrival: 這個值可避免包含 StartEnd日期的入住日期 範圍。
  • Departure: 這個值可避免包含 StartEnd的退房日期 日期範圍 (含首尾)。
  • Master: 這個值會指出客房是否 房價當天可提供訂房服務。

注意:如果未指定 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 天前預訂。A 罩杯 0 的值 (預設值) 表示未設限制 提前預訂
  • ISO 8601 Duration (days, hours, and minutes): 抵達前的天數 (可視需要指定小時/分鐘) 日期。舉例來說,P30D 值表示房間 訂價必須在抵達日期前 30 天以前預訂。 如果值為 P30DT6H,表示無法預訂 早於 18:00,也就是抵達日前 30 天

範例

落後企業抵達日期

設定最短和最長入住天數 (根據抵達日期)。

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

成本損失

設定最短和最長入住天數 (根據入住天數)。

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

發車限制

設定封閉式路程規劃。(這樣可以避免含有 退房日期)。

<?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 在飯店當地時間 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 訊息包含下列元素和屬性:

元素 / @屬性 發生次數 類型 說明
OTA_HotelAvailNotifRS 1 Complex element 回應可用性訊息的根元素。
OTA_HotelAvailNotifRS / @TimeStamp 1 DateTime 這則訊息的建立日期和時間。
OTA_HotelAvailNotifRS / @EchoToken 1 string OTA_HotelAvailNotifRQ 訊息。
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 與 錯誤。僅使用 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>