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-zA-Z0-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 值。 如果 startend 相等,则更新会应用于该日期。请注意,Google 最多支持三年的数据。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Mon 0..1 boolean 设置为 true1 可明确包含星期一。

如果设置为 true,则会排除未明确设置为 true 的其他日期(实际上,系统会从 StartEnd 中的日期中滤除这些日期)。

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Tue 0..1 boolean 设置为 true1 以明确包含星期二。

如果设置为 true,则会排除未明确设置为 true 的其他日期(实际上,系统会从 StartEnd 中的日期中滤除这些日期)。

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Weds 0..1 boolean 设置为 true1 以明确包含周三。

如果设置为 true,则会排除未明确设置为 true 的其他日期(实际上,系统会从 StartEnd 中的日期中滤除这些日期)。

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Thur 0..1 boolean 设置为 true1 可明确包含星期四。

如果设置为 true,则会排除未明确设置为 true 的其他日期(实际上,系统会从 StartEnd 中的日期中滤除这些日期)。

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Fri 0..1 boolean 设置为 true1 可明确包含星期五。

如果设置为 true,则会排除未明确设置为 true 的其他日期(实际上,系统会从 StartEnd 中的日期中滤除这些日期)。

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sat 0..1 boolean 设置为 true1 可明确包含周六。

如果设置为 true,则会排除未明确设置为 true 的其他日期(实际上,系统会从 StartEnd 中的日期中滤除这些日期)。

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sun 0..1 boolean 设置为 true1 可明确包含星期日。

如果设置为 true,则会排除未明确设置为 true 的其他日期(实际上,系统会从 StartEnd 中的日期中滤除这些日期)。

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 的定价,必须指定 RateTimeUnitUnitMultiplier。否则,请勿指定这两者。

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @UnitMultiplier 0..1 Integer 构成此房价的住宿晚数的 RateTimeUnits 数量。

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

Rate 对象下指定的入住人数将乘以 UnitMultiplier(住宿晚数),以得出住宿总价。

如需使用基于 LOS 的定价,必须指定 RateTimeUnitUnitMultiplier。否则,请勿指定这两者。

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

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

可以同时指定 AmountBeforeTaxAmountAfterTax。如果未指定 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> 中指定的最高入住人数,该人数小于或等于用户搜索中的成人人数。
  • 只要用户搜索的入住人数在客房的入住人数上限之内,系统就会应用这些费用。
  • NotifTypeDeltaOverlay 时,<AdditionalGuestAmounts> 始终会将之前指定的额外金额替换为新金额。
  • 只有当 NotifTypeDelta 时,才能独立于基准费率发送 <AdditionalGuestAmounts>。当 NotifTypeOverlay 时,必须指定 <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

AgeQualifyingCode8 时,必须指定 MaxAge

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @MaxAge 0..1 integer AgeQualifyingCode8 时,必须指定 MaxAge。如果 AgeQualifyingCode10,则不得指定此值。

MaxAge 应介于 017. 之间的整数

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

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

您可以通过单独的 AdditionalGuestAmount 元素指定多个儿童年龄段。年龄范围必须是连续的且不重叠。

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @Amount 1 float 在基本费率的基础上,每位额外入住的客人需支付的税费及其他费用(不含税费)。

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

示例

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

设置 addoverlayremove 值时,日期范围可以相同,也可以不同,具体取决于您的目标。例如,您可以使用 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 件。使用 OverlayRemove 通知类型移除之前定义的产品。

添加费率

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>