프로모션

개요

이 API를 사용하면 가능한 할인을 지정할 수 있습니다. 지정된 프로모션 중에서 Google은 가장 낮은 가격으로 이어지는 적격 프로모션 또는 프로모션 집합을 적용합니다. 조건이 충족될 때 가격을 높이거나 낮출 수 있는 임의의 요금 조정을 지원하는 API를 찾고 있다면 Rate Modifications API를 이용해 보세요. 두 API가 모두 있는 경우 요금 수정이 프로모션 전에 적용됩니다.

요청

문법

Promotions 메시지는 다음 구문을 사용합니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner= "partner_key"
            id="message_ID"
            timestamp="timestamp">
  <HotelPromotions hotel_id="HotelID" action="[overlay]">
    <Promotion id="PromotionID" action="[delete]">
      <BookingDates>
        <DateRange start="YYYY-MM-DD[THH:mm:ss]" end="YYYY-MM-DD[THH:mm:ss]"
          days_of_week="MTWHFSU_or_subset"/>
        <DateRange start="YYYY-MM-DD[THH:mm:ss]" end="YYYY-MM-DD[THH:mm:ss]"
          days_of_week="MTWHFSU_or_subset"/>
      </BookingDates>
      <BookingWindow min="integer_or_duration" max="integer_or_duration"/>
      <Ceiling amount_per_night="float"/>
      <Floor amount_per_night="float"/>
      <CheckinDates>
        <DateRange start="[YYYY-]MM-DD" end="[YYYY-]MM-DD" days_of_week="MTWHFSU_or_subset"/>
      </CheckinDates>
      <CheckoutDates>
        <DateRange start="[YYYY-]MM-DD" end="[YYYY-]MM-DD" days_of_week="MTWHFSU_or_subset"/>
      </CheckoutDates>
      <!-- Specify only one of percentage, fixed_amount, fixed_amount_per_night,
           fixed_price, or fixed_price_per_night; applied_nights is only used
           with percentage, fixed_amount_per_night, and fixed_price_per_night. -->
      <Discount percentage="float" fixed_amount="float" fixed_amount_per_night="float"
                fixed_price="float" fixed_price_per_night="float"
                applied_nights="integer_1_to_99" rank="integer_1_to_99">
        <!-- FreeNights may not be used in conjunction with attributes on Discount -->
        <FreeNights stay_nights="integer" discount_nights="integer"
                    discount_percentage="float" night_selection="[cheapest|last]"
                    repeats="boolean"/>
      </Discount>
      <!-- Exactly one of Discount or BestDailyDiscount must be specified.
           Specify only one of percentage, fixed_amount, or fixed_price. -->
      <BestDailyDiscount percentage="float" fixed_amount="float" fixed_price="float"/>
      <Devices>
        <Device type="[desktop|tablet|mobile]"/>
      </Devices>
      <InventoryCount min="integer" max="integer"/>
      <LengthOfStay min="integer" max="integer"/>
      <MembershipRateRule id="RateRuleID"/>
      <MinimumAmount before_discount="integer"/>
      <Occupancy min="integer" max="integer"/>
      <RatePlans>
        <RatePlan id="PackageID_1"/>
        <RatePlan id="PackageID_2"/>
      </RatePlans>
      <RoomTypes>
        <RoomType id="RoomID_1"/>
        <RoomType id="RoomID_2"/>
      </RoomTypes>
      <Stacking type="[any|base|none|second]"/>
      <StayDates application="[all|any|overlap]">
        <DateRange start="[YYYY-]MM-DD" end="[YYYY-]MM-DD" days_of_week="MTWHFSU_or_subset"/>
      </StayDates>
      <UserCountries type="[include|exclude]">
        <Country code="country_code"/>
      </UserCountries>
    </Promotion>
  </HotelPromotions>
</Promotions>

요소 및 속성

프로모션 메시지에는 다음과 같은 요소와 속성이 있습니다.

요소 / @Attribute 발생 횟수 유형 설명
Promotions 1 Complex element 프로모션 메시지의 루트 요소입니다.
Promotions / @partner 1 string 이 메시지의 파트너 계정입니다. 이 문자열 값은 Hotel Center의 계정 설정 페이지에 나열된 '파트너 키' 값입니다.

여러 계정에 피드를 제공하는 백엔드가 있는 경우 이 값은 동일한 계정의 <OTA_HotelRateAmountNotifRQ><OTA_HotelAvailNotifRQ> 메시지의 <RequestorID> 요소에 지정된 ID 속성 값과 일치해야 합니다.

Promotions / @id 1 string 이 요청 메시지의 고유 식별자입니다. 이 값은 응답 메시지에 반환됩니다. 허용되는 문자는 a~z, A~Z, 0~9, _(밑줄), - (대시)입니다.
Promotions / @timestamp 1 DateTime 이 메시지를 작성한 날짜 및 시간입니다.
Promotions / HotelPromotions 0..n HotelPromotions

숙박 시설 프로모션 각 프로모션은 숙박 시설 1개에 적용됩니다.

<Stacking>을 사용하지 않으면 여러 프로모션을 사용할 수 있는 경우 가장 큰 할인이 적용된 프로모션이 예약에 적용됩니다.

Promotions / HotelPromotions / @hotel_id 1 string 숙박 시설의 고유 식별자입니다. 이 값은 호텔 목록 피드의 <listing> 요소에서 <id>를 사용하여 지정된 호텔 ID와 일치해야 합니다. 호텔 ID는 Hotel Center에도 표시됩니다.
Promotions / HotelPromotions / @action 0..1 enum

지정된 경우 값은 "overlay"여야 합니다. 값이 "overlay"이면 현재 메시지에 지정된 프로모션을 저장하기 전에 저장된 모든 프로모션이 삭제됩니다.

지정하지 않으면 현재 메시지에 지정된 각 프로모션은 다음 중 하나입니다.

  • Added (저장된 프로모션 중 id이 동일한 프로모션이 없는 경우)
  • Updated (저장된 프로모션에 동일한 id이 있는 경우)
  • Deleted (저장된 프로모션에 동일한 id이 있고 현재 메시지에 지정된 프로모션의 action 속성 값이 "delete"인 경우)
Promotions / HotelPromotions / Promotion 0..99 Promotion

