促銷

如果您有為多個帳戶提供動態饋給的後端，這個值必須與同一個帳戶 <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 天的預訂。A 罩杯 如為 P30DT6H，則須在 18:00 當天或之前訂房 抵達目的地的第 30 天

有效的值類型包括：

• 整數：入住日期前幾天。例如，30 值表示 促銷活動僅適用於最晚 30 天前的預訂 入住日期。
• ISO 8601 時間長度 (天、小時和分鐘)：代表的數字數量 入住日期前的天 (可視需要指定小時/分鐘)。舉例來說，如果值為 P30D，表示促銷活動只適用於入住日期前 30 天內的預訂。A 罩杯 如為 P30DT6H，則須在 18:00 當天或之後預訂 抵達目的地的第 30 天

定義可設定費率的最大值限制 套用促銷活動後。

促銷活動一律必須指定 <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。低於天花板 因此不會套用第二個天花板最終費率為 35。

雖然 60 是更嚴格的整體上限，但這與實際情況無關，因為它只適用於該促銷活動，且整個促銷活動堆疊中並沒有單一上限。

可設定每晚房價的最高金額 會套用折扣。

如果同時指定了 <Floor> 元素，這個元素就會 必須設為大於或等於 amount_per_night 屬性 <Floor>。

使用「amount_per_night」時，需支付稅金和相關費用 已使用 AmountAfterTax 包含在每晚房價中，但 不是透過 TaxFeeInfo 指定的參數。

定義可設定費率的最小值限制 套用促銷活動後。

促銷活動一律必須指定 <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 層)，以及 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 (或 如果 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_amount_per_night、 fixed_price，或fixed_price_per_night是 這通常代表交易 不會十分要求關聯語意

系統會從 每晚房價：AmountAfterTax (或 每晚房價總和：AmountBeforeTax 未指定 AmountAfterTax)。假設為 和每晚房價相同的貨幣。如果這個值大於 每晚房價總和，結果值為 0。

範例：

• 如果我們要計算 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，然後

  促銷費率 = 總和(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大於 1 每晚每晚房價都會降低為 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)，同時遵循設定的堆疊類型。系統會比較此合併折扣 且可以與其他符合資格的 <折扣> 透過促銷活動找出能達成最佳目標的一或多個組合 折扣。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 (或 AmountBeforeTax 每晚房價 未指定 AmountAfterTax)。假設為 和每晚房價相同的貨幣。如果這個值大於 每晚房價總和，結果值為 0。

範例：

• 如果一晚的 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

用來觸發特定 UI 的會員費率規則容器 來處理相關折扣

除非必要，否則「請勿」指定這個元素 也指定 <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，系統會以重疊住宿晚數的每晚房價百分比套用折扣。
• 指定 fixed_amount 的 <Discount> application 設為 overlap 是 組合無效。
• <FreeNights>支援所有 application 值。請注意，對於 overlap， 只有重疊的入住天數才會計入折扣 Google Cloud 就是最佳選擇

指定套用促銷活動的日期。

系統也支援 YearlessDate 格式。

• 如果 start 或 end 中的任一單位是無年紀念 日期，皆須填入無年日期。
• 無年份日期範圍不得跨越新年。請改為以兩個相鄰的日期範圍表示範圍。例如： {"12-29", "01-05"} 能以下列形式表示： 「{"12-29", "12-31"}」和 {"01-01", "01-05"}。

如要將StayDates範圍設為 限時一週的促銷活動，請將 將 start 日期設為今天，沒有 end，因此 表示促銷活動沒有使用期限

如果start 未提供 end 值。

如果end 未提供 start 值。

日期範圍內允許的星期幾。如果不是 指定的日期，您可以在日期範圍內允許所有日期。每項 字元指定天數。例如「MTWHF」會指定 日期範圍。

有效的字元包括：

• M (週一)
• T 代表星期二
• W 代表星期三
• H 代表星期四
• F 代表星期五
• S 代表星期六
• U 代表星期日

任何字元組合皆可使用。

有效值為 include 和 exclude。

如果使用者國家/地區type設為 include，促銷活動適用於符合以下條件的使用者： 列出的國家。

如果使用者國家/地區type為exclude， 本優惠適用於下列國家/地區以外的使用者 國家。

如未設定 User countries type，系統會將此資訊視為 include，而促銷活動會套用至以下來源的使用者： 清單中列出的國家/地區

<Success> 或 <Issues> 為 。

<Success> 或 <Issues> 為 。

遇到的問題類型。

有效值為 warning、error、 和 failure。