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> 中指定的每個屬性、日期、房間和套件，更新先前定義的限制只會取代相同限制的值，新增限制並不會影響其他先前定義的限制。舉例來說，如果您先前已定義最短入住天數，之後又更新一則僅包含入住 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-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 值。 注意：如果您的後端為多個帳戶提供動態饋給，這個值必須符合同一帳戶 <OTA_HotelRateAmountNotifRQ> 訊息中 <RequestorID> 訊息的 partner 屬性值，以及 ID 屬性值。
OTA_HotelAvailNotifRQ / AvailStatusMessages	1	AvailStatusMessages	一或多個 <AvailStatusMessage> 元素的容器。
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode	1	string	房源的專屬 ID。這個值必須與飯店清單動態饋給中 <listing> 元素中的 <id> 相符，且與指定飯店 ID 相符。 飯店 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	定義日期範圍，以及房型 (InvTypeCode) 和房價方案 (RatePlanCode) 的 ID。
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 注意：1 個 "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 中的「Closed」值對應此處的 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>

成本損失

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

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

注意： 如未指定 Restriction，則預設值為 Master。

預訂上限

設定指定日期內房型類型的庫存數量。

注意：比起設定這項屬性，建議優先使用 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 訊息中的專屬 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>