숙박 시설에 대한 단일 프로모션입니다. action="overlay"<Promotion>를 지정하지 않으면 속성의 모든 프로모션이 삭제됩니다.

99개가 넘는 프로모션을 사용해야 하는 경우 기술계정 관리자 (TAM)에게 문의하세요.

Promotions / HotelPromotions / Promotion / @id 1 string 프로모션의 고유 식별자입니다. 최대 40자(영문 기준)까지 허용됩니다. 허용되는 문자는 a~z, A~Z, 0~9, _ (밑줄), - (대시), 입니다 . (마침표)를 누릅니다.
Promotions /HotelPromotions / Promotion / @action 0..1 enum

지정된 경우 값은 delete여야 합니다. 지정하지 않고 id가 동일한 프로모션이 저장되지 않으면 이 프로모션이 저장됩니다. 지정하지 않고 id가 동일한 프로모션이 저장되면 기존 프로모션이 업데이트됩니다.

delete가 지정되면 id가 동일한 저장된 프로모션이 삭제됩니다. delete를 사용할 때는 <Promotion>에 하위 요소를 포함하지 마세요. 또한 delete<HotelPromotions action="overlay"/>와 함께 사용할 수 없습니다.

Promotions / HotelPromotions / Promotion / BookingDates 0..1 BookingDates 프로모션을 적용하려면 예약이 발생하는 시점을 정의하는 하나 이상의 범위에 대한 컨테이너가 있어야 합니다.
Promotions / HotelPromotions / Promotion / BookingDates / DateRange 1..99 DateRange 프로모션을 적용하려면 예약이 발생해야 하는 시점을 지정하는 범위입니다.
Promotions / HotelPromotions / Promotion / BookingDates / DateRange / @start 0..1 Date 또는 DateTime

범위의 시작 날짜 또는 날짜/시간 (속성 시간대 기준)입니다.

  • start로 지정된 날짜 또는 일시는 end로 지정된 날짜 또는 그 이전이거나 그와 동일해야 합니다.
  • start을 지정하지 않으면 범위가 시작 시간 측면에서 사실상 무제한입니다.
  • start이 날짜 'YYYY-MM-DD'로 채워지면 'YYYY-MM-DDT00:00:00' 날짜/시간으로 해석됩니다.
Promotions / HotelPromotions / Promotion / BookingDates / DateRange / @end 0..1 Date 또는 DateTime

범위의 종료 날짜 또는 날짜/시간 (속성 시간대 기준)입니다.

  • end로 지정된 날짜 또는 날짜/시간은 start에서 지정된 날짜 또는 그 이후여야 합니다.
  • end를 지정하지 않으면 종료 시간 범위가 사실상 무제한입니다.
  • end가 날짜 'YYYY-MM-DD'로 제공되면 날짜/시간 'YYYY-MM-DDT23:59:59'로 해석됩니다.
Promotions / HotelPromotions / Promotion / BookingDates / DateRange / @days_of_week 0..1 string

기간에 허용되는 요일입니다. 지정하지 않으면 기간에 모든 요일이 허용됩니다. 문자열의 각 문자는 날짜를 지정합니다. 예를 들어 'MTWHF'는 기간에서 평일이 허용되도록 지정합니다.

유효한 문자는 다음과 같습니다.

  • 월요일 M
  • 화요일의 경우 T
  • 수요일의 경우 W
  • 목요일의 경우 H
  • 금요일의 경우 F
  • 토요일의 경우 S
  • 일요일의 경우 U

모든 문자 조합을 사용할 수 있습니다.

Promotions / HotelPromotions / Promotion / BookingWindow 0..1 BookingWindow 체크인 날짜를 기준으로 예약이 이루어져야 하는 기간을 숙박 시설의 시간대를 기준으로 지정합니다. 예를 들어 예약 기간은 체크인 전 최소 7일에서 180일 이하로 설정할 수 있습니다.
Promotions / HotelPromotions / Promotion / BookingWindow / @min 0..1 integer or duration 프로모션을 적용하려면 예약 시 체크인 전 최소 기간이 발생해야 합니다. 지정되지 않거나 값이 0이면 최솟값이 없습니다.

유효한 값 유형은 다음과 같습니다.

  • 정수: 체크인 날짜 전의 일 수입니다. 예를 들어 값 30은 체크인 날짜 최소 30일 전의 예약에만 프로모션이 적용됨을 나타냅니다.
  • ISO 8601 기간 (일, 시간, 분): 체크인 날짜 전 일수 (선택사항으로 시간/분)입니다. 예를 들어 값 P30D은 체크인 날짜 최소 30일 전의 예약에만 프로모션이 적용됨을 나타냅니다. 값이 P30DT6H이면 도착 30일 전 18:00 또는 그 이전에 예약해야 합니다.
Promotions / HotelPromotions / Promotion / BookingWindow / @max 0..1 integer or duration 프로모션이 적용되려면 예약 시 체크인 전 최대 기간(일)이 발생해야 합니다. 지정되지 않거나 값이 0이면 최댓값이 없습니다.

유효한 값 유형은 다음과 같습니다.

  • 정수: 체크인 날짜 전의 일 수입니다. 예를 들어 값 30은 체크인 날짜 최대 30일 전의 예약에만 프로모션이 적용됨을 나타냅니다.
  • ISO 8601 기간 (일, 시간, 분): 체크인 날짜 전 일수 (선택사항으로 시간/분)입니다. 예를 들어 값 P30D은 체크인 날짜 최대 30일 전의 예약에만 프로모션이 적용됨을 나타냅니다. 값이 P30DT6H이면 도착 30일 전 18:00 이후에 예약해야 합니다.
Promotions / HotelPromotions / Promotion / Ceiling 0..1 Ceiling

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

프로모션은 항상 <Discount> 또는 <BestDailyDiscount>를 지정해야 하므로 <Ceiling>만 적용하는 프로모션을 만들려면 한 가지 옵션은 percentage0로 설정하여 <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이 전체 상한선이 더 엄격하다는 사실은 자체 프로모션에만 유효하고 전체 프로모션 스택을 포괄하는 단일 상한이 있을 수 없으므로 관련이 없습니다.

