OTA_酒店房价金额通知

请求

语法

OTA_HotelRateAmountNotifRQ 消息使用以下语法：

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="message_ID"
                            TimeStamp="timestamp"
                            Version="3.0"
                            NotifType="[Overlay|Delta|Remove]"
                            NotifScopeType="[ProductRate]">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID"
                                RatePlanType="[26]" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="float"
                            AmountAfterTax="float"
                            CurrencyCode="currency"
                            NumberOfGuests="integer"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="float"
                                   AgeQualifyingCode="[10|8]"
                                   MaxAge="integer"/>
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

元素和属性

OTA_HotelRateAmountNotifRQ 消息包含以下元素和属性：

元素 / @Attribute 出现次数 类型 说明
OTA_HotelRateAmountNotifRQ 1 Complex element 费率消息的根元素。
OTA_HotelRateAmountNotifRQ / @xmlns 0..1 string (URI) XML 命名空间。
OTA_HotelRateAmountNotifRQ / @EchoToken 1 string 此请求消息的唯一标识符。此值会在响应消息中返回。允许使用的字符包括 a-z、A-Z、0-9、_ (underscore) 和 - (dash)。
OTA_HotelRateAmountNotifRQ / @TimeStamp 1 DateTime 此消息的创建日期和时间。
OTA_HotelRateAmountNotifRQ / @Version 1 decimal OpenTravel 消息版本。
OTA_HotelRateAmountNotifRQ / @NotifType 0..1 enum

要应用于每个 <RateAmountMessage> 的通知类型。

有效值包括：

如需了解这些属性的运作方式，请查看示例。

  • Overlay: 删除 <StatusApplicationControl> 中指定的客房类型、费率方案和日期的所有入住人数费率，并将其替换为新费率。
  • Remove: 删除 <StatusApplicationControl> 中指定的客房类型、费率方案和日期的所有现有入住人数费率。
  • Delta:（如果未指定 NotifType，则为默认值）为 <StatusApplicationControl> 中指定的客房类型、费率方案和日期添加或更新现有的每人入住费率。
OTA_HotelRateAmountNotifRQ / @NotifScopeType 0..1 enum

要应用于每个 <RateAmountMessage> 的 NotifType 的范围。

有效值包括：

  • ProductRate:（如果未指定 NotifScopeType，则为默认值）NotifType 适用于产品，即客房类型 (InvTypeCode) 和费率方案 (RatePlanCode) 的组合。
OTA_HotelRateAmountNotifRQ / POS 0..1 POS 用于指定此消息的合作伙伴账号的容器（通常在后端为多个合作伙伴账号提供价格 Feed 时使用）。
OTA_HotelRateAmountNotifRQ / POS / Source 1 Source 必需（如果存在 <POS>）。<RequestorID> 的容器。
OTA_HotelRateAmountNotifRQ / POS / RequestorID 1 RequestorID 必需（如果存在 <POS>）。定义合作伙伴账号。
OTA_HotelRateAmountNotifRQ / POS / RequestorID / @ID 1 string 此消息对应的合作伙伴账号。此字符串值是 Hotel Center “账号设置”页面上列出的“合作伙伴键”值。

注意：如果您有一个后端为多个账号提供 Feed，则此值需要与同一账号的“交易（房源数据）”消息的 partner 属性值以及 <OTA_HotelAvailNotifRQ> 消息的 <RequestorID> 元素中的 ID 属性值相匹配。
OTA_HotelRateAmountNotifRQ / RateAmountMessages 1 RateAmountMessages 用于定义费率的一组 <RateAmountMessage> 元素。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / @HotelCode 1 string 房源的唯一标识符。此值必须与酒店列表 Feed 中<listing> 元素中使用 <id> 指定的酒店 ID 一致。酒店 ID 也列在 Hotel Center 中。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage 1..n RateAmountMessage 用于设置房价（日期范围内的客房类型和费率方案组合）的容器。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl 1 StatusApplicationControl 定义日期范围，以及客房类型 (InvTypeCode) 和费率方案 (RatePlanCode) 的标识符。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Start 1 Date 日期范围的开始日期（基于媒体资源所在的时区），包括该日期。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @End 1 Date 日期范围的结束日期（以媒体资源所在的时区为准），含此日期。必须等于或大于 start 值。 如果 start 和 end 相等，则更新会应用于该日期。请注意，Google 最多支持三年的数据。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Mon 0..1 boolean 设置为 true 或 1 可明确包含星期一。

