促销活动

如果您有为以下对象提供 Feed 的后端： 多个账号，此值需要与 ID 匹配 <RequestorID> 中指定的属性值 <OTA_HotelRateAmountNotifRQ> 的元素以及 同一天收到 <OTA_HotelAvailNotifRQ> 条消息 。

酒店的促销活动。每个促销活动只适用于 属性。

除非使用 <Stacking>，否则 在以下情况下，系统会向相应预订应用折扣最大的促销活动： 有多个促销活动符合条件。

如果指定，值必须为 "overlay"。当值为 "overlay" 时，所有 已存储的宣传内容会在存储指定的促销之前被删除 。

如果未指定，则当前指定的 消息为：

• Added（如果存储的促销信息都没有 相同的 id）
• Updated（如果存储的促销活动有相同的 id)
• Deleted（如果存储的促销活动有相同的 id 和 action 属性的值 当前消息中指定的促销信息 "delete")

一项房源的促销活动。请注意，如果未指定 action="overlay" 和 <Promotion>，系统会删除相应媒体资源的所有促销活动。

如需使用超过 99 个促销活动，请联系 您的技术支持客户经理 (TAM)。

如果指定，则值必须为 delete。如果不是 和 同一 id 的促销活动未存储，则此 促销。如果未指定，则促销活动包含 系统会存储相同的 id，则使用现有的促销活动 已更新。

如果指定了 delete，则存储的促销以及 相同的 id 被删除。 使用 delete 时，请勿在 <Promotion>。此外，delete 不是 允许与 <HotelPromotions action="overlay"/> 结合使用。

范围的开始日期或日期时间（基于媒体资源所在的时区），包括该日期/时间。

• start 指定的日期或日期时间必须为 早于（或等于） end。
• 如果未指定 start，则范围实际上是 且开始时间不受限制
• 如果将 start 填充为日期“YYYY-MM-DD”，则它为 解释为日期时间“YYYY-MM-DDT00:00:00”。

范围的结束日期或日期时间（基于媒体资源所在的时区），包括该日期/时间。

• end 指定的日期或日期时间必须更晚 指定日期或日期时间 start。
• 如果未指定 end，则范围实际上是 且不限结束时间
• 如果以“YYYY-MM-DD”的形式提供 end， 解释为日期时间“YYYY-MM-DDT23:59:59”。

允许出现在日期范围内的星期几。如果不是 指定日期范围，则允许日期范围内的所有日期。每个 字符串中的字符指定了日期。例如：“MTWHF”指定了 日期范围允许工作日。

有效字符包括：

• M（周一）
• T（周二）
• W：周三
• H 表示周四
• F - 周五
• 周六 S
• 周日U

任何字符组合均有效。

有效的值类型包括：

• 整数：入住前的天数 日期。例如，值为 30 表示促销优惠仅适用于入住日期前至少 30 天的预订。
• ISO 8601 时长（天、小时和分钟）：入住日期前的天数（可选小时/分钟）。例如，值为 P30D 表示促销优惠仅适用于入住日期前至少 30 天的预订。答 价值 P30DT6H 的预订要求在 18:00 或之前预订 到家前 30 天预订。

有效的值类型包括：

• 整数：入住前的天数 日期。例如，值 30 表示 本促销优惠仅适用于活动开始前 30 天内的预订， 入住日期。
• ISO 8601 Duration（天、小时和分钟）： 天（也可选择是小时/分钟）。对于 例如，值 P30D 表示仅限促销活动 适用于入住前 30 天内的预订。答 价值 P30DT6H 的预订要求在以下日期或之后的 18:00 或之后预订： 到家前 30 天预订。

定义对可设置费率最大值的限制 在应用促销优惠后展示。

促销活动必须始终指定 <Discount> 或 <BestDailyDiscount>，因此要创建符合以下条件的促销活动 仅适用于 <Ceiling>，一种选项是设置 <Discount>，percentage： 0。

如果配置了堆叠，则可以对单次住宿应用多个包含 <Ceiling> 的促销优惠。每项促销活动 应用折扣后，紧跟其上限。通过 下例展示了每个上限对 堆栈中的促销信息计算。

示例：

在AmountBeforeTax为 1 晚的住宿定价 共有 2 项促销优惠：

1. 堆叠类型为“base”的促销 第 fixed_amount 个（共 25 个）和上限 第 amount_per_night 个（共 60 个）
2. 堆叠类型为“second”的促销 第 fixed_amount 个（共 25 个）和上限 第 amount_per_night 项，共 90 项