Promotions / HotelPromotions / Promotion / Ceiling / @amount_per_night 1 float

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

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

amount_per_night은(는) AmountAfterTax을(를) 사용하는 1박 요금에 포함된 경우 세금 및 수수료에 적용되지만 TaxFeeInfo를 사용하여 지정된 요금에는 적용되지 않습니다.

Promotions / HotelPromotions / Promotion / Floor 0..1 Floor

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

프로모션은 항상 <Discount> 또는 <BestDailyDiscount>를 지정해야 하므로 <Floor>만 적용하는 프로모션을 만들려면 한 가지 옵션은 percentage0로 설정하여 <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의 하한선을 초과하므로 2층이 적용되지 않습니다. 최종 비율은 65입니다.

90이 전체 하한선이 더 엄격하다는 사실은 관련이 없습니다. 자체 프로모션에만 유효하고 전체 프로모션 스택을 포괄하는 단일 하한선은 없기 때문입니다.

Promotions / HotelPromotions / Promotion / Floor / @amount_per_night 1 float

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

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

amount_per_night은(는) AmountAfterTax을(를) 사용하는 1박 요금에 포함된 경우 세금 및 수수료에 적용되지만 TaxFeeInfo를 사용하여 지정된 요금에는 적용되지 않습니다.

Promotions / HotelPromotions / Promotion / CheckinDates 0..1 CheckinDates 프로모션을 적용하려면 체크인이 발생해야 하는 시간을 정의하는 하나 이상의 기간에 대한 컨테이너입니다.
Promotions / HotelPromotions / Promotion / CheckinDates / DateRange 1..20 DateRange

프로모션을 적용하려면 체크인이 발생해야 하는 시간을 지정하는 기간입니다. 하나 이상의 프로모션을 삭제하는 경우 이 요소가 필요하지 않습니다.

YearlessDate 형식도 지원됩니다.

  • start 또는 end 중 하나가 연도가 없는 날짜인 경우 둘 다 연도가 없는 날짜로 채워져야 합니다.
  • 연도가 없는 기간은 새해를 둘러싸지 않아야 합니다. 대신, 두 개의 인접한 기간으로 기간을 나타냅니다. 예를 들어 {"12-29", "01-05"}{"12-29", "12-31"}{"01-01", "01-05"}로 표시할 수 있습니다.
Promotions / HotelPromotions / Promotion / CheckinDates / DateRange / @start 0..1 Date or YearlessDate 기간의 시작 날짜 (속성 시간대를 기준으로 함)입니다. 이 날짜는 end 날짜 이전이거나 동일하거나 같아야 합니다. start을 지정하지 않으면 시작일과 관련하여 기간이 제한이 없습니다.
Promotions / HotelPromotions / Promotion / CheckinDates / DateRange / @end 0..1 Date or YearlessDate 기간의 종료일 (속성 시간대를 기준으로 함)입니다. 이 날짜는 start 날짜와 같거나 그 이후여야 합니다. end를 지정하지 않으면 종료일이 사실상 무제한입니다.
Promotions / HotelPromotions / Promotion / CheckinDates / DateRange / @days_of_week 0..1 string

기간에 허용되는 요일입니다. 지정하지 않으면 기간에 모든 요일이 허용됩니다. 문자열의 각 문자는 날짜를 지정합니다. 예를 들어 'MTWHF'는 기간에서 평일이 허용되도록 지정합니다.

유효한 문자는 다음과 같습니다.

  • 월요일 M
  • 화요일의 경우 T
  • 수요일의 경우 W
  • 목요일의 경우 H
  • 금요일의 경우 F
  • 토요일의 경우 S
  • 일요일의 경우 U

모든 문자 조합을 사용할 수 있습니다.

Promotions / HotelPromotions / Promotion / CheckoutDates 0..1 CheckoutDates 프로모션을 적용하려면 체크아웃이 발생해야 하는 시기를 정의하는 하나 이상의 기간에 대한 컨테이너입니다.
Promotions / HotelPromotions / Promotion / CheckoutDates / DateRange 1..20 DateRange

프로모션을 적용하려면 체크아웃이 시작되어야 하는 시기를 지정하는 기간입니다. 하나 이상의 프로모션을 삭제하는 경우 이 요소가 필요하지 않습니다.

YearlessDate 형식도 지원됩니다.

  • start 또는 end 중 하나가 연도가 없는 날짜인 경우 둘 다 연도가 없는 날짜로 채워져야 합니다.
  • 연도가 없는 기간은 새해를 둘러싸지 않아야 합니다. 대신, 두 개의 인접한 기간으로 기간을 나타냅니다. 예를 들어 {"12-29", "01-05"}{"12-29", "12-31"}{"01-01", "01-05"}로 표시할 수 있습니다.
Promotions / HotelPromotions / Promotion / CheckoutDates / DateRange / @start 0..1 Date or YearlessDate 기간의 시작 날짜 (속성 시간대를 기준으로 함)입니다. 이 날짜는 end 날짜 이전이거나 동일하거나 같아야 합니다. start을 지정하지 않으면 시작일과 관련하여 기간이 제한이 없습니다.
Promotions / HotelPromotions / Promotion / CheckoutDates / DateRange / @end 0..1 Date or YearlessDate 기간의 종료일 (속성 시간대를 기준으로 함)입니다. 이 날짜는 start 날짜와 같거나 그 이후여야 합니다. end를 지정하지 않으면 종료일이 사실상 무제한입니다.
Promotions / HotelPromotions / Promotion / CheckoutDates / DateRange / @days_of_week 0..1 string

기간에 허용되는 요일입니다. 지정하지 않으면 기간에 모든 요일이 허용됩니다. 문자열의 각 문자는 날짜를 지정합니다. 예를 들어 'MTWHF'는 기간에서 평일이 허용되도록 지정합니다.

유효한 문자는 다음과 같습니다.

  • 월요일 M
  • 화요일의 경우 T
  • 수요일의 경우 W
  • 목요일의 경우 H
  • 금요일의 경우 F
  • 토요일의 경우 S
  • 일요일의 경우 U

모든 문자 조합을 사용할 수 있습니다.