如果设置为 true，则会排除未明确设置为 true 的其他日期（实际上，系统会从 Start 和 End 中的日期中滤除这些日期）。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Tue 0..1 boolean 设置为 true 或 1 以明确包含星期二。

如果设置为 true，则会排除未明确设置为 true 的其他日期（实际上，系统会从 Start 和 End 中的日期中滤除这些日期）。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Weds 0..1 boolean 设置为 true 或 1 以明确包含周三。

如果设置为 true，则会排除未明确设置为 true 的其他日期（实际上，系统会从 Start 和 End 中的日期中滤除这些日期）。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Thur 0..1 boolean 设置为 true 或 1 可明确包含星期四。

如果设置为 true，则会排除未明确设置为 true 的其他日期（实际上，系统会从 Start 和 End 中的日期中滤除这些日期）。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Fri 0..1 boolean 设置为 true 或 1 可明确包含星期五。

如果设置为 true，则会排除未明确设置为 true 的其他日期（实际上，系统会从 Start 和 End 中的日期中滤除这些日期）。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sat 0..1 boolean 设置为 true 或 1 可明确包含周六。

如果设置为 true，则会排除未明确设置为 true 的其他日期（实际上，系统会从 Start 和 End 中的日期中滤除这些日期）。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sun 0..1 boolean 设置为 true 或 1 可明确包含星期日。

如果设置为 true，则会排除未明确设置为 true 的其他日期（实际上，系统会从 Start 和 End 中的日期中滤除这些日期）。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @InvTypeCode 1 string 房源（客房类型）的唯一标识符。此值在“交易（房源数据）”消息中映射到 <RoomID>。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanCode 1 string 费率方案的唯一标识符。此标识符会映射到“交易（房源数据）”消息中的 <PackageID>。<OTA_HotelRateAmountNotifRQ> 和 <OTA_HotelAvailNotifRQ> 消息中的 <StatusApplicationControl> 中进一步定义并引用了费率方案。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanType 0..1 string 一个标识符，用于指明适用于此价格更新的 ARI 价格模型类型。仅当使用基于 LOS 的定价模型时，才应使用值 26 指定此参数。不添加此属性表示这是按日期价格更新。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates 0..1 Rates <Rate> 元素集合的容器。如果 NotifType 为 "Remove"，则不得指定此元素。否则，此元素必须精确指定一次。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate 1 Rate 用于存放 <BaseByGuestAmts> 元素集合的容器。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @RateTimeUnit 0..1 String 用于指定住宿晚数的单位。唯一支持的值为 "Day"，表示住宿晚数将以天为单位指定。

如需使用基于 LOS 的定价，必须指定 RateTimeUnit 和 UnitMultiplier。否则，请勿指定这两者。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @UnitMultiplier 0..1 Integer 构成此房价的住宿晚数的 RateTimeUnits 数量。

例如，如果 RateTimeUnits 值为 "Day"，则 UnitMultiplier 为 5 表示在此 Rate 对象下指定的房价适用于 5 晚住宿的每晚。

此 Rate 对象下指定的入住人数将乘以 UnitMultiplier（住宿晚数），以得出住宿总价。

如需使用基于 LOS 的定价，必须指定 RateTimeUnit 和 UnitMultiplier。否则，请勿指定这两者。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts 1 BaseByGuestAmts 用于存放一组基本费用的容器。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt 1..n BaseByGuestAmt 指定以指定币种显示的客房价格。您可以使用多个 <BaseByGuestAmt> 元素（每个元素的 NumberOfGuests 值不同）来设置每位入住人数的价格。否则，价格适用于 NumberOfGuests 定义的入住人数上限。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountBeforeTax 0..1 float

不含税费及其他费用的房价每日价格。

可以同时指定 AmountBeforeTax 和 AmountAfterTax。如果未指定 AmountBeforeTax，则必须指定 AmountAfterTax。如果指定了 AmountBeforeTax，但未指定 AmountAfterTax，则必须在 <TaxFeeInfo> 消息中指定税费。

如果您使用促销活动，折扣会应用于 AmountBeforeTax；百分比折扣也会应用于 AmountAfterTax。由于此方法不适用于某些税务结构，因此我们强烈建议您在此处仅指定 AmountBeforeTax，并使用 <TaxFeeInfo> 指定税费。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountAfterTax 0..1 float 包含适用税费和其他费用的房价单日价格。如果指定了 AmountAfterTax，则无需发送按属性发送的单独 <TaxFeeInfo> 消息。此属性可与 AmountBeforeTax 结合使用，以提供可向特定地区的用户显示的基本费率和总费率。

