プロモーション

複数のアカウントのフィードを提供するバックエンドを使用している場合、この値は、同じアカウントの <OTA_HotelRateAmountNotifRQ> メッセージと <OTA_HotelAvailNotifRQ> メッセージの <RequestorID> 要素で指定されている ID 属性値に一致する必要があります。

宿泊施設のプロモーション。各プロモーションは 1 つの宿泊施設に適用されます。

<Stacking> を使用する場合を除き、複数のプロモーションが対象となる場合、割引が最大であるプロモーションが予約に適用されます。

指定する場合、値は "overlay" である必要があります。値が "overlay" の場合、現在のメッセージで指定されたプロモーションを保存する前に、保存されているすべてのプロモーションが削除されます。

指定しない場合、現在のメッセージで指定されている各プロモーションは次のいずれかになります。

• Added（保存済みプロモーションに同じ id が含まれない場合）
• Updated（保存済みプロモーションに同じ id がある場合）
• Deleted（保存済みプロモーションに同じ id があり、現在のメッセージで指定されているプロモーションの action 属性の値が "delete" である場合）

宿泊施設の 1 件のプロモーション。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（日曜日）

任意の文字の組み合わせが有効です。

有効な値の型は次のとおりです。

• Integer: チェックイン日までの日数。たとえば、値 30 は、プロモーションがチェックイン日の 30 日前以上の予約にのみ適用されることを示します。
• ISO 8601 の期間（日数、時間、分）: チェックイン日までの日数（オプションで時間/分）。たとえば、値 P30D は、プロモーションがチェックイン日の 30 日前以上の予約にのみ適用されることを示します。値 P30DT6H は、到着日の 30 日前の 18:00 までに予約する必要があることを示します。

有効な値の型は次のとおりです。

• Integer: チェックイン日までの日数。たとえば、値 30 は、プロモーションがチェックイン日の 30 日前までの予約にのみ適用されることを示します。
• ISO 8601 の期間（日数、時間、分）: チェックイン日までの日数（オプションで時間/分）。たとえば、値 P30D は、プロモーションがチェックイン日の 30 日前までの予約にのみ適用されることを示します。値 P30DT6H は、到着日の 30 日前の 18:00 以降に予約する必要があることを示します。

プロモーションを適用した後に料金に設定できる最大値に関する制限を定義します。

プロモーションでは常に <Discount> または <BestDailyDiscount> を指定する必要があります。そのため、<Ceiling> のみを適用するプロモーションを作成するには、percentage を 0 にして <Discount> を設定します。

重ね合わせが構成されている場合、<Ceiling> を含む複数のプロモーションが 1 回の滞在に適用されることがあります。各プロモーションの割引が適用され、その直後に上限が適用されます。次の例は、各上限がスタック内の次の昇進計算にどのように影響するかを示しています。

例:

AmountBeforeTax が 100 で、2 つのプロモーションがスタックされている 1 泊の料金:

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 を下回っているため、2 つ目の上限は適用されません。最終的なレートは 35 です。

60 が全体的な上限としてより厳しいという点は、その上限が独自のプロモーションにのみ有効であり、プロモーション スタック全体にまたがる単一の上限が存在しないため、無関係です。

割引を適用した後の宿泊料金の最大額。

<Floor> 要素も指定する場合は、<Floor> の amount_per_night 属性以上の値に設定する必要があります。

amount_per_night は、AmountAfterTax を使用して 1 泊あたりの料金に含まれる税金と手数料に適用されますが、TaxFeeInfo を使用して指定された税金と手数料には適用されません。

プロモーションを適用した後に料金に設定できる最小値に関する制限を定義します。

プロモーションでは常に <Discount> または <BestDailyDiscount> を指定する必要があります。そのため、<Floor> のみを適用するプロモーションを作成するには、percentage を 0 にして <Discount> を設定します。

無料宿泊に 100% 割引が適用されている場合でも、<FreeNights> 割引には <Floor> ロジックが適用されます。