Promotions / HotelPromotions / Promotion / Devices 0..1 Devices 프로모션 대상인 사용자 기기를 나열하기 위한 컨테이너입니다. 지정하면 나열된 기기에서 자격 요건을 충족하는 사용자에게만 할인 혜택이 제공됩니다. 지정하지 않으면 모든 기기에서 자격을 갖춘 사용자에게 할인율이 적용됩니다.
Promotions / HotelPromotions / Promotion / Devices / Device 1..3 Device 프로모션을 이용할 수 있는 사용자 기기 유형 중 하나를 정의합니다.
Promotions / HotelPromotions / Promotion / Devices / Device / @type 1 enum 기기 유형입니다. 값은 desktop, tablet 또는 mobile여야 합니다.
Promotions / HotelPromotions / Promotion / Discount 1 Discount

Discount 또는 BestDailyDiscount 중 정확히 하나를 지정해야 합니다.

이 프로모션에 적용할 할인을 지정합니다.

Promotions / HotelPromotions / Promotion / Discount / @percentage 0..1 float

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

Promotions / HotelPromotions / Promotion / Discount / @fixed_amount 0..1 float

percentage, fixed_amount, fixed_amount_per_night, fixed_price, fixed_price_per_night 중 정확히 하나가 필요합니다.

AmountAfterTax 1박 요금의 합계 (또는 AmountAfterTax를 지정하지 않은 경우 AmountBeforeTax 1박 요금의 합계)에서 뺄 고정 금액입니다. 야간 요금과 동일한 통화로 간주됩니다. 이 값이 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박 숙박에 대한 가격을 책정하는 경우

    프로모션 요금 = 합계(AmountAfterTax) - (고정 할인)

    180.00 = (100 + 110 + 120) - 150

Promotions / HotelPromotions / Promotion / Discount / @fixed_amount_per_night 0..1 float

percentage, fixed_amount, fixed_amount_per_night, fixed_price, fixed_price_per_night 중 정확히 하나가 필요합니다.

AmountAfterTax박 요금 (또는 applied_nights가 지정된 경우 가장 저렴한 N)에 적용되는 고정 할인입니다. AmountAfterTax를 지정하지 않으면 AmountBeforeTax에 적용됩니다. 야간 요금과 동일한 통화로 간주됩니다. fixed_amount_per_night이 1박 요금보다 큰 경우에는 1박 요금이 0으로 줄어듭니다. 할인으로 인해 1박 요금이 음수가 될 수는 없습니다.

예를 들면 다음과 같습니다.

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

    프로모션 요금 = 합계(AmountBeforeTax - 고정 금액 할인)

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

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

    프로모션 요금 = 합계(AmountAfterTax - 고정 금액 할인)

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

Promotions / HotelPromotions / Promotion / Discount / @fixed_price 0..1 float

percentage, fixed_amount, fixed_amount_per_night, fixed_price, fixed_price_per_night 중 정확히 하나가 필요합니다.

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

AmountAfterTax에 세금 비율을 반영하려는 경우 AmountBeforeTax에 고정 가격을 설정하면 세금 및 수수료가 부정확해질 수 있습니다. 일반적으로 TaxFeeInfo를 사용하여 속성의 세금 및 수수료를 지정하는 것이 좋습니다.

예를 들면 다음과 같습니다.

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

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

    86.40 = 80 * 1.08

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

    프로모션 비율 = 300

Promotions / HotelPromotions / Promotion / Discount / @fixed_price_per_night 0..1 float

percentage, fixed_amount, fixed_amount_per_night, fixed_price, fixed_price_per_night 중 정확히 하나가 필요합니다.

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

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입니다.
Promotions / HotelPromotions / Promotion / Discount / @applied_nights 0..1 integer

percentage 또는 fixed_amount_per_night에서만 사용해야 합니다.

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

Promotions / HotelPromotions / Promotion / Discount / FreeNights 0..1 FreeNights 최소 숙박 기간이 충족되면 특정 숙박 일수에 대한 할인을 지정합니다. 이 요소를 사용하는 경우 상위 Discount 요소의 속성이 허용되지 않습니다.
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @stay_nights 1 integer

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

예를 들어 stay_nights이 4이고 (repeats가 true인) 10박 숙박의 경우 1~4일 밤과 5~8일 밤의 숙박 기간 세그먼트가 2개 있습니다. 9일과 10일 밤은 숙박 일수 세그먼트에 포함되지 않습니다.

Promotions / HotelPromotions / Promotion / Discount / FreeNights / @discount_nights 1 integer 숙박 일수의 각 세그먼트 내에서 할인된 숙박 일수입니다.
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @discount_percentage 1 float 할인 숙박 일수에 적용되는 할인입니다. 이 값이 50인 경우 선택한 각 숙박 기간은 50% 할인됩니다.
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @night_selection 1 string cheapest 또는 last여야 합니다. last인 경우 숙박 일수 세그먼트가 끝나는 숙박 일수에 대한 요금이 할인됩니다. cheapest인 경우 숙박 기간 중 가장 저렴한 숙박 일수가 할인됩니다.
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @repeats 1 boolean

여러 숙박 기간에 할인을 적용할 수 있는지 여부입니다. false인 경우 숙박 일정 시작 시 숙박 일수의 세그먼트만 할인됩니다. true인 경우 숙박일 기준의 모든 세그먼트에 할인이 적용됩니다.

예를 들어 stay_nights이 4이고 운항 일정이 10박이면 repeatstrue이면 세그먼트 2개가 할인됩니다 (1~4박, 5~8박). 그러나 repeatsfalse이면 세그먼트 1개만 할인됩니다 (1~4박).

Promotions / HotelPromotions / Promotion / Discount / @rank 0..1 integer 이 프로모션에 순위를 할당하고 순위가 가장 낮은 프로모션만 적용되도록 순위 선정을 선택합니다. 값은 1 이상 99 이하여야 합니다. 여러 프로모션이 동일한 순위를 공유하는 경우 하나가 임의로 선택되고 적용됩니다.
Promotions / HotelPromotions / Promotion / BestDailyDiscount 1 Discount

Discount 또는 BestDailyDiscount 중 정확히 하나를 지정해야 합니다.

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