警告：如果您使用促销活动，我们强烈建议您不要使用 AmountAfterTax 金额。如果您想使用折扣，请使用 <TaxFeeInfo> 消息指定税费。然后，系统会将折扣应用于 AmountBeforeTax 金额。

注意：如果未指定 AmountBeforeTax，则必须指定 AmountAfterTax。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @CurrencyCode 1 enum 特定货币单位的 ISO 4217 (3) 字母字符代码。

请参阅支持的货币列表。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @NumberOfGuests 0..1 integer 此费率可容纳的房客人数上限。 如果未提供，则默认为 2 名访客。

请注意，如果 <AdditionalGuestAmounts> 包含儿童费用，则 NumberOfGuests 仅指成人。如果 <AdditionalGuestAmounts> 未指定或未包含儿童费用，NumberOfGuests 则是指包括成人和儿童在内的入住人数。

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts 0..1 AdditionalGuestAmounts 用于容纳额外房客费用集合的容器。

如果额外入住的客人或儿童费率因日期而异，此语法非常有用。如果这些金额可以在媒体资源级别静态定义，请考虑使用效率更高的 ExtraGuestCharges 消息。

额外房客费用如下所示：
  • 这些费率会在基本入住人数费率的基础上加收。基本入住人数是指 <BaseByGuestAmts> 中指定的最高入住人数，该人数小于或等于用户搜索中的成人人数。
  • 只要用户搜索的入住人数在客房的入住人数上限之内，系统就会应用这些费用。
  • 当 NotifType 为 Delta 或 Overlay 时，<AdditionalGuestAmounts> 始终会将之前指定的额外金额替换为新金额。
  • 只有当 NotifType 为 Delta 时，才能独立于基准费率发送 <AdditionalGuestAmounts>。当 NotifType 为 Overlay 时，必须指定 <BaseByGuestAmts>。
  • 将 NotifType 设置为 Delta 的空 <AdditionalGuestAmounts> 元素会移除现有的额外金额，而不会影响基本费率。
  • 它们使用 <BaseByGuestAmt> 中指定的货币应用。

例如，假设您为 1 名和 2 名成人指定了基本费率。

  • 如果用户搜索 3 名成人入住，系统会选择双人入住费率作为基本费率，并在此基础上再收取 1 名成人的额外费用。
  • 如果用户搜索 1 名成人和 2 名儿童的入住信息，系统会选择单人入住费率作为基本费率，并针对这两名儿童额外收取费用。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount 0..n AdditionalGuestAmount 根据通过 AgeQualifyingCode 指定的房客类型以及通过 MaxAge 指定的房客年龄（如果适用）指定价格。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @AgeQualifyingCode 1 enum 定义额外入住的客人的类型（成人或儿童）。有效选项包括：
  • 10: 成人。
  • 8: 子级。

最多只能有一个 AdditionalGuestAmount 元素的 AgeQualifyingCode 可设置为 10。

当 AgeQualifyingCode 为 8 时，必须指定 MaxAge。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @MaxAge 0..1 integer 当 AgeQualifyingCode 为 8 时，必须指定 MaxAge。如果 AgeQualifyingCode 为 10，则不得指定此值。

MaxAge 应介于 0 到 17. 之间的整数

指定值为 0 会停用儿童乘客。

大于 17 的值将被视为接受的最大值 17。

您可以通过单独的 AdditionalGuestAmount 元素指定多个儿童年龄段。年龄范围必须是连续的且不重叠。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @Amount 1 float 在基本费率的基础上，每位额外入住的客人需支付的税费及其他费用（不含税费）。

必须通过 <TaxFeeInfo> 消息中的 <AgeBrackets> 元素指定取决于入住者的年龄的税费和其他费用。

示例

本部分提供了代码示例，重点介绍了如何：

设置 add、overlay 或 remove 值时，日期范围可以相同，也可以不同，具体取决于您的目标。例如，您可以使用 overlay 仅针对 12 月的节假日设置几周，而不是针对“添加费率”消息设置的整个范围。这只会替换此时间段内的入住人数费率。

按日期付费

对于给定的客房和费率方案，每个房源最多可以有 50 种入住人数费率。如果所有入住人数的房价相同，您只需发送最多入住人数和所需价格即可。这样一来，Google 会推断出入住人数较少的房源也采用相同的基本房价。

设置基本费率和总费率

示例 1

