修改费率

概览

借助此 API，您可以定义在满足条件时动态地对房价应用操作的方式，例如调整价格或启用可退款性。与 Promotions API 不同，它只能应用折扣力度最高的符合条件的促销活动，而会在满足特定条件时应用所有操作，包括最终可能会提高最终价格的价格调整。

请求数

语法

RateModifications 消息使用以下语法：

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="partner_key"
                      id="message_ID"
                      timestamp="timestamp">
  <HotelRateModifications hotel_id="HotelID" action="[overlay]">
    <ItineraryRateModification id="ModificationID" action="[delete]">
      <BookingDates>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </BookingDates>
      <BookingWindow min="integer" max="integer"/>
      <CheckinDates>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </CheckinDates>
      <CheckoutDates>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </CheckoutDates>
      <Devices>
        <Device type="[desktop|tablet|mobile]"/>
      </Devices>
      <LengthOfStay min="integer" max="integer"/>
      <MinimumAmount before_discount="integer"/>
      <RatePlans>
        <RatePlan id="PackageID_1"/>
        <RatePlan id="PackageID_2"/>
      </RatePlans>
      <RoomTypes>
        <RoomType id="RoomID_1"/>
        <RoomType id="RoomID_2"/>
      </RoomTypes>
      <StayDates application="[all|any]">
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </StayDates>
      <UserCountries type="[include|exclude]">
        <Country code="country_code"/>
      </UserCountries>
      <ModificationActions>
        <PriceAdjustment multiplier="float"/>
        <RateRule id="RateRuleID"/>
        <Refundable available="[false|true]"
                       refundable_until_days="number_of_days"
                       refundable_until_time="time"/>
        <Availability status="[unavailable]"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

元素和属性

RateModifications 消息具有以下元素和属性：

Element / @Attribute 出现次数 类型 说明
RateModifications 1 Complex element 费率修改消息的根元素。
RateModifications / @partner 1 string 此消息的合作伙伴账号。此字符串值是 Hotel Center 的 “帐号设置”页面上列出的“合作伙伴密钥”值。

注意：如果您的后端为多个帐号提供 Feed，则此值需要与同一帐号的 <OTA_HotelRateAmountNotifRQ> 和 <OTA_HotelAvailNotifRQ> 消息的 <RequestorID> 元素中指定的 ID 属性值匹配。
RateModifications / @id 1 string 此请求消息的唯一标识符。此值会在响应消息中返回。允许使用的字符包括 a-z、A-Z、0-9、_（下划线）和 -（短划线）。
RateModifications / @timestamp 1 DateTime 此消息的创建日期和时间。
RateModifications / HotelRateModifications 0..n HotelRateModifications

修改房源的房价。每项房价修改都适用于单个房源。

注意：如果可对同一费率应用多个费率修改，则系统会应用所有修改。无法保证任何特定顺序。
RateModifications / HotelRateModifications / @hotel_id 1 string 房源的唯一标识符。此值必须与酒店列表 Feed 的 <listing> 元素中使用 <id> 指定的酒店 ID 一致。酒店 ID 也会显示在 Hotel Center 中。
RateModifications / HotelRateModifications / @action 0..1 enum

如果未指定 action，则为此酒店添加或更新此元素中的修改。如果指定了 action="overlay"，则首先会删除之前为此酒店定义的所有修改。然后，系统会写入此处指定的修改。如果使用了 action="overlay"，并且没有在此元素中指定任何修改，则针对此酒店的所有修改都将被删除。
RateModifications / HotelRateModifications / ItineraryRateModification 0..200 ItineraryRateModification

房源的单次费率修改。

注意：费率修改很难调试，我们建议您谨慎使用。对于需要修改超过 200 次费率的用例，请与您的技术支持客户经理 (TAM) 联系。
RateModifications / HotelRateModifications / ItineraryRateModification / @id 1 string 用于修改房价的唯一标识符。允许的最大字符数为 40。允许使用的字符包括 a-z、A-Z、0-9、_（下划线）、-（短划线）和 . （句点）。
RateModifications / HotelRateModifications / ItineraryRateModification / @action 0..1 enum