각 숙박 시설에는 '매일 최고의 상품'으로 간주되는 단일 프로모션 그룹이 있을 수 있습니다. 즉, 각 숙박일별로 요건을 충족하며 해당 숙박에 대한 가장 큰 할인을 제공하는 단일 '최고의 일일' 프로모션이 선택되며 적용할 수 있습니다.

StackingBestDailyDiscount로 지정할 수 없습니다. 각 1박에 대해 가장 큰 할인을 제공하는 '최고의 일일' 할인이 결합되어 스택 유형이 base로 설정된 단일 숙박 할인 (예: Discount)으로 처리됩니다. 이 결합된 할인은 요건을 충족하는 다른 <Discount> 프로모션과 비교하거나 이 프로모션과 겹쳐서 가장 큰 할인을 제공하는 하나 또는 조합을 찾을 수 있습니다. BestDailyDiscount의 조합 또는 단일 Discount의 조합(둘 중 더 낮은 가격이 산출되는 항목)이 선택되고 base 스태킹 유형에 적용됩니다.

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

.
Promotions / HotelPromotions / Promotion / BestDailyDiscount / @percentage 0..1 float

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

Promotions / HotelPromotions / Promotion/ BestDailyDiscount / @fixed_amount 0..1 float

percentage, fixed_amount, fixed_price 중 정확히 하나가 필요합니다.

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

Promotions / HotelPromotions / Promotion/ BestDailyDiscount / @fixed_price 0..1 float

percentage, fixed_amount, fixed_price 중 정확히 하나가 필요합니다.

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

예를 들면 다음과 같습니다.

  • 하룻밤의 AmountBeforeTax가 90이고, AmountAfterTax이 100, fixed_price이 80이면 프로모션 비율은 80입니다.
  • 하룻밤의 AmountBeforeTax가 100이고 fixed_amount가 80이며 TaxFeeInfo가 8%의 세금을 지정하는 경우

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

    86.40 = 80 * 1.08

Promotions / HotelPromotions / Promotion / InventoryCount 0..1 InventoryCount 이 프로모션을 적용하기 위해 사용할 수 있어야 하는 객실 수에 관한 제한을 정의합니다. 제약조건을 충족하는 숙박일에만 할인이 적용됩니다. fixed_amount 할인과 함께 허용되지 않습니다. 사용 가능한 객실 수는 OTA_HotelInvCountNotifRQ (InvCount) 또는 OTA_HotelAvailNotifRQ(BookingLimit)로 지정됩니다.
Promotions / HotelPromotions / Promotion / InventoryCount / @min 0..1 integer 프로모션을 1박 요금에 적용하기 위해 사용할 수 있어야 하는 최소 객실 수입니다. 지정되지 않으면 최솟값이 없습니다.
Promotions / HotelPromotions / Promotion / InventoryCount / @max 0..1 integer 프로모션을 1박 요금에 적용하기 위해 사용할 수 있어야 하는 최대 객실 수입니다. 지정되지 않으면 최댓값이 없습니다.
Promotions / HotelPromotions / Promotion / LengthOfStay 0..1 LengthOfStay 이 프로모션을 적용할 수 있는 숙박 기간 한도를 정의합니다. 숙박 기간이 최소 및 최대 한도를 벗어나면 프로모션이 적용되지 않습니다.
Promotions / HotelPromotions / Promotion / LengthOfStay / @min 0..1 integer 프로모션이 적용될 수 있는 최소 숙박 일수입니다. 지정되지 않으면 최솟값이 없습니다.
Promotions / HotelPromotions / Promotion / LengthOfStay / @max 0..1 integer 프로모션을 적용하기 위해 허용되는 최대 숙박 일수입니다. 지정되지 않으면 최댓값이 없습니다.
Promotions / HotelPromotions / Promotion / MembershipRateRule 0..1 MembershipRateRule

관련 할인에 대한 특정 UI 처리를 트리거하는 멤버십 요금 규칙의 컨테이너입니다.

<Discount>도 지정되지 않은 경우 이 요소를 지정해서는 안 됩니다.

Promotions / HotelPromotions / Promotion / MembershipRateRule / @id 1 string

멤버십 프로그램과 연결된 요금 규칙의 ID입니다.

Promotions / HotelPromotions / Promotion / MinimumAmount 0..1 MinimumAmount 프로모션을 적용하기 위해 초과해야 하는 일일 객실 요금의 최소 합계 (AmountBeforeTax 또는 AmountAfterTax 중 더 큰 값 사용)를 지정합니다.
Promotions / HotelPromotions / Promotion / MinimumAmount / @before_discount 1 integer 프로모션을 적용하려면 초과해야 하는 값입니다.
Promotions / HotelPromotions / Promotion / Occupancy 0..1 Occupancy 이 프로모션이 적용되는 숙박 인원에 대한 제한사항을 정의합니다. 숙박 인원이 최소 및 최대 한도를 벗어나면 프로모션이 적용되지 않습니다.
Promotions / HotelPromotions / Promotion / Occupancy / @min 0..1 integer 할인을 적용하려면 사용자가 지정한 숙박 인원이 이 값 이상이어야 합니다.
Promotions / HotelPromotions / Promotion / Occupancy / @max 0..1 integer 할인을 적용하려면 사용자가 지정한 숙박 인원이 이 값 이하여야 합니다.
Promotions / HotelPromotions / Promotion / RatePlans 0..1 RatePlans 프로모션이 적용되는 요금제 목록의 컨테이너입니다. <RatePlans>을 지정하지 않으면 프로모션이 모든 요금제에 적용됩니다.
Promotions / HotelPromotions / Promotion / RatePlans / RatePlan 1..n RatePlan 요금제를 지정합니다. 요금제는 트랜잭션(숙박 시설 데이터), OTA_HotelRateAmountNotifRQ, OTA_HotelAvailNotifRQ 메시지에 정의되고 PackageID로 식별되는 패키지, 요금, 이용 가능 여부의 조합으로 정의됩니다.
Promotions / HotelPromotions / Promotion / RatePlans / RatePlan / @id 1 string 요금제의 고유 식별자입니다. 이 값은 트랜잭션 (숙박 시설 데이터) 메시지의 <PackageData><OTA_HotelRateAmountNotifRQ><OTA_HotelAvailNotifRQ> 메시지의 <StatusApplicationControl>에 있는 RatePlanCode 속성에 매핑됩니다. 허용되는 최대 문자 수는 50자(영문 기준)입니다.
Promotions / HotelPromotions / Promotion / RoomTypes 0..1 RoomTypes 프로모션이 적용되는 객실 유형 목록의 컨테이너입니다. 지정된 각 <RoomType>에 프로모션이 적용됩니다. <RoomTypes>을 지정하지 않으면 프로모션이 모든 객실에 적용됩니다.
Promotions / HotelPromotions / Promotion / RoomTypes / RoomType 1..n RoomType 방 유형을 지정합니다. 객실 유형은 트랜잭션 (숙박 시설 데이터) 메시지의 <RoomData> 요소에 정의되며 <RoomID> 값을 사용하여 참조됩니다. <RoomID> 값은 OTA_HotelRateAmountNotifRQ 메시지의 InvTypeCode 속성에 의해서도 참조됩니다.
Promotions / HotelPromotions / Promotion / RoomTypes / RoomType / @id 1 string 인벤토리의 고유 식별자입니다 (방 유형). 이 값은 트랜잭션 (숙박 시설 데이터) 메시지에서 <RoomID>에 매핑됩니다. 허용되는 최대 문자 수는 50자(영문 기준)입니다.
Promotions / HotelPromotions / Promotion / Stacking 0..1 Stacking 프로모션 결합 방법을 지정합니다. 지정하지 않으면 'type'이 base인 것으로 간주됩니다.
Promotions / HotelPromotions / Promotion / Stacking / @type 1 enum