默认入住人数（双人）的基本费率（不含税费及其他费用）。在此模型中，必须使用 <TaxFeeInfo> 消息定义房源的税费和其他费用。对于从某些地区进行搜索的用户，基本费率将更醒目。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

示例 2

默认入住人数（双人）的基本费率和总费率。在此模型中，不应使用 <TaxFeeInfo> 消息单独定义税费和其他费用。对于从特定地区搜索的用户，基本费率将更醒目。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            AmountAfterTax="110.00"
                            CurrencyCode="USD"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

示例 3

多人入住的总费率（含税费及其他费用）。在此模型中，不应使用 <TaxFeeInfo> 消息单独定义税费和其他费用。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountAfterTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountAfterTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
            <BaseByGuestAmt AmountAfterTax="120.00"
                            CurrencyCode="USD"
                            NumberOfGuests="3"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

示例 4

不同日期范围内多种客房类型和费率方案的基础费率和总费率。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            AmountAfterTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-01"
                                End="2020-05-31"
                                InvTypeCode="RoomID_2"
                                RatePlanCode="PackageID_2"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            AmountAfterTax="220.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
添加、叠加和移除费率

每个房源的商品（客房类型和套餐组合）数量上限为 5,000 件。使用 Overlay 或 Remove 通知类型移除之前定义的产品。

添加费率

将 NotifType 设置为 Delta，以便在 2021 年 10 月 20 日至 2021 年 12 月 31 日期间为 RoomID_1 和 PackageID_1 添加每人入住费率。请注意，Google 最多支持 3 年的数据。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountBeforeTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
            <BaseByGuestAmt AmountBeforeTax="120.00"
                            CurrencyCode="USD"
                            NumberOfGuests="3"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

叠加率

将 NotifType 设为 Overlay 可删除 2021 年 10 月 20 日至 2021 年 12 月 31 日期间 RoomID_1 和 PackageID_1 的所有每人入住费率，并将其替换为新指定的每人入住费率。

例如，如果此消息是在“添加房价”消息之后发送的，系统会删除入住人数为 1、2 和 3 的房价，并仅存储新的入住人数为 1 的房价。您还可以设置较短的日期范围（例如：2021-12-20 和 2021-12-31）来仅替换特定日期（例如节假日）的部分入住人数费率。 

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

移除费率

将 NotifType 设置为 Remove，以删除 2021 年 10 月 20 日至 2021 年 12 月 31 日期间 RoomID_1 和 PackageID_1 的所有入住人数费率。

例如，如果此消息是在上述任一示例消息之后发送的，则系统不会存储每种入住人数的费率。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">>
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
添加、叠加和移除额外房客费用

添加金额

将 NotifType 设为 Delta，以便在 2021 年 10 月 20 日至 2021 年 12 月 31 日期间为 RoomID_1 和 PackageID_1 添加入住人数为 1 人和 2 人的房价基准以及额外入住人数费用。

额外入住人数费用将在基本费率的基础上收取，基本费率将根据用户搜索时的入住人数而定。用户指定的入住人数必须在 RoomID_1 的容量范围内。

在此示例中，额外入住的客人费用将按以下方式计算：

  • 5 美元（适用于 0 至 10 周岁的儿童）。
  • 11 至 17 周岁（含）的儿童：10 美元。
  • 成人 20 美元。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountBeforeTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="5.00" AgeQualifyingCode="8" MaxAge="10" />
            <AdditionalGuestAmount Amount="10.00" AgeQualifyingCode="8" MaxAge="17" />
            <AdditionalGuestAmount Amount="20.00" AgeQualifyingCode="10" />
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

叠加金额

将 NotifType 设置为 Overlay 可删除 2021 年 10 月 20 日至 2021 年 12 月 31 日期间 RoomID_1 和 PackageID_1 的所有每人入住费率和所有额外客人费用，并将其替换为新指定的每人入住费率和额外费用。

例如，如果此消息是在“添加房价”消息之后发送的，系统会删除基本入住人数 1 和 2 的房价，并仅存储新的基本入住人数 1 的房价。系统会删除之前的一组额外房客费用，只会存储新一组费用。 现在，额外的入住人数将使用新的入住人数 1 费率作为基本费率。请注意，此次更新后，系统不会为儿童定义额外的访客费用。 

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="30.00" AgeQualifyingCode="10" />
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

移除金额

将 NotifType 设置为 Delete 可删除 2021 年 10 月 20 日至 2021 年 12 月 31 日期间 RoomID_1 和 PackageID_1 的所有每人入住基本费率以及所有额外入住人数费用。

