프로모션

여러 계정의 피드를 제공하는 백엔드가 있는 경우 이 값은 동일한 계정의 <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>만 적용되는 프로모션을 만들려면 percentage이 0인 <Discount>를 설정하는 방법이 있습니다.

중복 적용이 구성된 경우 <Ceiling>가 있는 여러 프로모션이 단일 숙박에 적용될 수 있습니다. 각 프로모션에 할인이 적용되고 바로 할인 한도가 적용됩니다. 다음 예는 각 상한선이 스택의 다음 프로모션 계산에 기여하는 방식을 보여줍니다.

예:

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이라는 상한선보다 낮으므로 두 번째 상한선은 적용되지 않습니다. 최종 요율은 35입니다.

60이 더 엄격한 전체 상한선이라는 사실은 관련이 없습니다. 자체 프로모션에만 유효하며 전체 프로모션 스택에 걸쳐 단일 상한선이 있을 수 없기 때문입니다.

할인이 적용된 후 숙박 요금을 설정할 수 있는 최대 금액입니다.

<Floor> 요소도 지정된 경우 이 값은 <Floor>의 amount_per_night 속성보다 크거나 같은 값으로 설정해야 합니다.

amount_per_night는 AmountAfterTax를 사용하여 숙박 요금에 포함된 세금 및 수수료에 적용되지만 TaxFeeInfo를 사용하여 지정된 세금 및 수수료에는 적용되지 않습니다.

프로모션이 적용된 후 요금을 설정할 수 있는 최소값에 대한 제한을 정의합니다.

프로모션은 항상 <Discount> 또는 <BestDailyDiscount>를 지정해야 하므로 <Floor>만 적용되는 프로모션을 만들려면 percentage이 0인 <Discount>를 설정하는 방법이 있습니다.

무료 숙박에 100% 할인이 적용되더라도 <Floor> 로직은 <FreeNights> 할인에 계속 적용됩니다.

중복 적용이 구성된 경우 <Floor>가 있는 여러 프로모션이 단일 숙박에 적용될 수 있습니다. 각 프로모션은 할인을 적용한 후 즉시 가격 하한선을 적용합니다. 다음 예는 각 가격대가 스택의 다음 프로모션 계산에 기여하는 방식을 보여줍니다.

예:

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이라는 최솟값보다 높으므로 두 번째 최솟값은 적용되지 않습니다. 최종 비율은 65입니다.

90이 전체적으로 더 엄격한 하한선이라는 사실은 관련이 없습니다. 자체 프로모션에만 유효하며 전체 프로모션 스택에 걸쳐 단일 하한선을 설정할 수 없기 때문입니다.

할인이 적용된 후 1박 요금을 설정할 수 있는 최소 금액입니다.

<Ceiling> 요소도 지정된 경우 <Ceiling>의 amount_per_night 속성보다 작거나 같은 값으로 설정해야 합니다.

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, 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인 1박 숙박에 순차적으로 적용되는 프로모션이 2개 있다고 가정해 보겠습니다. 첫 번째는 일반 10% 할인율이고 두 번째는 기본 할인율의 10% 입니다. 그러면 두 프로모션 모두 10% 할인이 적용되므로 할인율은 80이 됩니다. 두 번째 프로모션도 일반 비율 할인인 경우 두 번째 프로모션에서 90의 10%를 할인하므로 할인율은 81이 됩니다.

percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price, fixed_price_per_night 중 하나만 필요합니다.

AmountAfterTax 숙박 요금의 합계 (또는 AmountAfterTax가 지정되지 않은 경우 AmountBeforeTax 숙박 요금의 합계)에서 공제할 고정 금액입니다. 1박 요금과 동일한 통화로 간주됩니다. 이 값이 숙박 요금의 합계보다 크면 결과 값은 0입니다.

예:

• AmountBeforeTax가 90, AmountAfterTax가 100, fixed_amount가 20인 1박 숙박 요금을 책정하는 경우

  프로모션 요율 = AmountAfterTax - 고정 할인

  80.00 = 100 - 20

• AmountBeforeTax이 100이고 fixed_amount이 20이며 TaxFeeInfo가 8%의 세금을 지정하는 1박 숙박 가격을 책정하는 경우

  프로모션 가격 = (AmountBeforeTax - 고정 할인) * (1 + 세율)

  86.40 = (100 - 20) * 1.08