如果未指定，并且未存储具有相同 id 的费率修改，则系统会存储此费率修改。 否则，如果未指定，并且存储了具有相同 id 的费率修改，则会更新现有的费率修改。

如果指定，则值必须为 "delete"。如果指定了 "delete"，系统会删除具有相同 id 的存储费率修改。 使用 "delete" 时，请勿在 <ItineraryRateModification> 中添加任何子元素。此外，"delete" 不能与 <HotelRateModifications action="overlay"/> 结合使用。
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates 0..1 BookingDates 一个或多个日期范围的容器，用于定义必须在何时预订才能应用费率修改。
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange 1..99 DateRange 用于指定必须在何时开始预订才能应用费率修改的日期范围。
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @start 0..1 Date 日期范围的开始日期（基于媒体资源的时区）。此日期必须早于或与 end 日期相同。如果未指定 start，就开始日期而言，日期范围实际上是不受限制的。
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @end 0..1 Date 日期范围的结束日期（基于媒体资源的时区）。此日期必须与 start 日期相同或更晚。如果未指定 end，则就结束日期而言，日期范围实际上是不受限制的。
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @days_of_week 0..1 string

日期范围内允许的星期几。如果未指定，则允许日期范围中的所有日期。字符串中的每个字符都指定日期。例如，“MTWHF”指定允许在日期范围内使用工作日。

有效字符包括：

  • 周一价格为 M
  • 周二价格为 T
  • 周三W
  • 周四：H
  • 周五F
  • S（周六）
  • U（周日）

任何字符组合都有效。
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow 0..1 BookingWindow 指定必须相对于入住日期进行预订的时间段（基于房源的时区）。例如，预订时间范围可设置为入住前至少 7 天，但不能超过 180 天。
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow / @min 0..1 integer 入住前至少提前多少天预订，这样才能应用房价修改。如果未指定，则表示没有最小值。
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow / @max 0..1 integer 入住前最多提前多少天预订，这样才能应用房价修改。如果未指定，则表示没有上限。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates 0..1 CheckinDates 一个或多个日期范围的容器，用于定义必须在何时入住才能应用费率修改。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange 1..99 DateRange 指定必须在何时入住才能应用费率修改的日期范围。如果您要删除一项或多项费率修改，则此元素不是必需的。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @start 0..1 Date 日期范围的开始日期（基于媒体资源的时区）。此日期必须早于或与 end 日期相同。如果未指定 start，就开始日期而言，日期范围实际上是不受限制的。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @end 0..1 Date 日期范围的结束日期（基于媒体资源的时区）。此日期必须与 start 日期相同或更晚。如果未指定 end，则就结束日期而言，日期范围实际上是不受限制的。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @days_of_week 0..1 string

日期范围内允许的星期几。如果未指定，则允许日期范围中的所有日期。字符串中的每个字符都指定日期。例如，“MTWHF”指定允许在日期范围内使用工作日。

有效字符包括：

  • 周一价格为 M
  • 周二价格为 T
  • 周三W
  • 周四：H
  • 周五F
  • S（周六）
  • U（周日）

任何字符组合都有效。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates 0..1 CheckoutDates 一个或多个日期范围的容器，用于定义必须在何时结账才能应用费率修改。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange 1..99 DateRange 指定必须在何时结算才能应用费率修改的日期范围。如果您要删除一项或多项费率修改，则此元素不是必需的。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @start 0..1 Date 日期范围的开始日期（基于媒体资源的时区）。此日期必须早于或与 end 日期相同。如果未指定 start，就开始日期而言，日期范围实际上是不受限制的。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @end 0..1 Date 日期范围的结束日期（基于媒体资源的时区）。此日期必须与 start 日期相同或更晚。如果未指定 end，则就结束日期而言，日期范围实际上是不受限制的。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @days_of_week 0..1 string

日期范围内允许的星期几。如果未指定，则允许日期范围中的所有日期。字符串中的每个字符都指定日期。例如，“MTWHF”指定允许在日期范围内使用工作日。