计算顺序如下：

1. 先应用“base”促销优惠并应用折扣 将AmountBeforeTax调整为 75，但上限降低 设为 60。
2. second促销活动提供了 AmountBeforeTax从 60 降至 35。低于上限 所以不会应用第二个上限。最终费率为 35。

60 是更严格的总体上限，这无关紧要， 仅适用于其自身的促销活动， 设置跨越整个促销活动堆栈的“天花板”上限

折扣。

如果还指定了 <Floor> 元素，则 必须设置为大于或等于 amount_per_night 属性 <Floor>。

税费及其他费用为 amount_per_night 使用 AmountAfterTax 包含在每晚房价中，但 而不是使用 TaxFeeInfo 指定的。

定义对可设置费率的最小值的限制 在应用促销优惠后展示。

促销活动必须始终指定 <Discount> 或 <BestDailyDiscount>，因此要创建符合以下条件的促销活动 仅适用于 <Floor>，一种选项是设置 <Discount>，percentage： 0。

<Floor> 逻辑仍然适用于 <FreeNights>的折扣，即使免费住宿晚数有 已应用 100% 的折扣。

如果配置了堆叠，则可以对单次住宿应用多个包含 <Floor> 的促销优惠。每项促销活动 其折扣后紧跟其底价通过 以下示例展示了每个楼层对后续楼层的影响 堆栈中的促销信息计算。

示例：

在AmountBeforeTax为 1 晚的住宿定价 共有 2 项促销优惠：

1. 堆叠类型为“base”的促销 fixed_amount/25 和 1 层 第 amount_per_night 项，共 90 项
2. 堆叠类型为“second”的促销 fixed_amount/25 和 1 层 第 amount_per_night 个（共 60 个）

计算顺序如下：

1. 系统会先应用 base 促销，将 AmountBeforeTax 的价格折扣为 75，但最低价会将其上调至 90。
2. second促销活动提供了 AmountBeforeTax：90 到 65。高于地面 所以第二层不会应用最终费率为 65。

90 是更为严格的总底价，这一事实无关紧要， 仅适用于其自身的促销活动， 用于覆盖整个促销活动堆栈的底价。

折扣应用后，每晚房价可设置的最低金额。

如果还指定了 <Ceiling> 元素，则 必须设置为小于或等于 amount_per_night 属性 <Ceiling>。

税费及其他费用为 amount_per_night 使用 AmountAfterTax 包含在每晚房价中，但 而不是使用 TaxFeeInfo 指定的。

指定入住必须在什么日期范围内进行，才能享受促销优惠 。如果您要删除一个或多个 促销。

也支持 YearlessDate 格式。

• 如果 start 或 end 中的一项是一年制 日期，两者都必须填充为无年份日期。
• 不设年份的日期范围不得环绕新年。相反， 将范围表示为两个相邻的日期范围。例如： {"12-29", "01-05"} 可以表示为 {"12-29", "12-31"} 和 {"01-01", "01-05"}。

允许出现在日期范围内的星期几。如果未指定，则日期范围内的所有日期均可。每个 字符串中的字符指定了日期。例如：“MTWHF”指定了 日期范围允许工作日。

有效字符包括：

• M（周一）
• T（周二）
• W：周三
• H 表示周四
• F - 周五
• 周六 S
• 周日U

任意字符组合均有效。

一个日期范围，用于指定促销活动必须在什么时间退房 。对于非线性广告， 删除一个或多个宣传。

还支持 YearlessDate 格式。

• 如果 start 或 end 中有一个没有年份 日期，两者都必须填充为无年份日期。
• 不设年份的日期范围不得环绕新年。相反， 将范围表示为两个相邻的日期范围。例如，{"12-29", "01-05"} 可以表示为 {"12-29", "12-31"} 和 {"01-01", "01-05"}。

允许出现在日期范围内的星期几。如果未指定，则日期范围内的所有日期均可。每个 字符串中的字符指定了日期。例如：“MTWHF”指定了 日期范围允许工作日。

有效字符包括：

• M（周一）
• T（周二）
• W：周三
• H 表示周四
• F - 周五
• 周六 S
• 周日U

任意字符组合均有效。

必须指定 Discount 或 BestDailyDiscount 中的一个。

指定要应用于此促销活动的折扣。

“percentage”中的一个， fixed_amount、fixed_amount_per_night、 fixed_price 或 fixed_price_per_night 是 必填字段。

介于 0 到 100 之间的一个小数值，用于指定折扣百分比。 应用于 AmountAfterTax（或 AmountBeforeTax（如果 AmountAfterTax 不是） 指定）。

