推广

如果您的后端为多个账号提供 Feed，则此值需要与同一账号的 <OTA_HotelRateAmountNotifRQ> 和 <OTA_HotelAvailNotifRQ> 消息的 <RequestorID> 元素中指定的 ID 属性值一致。

酒店的促销活动。每个促销活动只适用于单个房源。

如果有多个促销活动符合条件，除非使用 <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，则在结束时间方面，范围实际上是无限的。
• 如果 end 以日期“YYYY-MM-DD”的形式提供，则会被解读为日期时间“YYYY-MM-DDT23:59:59”。

日期范围内允许的星期几。如果未指定，则日期范围内的所有日期均可。字符串中的每个字符都指定一天。例如，“MTWHF”表示日期范围内允许包含周一至周五。

有效字符包括：

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

任何字符组合均有效。

有效的值类型包括：

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

有效的值类型包括：

• 整数：入住日期前的天数。例如，值为 30 表示促销仅适用于入住日期前最多 30 天的预订。
• ISO 8601 时长（天、小时和分钟）：入住日期前的天数（可选小时/分钟）。例如，值为 P30D 表示促销仅适用于入住日期前最多 30 天的预订。如果值为 P30DT6H，则要求在入住前 30 天的 18:00 或之后进行预订。

定义应用促销优惠后费率可设置的最大值。

促销活动始终必须指定 <Discount> 或 <BestDailyDiscount>，因此，若要创建仅应用 <Ceiling> 的促销活动，一种方法是设置 <Discount>，并将 percentage 设为 0。

如果配置了堆叠，则可以对单次住宿应用多个包含 <Ceiling> 的促销优惠。每个促销活动都会应用其折扣，紧随其后的是其上限。以下示例展示了每个上限如何影响堆栈中的下一次促销计算。

示例：

计算入住 1 晚的价格，其中 AmountBeforeTax 为 100，并且有两个叠加的促销：

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。此值低于上限 90，因此不会应用第二个上限。最终费率为 35。

60 是一个更严格的总上限，但这无关紧要，因为它仅适用于其自身的促销活动，并且无法有一个涵盖整个促销活动堆栈的上限。

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

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

当税费和其他费用包含在使用 AmountAfterTax 计算的每晚费率中时，系统会对其应用 amount_per_night，但不会对使用 TaxFeeInfo 指定的税费和其他费用应用 amount_per_night。

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

促销活动始终必须指定 <Discount> 或 <BestDailyDiscount>，因此，若要创建仅应用 <Floor> 的促销活动，一种方法是设置 <Discount>，并将 percentage 设为 0。

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

如果配置了堆叠，则可以对单次住宿应用多个包含 <Floor> 的促销优惠。每个促销活动都会应用其折扣，紧随其后的是其底价。以下示例展示了每个楼层如何对堆栈中的下一次促销计算做出贡献。

示例：

计算入住 1 晚的价格，其中 AmountBeforeTax 为 100，并且有两个叠加的促销：

1. 促销活动，堆叠类型为 base，fixed_amount 为 25，amount_per_night 为 90
2. 促销活动，堆叠类型为 second，fixed_amount 为 25，amount_per_night 为 60

计算顺序如下：

1. 系统会先应用 base 促销，将 AmountBeforeTax 的折扣金额减至 75，但最低金额将其上调至 90。
2. second 促销将 AmountBeforeTax 的价格从 90 降至 65。此值高于下限 60，因此不会应用第二个下限。最终费率为 65。

90 是一个更严格的整体下限，但这无关紧要，因为它仅适用于其自身的促销活动，并且无法有一个下限涵盖整个促销活动堆叠。

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

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

当税费和其他费用包含在使用 AmountAfterTax 计算的每晚费率中时，系统会对其应用 amount_per_night，但不会对使用 TaxFeeInfo 指定的税费和其他费用应用 amount_per_night。

指定必须在何时入住才能应用促销优惠的日期范围。如果您要删除一个或多个促销活动，则无需此元素。

也支持 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、percentage_of_base、fixed_amount、fixed_amount_per_night、fixed_price 或 fixed_price_per_night 中的一个。

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

示例：

• 如果 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、percentage_of_base、fixed_amount、fixed_amount_per_night、fixed_price 或 fixed_price_per_night 中的一个。