有效字符包括：

  • 周一价格为 M
  • 周二价格为 T
  • 周三W
  • 周四：H
  • 周五F
  • S（周六）
  • U（周日）

任何字符组合都有效。
RateModifications / HotelRateModifications / ItineraryRateModification / Devices 0..1 Devices 用于列出符合费率修改条件的用户设备的容器。如果指定，则仅当用户与列出的某部设备匹配时，才会应用费率修改。如果未指定，则不会限制费率修改的应用。
RateModifications / HotelRateModifications / ItineraryRateModification / Devices / Device 1..3 Device 定义一种可以修改费率的用户设备类型。
RateModifications / HotelRateModifications / ItineraryRateModification / Devices / Device / @type 1 enum 一种设备类型。该值必须为 desktop、tablet 或 mobile。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions 1 ModificationActions

在满足所有指定条件时应用于房价的操作。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / PriceAdjustment 0..1 PriceAdjustment 将 AmountBeforeTax 和 AmountAfterTax 乘以指定的调节系数来修改费率
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / PriceAdjustment / @multiplier 1 float AmountBeforeTax 和 AmountAfterTax 都会与此值相乘。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / RateRule 0..1 RateRule 通过应用指定的费率规则 ID 来修改费率。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / RateRule / @id 1 string 此 ID 将费率与费率规则定义文件中的定义相匹配。 注意：
  • 此字段的字符数限制为 40。
  • 每个费率只能与一条费率规则相关联。
  • 如果有多项应用了某个费率规则 ID 的修改，则系统会将字典顺序上最小的费率规则 ID 分配给该费率。
  • 如果此 ID 与费率规则定义文件中的费率规则不匹配，则会被视为不符合条件。
如需了解不同的不公开费率界面处理方式，请参阅 这篇文章。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable 0..1 Refundable 将房价的可退款性替换为指定值。

设置属性时，请注意以下事项：

  • 此修改操作会完全重写符合条件的费率的“可退款”设置，而不仅仅是重写填充的字段。
  • 如果未设置 available 或 refundable_until_days，费率不会显示为可退款。
  • 如果 available 为 0 或 false，则系统会忽略其他属性。即使设置了其他某个或两个属性，费率也不会显示为可退款。
  • 建议设置 refundable_until_time；如果未设置，则使用最早时间（午夜）。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable / @available 1 boolean （必需）设置为 1 或 true，以指明相应费率是否允许全额退款；否则，应设置为 0 或 false。
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days 0..1 integer （如果 available 为 true，则为必需）指定入住前提前多少天可以申请全额退款。refundable_until_days 的值必须是 0 到 330（含 0 和 330）之间的整数。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable / @refundable_until_time 0..1 Time （如果 available 为 true，则推荐使用）指定允许全额退款请求的最晚时间（以酒店的当地时间为准）。此参数可与 refundable_until_days 结合使用，例如指定“退票可在入住前两天下午 4 点之前享受”。如果未设置 refundable_until_time，则该值默认为午夜。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Availability 0..1 Availability 将房价的空房情况替换为指定值。 我们仅支持将费率设置为 unavailable。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Availability / @status 1 enum 如果为 status="unavailable"，则无论费率是否存在有效价格，都将其视为不可用。
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay 0..1 LengthOfStay 定义可在哪些住宿晚数限制内应用此房价修改。当住宿晚数超出下限和上限时，系统不会应用房价修改。
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay / @min 0..1 integer 为应用房价修改而允许的住宿晚数下限。如果未指定，则表示没有最小值。
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay / @max 0..1 integer 为应用房价修改而允许入住的最长晚数。如果未指定，则表示没有上限。
RateModifications / HotelRateModifications / ItineraryRateModification / MinimumAmount 0..1 MinimumAmount 指定每日房价的总和（使用 AmountBeforeTax 或 AmountAfterTax 中的较大者），才能应用房价修改。
RateModifications / HotelRateModifications / ItineraryRateModification / MinimumAmount / @before_discount 1 integer 为了应用费率修改而必须超过的值。
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans 0..1 RatePlans 用于容纳费率修改所应用到的费率方案的列表的容器。如果未指定 <RatePlans>，则费率修改会应用于所有费率方案。
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans / RatePlan 1..n RatePlan 指定费率方案。费率方案由套餐、房价和空房情况组成，如交易（房源数据）、OTA_HotelRateAmountNotifRQ 和 OTA_HotelAvailNotifRQ 消息中定义，并由 PackageID 标识。
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans / RatePlan / @id 1 string 费率方案的唯一标识符。此值映射到交易（房源数据）消息中的 <PackageData> 中的 PackageID 值，以及 <OTA_HotelRateAmountNotifRQ> 和 <OTA_HotelAvailNotifRQ> 消息中 <StatusApplicationControl> 的 RatePlanCode 属性中的值。 允许的最大字符数为 50。
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes 0..1 RoomTypes 用于包含需要修改房价的房型列表的容器。 费率修改会应用于指定的每个 <RoomType>。如果未指定 <RoomTypes>，房价修改会应用于所有客房。
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType 1..n RoomType 指定房间类型。房间类型在交易（房源数据）消息的 <RoomData> 元素中定义，并通过其 <RoomID> 值引用。（OTA_HotelRateAmountNotifRQ 消息中的 InvTypeCode 属性也会引用其 <RoomID> 值。）
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType / @id 1 string 广告资源（房间类型）的唯一标识符。此值映射到交易（房源数据）消息中的 <RoomID>。 允许的最大字符数为 50。
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates 0..1 StayDates 一个或多个日期范围的容器，用于确定如何应用费率修改，例如调整季节性定价。
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / @application 1 enum