示例：

• 如果 AmountAfterTax 为 100 且 percentage 为 20，则

  促销率 = AmountAfterTax * (1 - 百分比) 折扣）

  80.00 = 100 * (1 - 0.2)

• 如果 AmountBeforeTax 为 100， percentage 为 20，TaxFeeInfo 指定税费为 10， 然后

  促销率 = AmountBeforeTax * (1 - 百分比) 折扣）+ 税费

  90.00 = 100 * (1 - 0.2) + 10

“percentage”中的一个， fixed_amount、fixed_amount_per_night、 fixed_price 或 fixed_price_per_night 是 必填字段。

从以下总和中减去的固定金额： AmountAfterTax每晚房价（或 AmountBeforeTax每晚房价的总和： 未指定 AmountAfterTax）。假定其币种与每晚费率相同。如果此值大于每晚费率的总和，则结果为零。

示例：

• 如果我们指定住宿价格为 1 晚， AmountBeforeTax 是 90， AmountAfterTax 为 100，fixed_amount 为 20，则

  促销率 = AmountAfterTax - 固定 折扣

  80.00 = 100 - 20

• 如果我们指定住宿价格为 1 晚， AmountBeforeTax 是 100，fixed_amount 为 20，TaxFeeInfo 指定税率 8%，则

  促销率 =（AmountBeforeTax - 已修正 折扣）*（1 + 百分比税）

  86.40 = (100 - 20) * 1.08

• 如果我们指定住宿价格为 1 晚， AmountBeforeTax 是 50，fixed_amount 是 TaxFeeInfo 将税费指定为 10，则

  促销率 =（AmountBeforeTax - 已修正 折扣）* 税费

  10.00 = 0 + 10

• 如果我们要为 3 晚的住宿定价，其中 AmountAfterTax 值分别为 100、110 和 120，fixed_amount 为 150，则

  促销率 = 总和(AmountAfterTax) - (固定) 折扣）

  180.00 = (100 + 110 + 120) - 150

“percentage”中的一个， fixed_amount、fixed_amount_per_night、 fixed_price 或 fixed_price_per_night 是 必填字段。

应用于每个 AmountAfterTax 每晚费率（如果指定了 applied_nights，则应用于最便宜的 N 个每晚费率）的固定折扣。如果 AmountAfterTax 未指定，它将应用于 AmountBeforeTax。假设 采用与每晚价格相同的币种。如果 “fixed_amount_per_night”大于 每晚价格会降为 0，即 折扣不会导致每晚费率变为负值。

示例：