一个介于 0 到 100 之间的十进制值，用于指定基础折扣的百分比。与 percentage 类似，它会应用于 AmountAfterTax（如果未指定 AmountAfterTax，则应用于 AmountBeforeTax）。

与 percentage 不同，无论之前应用了哪些促销优惠，此折扣始终按占基准费率的百分比计算。

示例：

• 假设我们有两项促销活动，分别按顺序应用于价格为 100 元的单晚住宿。第一个是常规的 10% 折扣，第二个是基础折扣的 10%。那么折扣率将为 80，因为这两项促销活动都将价格打折 10 元。请注意，如果第二项促销活动也是按百分比折扣，那么折扣率将为 81，因为第二项促销活动将 90 元的价格打折 10%。

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

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

示例：

• 如果我们要为 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 为 60，TaxFeeInfo 指定的税费为 10，则

  促销折扣率 = (AmountBeforeTax - 固定折扣) * 税率

  10.00 = 0 + 10

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

  促销率 = sum(AmountAfterTax) - (fixed discount)

  180.00 = (100 + 110 + 120) - 150

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

应用于每个 AmountAfterTax 每晚费率（如果指定了 applied_nights，则应用于最便宜的 N 个每晚费率）的固定折扣。如果未指定 AmountAfterTax，则系统会将其应用于 AmountBeforeTax。假定其币种与每晚费率相同。如果 fixed_amount_per_night 大于每晚费率，则将该每晚费率减为零；折扣不能导致每晚费率变为负数。

示例：

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

  促销折扣率 = sum(AmountBeforeTax - 固定金额折扣)

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

• 如果我们要为 3 晚的住宿价格定价，其中 AmountAfterTax 值分别为 10、50 和 100，fixed_amount_per_night 为 20，则

  促销折扣率 = sum(AmountAfterTax - 固定金额折扣)

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

必须提供 percentage、percentage_of_base、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、percentage_of_base、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（如果未指定 AmountAfterTax，则应用于 AmountBeforeTax）。

示例：

• 如果 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：系统会在 base 促销优惠（如果适用）之后、any 促销优惠之前，选择并应用最优惠的符合条件的 second 促销优惠。
• none：不能与其他促销优惠搭配使用。

在允许的组合中，系统会对房价应用可提供最大折扣的一组促销活动。

说明如何应用促销活动。

有效值包括：

• all：如果行程中的所有日期与住宿日期重叠，则将促销优惠应用于行程中的每晚。
• any：如果行程中的任何日期与住宿日期范围内的日期重叠，则将促销优惠应用于行程中的所有晚数。
• overlap：仅将促销优惠应用于行程中与住宿日期范围重叠的晚数。

必须始终指定此属性。

• 如果 <Discount> 指定了 percentage，并且 application 设置为 all 或 any，则折扣将以整次住宿费用的百分比形式应用。
• 如果 <Discount> 指定了 percentage，并且 application 设为 overlap，则折扣将按重叠晚数的每晚房价的百分比应用。
• <Discount> 指定 fixed_amount 且 application 设为 overlap 的组合无效。
• <FreeNights> 支持所有 application 值。请注意，对于 overlap，系统仅会考虑重叠的住宿晚数来判断是否符合折扣条件。

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

也支持 YearlessDate 格式。

• 如果 start 或 end 之一是无年份日期，则必须将这两个日期都填充为无年份日期。
• 不含年份的日期范围不得跨越新年。请改为将该范围表示为两个相邻的日期范围。例如，{"12-29", "01-05"} 可以表示为 {"12-29", "12-31"} 和 {"01-01", "01-05"}。

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

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

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

日期范围内允许的星期几。如果未指定，则日期范围内的所有日期均可。字符串中的每个字符都指定一天。例如，“MTWHF”表示日期范围内允许包含周一至周五。

有效字符包括：

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

任何字符组合均有效。

有效值为 include 和 exclude。

如果将 UserCountries type 设置为 include，则促销活动适用于列出的国家/地区的用户。

如果 UserCountries type 为 exclude，则促销活动适用于不在所列国家/地区的用户。

如果未设置 UserCountries type，系统会将其视为 include，并将促销应用于列出的国家/地区的用户。

每条消息中都包含 <Success> 或 <Issues>。

每条消息中都包含 <Success> 或 <Issues>。

遇到的问题类型。

有效值为 warning、error 和 failure。