例如，如果此消息是在上述任一示例消息之后发送的，系统将不会存储每人入住的基本房价或额外入住人数。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">>
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

仅移除额外的房客费用

将 NotifType 设为 Delta 并使用空 <AdditionalGuestAmounts> 元素，即可删除 RoomID_1 和 PackageID_1 的所有额外房客费用，而不会影响 2021 年 10 月 20 日至 2021 年 12 月 31 日之间的基本费率。

例如，如果此消息是在上述任一示例消息之后发送的，则系统只会存储基本金额。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <AdditionalGuestAmounts/>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

基于 LOS 的定价

设置基于 LOS 的费率

示例 1

为 2020 年 5 月 18 日开始的 1 晚、2 晚和 3 晚入住设置房价。在本例中，1 晚、2 晚和 3 晚的住宿总费率分别为 100 美元、180 美元和 240 美元。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="1" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
        <Rate UnitMultiplier="2" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="90.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
添加、叠加和移除基于 LOS 的费率

添加住宿晚数

采用基于住宿晚数的定价时，Delta 操作可让系统针对 <StatusApplicationControl> 中指明的入住日期范围以及每个子 Rate 元素的 UnitMultiplier 中指明的所有住宿晚数逐渐更新房价。

对于每个适用的入住日期和住宿晚数，都必须指定所有入住人数费率。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

叠加的住宿晚数

采用基于 LOS 的定价时，Overlay 运算会替换 <StatusApplicationControl> 中指明的商品的所有住宿晚数和入住日期范围的房价。

使用此消息后，系统会移除指定入住日期的所有住宿晚数的每人入住费率，并将其替换为仅针对住宿晚数 3 定义的双人入住费率。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

移除住宿晚数

如果采用基于住宿晚数的定价，Remove 操作会移除 <StatusApplicationControl> 中所指明的商品的所有住宿晚数和入住日期范围的房价。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

响应

语法

OTA_HotelRateAmountNotifRS 消息使用以下语法：

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS 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_HotelRateAmountNotifRS>

元素和属性

OTA_HotelRateAmountNotifRS 消息包含以下元素和属性：

元素 / @Attribute 出现次数 类型 说明
OTA_HotelRateAmountNotifRS 1 Complex element 对有空/忙碌信息的响应的根元素。
OTA_HotelRateAmountNotifRS / @TimeStamp 1 DateTime 此消息的创建日期和时间。
OTA_HotelRateAmountNotifRS / @EchoToken 1 string 关联的 OTA_HotelRateAmountNotifRQ 消息中的唯一标识符。
OTA_HotelRateAmountNotifRS / Success 0..1 Success 表示 OTA_HotelRateAmountNotifRQ 消息已成功处理。

每条消息中都包含 <Success> 或 <Errors>。
OTA_HotelRateAmountNotifRS / Errors 0..1 Errors 用于容纳处理 OTA_HotelRateAmountNotifRQ 消息时遇到的一个或多个问题。

每条消息中都包含 <Success> 或 <Errors>。
OTA_HotelRateAmountNotifRS / Errors / Error 1..n Error 处理 OTA_HotelRateAmountNotifRQ 消息时遇到的错误的说明。如需详细了解这些错误，请参阅 Feed 状态错误消息。
OTA_HotelRateAmountNotifRS / Errors / Error / @Type 1 integer 与错误相关联的 OpenTravel Alliance EWT（错误警告类型）。仅使用值 12 (Processing exception)。
OTA_HotelRateAmountNotifRS / Errors / Error / @Code 1 integer 与错误相关联的 OpenTravel Alliance ERR（错误代码）。 仅使用值 450 (Unable to process)。
OTA_HotelRateAmountNotifRS / Errors / Error / @Code 1 enum 原始请求的状态。仅使用值 NotProcessed。
OTA_HotelRateAmountNotifRS / Errors / Error / @ShortText 1 string 问题的 Google 标识符。如需详细了解这些错误，请参阅 Feed 状态错误消息。

示例

成功

以下是对成功处理的 OTA_HotelRateAmountNotifRQ 消息的响应。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2021-10-20T20:50:37-05:00"
                       Version="3.0">
  <Success/>
</OTA_HotelRateAmountNotifRS>

错误

以下是对因错误而未处理的 OTA_HotelRateAmountNotifRQ 消息的响应。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2021-10-20T20:50:37-05:00"
                       Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelRateAmountNotifRS>