RateModifications

概览

借助此 API，您可以定义在满足条件时以动态方式对费率应用操作的方法，例如调整价格或启用退款功能。与只能应用折扣力度最大的符合条件的促销活动的 Promotions API 不同，此 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 消息具有以下元素和属性：

元素 / @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 中使用 `<id>` 在 `<listing>` 元素中指定的酒店 ID 相匹配。您还可以在 Hotel Center 中找到酒店 ID。
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	将价格的退款状态覆盖为指定值。设置属性时，请注意以下事项：此修改操作会完全重写符合条件的房价的 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 之间的整数（含边界值）。
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	UserCountries 规范的类型。有效值为 `include` 和 `exclude`。如果 UserCountries `type` 设置为 `include`，则费率修改适用于所列国家/地区的用户。如果 UserCountries `type` 为 `exclude`，则费率修改适用于所列国家/地区以外的用户。如果未设置 UserCountries `type`，则将其视为 `include`，并且费率修改适用于所列国家/地区的用户。
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / Country	1..300	Country	指定允许进行费率修改的用户国家/地区。
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / Country / @code	1	string	CLDR 国家/地区代码，例如 `DE` 或 `FR`。请注意，对于某些国家/地区，CLDR 国家/地区代码与双字母 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 消息具有以下元素和属性：

元素 / @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>

RateModifications 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

概览

请求

语法

元素和属性

示例

基本消息

删除一项费率调整

删除所有费率调整

叠加所有费率修改

多项修改操作

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

响应

语法

元素和属性

示例

成功

问题

RateModifications