重ね合わせが構成されている場合、<Floor> を含む複数のプロモーションが 1 回の滞在に適用されることがあります。各プロモーションの割引が適用され、その後すぐに最小価格が適用されます。次の例は、各階層がスタック内の次のプロモーション計算にどのように影響するかを示しています。

例:

AmountBeforeTax が 100 で、2 つのプロモーションがスタックされている 1 泊の料金:

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 の下限を超えているため、2 つ目の下限は適用されません。最終的なレートは 65 です。

90 が全体的な下限としてより厳しいという点は、そのプロモーションにのみ有効であり、プロモーション スタック全体にわたる単一の下限を設定できないため、無関係です。

割引が適用された後の宿泊料金の最小額。

<Ceiling> 要素も指定する場合は、<Ceiling> の amount_per_night 属性以下の値に設定する必要があります。

amount_per_night は、AmountAfterTax を使用して 1 泊あたりの料金に含まれる税金と手数料に適用されますが、TaxFeeInfo を使用して指定された税金と手数料には適用されません。

プロモーションを適用するためにチェックインが行われる必要があるタイミングを指定する期間。1 件以上のプロモーションを削除する場合、この要素は不要です。

YearlessDate 形式もサポートされています。

• start または end のいずれかが年指定なしの日付になっている場合、どちらの日付も年指定なしの日付として入力する必要があります。
• 年指定なしの期間は、新年をまたいで指定することはできません。代わりに、期間を 2 つの隣接する期間として表します。たとえば、{"12-29", "01-05"} は {"12-29", "12-31"} と {"01-01", "01-05"} で表すことができます。

期間で許可される曜日です。指定しないと、期間内のすべての曜日が許可されます。文字列の各文字で曜日を指定します。たとえば、「MTWHF」は、期間で平日を許可することを指定します。

有効な文字は次のとおりです。

• M（月曜日）
• T（火曜日）
• W（水曜日）
• H（木曜日）
• F（金曜日）
• S（土曜日）
• U（日曜日）

任意の文字の組み合わせが有効です。

プロモーションを適用するためにチェックアウトが行われる必要があるタイミングを指定する期間。1 件以上のプロモーションを削除する場合、この要素は不要です。

YearlessDate 形式もサポートされています。

• start または end のいずれかが年指定なしの日付になっている場合、どちらの日付も年指定なしの日付として入力する必要があります。
• 年指定なしの期間は、新年をまたいで指定することはできません。代わりに、期間を 2 つの隣接する期間として表します。たとえば、{"12-29", "01-05"} は {"12-29", "12-31"} と {"01-01", "01-05"} で表すことができます。

期間で許可される曜日です。指定しないと、期間内のすべての曜日が許可されます。文字列の各文字で曜日を指定します。たとえば、「MTWHF」は、期間で平日を許可することを指定します。

有効な文字は次のとおりです。

• M（月曜日）
• T（火曜日）
• W（水曜日）
• H（木曜日）
• F（金曜日）
• S（土曜日）
• U（日曜日）

任意の文字の組み合わせが有効です。

Discount または BestDailyDiscount のいずれか 1 つを指定する必要があります。

このプロモーションに適用する割引を指定します。

percentage、percentage_of_base、fixed_amount、fixed_amount_per_night、fixed_price、fixed_price_per_night のいずれか 1 つを指定する必要があります。

割引率を指定する 0 ～ 100 の 10 進値。これは AmountAfterTax に適用されます（AmountAfterTax が指定されていない場合は AmountBeforeTax に適用されます）。

例:

• AmountAfterTax が 100 で、percentage が 20 の場合:

  プロモーション料金 = AmountAfterTax x (1 - 割引率)

  80.00 = 100 x (1 - 0.2)

• AmountBeforeTax が 100 で、percentage が 20 で、TaxFeeInfo が税金 10 を指定する場合:

  プロモーション料金 = AmountBeforeTax x (1 - 割引率) + 税金

  90.00 = 100 x (1 - 0.2) + 10