描述应如何应用费率修改。

有效值包括：

  • all：如果行程中的所有日期与住宿日期重叠，则对行程中的每晚应用房价修改。
  • any：如果行程中的任何日期与住宿日期范围内的日期重叠，则将房价修改应用于行程中的所有住宿晚数。

必须始终指定此属性。
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange 1..99 DateRange 用于指定应用费率修改日期的日期范围。
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @start 0..1 Date 日期范围的开始日期（基于媒体资源的时区）。此日期必须早于或与 end 日期相同。如果未指定 start，就开始日期而言，日期范围实际上是不受限制的。
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @end 0..1 Date 日期范围的结束日期（基于媒体资源的时区）。此日期必须与 start 日期相同或更晚。如果未指定 end，则就结束日期而言，日期范围实际上是不受限制的。
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @days_of_week 0..1 string

日期范围内允许的星期几。如果未指定，则允许日期范围中的所有日期。字符串中的每个字符都指定日期。例如，“MTWHF”指定允许在日期范围内使用工作日。

有效字符包括：

  • 周一价格为 M
  • 周二价格为 T
  • 周三W
  • 周四：H
  • 周五F
  • S（周六）
  • U（周日）

任何字符组合都有效。
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries 0..1 UserCountries 如果指定，则仅当用户位于指定国家/地区之一时，才会应用房价修改。如果未指定，则无论用户身在何处，系统都会应用房价修改。
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / @type 0..1 enum UserCountry 规范的类型。

有效值为 include 和 exclude。

如果 UserCountry type 设置为 include，则费率修改会应用于这些国家/地区的用户。

如果 UserCountry type 为 exclude，则费率修改会应用于所列国家/地区以外的用户。

如果未设置 UserCountry type，则会被视为 include，并且费率修改会应用于所列国家/地区的用户。
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / Country 1..300 Country 指定允许修改费率的用户所在的国家/地区。
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / Country / @code 1 string CLDR 国家/地区代码，例如 DE 或 FR。请注意，对于某些国家/地区，CLDR 国家/地区代码与 2 个字母的 ISO 国家/地区代码不同。此外，也不支持 CLDR 地区代码。

示例

基本消息

