空房情况、费率和库存 (ARI) XML 参考

本 XML 参考指南为“空房情况”、“费率”和“空房库存”(ARI) Feed 中的不同消息、元素和属性提供了详细的参考内容和代码示例。

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 日 初始版本。
2020 年 10 月 21 日 添加了促销消息类型。
2020 年 11 月 17 日 对于交易(房源数据)消息,更新了端点并向 PropertyDataSet 元素添加了 action 属性。
2020 年 11 月 24 日 对于交易(房源数据)消息,添加了 <AllowablePackageIDs><AllowableRoomIDs> 元素。
2021 年 2 月 4 日 添加了响应消息。
2021 年 2 月 25 日 添加了 OTA_HotelInvCountNotifRQ
2020 年 10 月 21 日 添加了“费率修改”消息类型。