• AmountBeforeTax가 50이고 fixed_amount가 60이며 TaxFeeInfo가 세금 10을 지정하는 1박 숙박 가격을 책정하는 경우

  프로모션 요율 = (AmountBeforeTax - 고정 할인) * 세금

  10.00 = 0 + 10

• AmountAfterTax 값이 100, 110, 120이고 fixed_amount이 150인 3박 숙박에 가격을 책정하는 경우

  프로모션 요율 = sum(AmountAfterTax) - (고정 할인)

  180.00 = (100 + 110 + 120) - 150

percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price, fixed_price_per_night 중 하나만 필요합니다.

각 AmountAfterTax 1박 요금 (또는 applied_nights가 지정된 경우 가장 저렴한 N)에 적용되는 고정 할인입니다. AmountAfterTax가 지정되지 않은 경우 AmountBeforeTax에 적용됩니다. 1박 요금과 동일한 통화로 간주됩니다. fixed_amount_per_night가 숙박 요금보다 크면 숙박 요금이 0으로 감소합니다. 할인으로 인해 숙박 요금이 음수가 될 수는 없습니다.

예:

• AmountAfterTax 값이 100, 110, 120이고 fixed_amount_per_night이 10인 3박 숙박에 가격을 책정하는 경우

  프로모션 비율 = sum(AmountBeforeTax - 고정 금액 할인)

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

• AmountAfterTax 값이 10, 50, 100이고 fixed_amount_per_night이 20인 3박 숙박에 가격을 책정하는 경우

  프로모션 비율 = 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 1박 요금이 지정되면 세금 및 수수료를 포함한 숙박 가격이 지정된 값으로 설정됩니다. AmountBeforeTax가 지정되면 AmountAfterTax가 지정되었는지 여부와 관계없이 숙박에 대한 세전 가격이 지정된 값으로 설정됩니다. 1박 요금과 동일한 통화로 간주됩니다.

AmountAfterTax가 세율을 반영하기 위한 것이라면 AmountBeforeTax에 고정 가격을 설정하면 세금과 수수료가 부정확해질 수 있습니다. 일반적으로 TaxFeeInfo를 사용하여 숙박 시설의 세금 및 수수료를 지정하는 것이 좋습니다.

예:

• 1박 숙박 요금을 책정할 때 AmountBeforeTax가 90, AmountAfterTax가 100, fixed_price가 80이면 프로모션 요금은 80입니다.
• AmountBeforeTax이 100이고 fixed_amount이 80이며 TaxFeeInfo에서 세금을 8%로 지정하는 1박 숙박 가격을 책정하는 경우

  프로모션 가격 = 고정 가격 * (1 + 세율)

  86.40 = 80 * 1.08

• AmountAfterTax 값이 100, 110, 120이고 fixed_amount이 300인 3박 숙박에 가격을 책정하는 경우

  프로모션 비율 = 300

percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price, fixed_price_per_night 중 하나만 필요합니다.

AmountAfterTax 1박 요금이 지정되면 세금 및 수수료를 포함한 숙박 일별 가격이 지정된 값으로 설정됩니다. AmountBeforeTax가 지정되면 AmountAfterTax가 지정되었는지 여부와 관계없이 숙박 일수별 세전 가격이 지정된 값으로 설정됩니다. 1박 요금과 동일한 통화로 간주됩니다.

AmountAfterTax가 세율을 반영하기 위한 것이라면 AmountBeforeTax에 고정 가격을 설정하면 세금과 수수료가 부정확해질 수 있습니다. 일반적으로 TaxFeeInfo를 사용하여 숙박 시설의 세금 및 수수료를 지정하는 것이 좋습니다.

applied_nights가 지정되면 가장 저렴한 N박에 새 가격이 적용됩니다.

예:

• AmountBeforeTax 값이 90, 90이고, AmountAfterTax 값이 100, 100이며, fixed_price가 80인 2박 숙박 요금을 책정하는 경우 프로모션 요금은 80 + 80 = 160입니다.
• AmountBeforeTax가 100, 100이고 fixed_amount가 80이며 TaxFeeInfo가 8%의 세금을 지정하는 2박 숙박 요금을 책정하는 경우 프로모션 요율은 (80 + 80) * 1.08 = 172.8입니다.
• AmountAfterTax 값이 100, 110, 120이고 fixed_amount이 110인 3박 숙박에 가격을 책정하는 경우 프로모션 요율은 110 * 3 = 330입니다.