percentage、percentage_of_base、fixed_amount、fixed_amount_per_night、fixed_price、fixed_price_per_night のいずれか 1 つを指定する必要があります。

基本割引の割合を指定する 0 ～ 100 の 10 進値。percentage と同様に、AmountAfterTax に適用されます（AmountAfterTax が指定されていない場合は AmountBeforeTax に適用されます）。

percentage とは異なり、この割引は、以前に適用されたプロモーションに関係なく、常に基本料金の割合として計算されます。

例:

• 100 円の 1 泊の宿泊に 2 つのプロモーションが順番に適用されるとします。1 つ目は通常の 10% の割引率で、2 つ目は基本割引の 10% の割引率です。両方のプロモーションで 10% の割引が適用されるため、割引後の料金は 80 になります。2 つ目のプロモーションが通常の割引率の場合、2 つ目のプロモーションで 90% の 10% が割引されるため、割引後の料金は 81 になります。

percentage、percentage_of_base、fixed_amount、fixed_amount_per_night、fixed_price、fixed_price_per_night のいずれか 1 つを指定する必要があります。

AmountAfterTax の宿泊料金の合計（または AmountAfterTax が指定されていない場合は AmountBeforeTax の宿泊料金の合計）から差し引かれる定額。宿泊料金と同じ通貨であるとみなされます。これが宿泊料金の合計より大きい場合、結果の値は 0 になります。

例:

• 1 泊の料金を計算する際に、AmountBeforeTax が 90、AmountAfterTax が 100、fixed_amount が 20 の場合:

  プロモーション料金 = AmountAfterTax - 固定割引

  80.00 = 100 - 20

• 1 泊の料金を計算する際に、AmountBeforeTax が 100、fixed_amount が 20、TaxFeeInfo で税率 8% を指定する場合:

  プロモーション料金 = (AmountBeforeTax - 固定割引) x (1 + 税率)

  86.40 = (100 - 20) x 1.08

• 1 泊の料金を計算する際に、AmountBeforeTax が 50、fixed_amount が 60、TaxFeeInfo で税金 10 を指定する場合:

  プロモーション料金 = (AmountBeforeTax - 固定割引) x 税金

  10.00 = 0 + 10

• 3 泊の料金を計算する際に、AmountAfterTax の値が 100、110、120 で、fixed_amount が 150 の場合:

  プロモーション料金 = sum(AmountAfterTax) - (固定割引)

  180.00 = (100 + 110 + 120) - 150

percentage、percentage_of_base、fixed_amount、fixed_amount_per_night、fixed_price、fixed_price_per_night のいずれか 1 つを指定する必要があります。

AmountAfterTax の各宿泊料金（applied_nights が指定されている場合は最も最安の N）に適用される固定割引。AmountAfterTax が指定されていない場合は、AmountBeforeTax に適用されます。宿泊料金と同じ通貨であるとみなされます。fixed_amount_per_night が 1 泊の料金を上回る場合、その 1 泊の料金は 0 に引き下げられます。割引により、1 泊の料金が負の値になることはありません。

例:

• 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 のいずれか 1 つを指定する必要があります。

1 泊の料金として AmountAfterTax が指定されている場合、税金と手数料を含む宿泊料金が指定された値に設定されます。AmountBeforeTax が指定されている場合、AmountAfterTax が指定されているかどうかにかかわらず、滞在の税抜き料金が指定された値に設定されます。宿泊料金と同じ通貨であるとみなされます。

AmountAfterTax が税率を反映するものである場合、AmountBeforeTax に固定価格を設定すると、税金と手数料が不正確になる可能性があります。通常は、TaxFeeInfo を使用して宿泊施設の税金と手数料を指定することを強くおすすめします。

例:

• 1 泊の料金を計算する際に、AmountBeforeTax が 90、AmountAfterTax が 100、fixed_price が 80 の場合、プロモーション料金は 80 です。
• 1 泊の料金を計算する際に、AmountBeforeTax が 100、fixed_amount が 80、TaxFeeInfo で税率 8% を指定する場合:

  プロモーション料金 = 固定価格 x (1 + 税率)

  86.40 = 80 x 1.08

• 3 泊の料金を計算する際に、AmountAfterTax の値が 100、110、120 で、fixed_amount が 300 の場合:

  promotion rate = 300

percentage、percentage_of_base、fixed_amount、fixed_amount_per_night、fixed_price、fixed_price_per_night のいずれか 1 つを指定する必要があります。

AmountAfterTax 1 泊あたりの料金が指定されている場合、宿泊の各泊の料金（税金と手数料を含む）が指定された値に設定されます。AmountBeforeTax が指定されている場合、AmountAfterTax が指定されているかどうかにかかわらず、宿泊 1 泊あたりの税抜き料金が指定された値に設定されます。宿泊料金と同じ通貨であるとみなされます。

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 の整数を指定する必要があります。指定しない場合、すべての宿泊に割引が適用されます。

割引を適用するために必要な宿泊日数。各割引は、宿泊日数の個別のセグメントに適用されます。

たとえば、stay_nights が 4 で（repeats が true）10 泊の宿泊の場合、1 泊目から 4 泊目と 5 泊目から 8 泊目の 2 つの宿泊日セグメントがあります。9 泊目と 10 泊目は宿泊日セグメントに含まれません。

割引を複数の宿泊日数セグメントに適用できるかどうか。false の場合、旅行プランの最初の宿泊日数のみが割引されます。true の場合、滞在日数の任意のセグメントが割引されます。

たとえば、stay_nights が 4 で、旅行プランが 10 泊の場合、repeats が true であれば 2 つのセグメント（1 ～ 4 泊目と 5 ～ 8 泊目）が割引されますが、repeats が false であれば 1 つのセグメント（1 ～ 4 泊目）のみが割引されます。

Discount または BestDailyDiscount のいずれか 1 つを指定する必要があります。

1 泊に適用できる 1 日あたりの割引を指定します。これは、滞在全体に割引を適用する Discount とは対照的です。

各プロパティには、「1 日あたりのベスト」と見なされるプロモーションのグループを 1 つ設定できます。つまり、宿泊する 1 泊ごとに、その夜に適用できる割引率が最も高い「1 日あたりの最適な」プロモーション 1 つが選択され、適用される可能性があります。

Stacking は BestDailyDiscount で指定できます。base または none に設定する必要があります。1 泊あたりの割引率が最も高い「1 泊あたりの最適な」割引が組み合わせられ、構成されたスタッキング タイプに従って 1 回の宿泊の割引（Discount）として扱われます。この組み合わせ割引は、他の対象となる <Discount> プロモーションと比較され、組み合わせて適用できます。これにより、最も割引率の高いプロモーションまたは組み合わせが見つかります。base のスタッキング タイプには、BestDailyDiscount の組み合わせまたは単一の Discount のいずれか（低い方の価格）が選択され、適用されます。

このタイプの割引で StayDates を指定できますが、application は overlap に設定する必要があります。

percentage、fixed_amount、fixed_price のいずれか 1 つのみが必要です。

割引率を指定する 0 ～ 100 の 10 進値。これは AmountAfterTax に適用されます（AmountAfterTax が指定されていない場合は AmountBeforeTax に適用されます）。

例:

• 1 泊の AmountAfterTax が 100、percentage が 20 の場合:

  プロモーション料金 = AmountAfterTax x (1 - 割引率)

  80.00 = 100 x (1 - 0.2)

• 1 泊の AmountBeforeTax が 100、percentage が 20、TaxFeeInfo が税金 10 を指定する場合:

  プロモーション料金 = AmountBeforeTax x (1 - 割引率) + 税金

  90.00 = 100 x (1 - 0.2) + 10