이 설정에 따라 여러 프로모션을 단일 요금에 적용할 수 있습니다.

  • any: 다른 프로모션 (none 제외)과 함께 사용할 수 있지만 프로모션이 적용되어야 하는 순서는 보장되지 않습니다.
  • base: 조건을 충족하는 가장 적합한 base 프로모션이 먼저 선택되어 적용된 후에 다른 프로모션보다 먼저 적용됩니다. 이전 이름은 base_only입니다.
  • second: base 프로모션(해당하는 경우) 후 및 any개의 프로모션 이전에 가장 적합한 second 프로모션이 선택되어 적용됩니다.
  • none: 다른 프로모션과 함께 사용할 수 없습니다.

허용되는 조합 중에서 가장 큰 할인을 제공하는 프로모션 세트가 요금에 적용됩니다.

Promotions / HotelPromotions / Promotion / StayDates 0..1 StayDates 시즌 할인 수용과 같이 프로모션 적용 방식을 결정하는 하나 이상의 기간에 대한 컨테이너입니다.
Promotions / HotelPromotions / Promotion / StayDates / @application 1 enum

프로모션을 적용하는 방법을 설명합니다.

유효한 값은 다음과 같습니다.

  • all: 숙박 일정의 모든 날짜가 숙박 날짜와 겹치는 경우 숙박 일정의 각 밤에 프로모션을 적용합니다.
  • any: 숙박 일정의 날짜가 숙박 기간의 날짜와 겹치는 경우 숙박 일정의 모든 숙박 일수에 프로모션을 적용합니다.
  • overlap: 숙박 일정 중 숙박 기간의 날짜와 겹치는 숙박 일수에만 프로모션을 적용합니다.

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

  • <Discount>에서 percentage를 지정하고 applicationall 또는 any로 설정되면 할인이 전체 숙박의 비율로 적용됩니다.
  • <Discount>에서 percentage을 지정하고 applicationoverlap로 설정하면 겹치는 숙박 일수의 1박 요금에 할인이 백분율로 적용됩니다.
  • fixed_amount를 지정하는 <Discount>overlap로 설정된 application는 잘못된 조합입니다.
  • <FreeNights>는 모든 application 값을 지원합니다. overlap의 경우 겹치는 숙박 일수만 할인 요건이 적용됩니다.
Promotions / HotelPromotions / Promotion / StayDates / DateRange 1..99 DateRange

프로모션을 적용할 날짜를 지정하는 기간입니다.

YearlessDate 형식도 지원됩니다.

  • start 또는 end 중 하나가 연도가 없는 날짜인 경우 둘 다 연도가 없는 날짜로 채워져야 합니다.
  • 연도가 없는 기간은 새해를 둘러싸지 않아야 합니다. 대신, 두 개의 인접한 기간으로 기간을 나타냅니다. 예를 들어 {"12-29", "01-05"}{"12-29", "12-31"}{"01-01", "01-05"}로 표시할 수 있습니다.
Promotions / HotelPromotions / Promotion / StayDates / DateRange / @start 0..1 Date or YearlessDate 기간의 시작 날짜 (속성 시간대를 기준으로 함)입니다. 이 날짜는 end 날짜 이전이거나 동일하거나 같아야 합니다. start을 지정하지 않으면 시작일과 관련하여 기간이 제한이 없습니다.
Promotions / HotelPromotions / Promotion / StayDates / DateRange / @end 0..1 Date or YearlessDate 기간의 종료일 (속성 시간대를 기준으로 함)입니다. 이 날짜는 start 날짜와 같거나 그 이후여야 합니다. end를 지정하지 않으면 종료일이 사실상 무제한입니다.
Promotions / HotelPromotions / Promotion / StayDates / DateRange / @days_of_week 0..1 string

기간에 허용되는 요일입니다. 지정하지 않으면 기간에 모든 요일이 허용됩니다. 문자열의 각 문자는 날짜를 지정합니다. 예를 들어 'MTWHF'는 기간에서 평일이 허용되도록 지정합니다.

유효한 문자는 다음과 같습니다.

  • 월요일 M
  • 화요일의 경우 T
  • 수요일의 경우 W
  • 목요일의 경우 H
  • 금요일의 경우 F
  • 토요일의 경우 S
  • 일요일의 경우 U

모든 문자 조합을 사용할 수 있습니다.

Promotions / HotelPromotions / Promotion / UserCountries 0..1 UserCountries 프로모션에 참여할 수 있는 사용자 위치 (국가)를 나열하기 위한 컨테이너입니다. 지정하면 나열된 국가의 자격 요건을 충족하는 사용자에게만 할인 혜택이 제공됩니다. 지정하지 않으면 모든 국가의 대상 사용자에게 할인 요금이 제공됩니다.
Promotions / HotelPromotions / Promotion / UserCountries / @type 0..1 enum 사용자 국가 사양의 유형입니다.

