개요
이 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 | 이 메시지의 파트너 계정입니다. 이 문자열 값은
'파트너 키' 값이
<ph type="x-smartling-placeholder"></ph>
계정 설정 페이지로 이동합니다.
특정 주제에 대한 피드를 제공하는 백엔드가 있는 경우
여러 계정이 있는 경우 이 값은 |
Promotions / @id | 1 | string | 이 요청 메시지의 고유 식별자입니다. 이 값이 반환됩니다. 을 입력합니다. 허용되는 문자는 a~z, A~Z, 0~9, _입니다. (밑줄) 및 - (대시)가 있습니다. |
Promotions / @timestamp | 1 | DateTime | 이 메시지를 작성한 날짜 및 시간입니다. |
Promotions / HotelPromotions | 0..n | HotelPromotions | 숙박 시설 프로모션 각 프로모션은 속성
|
Promotions / HotelPromotions / @hotel_id | 1 | string | 숙박 시설의 고유 식별자입니다. 이 값은
을(를) 사용하여 지정된 호텔 ID
<listing> 요소의 <id>
호텔 목록 피드에 표시됩니다. 호텔 ID는 Hotel Center에도 표시됩니다. |
Promotions / HotelPromotions / @action | 0..1 | enum | 지정된 경우 값은
지정하지 않으면 현재 메시지는 다음 중 하나입니다.
|
Promotions / HotelPromotions / Promotion | 0..99 | Promotion | 숙박 시설에 대한 단일 프로모션입니다. 99개가 넘는 프로모션을 사용해야 하는 경우 담당 기술계정 관리자 (TAM)에게 문의하세요. |
Promotions / HotelPromotions / Promotion / @id | 1 | string | 프로모션의 고유 식별자입니다. 허용되는 문자는 40자(영문 기준)입니다. 허용되는 문자는 a~z, A~Z, 0~9, _ (밑줄), - (대시), . (마침표)를 누릅니다. |
Promotions /HotelPromotions / Promotion / @action | 0..1 | enum | 지정된 경우 값은
|
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 | 시작 날짜 또는 날짜/시간 (속성 시간대 기준) 범위에 포함됩니다.
|
Promotions / HotelPromotions / Promotion / BookingDates / DateRange / @end | 0..1 | Date 또는 DateTime | 종료 날짜 또는 날짜/시간 (속성 시간대 기준) 범위에 포함됩니다.
|
Promotions / HotelPromotions / Promotion / BookingDates / DateRange / @days_of_week | 0..1 | string | 기간에 허용되는 요일입니다. 지정하지 않으면 기간 내 모든 날짜가 허용됩니다. 각 문자는 일을 지정합니다. 예: 'MTWHF' 지정 선택할 수 있습니다. 유효한 문자는 다음과 같습니다.
모든 문자 조합을 사용할 수 있습니다. |
Promotions / HotelPromotions / Promotion / BookingWindow | 0..1 | BookingWindow | 다음 기간을 기준으로 예약이 이루어져야 하는 기간을 지정합니다. 체크인 날짜를 선택합니다 (숙박 시설의 시간대 기준). 예를 들어 예약 기간은 최소 7일에서 180일 이하로 설정할 수 있습니다. 를 클릭하세요. |
Promotions / HotelPromotions / Promotion / BookingWindow / @min | 0..1 | integer or duration | 체크인 전 예약이 이루어지는 최소 시간입니다.
확인해야 합니다 지정되지 않거나 값이 0 이면 최솟값이 없습니다.
유효한 값 유형은 다음과 같습니다.
|
Promotions / HotelPromotions / Promotion / BookingWindow / @max | 0..1 | integer or duration | 예약할 때 체크인하기 전까지 남은 최대 일수입니다.
확인해야 합니다 지정되지 않은 경우 또는 그 값
0 인 경우 최댓값이 없습니다.
유효한 값 유형은 다음과 같습니다.
|
Promotions / HotelPromotions / Promotion / Ceiling | 0..1 | Ceiling |
요율을 설정할 수 있는 최댓값에 대한 제한을 정의합니다. 프로모션 적용 후 프로모션에서는 항상 스태킹이 구성된 경우
1회 숙박에 예:
계산 순서는 다음과 같습니다.
60이 전체 상한선이 더 엄격하다는 사실은 자체 프로모션에만 유효하며 전체 프로모션 스택에 걸친 천장 |
Promotions / HotelPromotions / Promotion / Ceiling / @amount_per_night | 1 | float |
다음 날짜 이후에 1박 요금을 설정할 수 있는 최대 금액입니다. 할인이 적용됩니다.
|
Promotions / HotelPromotions / Promotion / Floor | 0..1 | Floor |
요율을 설정할 수 있는 최솟값에 대한 제한을 정의합니다. 프로모션 적용 후 프로모션은 항상
중복 적용이 구성된 경우 예:
계산 순서는 다음과 같습니다.
90이 전체적으로 더 엄격한 하한선이라는 사실은 자체 프로모션에만 유효하며 하한선은 전체 프로모션 스택에 걸쳐 있습니다. |
Promotions / HotelPromotions / Promotion / Floor / @amount_per_night | 1 | float |
할인이 적용된 후 1박 요금을 설정할 수 있는 최소 금액입니다.
|
Promotions / HotelPromotions / Promotion / CheckinDates | 0..1 | CheckinDates | 체크인해야 하는 시간을 정의하는 하나 이상의 기간에 대한 컨테이너입니다. 프로모션이 적용됩니다. |
Promotions / HotelPromotions / Promotion / CheckinDates / DateRange | 1..20 | DateRange | 프로모션이 적용되기 위해 체크인이 이루어져야 하는 기간을 지정하는 날짜 범위입니다. 하나 이상의 프로모션을 삭제하는 경우에는 이 요소가 필요하지 않습니다. YearlessDate 형식도 지원됩니다.
|
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' 지정 선택할 수 있습니다. 유효한 문자는 다음과 같습니다.
모든 문자 조합을 사용할 수 있습니다. |
Promotions / HotelPromotions / Promotion / CheckoutDates | 0..1 | CheckoutDates | 체크아웃 시점을 정의하는 하나 이상의 기간에 대한 컨테이너입니다. 가 발생해야 합니다. |
Promotions / HotelPromotions / Promotion / CheckoutDates / DateRange | 1..20 | DateRange | 프로모션을 위해 체크아웃해야 하는 시간을 지정하는 기간 적용됩니다. 하나 이상의 프로모션을 삭제하는 경우에는 이 요소가 필요하지 않습니다. YearlessDate 형식도 지원됩니다.
|
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' 지정 선택할 수 있습니다. 유효한 문자는 다음과 같습니다.
모든 문자 조합을 사용할 수 있습니다. |
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 |
이 프로모션에 적용할 할인을 지정합니다. |
Promotions / HotelPromotions / Promotion / Discount / @percentage | 0..1 | float |
할인율을 지정하는 0~100 사이의 십진수 값입니다.
예:
|
Promotions / HotelPromotions / Promotion / Discount / @fixed_amount | 0..1 | float |
합계에서 차감할 고정 금액입니다.
예:
|
Promotions / HotelPromotions / Promotion / Discount / @fixed_amount_per_night | 0..1 | float |
각 예:
|
Promotions / HotelPromotions / Promotion / Discount / @fixed_price | 0..1 | float |
1박 요금을
예:
|
Promotions / HotelPromotions / Promotion / Discount / @fixed_price_per_night | 0..1 | float |
예:
|
Promotions / HotelPromotions / Promotion / Discount / @applied_nights | 0..1 | integer | 이것은
할인이 적용되는 숙박 일수로, 다음으로 시작합니다. 가장 저렴합니다 1~99 사이의 정수여야 합니다. 지정하지 않으면 모든 숙박에 할인이 적용됩니다. |
Promotions / HotelPromotions / Promotion / Discount / FreeNights | 0..1 | FreeNights | 최소 숙박 일수인 경우 특정 숙박일의 할인을 지정합니다.
사용할 수 있습니다. 상위 Discount 요소의 속성
이 요소가 사용되는 경우 허용되지 않습니다. |
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @stay_nights | 1 | integer | 할인을 적용하기 위해 필요한 숙박 일수입니다. 각 할인은 별도의 숙박 일수 세그먼트에 적용됩니다. 예를 들어 |
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @discount_nights | 1 | integer | 숙박 일수의 각 세그먼트 내에서 할인된 숙박 일수입니다. |
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @discount_percentage | 1 | float | 할인 숙박 일수에 적용되는 할인입니다. 이 값이
50 인 경우 선택한 1박당 50% 할인됩니다. |
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @night_selection | 1 | string | cheapest 또는 last 여야 합니다. 만약
last , 이후 숙박 기간 종료 시 숙박 일수
1박 요금이 할인됩니다. cheapest 인 경우 최저가
숙박 일수 세그먼트 내 숙박 일수는 할인됩니다. |
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @repeats | 1 | boolean | 2박 이상 숙박에 할인이 적용되는지 여부입니다.
세그먼트. 예를 들어 |
Promotions / HotelPromotions / Promotion / Discount / @rank | 0..1 | integer | 이 프로모션에 순위를 할당하고 순위가 지정된 선택에 선택합니다. 순위가 가장 낮은 프로모션만 적용되도록 선택됩니다. 값 1 이상 99 이하여야 합니다. 여러 프로모션이 동일한 순위를 공유하는 경우 하나가 임의로 선택되어 적용됩니다. |
Promotions / HotelPromotions / Promotion / BestDailyDiscount | 1 | Discount |
다음을 지정합니다.
숙박 1박에 적용될 수 있는 일일 할인. 이 내용은
할인을 적용하는 숙박 시설마다 '매일 최고 인기'로 간주됩니다. 즉, 숙박 기간 중 매일 숙박할 때마다 싱글 '베스트 일일' 가장 높은 실적을 기록하는 프로모션 할인이 선택되어 적용될 수 있습니다.
|
Promotions / HotelPromotions / Promotion / BestDailyDiscount / @percentage | 0..1 | float |
할인율을 지정하는 0~100 사이의 십진수 값입니다.
예:
|
Promotions / HotelPromotions / Promotion/ BestDailyDiscount / @fixed_amount | 0..1 | float |
단일 예:
|
Promotions / HotelPromotions / Promotion/ BestDailyDiscount / @fixed_price | 0..1 | float |
1박 요금을 예:
|
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를 트리거하는 멤버십 요금 규칙의 컨테이너 관련 할인의 전체 처리입니다. 이 요소는 다음 경우에만 지정되어야 합니다.
|
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 패키지 ID로 식별됩니다. |
Promotions / HotelPromotions / Promotion / RatePlans / RatePlan / @id | 1 | string | 요금제의 고유 식별자입니다. 이 값은 거래(숙박 시설 데이터) 메시지의 <PackageData> 에 있는 PackageID 값과 <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 속성
messages.) |
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 | 다음에 따라 여러 프로모션을 단일 요율에 적용할 수 있습니다. 이 설정을 적용할 수 있습니다.
허용되는 조합 중에서 가장 큰 할인이 요율에 적용됩니다. |
Promotions / HotelPromotions / Promotion / StayDates | 0..1 | StayDates | 하나 이상의 기간에 대한 컨테이너입니다. 프로모션이 적용됩니다(예: 시즌 할인 제공). |
Promotions / HotelPromotions / Promotion / StayDates / @application | 1 | enum | 프로모션을 적용하는 방법을 설명합니다. 유효한 값은 다음과 같습니다.
이 속성은 항상 지정해야 합니다.
|
Promotions / HotelPromotions / Promotion / StayDates / DateRange | 1..99 | DateRange | 프로모션을 적용할 날짜를 지정하는 기간입니다. YearlessDate 형식도 지원됩니다.
|
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 가 지정되지 않으면 날짜 범위는 start 날짜 이후로 사실상 무제한입니다.
다음과 같은 경우 |
Promotions / HotelPromotions / Promotion / StayDates / DateRange / @days_of_week | 0..1 | string | 기간에 허용되는 요일입니다. 그렇지 않은 경우 지정된 경우 기간 내의 모든 요일이 허용됩니다. 각 문자는 일을 지정합니다. 예: 'MTWHF' 지정 선택할 수 있습니다. 유효한 문자는 다음과 같습니다.
모든 문자 조합을 사용할 수 있습니다. |
Promotions / HotelPromotions / Promotion / UserCountries | 0..1 | UserCountries | 프로모션 대상 사용자 위치(국가)를 나열하는 컨테이너입니다. 지정하면 목록에 있는 자격이 있는 사용자만 할인율이 제공되는 국가입니다. 지정하지 않으면 모든 국가의 사용자에게 할인된 요금이 제공됩니다. |
Promotions / HotelPromotions / Promotion / UserCountries / @type | 0..1 | enum | 사용자 국가 사양의 유형입니다.
유효한 값은 사용자 국가 사용자 국가 사용자 국가 |
Promotions / HotelPromotions / Promotion / UserCountries / Country | 1..300 | Country | 사용자가 프로모션을 이용할 수 있는 국가를 정의합니다. |
Promotions / HotelPromotions / Promotion / UserCountries / Country / @code | 1 | string | CLDR 국가
코드가 포함된
(예: DE , FR ) 일부의 경우
CLDR 국가 코드는 2자리 ISO와 다릅니다.
국가 코드. 또한 CLDR 리전 코드도 지원되지 않습니다. |
예
프로모션은 숙박 시설당 500개로 제한됩니다. 숙박 시설에서 프로모션을 삭제하려면 '프로모션 1개 삭제' 예시를 참고하세요.
기본 메시지
다음 예는 기본 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>
예약 기간 제한
다음 예는 BookingWindow
가
요소는 시작 및 종료 경계가 ISO 8601 기간으로 정의된 상태로 사용됩니다.
있습니다. 이 예약 기간 제한으로, 18:00 이전에 예약해야 합니다.
도착 전날 및 도착 전 2일 차 12시 이후
있습니다.
<?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
가
요소는 다음과 같이 start
및 end
속성과 함께 사용됩니다.
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
가
요소에 start
및DateRanges
연도가 없는 end
필드. 이 예시에서는 프로모션이
연도와 관계없이 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% 할인과 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박 숙박을 고려해 보세요. 가장 높은 매출을 내는 일일 할인의 조합은 가장 높은 할인을 먼저 찾습니다
첫날 밤, '일반' 프로모션의 유일한 자격 요건을 충족하는 금액이며 고정 할인을 제공합니다
둘째 날은 '마음에 들어' 프로모션의 할인율이 '일반' 할인입니다. 따라서 고정 할인을 선택한 다음 50입니다.
그리고 머물며 '피에스타'를 즐기세요. 프로모션 할인을 1박당 5로 할인
총 10개입니다. 일일 최고의 할인율을 조합하여 적용할 수 있습니다.
왜냐하면 '피에스타' 스택 유형이 any
로 설정되어 있음 base
로 설정된 경우 최적의 일일 할인 또는 'fiesta' 할인 조합만 적용됩니다. 다음에 대한 설명 보기
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 | 프로모션 메시지가 성공적으로 처리되었음을 나타냅니다.
알림을 받아볼 수 있습니다
각 메시지에 |
PromotionsResponse / Issues | 0..1 | Issues | 처리 중에 발생한 하나 이상의 문제에 대한 컨테이너입니다.
프로모션 메시지
|
PromotionsResponse / Issues / Issue | 1..n | Issue | 해당 기간 동안 발생한 경고, 오류 또는 실패에 대한 설명 프로모션 메시지를 처리하는 데 사용됩니다. 이 문제에 대한 자세한 내용은 인치 피드 상태 오류 메시지. |
PromotionsResponse / Issues / Issue / @code | 1 | integer | 문제의 식별자입니다. |
PromotionsResponse / Issues / Issue / @status | 1 | enum | 발생한 문제의 유형입니다. 유효한 값은 |
예
성공
다음은 성공적으로 처리된 프로모션 메시지에 대한 응답입니다.
<?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>