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 訊息包含下列元素和屬性：

注意：每種入住天數限制都可以分別設定。舉例來說，設定 SetMaxLOS 的訊息不會覆寫先前為 SetForwardMaxStay 定義的值。

元素 / @Attribute 發生次數 類型 說明
OTA_HotelAvailNotifRQ 1 Complex element 定義房價供應情形的訊息根元素。
OTA_HotelAvailNotifRQ / @xmlns 0..1 string (URI) XML 命名空間。
OTA_HotelAvailNotifRQ / @EchoToken 1 string 此要求訊息的專屬 ID。這個值會在回應訊息中傳回。允許的字元包括 a-z、A-Z、0-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 定義日期範圍，以及房型 ID - InvTypeCode 和費率方案 — RatePlanCode。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start 1 Date 以資源時區 (包含日期範圍) 為準的開始日期。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End 1 Date 結束日期 (以資源的時區為準)，包含日期範圍。必須等於或大於 start 值。如果 start 和 end 相同，系統會在該日期套用更新。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon 0..1 boolean 設為 true 或 1 即可明確加入星期一。

如果設為 true，則系統會排除一週內其他未明確設為「true」的日子 (有效，這些日期會從 Start and End). 內的日期中排除)
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue 0..1 boolean 設為 true 或 1 即可明確納入週二。

如果設為 true，系統會排除一週內其他未明確設為 true 的日子 (有效，系統會將這些日期從 Start 和 End 內的日期篩除)。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean 設為 true 或 1 即可明確加入週三。

如果設為 true，系統會排除一週內其他未明確設為 true 的日子 (有效，系統會將這些日期從 Start 和 End 內的日期篩除)。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean 設為 true 或 1 即可明確加入週四。

如果設為 true，系統會排除一週內其他未明確設為 true 的日子 (有效，系統會將這些日期從 Start 和 End 內的日期篩除)。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0..1 boolean 設為 true 或 1 即可明確加入週五。

如果設為 true，系統會排除一週內其他未明確設為 true 的日子 (有效，系統會將這些日期從 Start 和 End 內的日期篩除)。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat 0..1 boolean 設為 true 或 1 即可明確加入週六。

如果設為 true，系統會排除一週內其他未明確設為 true 的日子 (有效，會從開始日期和 End 內的日期中排除這些日子)。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun 0..1 boolean 設為 true 或 1 即可明確加入週日。

如果設為 true，系統會排除一週內其他未明確設為 true 的日子 (有效，系統會將這些日期從 Start 和 End 內的日期篩除)。
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 入住天數測量期間的單位值。請注意，如果值為 0，則視為未設限制。舉例來說，<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 各種入住天數限制。SetMaxLOS、SetMinLOS 和 FullPatternLOS 都是依據抵達時間。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 Y 和 N 的序列，用來表示是否允許每個入住天數 (從一晚到 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 價格設定的「預設供應情形」中進行設定。Hotel Center 中的「關閉」值對應這裡的 Close 值。
  • 將 Master 設為 Close 稱為「停止銷售」。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction 0..1 enum

如果提供 Status，則此為必要屬性。

以下為有效值：

  • Arrival: 這個值可防止入住日期落在 Start 和 End (含) 日期範圍的行程。
  • Departure: 這個值可防止在 Start 和 End 日期範圍內的退房日期預訂行程。
  • 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 天前預訂房價。如果值為 0，表示最早的預訂時間沒有限制。
  • ISO 8601 Duration (days, hours, and minutes): 抵達日期前的天數 (包括小時/分鐘)。舉例來說，如果值為 P30D，表示預訂日期的前 30 天無法預訂房價。P30DT6H 值表示須在抵達日期前 30 天 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-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>

出發限制

設定「出發至出發」提醒。(這樣可防止在指定日期退房的行程)。

<?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 ID。如要進一步瞭解這些錯誤，請參閱 動態饋給狀態錯誤訊息一文。

示例

成功

以下是 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>