유효한 값은 includeexclude입니다.

사용자 국가 typeinclude로 설정된 경우 프로모션이 나열된 국가의 사용자에게 적용됩니다.

사용자 국가 typeexclude이면 프로모션이 나열된 국가 외의 사용자에게 적용됩니다.

사용자 국가 type가 설정되지 않은 경우 include로 처리되고 나열된 국가의 사용자에게 프로모션이 적용됩니다.

Promotions / HotelPromotions / Promotion / UserCountries / Country 1..300 Country 사용자가 프로모션을 이용할 수 있는 국가를 정의합니다.
Promotions / HotelPromotions / Promotion / UserCountries / Country / @code 1 string CLDR 국가 코드(예: DE 또는 FR) 일부 국가의 경우 CLDR 국가 코드가 2자리 ISO 국가 코드와 다릅니다. 또한 CLDR 리전 코드도 지원되지 않습니다.

기본 메시지

다음 예는 기본적인 Promotions 메시지를 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
         <DateRange start="2020-07-01" end="2020-07-31" days_of_week="MTWHF"/>
         <DateRange start="2020-09-01" end="2020-09-30"/>
      </BookingDates>
      <BookingWindow min="7" max="330"/>
      <CheckinDates>
         <DateRange start="2020-10-01" end="2020-10-31" days_of_week="FSU"/>
      </CheckinDates>
      <CheckoutDates>
         <DateRange start="2020-10-08" end="2020-11-07" days_of_week="FSU"/>
      </CheckoutDates>
      <Devices>
        <Device type="mobile"/>
        <Device type="tablet"/>
      </Devices>
      <Discount percentage="20" applied_nights="2"/>
      <LengthOfStay min="2" max="14"/>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <Stacking type="base"/>
      <UserCountries>
        <Country code="US"/>
        <Country code="GB"/>
      </UserCountries>
    </Promotion>
  </HotelPromotions>
</Promotions>


인벤토리 상태

다음 예시는 도착 날짜에 가까운 초과 인벤토리가 있는 경우 할인을 생성하는 방법을 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingWindow max="7"/>
      <Discount percentage="10"/>
      <InventoryCount min="3"/>
    </Promotion>
  </HotelPromotions>
</Promotions>


프로모션 1개 삭제

다음 예시에서는 숙박 시설의 프로모션 하나를 삭제하는 방법을 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1" action="delete"/>
  </HotelPromotions>
</Promotions>

모든 프로모션 삭제

다음 예시는 숙박 시설의 모든 프로모션을 삭제하는 방법을 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay"/>
</Promotions>



모든 프로모션 오버레이

다음 예는 새 프로모션이 하나 이상 있는 속성의 <HotelPromotions>를 오버레이하는 방법을 보여줍니다. action="overlay"인 경우 현재 메시지에 지정된 프로모션을 저장하기 전에 저장된 모든 프로모션이 삭제됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay">
    <Promotion id="1">
      <BookingDates>
         <DateRange start="2020-09-01" end="2020-09-30"/>
      </BookingDates>
      <Discount percentage="10"/>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
      <Stacking type="base"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

3가지 다양한 스태킹 유형

다음 예는 세 가지 프로모션이 적용되는 경우 (base, second, any)를 보여줍니다. none 프로모션은 다른 프로모션이 더 나은 할인을 제공하므로 적용되지 않습니다. 원래 가격이 $100라면 할인된 가격은 $72.90가 됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="10"/>
      <Stacking type="base"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="10"/>
      <Stacking type="second"/>
    </Promotion>
    <Promotion id="3">
      <Discount percentage="10"/>
      <Stacking type="any"/>
    </Promotion>
    <Promotion id="4">
      <Discount percentage="25"/>
      <Stacking type="none"/>
    </Promotion>
  </HotelPromotions>
</Promotions>


없음 스태킹 유형

다음 예는 다른 프로모션을 함께 사용하면 더 적은 할인을 제공하기 때문에 none 프로모션이 사용된 경우를 보여줍니다. 원래 가격이 $100라면 할인 가격은 $75가 됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="10"/>
      <Stacking type="base"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="10"/>
      <Stacking type="any"/>
    </Promotion>
    <Promotion id="3">
      <Discount percentage="25"/>
      <Stacking type="none"/>
    </Promotion>
  </HotelPromotions>
</Promotions>



예약 기간 제한

다음 예는 ISO 8601 기간 유형으로 정의된 시작 및 종료 경계와 함께 BookingWindow 요소가 사용되는 사례를 보여줍니다. 이러한 예약 기간에 따라 도착 전날 18:00 또는 그 이전과 도착 2일 전 12:00 이후를 예약해야 합니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingWindow min="P1DT6H" max="P2DT12H"/>
      <Discount percentage="20"/>
    </Promotion>
  </HotelPromotions>
</Promotions>


예약 날짜 날짜/시간 경계

다음 예는 BookingDates 요소가 startend 속성과 함께 DateTime 유형으로 사용되는 사례를 보여줍니다. 이 예약 날짜 제한에 따라 2020년 7월 1일 06:30에서 2020년 7월 2일 18:45 사이에 예약해야 합니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
         <DateRange start="2020-07-01T06:30:00" end="2020-07-02T18:45:00"/>
      </BookingDates>
      <Discount percentage="20"/>
    </Promotion>
  </HotelPromotions>
</Promotions>


연도가 지정되지 않은 기간

다음 예는 CheckInDates 요소에 연도가 없는 startend 필드가 있는 DateRanges가 포함된 경우를 보여줍니다. 이 예에서 프로모션은 연도에 관계없이 12월 29일부터 1월 2일 사이의 체크인 날짜에 적용됩니다. 새해 경계를 넘는 연도가 없는 날짜 범위는 유효하지 않으므로, DateRange는 두 개의 인접한 기간으로 표시됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <CheckInDates>
         <DateRange start="12-29" end="12-31"/>
         <DateRange start="01-01" end="01-02"/>
      </CheckInDates>
      <Discount percentage="20"/>
    </Promotion>
  </HotelPromotions>
</Promotions>



FreeNights 할인

다음 예시는 지정된 예약 날짜 범위 동안 숙박한 각 4박에 대해 2박에 50% 의 할인을 제공합니다. 10박 여행 일정의 경우 총 4박에 대해 50%의 할인율이 적용됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-01-01" end="2022-05-31"/>
      </BookingDates>
      <Discount>
        <FreeNights stay_nights="4" discount_nights="2" discount_percentage="50" night_selection="cheapest" repeats="true"/>
      </Discount>
    </Promotion>
  </HotelPromotions>
</Promotions>

다음 예시는 지정된 숙박 날짜 범위 동안 숙박한 각 3박에 대해 1박에 50% 를 할인합니다. 겹치는 숙박 일수만 할인 요건을 충족하는 계산에 반영됩니다. 2022년 1월 1일에 체크인하고 2022년 1월 7일에 체크아웃하는 다음 여행 일정에는 다음과 같이 요건을 충족하는 숙박일 및 할인이 적용됩니다.

  • 2022-01-01 (숙박)
  • 2022-01-02 (숙박)
  • 2022-01-03
  • 2022-01-04 (할인)
  • 2022-01-05 (숙박)
  • 2022-01-06 (숙박)
<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <StayDates application="overlap">
        <DateRange start="2022-01-01" end="2022-01-02"/>
        <DateRange start="2022-01-04" end="2022-01-06"/>
      </StayDates>
      <Discount>
        <FreeNights stay_nights="3" discount_nights="1" discount_percentage="50" night_selection="last" repeats="true"/>
      </Discount>
    </Promotion>
  </HotelPromotions>
</Promotions>


순위 선택

다음 예시에서는 20% 할인과 15% 할인이라는 두 가지 할인을 제공합니다. 평가 중에는 순위가 더 낮아 15% 할인만 적용됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15" rank="25"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="20" rank="50"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

BestDailyDiscount

다음 예에서는 Discount로 스택된 BestDailyDiscount를 적용하여 2박 숙박을 할인합니다.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
 <HotelPromotions hotel_id="HotelID" action="overlay">
   <Promotion id="general">
     <BestDailyDiscount fixed_amount="20"/>
   </Promotion>
   <Promotion id="may">
     <BestDailyDiscount fixed_amount="50"/>
     <StayDates application="overlap">
        <DateRange start="2023-05-01" end="2023-05-31"/>
     </StayDates>
   </Promotion>
   <Promotion id="fiesta">
     <Discount fixed_amount_per_night="5"/>
     <Stacking type="any"/>
   </Promotion>
 </HotelPromotions>
</Promotions>

2023년 4월 30일부터 2023년 5월 2일까지 2박 체류한다고 생각해 보세요. 계산 시 가장 큰 할인을 제공하는 최고의 일일 할인 조합을 먼저 찾습니다.

첫날 밤 '일반' 프로모션은 20의 고정 할인이 적용되는 유일한 대상입니다.

두 번째 밤에는 '할 수 있음' 프로모션이 '일반' 할인보다 더 큰 할인을 제공합니다. 따라서 'may'가 선택되면 고정 할인 금액은 50입니다.

숙박 시 'fiesta' 프로모션 할인으로 1박당 5달러(총 10개)로 할인됩니다. 'fiesta'의 스태킹 유형이 any로 설정되어 있으므로 최고의 일일 할인 조합과 함께 누적될 수 있습니다. base로 설정된 경우 최고의 일일 할인 또는 '피에스타' 할인의 조합만 적용됩니다. 자세한 내용은 Stacking 설명을 참고하세요.

`전체적으로 숙박 요금에 20 + 50 + 10 = 80의 고정 금액 할인이 적용됩니다.

응답

문법

PromotionsResponse 메시지는 다음 구문을 사용합니다.

<?xml version="1.0" encoding="UTF-8"?>
<PromotionsResponse timestamp="timestamp"
                    id="message_ID"
                    partner="partner_key">
  <!-- Either Success or Issues are populated. -->
  <Success/>
  <Issues>
    <Issue code="issue_code"
           status="issue_type">
      issue_description
    </Issue>
  </Issues>
</PromotionsResponse>

요소 및 속성

PromotionsResponse 메시지에는 다음과 같은 요소와 속성이 있습니다.

요소 / @Attribute 발생 횟수 유형 설명
PromotionsResponse 1 Complex element 수신된 프로모션 요청 메시지의 성공 또는 문제를 나타내는 루트 요소입니다.
PromotionsResponse / @timestamp 1 DateTime 이 메시지를 작성한 날짜 및 시간입니다.
PromotionsResponse / @id 1 string 연결된 프로모션 메시지의 고유 식별자입니다.
PromotionsResponse / @partner 1 string 이 메시지의 파트너 계정입니다.
PromotionsResponse / Success 0..1 Success 프로모션 메시지가 경고, 오류 또는 실패 없이 성공적으로 처리되었음을 나타냅니다.

각 메시지에는 <Success> 또는 <Issues>가 있습니다.

PromotionsResponse / Issues 0..1 Issues 프로모션 메시지를 처리하는 동안 발생한 하나 이상의 문제에 대한 컨테이너입니다.

각 메시지에는 <Success> 또는 <Issues>가 있습니다.

PromotionsResponse / Issues / Issue 1..n Issue 프로모션 메시지를 처리하는 동안 발생한 경고, 오류 또는 실패에 관한 설명입니다. 이 문제에 관한 자세한 내용은 피드 상태 오류 메시지에서 확인할 수 있습니다.
PromotionsResponse / Issues / Issue / @code 1 integer 문제의 식별자입니다.
PromotionsResponse / Issues / Issue / @status 1 enum

발생한 문제의 유형입니다.

유효한 값은 warning, error, failure입니다.

성공

다음은 성공적으로 처리된 프로모션 메시지에 대한 응답입니다.

<?xml version="1.0" encoding="UTF-8"?>
<PromotionsResponse timestamp="2020-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</PromotionsResponse>

문제

다음은 오류로 인해 처리되지 않은 프로모션 메시지에 대한 응답입니다.

<?xml version="1.0" encoding="UTF-8"?>
<PromotionsResponse timestamp="2020-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Issues>
    <Issue code="1001" status="error">Example</Issue>
  </Issues>
</PromotionsResponse>