percentage、fixed_amount、fixed_price のいずれか 1 つのみが必要です。

1 泊あたりの AmountAfterTax の宿泊料金（または AmountAfterTax が指定されていない場合は AmountBeforeTax の宿泊料金）から差し引かれる定額。宿泊料金と同じ通貨であるとみなされます。これが宿泊料金の合計より大きい場合、結果の値は 0 になります。

例:

• 1 泊の AmountBeforeTax が 90、AmountAfterTax が 100、fixed_amount が 20 の場合:

  プロモーション料金 = AmountAfterTax - 固定割引

  80.00 = 100 - 20

• 1 泊の AmountBeforeTax が 100、fixed_amount が 20、TaxFeeInfo で税率 8% を指定する場合:

  プロモーション料金 = (AmountBeforeTax - 固定割引) x (1 + 税率)

  86.40 = (100 - 20) x 1.08

percentage、fixed_amount、fixed_price のいずれか 1 つのみが必要です。

AmountAfterTax 1 泊の料金が指定されている場合、宿泊 1 泊の料金（税金と手数料を含む）が指定された値に設定されます。AmountBeforeTax が指定されている場合、AmountAfterTax が指定されているかどうかにかかわらず、滞在の税抜き料金が指定された値に設定されます。宿泊料金と同じ通貨であるとみなされます。

例:

• 1 泊の AmountBeforeTax が 90、AmountAfterTax が 100、fixed_price が 80 の場合、プロモーション料金は 80 です。
• 1 泊の AmountBeforeTax が 100、fixed_amount が 80、TaxFeeInfo で税率 8% を指定する場合:

  プロモーション料金 = 固定価格 x (1 + 税率)

  86.40 = 80 x 1.08

関連する割引の特定の UI 処理をトリガーするメンバーシップ料金ルールのコンテナ。

<Discount> も指定しない限り、この要素は指定しないでください。

メンバーシップ プログラムに関連付けられている 料金ルールの ID。

この設定に応じて、1 つの料金に複数のプロモーションを適用できます。

• any: 他のすべてのプロモーション（none を除く）と組み合わせることができますが、プロモーションの適用順序は保証されません。
• base: 対象となる最適な base プロモーションが選択され、他のプロモーションよりも先に適用されます。以前は base_only という名前でした。
• second: 最適な対象 second プロモーションが選択され、base プロモーション（該当する場合）の後に、any プロモーションの前に適用されます。
• none: 他のプロモーションと組み合わせることはできません。

許可されている組み合わせの中で、割引が最大であるプロモーションのセットが料金に適用されます。

プロモーションの適用方法を記述します。

指定できる値は次のとおりです。

• all: 宿泊プランのすべての日付が滞在日と重複している場合、宿泊プランの 1 泊ごとにプロモーションを適用します。
• any: 宿泊プランの任意の日付が滞在日の範囲にある日付と重複している場合、宿泊プランのすべての宿泊にプロモーションを適用します。
• overlap: 滞在日の範囲にある日付と重複する宿泊プランの宿泊にのみプロモーションを適用します。

この属性は常に指定する必要があります。

• <Discount> で percentage が指定されていて、application が all または any に設定されている場合、割引は滞在日全体の割合として適用されます。
• <Discount> で percentage が指定されていて、application が overlap に設定されている場合、重複する宿泊に関して、宿泊料金の割合として割引が適用されます。
• fixed_amount を指定する <Discount> と、overlap に設定された application は、無効な組み合わせです。
• <FreeNights> はすべての application 値をサポートします。overlap の場合、割引の要件として考慮されるのは、重複する宿泊日数のみです。

プロモーションを適用する日付を指定する期間。

YearlessDate 形式もサポートされています。

• start または end のいずれかが年指定なしの日付になっている場合、どちらの日付も年指定なしの日付として入力する必要があります。
• 年指定なしの期間は、新年をまたいで指定することはできません。代わりに、期間を 2 つの隣接する期間として表します。たとえば、{"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 です。