• 如果我们预订的是 3 晚住宿的价格， AmountAfterTax 的值为 100、110 和 120；和 fixed_amount_per_night 为 10，则

  促销率 = 总和(AmountBeforeTax - 固定金额 折扣）

  300.00 = ((100 - 10) + (110 - 10) + (120 - 10))

• 如果我们预订的是 3 晚住宿的价格， AmountAfterTax 的值为 10、50 和 100；和 fixed_amount_per_night 是 20，那么

  促销率 = 总和(AmountAfterTax - 固定金额 折扣）

  110.00 = (0 + (50 - 20) + (100 - 20))

必须指定 percentage、fixed_amount、fixed_amount_per_night、fixed_price 或 fixed_price_per_night 中的一个。

如果指定了 AmountAfterTax 每晚费率，则此属性会将住宿价格（含税费及其他费用）设置为指定的值。如果指定了 AmountBeforeTax，则 无论是否指定 AmountAfterTax，都会设置 指定价值的住宿的税前价格。假设 采用与每晚价格相同的币种。

如果 AmountAfterTax 旨在反映百分比税率，则为 AmountBeforeTax 设置固定价格可能会导致税费和其他费用不准确。一般情况下，强烈建议您使用 TaxFeeInfo 指定房源的税费及其他费用。

示例：

• 如果我们指定住宿价格为 1 晚， AmountBeforeTax 是 90， AmountAfterTax 为 100，fixed_price 为 80，则促销率为 80。
• 如果我们指定住宿价格为 1 晚， AmountBeforeTax 是 100，fixed_amount 为 80，TaxFeeInfo 指定的税率为 8%，则

  促销率 = 固定价格 *（1 + 百分比税费）

  86.40 = 80 * 1.08

• 如果我们要为 3 晚的住宿定价，其中 AmountAfterTax 值分别为 100、110 和 120，fixed_amount 为 300，则

  促销率 = 300

必须指定 percentage、fixed_amount、fixed_amount_per_night、fixed_price 或 fixed_price_per_night 中的一个。

如果指定了 AmountAfterTax 每晚价格，则此 将住宿每晚的价格（包括税费和其他费用）设置为 指定值。如果指定了 AmountBeforeTax，则 无论是否指定 AmountAfterTax，都会设置 每晚的税前价格不超过指定值。时间是 假定采用的货币与每晚价格相同。

如果 AmountAfterTax 旨在反映百分比税率，则为 AmountBeforeTax 设置固定价格可能会导致税费和其他费用不准确。一般来说，强烈建议使用 TaxFeeInfo 指定房源的税费。

如果指定了 applied_nights，则新价格会应用于最便宜的 N 晚。

示例：

• 如果我们确定的是入住 2 晚的价格， AmountBeforeTax 的值为 90、90； AmountAfterTax 的值为 100、100；和 fixed_price 为 80，则促销率为 80 + 80 = 160。
• 如果我们要为 2 晚的住宿定价，其中 AmountBeforeTax 为 100、100；fixed_amount 为 80，并且 TaxFeeInfo 指定了 8% 的税费，则促销折扣率为 (80 + 80) * 1.08 = 172.8。
• 如果我们预订的是 3 晚住宿的价格， AmountAfterTax 的值为 100、110 和 120；和 fixed_amount 为 110，则促销率为 110 * 3 = 330。

此参数只能用于 percentage 或 fixed_amount_per_night。

应用折扣的住宿晚数，从 价格最低必须是 1 到 99 之间的整数。如果未指定，则折扣会应用于所有晚数。

应用折扣所需的住宿晚数。每个 折扣会应用于单独的住宿晚数细分。

例如，对于 10 晚住宿，stay_nights 为 4（repeats 为 true），则住宿两晚 细分：第 1 晚到第 4 晚以及第 5 晚到第 8 晚；该 第 9 晚和第 10 晚不在住宿晚数的范围内。

折扣是否可应用于多个住宿晚数细分。如果为 false，则只有入住晚数的细分 行程开始时的优惠。如果为 true，则对任何住宿晚数段都会应用折扣。

例如，如果 stay_nights 为 4，行程为 10 晚，如果 repeats 为 true，则 2 细分受众群会打折（1-4 晚和 5-8 晚）；但是，如果 repeats 为 false，则只有 1 个细分 （第 1 至 4 晚）。

Discount 或 必须指定 BestDailyDiscount。

指定 每日折扣，可能适用于住宿一晚的折扣。这是 与 Discount 不同，后者对整个应用应用折扣 住宿。

每个房源可能有一组促销活动， 被视为“每日最佳”。这意味着，对于每晚的住宿，系统都会选择并应用符合条件且可为当晚提供最大幅折扣的单个“每日最佳”促销优惠。

Stacking 可以使用 BestDailyDiscount 指定。其必须设置为 base 或 none。“每日最佳”折扣 将得到每晚最大折扣后的金额相加并视为 一次性入住折扣（即 Discount），同时遵循 配置的堆叠类型系统会将此组合折扣与其他符合条件的 <Discount> 促销活动进行比较，并可与这些促销活动叠加使用，以找出折扣力度最高的折扣或组合折扣。BestDailyDiscount 或 单个 Discount（以产生较低价格者为准） 已选定并应用于base堆叠类型

可以用此类折扣指定 StayDates， 但 application 必须设置为 overlap

必须提供 percentage、fixed_amount 或 fixed_price 中的一个。

介于 0 到 100 之间的一个小数值，用于指定折扣百分比。 应用于 AmountAfterTax（或 AmountBeforeTax（如果 AmountAfterTax 不是） 指定）。

示例：

• 如果 AmountAfterTax（每晚住宿费）为 100，percentage 为 20，则

  促销率 = AmountAfterTax * (1 - 百分比) 折扣）

  80.00 = 100 * (1 - 0.2)

• 如果入住酒店的 AmountBeforeTax 为 100， percentage 为 20，TaxFeeInfo 指定税费为 10， 然后

  促销率 = AmountBeforeTax * (1 - 百分比) 折扣）+ 税费

  90.00 = 100 * (1 - 0.2) + 10

“percentage”中的一个， fixed_amount 或 fixed_price 为必填项。

从单个 AmountAfterTax 每晚房价（如果未指定 AmountAfterTax，则为 AmountBeforeTax 每晚房价）中扣除的固定金额。假定其币种与每晚费率相同。如果该值大于 每晚房价的总和，所得值为零。

示例：

• 如果单晚 AmountBeforeTax 是 90， AmountAfterTax 为 100，fixed_amount 为 20，则

  促销率 = AmountAfterTax - 固定 折扣

  80.00 = 100 - 20

• 如果单晚 AmountBeforeTax 为 100， fixed_amount 为 20，TaxFeeInfo 指定的税费为 8%，之后

  促销率 =（AmountBeforeTax - 已修正 折扣）*（1 + 百分比税）

  86.40 = (100 - 20) * 1.08

必须提供 percentage、fixed_amount 或 fixed_price 中的一个。

如果指定了 AmountAfterTax 每晚价格，则此 将住宿晚的价格（包括税费和其他费用）设置为 指定值。如果指定了 AmountBeforeTax，则 无论是否指定 AmountAfterTax，都会设置 指定价值的住宿的税前价格。假设 采用与每晚价格相同的币种。

示例：

• 如果单晚 AmountBeforeTax 是 90， AmountAfterTax 为 100，fixed_price 为 80，则促销率为 80。
• 如果单晚 AmountBeforeTax 为 100， fixed_amount 为 80，TaxFeeInfo 指定的税费为 8%，之后

  促销率 = 固定价格 *（1 + 百分比税费）

  86.40 = 80 * 1.08

用于触发特定界面的成员资格费率规则的容器 相关折扣的处理。

不应指定此元素，除非 还指定了 <Discount>。

的 ID 与会员计划相关联的价格规则。

一项费率可应用多个促销优惠，具体取决于 此设置：

• any：可与其他任何促销活动结合使用（但不包括 none），而应将促销信息显示 并不能保证实际应用
• base：系统会先选择最优惠的符合条件的 base 促销活动，然后再应用其他促销活动。此方法之前名为 base_only。
• second：最优惠的second促销活动 已选择，并在base促销活动结束后应用 （如适用）且在any促销之前。
• none：不能与其他产品结合使用 促销。

在允许的组合中，可产生 最大折扣应用于费率。

说明应如何应用促销优惠。

有效值包括：

• all：将促销优惠应用于以下活动的每晚： 如果行程中的所有日期重叠，则显示此行程 并附上了住宿日期信息
• any：如果行程中的任何日期与住宿日期范围内的日期重叠，则将促销优惠应用于行程中的所有晚数。
• overlap：仅将促销活动应用于 行程中与住宿日期的日期重叠的住宿晚数 范围。

必须始终指定此属性。

• 如果 <Discount> 指定了 percentage，并且 application 设置为 all 或 any，则折扣将以整次住宿费用的百分比形式应用。
• 如果 <Discount> 指定 percentage 且 application 设为 overlap， 折扣以每晚费率的百分比形式应用， 。
• <Discount>，指定了 fixed_amount 而设置为 overlap 的 application 则是 无效组合。
• <FreeNights> 支持所有 application 值。请注意，对于 overlap， 仅将重叠住宿晚数视为折扣 要求。

指定促销活动应用日期的日期范围。

还支持 YearlessDate 格式。

• 如果 start 或 end 中的一项是一年制 日期，两者都必须填充为无年份日期。
• 不设年份的日期范围不得环绕新年。相反， 将范围表示为两个相邻的日期范围。例如： {"12-29", "01-05"} 可以表示为 {"12-29", "12-31"}和 {"01-01", "01-05"}。

如果您想设置 StayDates 范围，以允许在特定日期促销，则应将 start 日期设置为当前日期，不添加 end，以免促销活动失效。

如果存在以下情况，则应指定 start 值： 未提供“end”值。

如果未提供 start 值，您应指定 end 值。

允许出现在日期范围内的星期几。如果未指定，则日期范围内的所有日期均可。字符串中的每个字符都指定一天。例如：“MTWHF”指定了 日期范围允许工作日。

有效字符包括：

• M（周一）
• T（周二）
• W：周三
• H 表示周四
• F - 周五
• 周六 S
• 周日U

任意字符组合均有效。

有效值为 include 和 exclude。

如果 UserCountry type 设置为 include，此促销活动适用于以下国家/地区的用户： 列出的国家/地区。

如果 UserCountry type 为 exclude， 此促销活动适用于所列用户 国家/地区。

如果未设置 User countries type，则会被视为 include，且促销优惠已应用于以下国家/地区的用户： 所列国家/地区。

<Success> 或 <Issues> 为 。

<Success> 或 <Issues> 为 。

遇到的问题类型。

有效值为 warning、error、 和 failure。