percentage 또는 fixed_amount_per_night와 함께만 사용해야 합니다.

할인이 적용되는 숙박 일수로, 가장 저렴한 숙박부터 시작됩니다. 1~99 사이의 정수여야 합니다. 지정하지 않으면 모든 숙박에 할인이 적용됩니다.

할인을 적용하기 위해 필요한 숙박 일수입니다. 각 할인은 숙박 일수의 별도 세그먼트에 적용됩니다.

예를 들어 stay_nights이 4이고 (repeats는 true) 숙박 일수가 10인 경우 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 중 정확히 하나만 지정해야 합니다.

숙박 1박에 적용할 수 있는 일일 할인을 지정합니다. 이는 전체 숙박에 할인을 적용하는 Discount와는 대조적입니다.

각 숙박 시설에는 '최고의 일일'로 간주되는 프로모션 그룹이 하나 있을 수 있습니다. 즉, 숙박하는 밤마다 요건을 충족하고 해당 밤에 가장 큰 할인을 제공하는 단일 '최고의 일일' 프로모션이 선택되어 적용될 수 있습니다.

Stacking은 BestDailyDiscount로 지정할 수 있습니다. base 또는 none로 설정해야 합니다. 각 밤에 가장 큰 할인을 제공하는 '최고의 일일' 할인이 결합되어 구성된 중복 적용 유형을 따르면서 단일 숙박 할인 (예: Discount)으로 취급됩니다. 이 결합 할인은 요건을 충족하는 다른 <Discount> 프로모션과 비교되며, 이를 통해 가장 큰 할인을 제공하는 프로모션 또는 조합을 찾을 수 있습니다. BestDailyDiscount 조합 또는 단일 Discount 중 더 낮은 가격을 산출하는 값이 선택되어 base 스택 유형에 적용됩니다.

이 유형의 할인으로 StayDates를 지정할 수 있지만 application는 overlap로 설정해야 합니다.

percentage, fixed_amount 또는 fixed_price 중 하나만 필요합니다.

할인율을 지정하는 0~100 사이의 십진수 값입니다. AmountAfterTax (또는 AmountAfterTax가 지정되지 않은 경우 AmountBeforeTax)에 적용됩니다.

예:

• 1박 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 1박 요금 (또는 AmountAfterTax가 지정되지 않은 경우 AmountBeforeTax 1박 요금)에서 공제할 고정 금액입니다. 1박 요금과 동일한 통화로 간주됩니다. 이 값이 숙박 요금의 합계보다 크면 결과 값은 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

percentage, fixed_amount 또는 fixed_price 중 하나만 필요합니다.

AmountAfterTax 1박 요금이 지정되면 세금 및 수수료를 포함한 숙박 일수의 가격을 지정된 값으로 설정합니다. AmountBeforeTax가 지정되면 AmountAfterTax가 지정되었는지 여부와 관계없이 숙박에 대한 세전 가격이 지정된 값으로 설정됩니다. 1박 요금과 동일한 통화로 간주됩니다.

예:

• 1박에 대한 AmountBeforeTax가 90이고 AmountAfterTax가 100, fixed_price가 80이면 프로모션 요금은 80입니다.
• 1박에 대한 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: 숙박 일정의 모든 날짜가 숙박 기간과 겹치는 경우 숙박 일정의 1박당에 프로모션을 적용합니다.
• any: 숙박 일정의 날짜가 숙박 기간과 겹치는 경우 숙박 일정의 모든 숙박 일수에 프로모션이 적용됩니다.
• overlap: 숙박 기간과 겹치는 숙박 일정의 밤에만 프로모션이 적용됩니다.

이 속성은 항상 지정되어야 합니다.

• <Discount>이 percentage를 지정하고 application가 all 또는 any로 설정된 경우 할인이 전체 숙박의 비율로 적용됩니다.
• <Discount>가 percentage을 지정하고 application가 overlap로 설정된 경우 할인은 중복된 밤의 1박 요금에 대한 비율로 적용됩니다.
• <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입니다.