以下示例展示了一条基本的 RateModifications 消息：

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-07-01" end="2023-07-31" days_of_week="MTWHF"/>
         <DateRange start="2023-09-01" end="2023-09-30"/>
      </BookingDates>
      <BookingWindow min="7" max="330"/>
      <CheckinDates>
         <DateRange start="2023-10-01" end="2023-10-31" days_of_week="FSU"/>
      </CheckinDates>
      <CheckoutDates>
         <DateRange start="2023-10-08" end="2023-11-07" days_of_week="FSU"/>
      </CheckoutDates>
      <Devices>
        <Device type="mobile"/>
        <Device type="tablet"/>
      </Devices>
      <LengthOfStay min="2" max="14"/>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <UserCountries>
        <Country code="US"/>
        <Country code="GB"/>
      </UserCountries>
      <ModificationActions>
        <PriceAdjustment multiplier="1.2"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

删除单一房价修改

以下示例展示了如何删除房源的单次费率修改：

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1" action="delete"/>
  </HotelRateModifications>
</RateModifications>

删除所有房价修改

以下示例展示了如何删除房源的所有房价修改：

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1" action="overlay"/>
</RateModifications>

叠加所有费率修改

以下示例展示了如何使用一个或多个新的费率修改来叠加属性的 <HotelRateModifications>。如果设为 action="overlay"，系统会在存储当前消息中指定的费率修改之前删除所有存储费率修改：

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1" action="overlay"/>
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-09-01" end="2023-09-30"/>
      </BookingDates>
      <ModificationActions>
        <PriceAdjustment multiplier="1.2"/>
      </ModificationActions>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

多项修改操作

以下示例展示了如何一次执行多项修改操作：

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-01-01" end="2023-02-28"/>
      </BookingDates>
      <ModificationActions>
        <PriceAdjustment multiplier=".95"/>
        <Refundable available="true"
                    refundable_until_days="1"
                    refundable_until_time="12:00:00"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

为用户国家/地区停用费率方案

以下示例展示了如何将费率方案限制为仅面向日语 (JP) 用户：

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <RatePlans>
         <RatePlan id="jp_only"/>
      </RatePlans>
      <UserCountries type="exclude">
        <Country code="JP"/>
      </UserCountries>
      <ModificationActions>
        <Availability status="unavailable"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

响应

语法

RateModificationsResponse 消息使用以下语法：

<?xml version="1.0" encoding="UTF-8"?>
<RateModificationsResponse timestamp="timestamp"
                    id="message_ID"
                    partner="partner_key">
  <!-- Either Success or Issues will be populated. -->
  <Success/>
  <Issues>
    <Issue code="issue_code" status="issue_type"><var>issue_description</var></Issue>
  </Issues>
</RateModificationsResponse>

元素和属性

RateModificationsResponse 消息具有以下元素和属性：

Element / @Attribute 出现次数 类型 说明
RateModifications 1 Complex element 表示收到的 RateModifications 请求消息是成功还是问题的根元素。
RateModificationsResponse / @timestamp 1 DateTime 此消息的创建日期和时间。
RateModificationsResponse / @id 1 string 来自关联的 RateModifications 消息的唯一标识符。
RateModificationsResponse / @partner 1 string 此消息的合作伙伴账号。
RateModificationsResponse / Success 0..1 Success 表示 RateModifications 消息已成功处理，没有警告、错误或失败。

每条消息中存在 <Success> 或 <Issues>。
RateModificationsResponse / Issues 0..1 Issues 用于存储处理 RateModifications 消息时发生的一个或多个问题的容器。

每条消息中存在 <Success> 或 <Issues>。
RateModificationsResponse / Issues / Issue 1..n Issue 对处理 RateModifications 消息时遇到的警告、错误或失败的说明。如需详细了解这些问题，请参阅 Feed 状态错误消息。
RateModificationsResponse / Issues / Issue / @code 1 integer 问题的标识符。
RateModificationsResponse / Issues / Issue / @status 1 enum

遇到的问题类型。

有效值为 warning、error 和 failure。

示例

成功

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

<?xml version="1.0" encoding="UTF-8"?>
<RateModificationsResponse timestamp="2023-05-22T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</RateModificationsResponse>

问题

以下是对由于错误而未处理的 RateModifications 消息的响应。

<?xml version="1.0" encoding="UTF-8"?>
<RateModificationsResponse timestamp="2023-05-22T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Issues>
    <Issue code="1001" status="error">Example</Issue>
  </Issues>
</RateModificationsResponse>