供應情形、費率和空房 (ARI) XML 參考資料

這份 XML 參考指南針對供應情形、費率和商品目錄 (ARI) 動態饋給可用的各種訊息、元素和屬性,提供了詳細的參考資料和程式碼範例。

ARI 是價格放送模式,可控制每晚的房價、空房資訊和空房數量,並提供方式限制。ARI 也能彈性納入稅金、費用和促銷活動。

ARI 遵循 OpenTravel Alliance (OTA) 的標準通訊協定,以便用於定義可用性和廣告空間的主要訊息類型。

以 LOS 為基礎的定價

LOS-based 定價可讓您指定每個入住日期和入住天數的費率,而非每個入住日期。當您為以 LOS 為基礎的價格指定 <StatusApplicationControl> 元素時,@Start@End 屬性表示適用 LOS 費率的入住日期範圍。

雖然使用 LOS 定價不再是每晚房價,但所有其他 ARI 功能 (庫存、供應情形、規則、促銷活動等) 仍適用於這些費率,並在夜間層級指定。這表示如果您的系統與以 LOS 為基礎的定價系統更加一致,除了利用每晚的可用性和限制更新授予的頻寬效率之外,您仍可利用豐富的 ARI 功能組合。

如要為您的帳戶啟用以 LOS 為基礎的定價,請聯絡您的 TAM 或與我們聯絡

ARI 會使用下列要求訊息:

  • Transaction (資源資料):定義類型和套件 (費率方案) 資訊。

  • OTA_HotelRateAmountNotifRQ:針對指定日期範圍,定義每項產品 (房型和費率方案組合) 根據日期或 LOS 計算的入住人數。

  • OTA_HotelAvailNotifRQ:根據房型和房價方案定義空房資訊和限制。您也可以透過這則訊息更新商品目錄,但建議使用 OTA_HotelInvCountNotifRQ

  • OTA_HotelInvCountNotifRQ:定義可售出的實體房間庫存或房間數量。

  • TaxFeeInfo (選用):定義各項資源的稅金和費用。如果 OTA_HotelRateAmountNotifRQ 訊息中指定了 AmountAfterTax,則不需要這則訊息。

  • Promotions (選用) 定義特定預訂、住宿和使用者的促銷費率。

  • RateModifications (選用) 定義特定預訂、住宿和使用者的費率修改規則。

  • ExtraGuestCharges (選用) 定義兒童和其他成人的費率設定方式。

每則訊息都包含一部分資訊,Google 會使用這些資訊,計算使用者在特定入住/退房日期和可住人數的房源時,向他們顯示的價格和供應情形。

ARI XML 參考資料修訂版本記錄

下表僅列出功能變更的說明文件更新。

日期 異動
2020 年 8 月 14 日 第 1 版。
2020 年 10 月 21 日 新增了促銷訊息類型。
2020 年 11 月 17 日 針對交易 (資源資料) 訊息,更新端點,並在 PropertyDataSet 元素中加入 action 屬性。
2020 年 11 月 24 日 如果是交易 (資源資料) 訊息,請新增 <AllowablePackageIDs><AllowableRoomIDs> 元素。
2021 年 2 月 4 日 已新增回應訊息。
2021 年 2 月 25 日 新增了 OTA_HotelInvCountNotifRQ
2020 年 10 月 21 日 新增「費率調整」訊息類型。