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-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 相符。飯店 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	用於定義入住天數限制的容器。如果 `<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`、`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` `Open` 和 `Close` 值與 `<Restriction>` 元素的所有值相容。如果 `Open` 和 `Close` 值與 `Arrival` 和 `Departure` 值搭配使用，則會分別限制行程中的特定入住和退房日期。 `Open` 和 `Close` (`Arrival`)：這個組合會指定行程中可供入住的日期 `Open` 和 `Close` (使用 `Departure`)：這個組合會指定行程中可辦理退房的日期 `Arrival` 日期不會限制入住日期後續晚數的空房情況。舉例來說，如果住宿在 4 月 2 日至 4 月 4 日不接受入住，但旅客預訂 4 月 1 日至 4 月 4 日的住宿，仍可順利預訂。注意：根據預設，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:` 這個值表示該日期是否可預訂房價。 `Arrival` 和 `Departure` 都必須為指定行程開放預訂。`Arrival` 和 `Departure` 的預設值都是 `Open`，除非先前已傳送訊息指出已關閉。此外，行程中所有日期的房型/套裝組合必須皆可預訂，住宿最後一天除外。這項供應情形可透過 Hotel Center 的預設設定，或 `<Status>` 或 <Restriction> 元素設定。如果預設設定為 `Close`，則必須傳送 `Open` 的 `Status` 值和 `Master` 的 `restriction` 值，才能重新開放行程日期的供應情形。舉例來說，如果入住三晚，抵達日期為 4 月 1 日，完整行程就是 4 月 1 日至 4 月 4 日。4 月 1 日至 3 日的每晚住宿，`Status` 值應設為 `Open`，`Restriction` 值應設為 `Master`。由於只有每晚的住宿日期需要 `Open` 狀態，因此住宿最後一天 (4 月 4 日) 會關閉。注意：如未指定 `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>

預訂截止時間

在飯店當地時間下午 6 點，為抵達當天的訂房設定截止時間。

<?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	相關聯訊息的專屬 ID。`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	與錯誤相關聯的 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>

OTA_HotelAvailNotifRQ 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

要求

語法

元素和屬性

範例

LoS 抵達日期

LoS 時間長度

移除 LoS 限制

出發限制

抵達限制

開放預訂日期

不開放預訂日期

提前預訂限制

預訂截止時間

多項限制

預訂限制

FullPatternLoS

回應

語法

元素和屬性

範例

成功

錯誤

OTA_HotelAvailNotifRQ