這份 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 日 | 新增「費率調整」訊息類型。 |