이 페이지는 Cloud Translation API를 통해 번역되었습니다.

비율 수정

개요

이 API를 사용하면 가격 조정 또는 환불 가능 여부 사용 설정 등의 조건이 충족된 경우 프로모션 코드에만 적용되는 프로모션 API와는 달리 조건을 충족하는 프로모션에 할인이 가장 많이 적용된다면 이 API는 특정 조건이 충족되는 경우 최종적으로 최종 가격을 인상하게 됩니다.

요청

구문

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

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="partner_key"
                      id="message_ID"
                      timestamp="timestamp">
  <HotelRateModifications hotel_id="HotelID" action="[overlay]">
    <ItineraryRateModification id="ModificationID" action="[delete]">
      <BookingDates>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </BookingDates>
      <BookingWindow min="integer" max="integer"/>
      <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>
      <Devices>
        <Device type="[desktop|tablet|mobile]"/>
      </Devices>
      <LengthOfStay min="integer" max="integer"/>
      <MinimumAmount before_discount="integer"/>
      <RatePlans>
        <RatePlan id="PackageID_1"/>
        <RatePlan id="PackageID_2"/>
      </RatePlans>
      <RoomTypes>
        <RoomType id="RoomID_1"/>
        <RoomType id="RoomID_2"/>
      </RoomTypes>
      <StayDates application="[all|any]">
        <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>
      <ModificationActions>
        <PriceAdjustment multiplier="float"/>
        <RateRule id="RateRuleID"/>
        <Refundable available="[false|true]"
                       refundable_until_days="number_of_days"
                       refundable_until_time="time"/>
        <Availability status="[unavailable]"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

요소 및 속성

RateModifications 메시지에는 다음 요소가 있습니다. 속성:

요소 / @Attribute	발생 횟수	유형	설명
RateModifications	1	Complex element	요금 수정 메시지의 루트 요소입니다.
RateModifications / @partner	1	string	이 메시지의 파트너 계정입니다. 이 문자열 값은 '파트너 키' 값이 <ph type="x-smartling-placeholder"></ph> 계정 설정 페이지로 이동합니다. 참고: 한 리소스에 대한 피드를 제공하는 백엔드가 있는 경우 계정이 여러 개인 경우 이 값은 `ID`와(과) 일치해야 합니다. `<RequestorID>`에 지정된 속성 값 `<OTA_HotelRateAmountNotifRQ>`의 요소 및 동일한 내용에 대한 메시지 `<OTA_HotelAvailNotifRQ>`개 있습니다.
RateModifications / @id	1	string	이 요청 메시지의 고유 식별자입니다. 이 값이 반환됩니다. 을 입력합니다. 허용되는 문자는 a~z, A~Z, 0~9, _입니다. 밑줄, -(대시)를 입력합니다.
RateModifications / @timestamp	1	DateTime	이 메시지를 작성한 날짜 및 시간입니다.
RateModifications / HotelRateModifications	0..n	HotelRateModifications	속성의 요금 수정입니다. 각 요율 수정은 단일 속성에 적용됩니다. 참고: 여러 요금 수정을 적용할 수 있는 경우 모든 수정사항이 적용됩니다. 특정 순서 없음 보장
RateModifications / HotelRateModifications / @hotel_id	1	string	숙박 시설의 고유 식별자입니다. 이 값은 을(를) 사용하여 지정된 호텔 ID `<listing>` 요소의 `<id>` 호텔 목록 피드에 표시됩니다. 호텔 ID는 Hotel Center에도 표시됩니다.
RateModifications / HotelRateModifications / @action	0..1	enum	`action`를 지정하지 않으면 수정사항이 이 호텔에 대해 추가 또는 업데이트됩니다. 만약 `action="overlay"`를 지정한 후 이전에 정의된 모든 값 이 호텔에 대한 수정사항이 먼저 삭제됩니다. 그런 다음 쓰여집니다 `action="overlay"`를 사용하고 이 요소 내에 수정사항이 지정되지 않은 경우 이 호텔의 수정사항이 삭제됩니다.
RateModifications / HotelRateModifications / ItineraryRateModification	0..200	ItineraryRateModification	숙박 시설의 단일 요금 수정입니다. 참고:비율 수정은 디버그하기 어려우며 가급적 사용하지 않는 것이 좋습니다. 다음과 같은 사용 사례에 대해서는 기술계정 관리자 (TAM)에게 문의하세요. 200개가 넘는 비율 수정이 필요합니다.
RateModifications / HotelRateModifications / ItineraryRateModification / @id	1	string	요금 수정을 위한 고유 식별자입니다. 허용되는 문자는 40자(영문 기준)입니다. 허용되는 문자는 a~z, A~Z, 0~9, _ (밑줄), - (대시), . (마침표)를 누릅니다.
RateModifications / HotelRateModifications / ItineraryRateModification / @action	0..1	enum	지정하지 않은 경우 `id`이(가) 저장되지 않으면 이 요율 수정이 저장됩니다. 그 외의 경우 지정하지 않고 동일한 `id`이(가) 저장되며 기존 요금 수정은 다음과 같습니다. 이(가) 업데이트되었습니다. 지정된 경우 값은 `"delete"`여야 합니다. `"delete"`를 지정하면 동일한 `id`의 저장된 요금 수정이 삭제됩니다. `"delete"`를 사용할 때는 `<ItineraryRateModification>`입니다. 또한 `"delete"`는 `<HotelRateModifications action="overlay"/>`와 함께 허용됩니다.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates	0..1	BookingDates	예약 시기를 정의하는 하나 이상의 기간에 대한 컨테이너는 필수 항목입니다. 요율 수정이 적용되어야 합니다.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange	1..99	DateRange	요금에 대해 예약이 발생해야 하는 시기를 지정하는 기간입니다. 있습니다.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @start	0..1	Date	(숙박 시설의 시간대를 기준으로 함) 시작일 확인할 수 있습니다 이 날짜는 `end` 날짜입니다. `start`를 지정하지 않으면 날짜 기간은 시작일 측면에서 사실상 무제한입니다.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @end	0..1	Date	기간을 설정할 수 있습니다. 이 날짜는 `start` 날짜입니다. `end`를 지정하지 않으면 날짜 종료일은 사실상 무제한입니다.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @days_of_week	0..1	string	기간에 허용되는 요일입니다. 그렇지 않은 경우 지정된 경우 기간 내의 모든 요일이 허용됩니다. 각 문자는 일을 지정합니다. 예: 'MTWHF' 지정 선택할 수 있습니다. 유효한 문자는 다음과 같습니다. 월요일 `M` 화요일의 경우 `T` 수요일의 경우 `W` 목요일의 경우 `H` 금요일의 경우 `F` 토요일의 경우 `S` 일요일의 경우 `U` 모든 문자 조합을 사용할 수 있습니다.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow	0..1	BookingWindow	다음 기간을 기준으로 예약이 이루어져야 하는 기간을 지정합니다. 체크인 날짜를 선택합니다 (숙박 시설의 시간대 기준). 예를 들어 예약 기간은 최소 7일에서 180일 이하로 설정할 수 있습니다. 를 클릭하세요.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow / @min	0..1	integer	예약 시 체크인하기 전까지 남은 최소 일수입니다. 요율 수정이 적용됩니다. 지정하지 않으면 최솟값이 없습니다
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow / @max	0..1	integer	예약할 때 체크인하기 전까지 남은 최대 일수입니다. 요율 수정이 적용됩니다. 지정하지 않으면 최댓값은 없습니다.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates	0..1	CheckinDates	체크인해야 하는 시간을 정의하는 하나 이상의 기간에 대한 컨테이너입니다. 요율 수정이 적용됩니다.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange	1..99	DateRange	요금에 체크인해야 하는 시기를 지정하는 날짜 범위 있습니다. 이 요소는 하나 이상의 비율 수정을 삭제합니다.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @start	0..1	Date	(숙박 시설의 시간대를 기준으로 함) 시작일 확인할 수 있습니다 이 날짜는 `end` 날짜입니다. `start`를 지정하지 않으면 날짜 기간은 시작일 측면에서 사실상 무제한입니다.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @end	0..1	Date	기간을 설정할 수 있습니다. 이 날짜는 `start` 날짜입니다. `end`를 지정하지 않으면 날짜 종료일은 사실상 무제한입니다.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @days_of_week	0..1	string	기간에 허용되는 요일입니다. 그렇지 않은 경우 지정된 경우 기간 내의 모든 요일이 허용됩니다. 각 문자는 일을 지정합니다. 예: 'MTWHF' 지정 선택할 수 있습니다. 유효한 문자는 다음과 같습니다. 월요일 `M` 화요일의 경우 `T` 수요일의 경우 `W` 목요일의 경우 `H` 금요일의 경우 `F` 토요일의 경우 `S` 일요일의 경우 `U` 모든 문자 조합을 사용할 수 있습니다.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates	0..1	CheckoutDates	체크아웃 시점을 정의하는 하나 이상의 기간에 대한 컨테이너입니다. 가 발생해야 요율 수정이 적용됩니다.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange	1..99	DateRange	요금에 대한 체크아웃이 발생해야 하는 시기를 지정하는 날짜 범위 있습니다. 이 요소는 하나 이상의 비율 수정을 삭제합니다.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @start	0..1	Date	(숙박 시설의 시간대를 기준으로 함) 시작일 확인할 수 있습니다 이 날짜는 `end` 날짜입니다. `start`를 지정하지 않으면 날짜 기간은 시작일 측면에서 사실상 무제한입니다.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @end	0..1	Date	기간을 설정할 수 있습니다. 이 날짜는 `start` 날짜입니다. `end`를 지정하지 않으면 날짜 종료일은 사실상 무제한입니다.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @days_of_week	0..1	string	기간에 허용되는 요일입니다. 그렇지 않은 경우 지정된 경우 기간 내의 모든 요일이 허용됩니다. 각 문자는 일을 지정합니다. 예: 'MTWHF' 지정 선택할 수 있습니다. 유효한 문자는 다음과 같습니다. 월요일 `M` 화요일의 경우 `T` 수요일의 경우 `W` 목요일의 경우 `H` 금요일의 경우 `F` 토요일의 경우 `S` 일요일의 경우 `U` 모든 문자 조합을 사용할 수 있습니다.
RateModifications / HotelRateModifications / ItineraryRateModification / Devices	0..1	Devices	에 적합한 사용자 기기를 나열하기 위한 컨테이너입니다. 요율 수정을 예로 들 수 있습니다. 지정된 경우 요금 수정은 사용자가 목록에 있는 기기 중 하나와 일치하면 적용됩니다. 지정하지 않으면 이렇게 해도 요금 수정의 적용이 제한되지는 않습니다.
RateModifications / HotelRateModifications / ItineraryRateModification / Devices / Device	1..3	Device	요금이 적용되는 한 가지 사용자 기기 유형을 정의합니다. 있습니다.
RateModifications / HotelRateModifications / ItineraryRateModification / Devices / Device / @type	1	enum	기기 유형입니다. 값은 `desktop`여야 합니다. `tablet` 또는 `mobile`입니다.
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions	1	ModificationActions	지정된 모든 조건에서 요금에 적용되는 작업입니다. 조건을 충족하는지 확인해야 합니다
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / PriceAdjustment	0..1	PriceAdjustment	`AmountBeforeTax` 및 지정된 승수별 `AmountAfterTax`
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / PriceAdjustment / @multiplier	1	float	`AmountBeforeTax` 및 `AmountAfterTax` 모두 곱하기만 하면 됩니다.
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / RateRule	0..1	RateRule	지정된 요금 규칙 ID를 적용하여 요금을 수정합니다.
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / RateRule / @id	1	string	이 ID는 요율을 요금 규칙 정의 파일. 참고: 이 입력란의 글자 수 제한은 40자(영문 기준)입니다. 각 요금은 하나의 요금 규칙과만 연결할 수 있습니다. 요금 규칙 ID를 적용하는 수정사항이 여러 개인 경우 사전순으로 가장 작은 요금 규칙 ID가 입니다. 이 ID가 요금 규칙 정의의 요금 규칙과 일치하지 않는 경우 파일이 없으면 부적격한 것으로 간주됩니다. 를 참조하세요. 이 도움말에서 다양한 특별 요금 UI에 관해 자세히 알아보세요. 치료합니다.
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable	0..1	Refundable	요금의 환불 가능 여부를 지정된 값으로 덮어씁니다. 속성을 설정할 때는 다음 사항에 유의하세요. 이 수정 작업을 수행하면 대상 요율의 환불 가능 채워진 필드뿐만 아니라 `available` 또는 `refundable_until_days`가 다음에 해당하는 경우 설정하지 않으면 요금이 환불 가능으로 표시되지 않습니다. `available`이 `0` 또는 `false`이면 다른 속성은 무시됩니다. 요금은 다른 속성 중 하나 또는 둘 다 설정되어 있더라도 환불이 가능합니다. `refundable_until_time`를 설정하는 것이 좋습니다. 그렇지 않은 경우 설정하면 가장 이른 시간 (자정)이 사용됩니다.
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable / @available	1	boolean	(필수) `1` 또는 `true`: 요율이 전체 refund; 그렇지 않으면 `0` 또는 `false`로 설정합니다.
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days	0..1	integer	(필요한 경우 `available`는 `true`임) 지정 체크인 전 전액 환불이 가능한 기간(일) 있습니다. `refundable_until_days`의 값 0 이상, 330 이하의 정수여야 합니다.
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable / @refundable_until_time	0..1	Time	(`available`가 `true`인 경우 권장됨) 지정 호텔의 현지 시간으로 하루 중 가장 늦은 시간 환불 요청이 인정됩니다. 이 기능은 지정할 `refundable_until_days`, 예를 들어 '환불은 2일 전 오후 4시까지 가능합니다. 확인합니다. `refundable_until_time`가 설정되지 않은 경우 값은 기본값은 자정입니다.
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Availability	0..1	Availability	요금의 이용 가능 여부를 지정된 값으로 덮어씁니다. 요율은 `unavailable`로만 설정할 수 있습니다.
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Availability / @status	1	enum	`status="unavailable"`인 경우 요금이 처리됩니다. 해당 제품에 유효한 가격이 존재하는지 여부와 관계없이 있습니다.
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay	0..1	LengthOfStay	이 요금 수정이 가능한 숙박 기간 한도를 정의합니다. 적용됩니다. 숙박 기간이 다음과 같은 경우 요금 수정이 적용되지 않습니다. 최소 및 최대 한도를 벗어납니다.
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay / @min	0..1	integer	요금을 수정할 수 있는 최소 숙박 일수입니다. 적용됩니다. 지정되지 않으면 최솟값이 없습니다.
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay / @max	0..1	integer	요금을 수정할 수 있는 숙박 기간의 최대 숙박 일수입니다. 적용됩니다. 지정되지 않으면 최댓값이 없습니다.
RateModifications / HotelRateModifications / ItineraryRateModification / MinimumAmount	0..1	MinimumAmount	일일 객실 요금의 최소 합계를 지정합니다( `AmountBeforeTax` 또는 `AmountAfterTax`)이 있어야 합니다. 초과되어야 합니다.
RateModifications / HotelRateModifications / ItineraryRateModification / MinimumAmount / @before_discount	1	integer	요율 수정을 위해 초과해야 하는 값입니다. 적용됩니다.
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans	0..1	RatePlans	요금을 수정할 요금제 목록의 컨테이너 적용됩니다. `<RatePlans>`를 지정하지 않으면 요율이 모든 요금제에 적용됩니다.
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans / RatePlan	1..n	RatePlan	요금제를 지정합니다. 요금제는 거래에 정의된 패키지, 요금, 예약 가능 여부 (숙박 시설 데이터), OTA_HotelRateAmountNotifRQ, OTA_HotelAvailNotifRQ 패키지 ID로 식별됩니다.
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans / RatePlan / @id	1	string	요금제의 고유 식별자입니다. 이 값은 `<PackageData>`의 PackageID 값 거래 (숙박 시설 데이터) 메시지 및 `RatePlanCode` 속성 양쪽에 `<StatusApplicationControl>` `<OTA_HotelRateAmountNotifRQ>` 및 `<OTA_HotelAvailNotifRQ>` 메시지 허용되는 최대 문자 수는 50자(영문 기준)입니다.
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes	0..1	RoomTypes	요금 수정이 적용되는 객실 유형 목록의 컨테이너입니다. 요율 수정은 각 `<RoomType>`에 적용됩니다. 지정합니다. `<RoomTypes>`를 지정하지 않으면 요금 수정이 모든 객실에 적용됩니다.
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType	1..n	RoomType	방 유형을 지정합니다. 객실 유형은 다음의 `<RoomData>` 요소 트랜잭션 (숙박 시설 데이터) 메시지에 포함되어 있으며 `<RoomID>` 값을 사용하여 참조됩니다. ( `<RoomID>` 값은 OTA_HotelRateAmountNotifRQ의 `InvTypeCode` 속성 messages.)
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType / @id	1	string	인벤토리의 고유 식별자입니다 (방 유형). 이 값은 트랜잭션 (숙박 시설 데이터) 메시지에서 `<RoomID>`로 전송됩니다. 허용되는 최대 문자 수는 50자(영문 기준)입니다.
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates	0..1	StayDates	하나 이상의 기간에 대한 컨테이너입니다. 시즌별 가격을 수용하기 위해 요금 수정이 적용됩니다.
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / @application	1	enum	요금 수정이 적용되는 방식을 설명합니다. 유효한 값은 다음과 같습니다. `all`: 각 숙박 시설에 요금 수정을 적용합니다. 숙박 일정의 모든 날짜가 겹치는 경우 숙박 일정 숙박 날짜도 함께 표시됩니다 `any`: 다음 날짜의 모든 숙박 시설에 요금 수정을 적용합니다. 숙박 일정의 날짜가 확인할 수 있습니다 이 속성은 항상 지정해야 합니다.
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange	1..99	DateRange	요금을 수정할 날짜를 지정하는 기간 적용됩니다.
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @start	0..1	Date	(숙박 시설의 시간대를 기준으로 함) 시작일 확인할 수 있습니다 이 날짜는 `end` 날짜입니다. `start`를 지정하지 않으면 날짜 기간은 시작일 측면에서 사실상 무제한입니다.
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @end	0..1	Date	기간을 설정할 수 있습니다. 이 날짜는 `start`과(와) 같거나 그 이후여야 합니다. 있습니다. `end`를 지정하지 않으면 날짜 종료일은 사실상 무제한입니다.
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @days_of_week	0..1	string	기간에 허용되는 요일입니다. 그렇지 않은 경우 지정된 경우 기간 내의 모든 요일이 허용됩니다. 각 문자는 일을 지정합니다. 예: 'MTWHF' 지정 선택할 수 있습니다. 유효한 문자는 다음과 같습니다. 월요일 `M` 화요일의 경우 `T` 수요일의 경우 `W` 목요일의 경우 `H` 금요일의 경우 `F` 토요일의 경우 `S` 일요일의 경우 `U` 모든 문자 조합을 사용할 수 있습니다.
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries	0..1	UserCountries	지정하면 사용자가 지정된 국가 중 하나에 거주 지정하지 않으면 요율이 사용자의 위치에 관계없이 수정이 적용됩니다.
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / @type	0..1	enum	사용자 국가 사양의 유형입니다. 유효한 값은 `include` 및 `exclude`입니다. 사용자 국가 `type`가 다음과 같이 설정된 경우 `include`인 경우 요금 수정이 사용자가 포함됩니다. 사용자 국가 `type`가 `exclude`인 경우 요율 수정이 나열된 국가 외의 사용자에게 적용됩니다. 사용자 국가 `type`가 설정되지 않은 경우 다음과 같이 처리됩니다. `include` 및 요금 수정 은 나열된 국가의 사용자에게 적용됩니다.
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / Country	1..300	Country	요금을 수정할 수 있는 사용자 국가를 지정합니다.
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / Country / @code	1	string	CLDR 국가 코드 (예: `DE`, `FR`) 일부의 경우 CLDR 국가 코드는 2자리 ISO와 다릅니다. 국가 코드. 또한 CLDR 리전 코드도 지원되지 않습니다.

예

기본 메시지

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

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-07-01" end="2023-07-31" days_of_week="MTWHF"/>
         <DateRange start="2023-09-01" end="2023-09-30"/>
      </BookingDates>
      <BookingWindow min="7" max="330"/>
      <CheckinDates>
         <DateRange start="2023-10-01" end="2023-10-31" days_of_week="FSU"/>
      </CheckinDates>
      <CheckoutDates>
         <DateRange start="2023-10-08" end="2023-11-07" days_of_week="FSU"/>
      </CheckoutDates>
      <Devices>
        <Device type="mobile"/>
        <Device type="tablet"/>
      </Devices>
      <LengthOfStay min="2" max="14"/>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <UserCountries>
        <Country code="US"/>
        <Country code="GB"/>
      </UserCountries>
      <ModificationActions>
        <PriceAdjustment multiplier="1.2"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

요금 수정 1개 삭제

다음 예시는 단일 요율표의 요금 수정 하나를 삭제하는 방법을 보여줍니다. 속성:

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1" action="delete"/>
  </HotelRateModifications>
</RateModifications>

모든 요금 수정사항 삭제

다음 예시는 단일 호출의 모든 요금 수정사항을 삭제하는 속성:

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1" action="overlay"/>
</RateModifications>

모든 요금 수정 오버레이

다음 예는 <HotelRateModifications>를 오버레이하는 방법을 보여줍니다. 속성을 하나 이상의 새로운 요금 수정이 있어야 합니다. 날짜 action="overlay", 다음 날짜 이전에 모든 저장 요금 수정사항이 삭제됩니다. 현재 메시지에 지정된 비율 수정을 저장합니다.

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1" action="overlay"/>
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-09-01" end="2023-09-30"/>
      </BookingDates>
      <ModificationActions>
        <PriceAdjustment multiplier="1.2"/>
      </ModificationActions>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

여러 수정 작업

다음 예는 여러 수정 작업을 실행하는 방법을 보여줍니다. 있습니다.

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-01-01" end="2023-02-28"/>
      </BookingDates>
      <ModificationActions>
        <PriceAdjustment multiplier=".95"/>
        <Refundable available="true"
                    refundable_until_days="1"
                    refundable_until_time="12:00:00"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

사용자 국가의 요금제 사용 중지

다음 예는 요금제를 일본어 (JP) 사용자:

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <RatePlans>
         <RatePlan id="jp_only"/>
      </RatePlans>
      <UserCountries type="exclude">
        <Country code="JP"/>
      </UserCountries>
      <ModificationActions>
        <Availability status="unavailable"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

대답

구문

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

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

요소 및 속성

RateModificationsResponse 메시지에는 다음이 포함됩니다. 요소 및 속성:

요소 / @Attribute	발생 횟수	유형	설명
RateModifications	1	Complex element	수신된 RateModifications 요청 메시지입니다.
RateModificationsResponse / @timestamp	1	DateTime	이 메시지를 작성한 날짜 및 시간입니다.
RateModificationsResponse / @id	1	string	연결된 RateModifications 메시지의 고유 식별자입니다.
RateModificationsResponse / @partner	1	string	이 메시지의 파트너 계정입니다.
RateModificationsResponse / Success	0..1	Success	RateModifications 메시지가 성공적으로 처리되었음을 나타냅니다. 알림을 받아볼 수 있습니다 `<Success>` 또는 `<Issues>`가 표시됩니다.
RateModificationsResponse / Issues	0..1	Issues	처리 중에 발생한 하나 이상의 문제에 대한 컨테이너입니다. RateModifications 메시지를 확인할 수 있습니다. `<Success>` 또는 `<Issues>`가 표시됩니다.
RateModificationsResponse / Issues / Issue	1..n	Issue	해당 기간 동안 발생한 경고, 오류 또는 실패에 대한 설명 RateModifications 메시지를 처리합니다. 이러한 문제에 대한 세부정보는 피드 상태 오류 메시지로 이동합니다.
RateModificationsResponse / Issues / Issue / @code	1	integer	문제의 식별자입니다.
RateModificationsResponse / Issues / Issue / @status	1	enum	발생한 문제의 유형입니다. 유효한 값은 `warning`, `error`, `failure`입니다.

예

성공

다음은 성공적으로 처리된 RateModifications에 대한 응답입니다. 메시지가 표시됩니다.

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

문제

다음은 처리되지 않은 RateModifications 메시지에 대한 응답입니다. 발생할 수 있습니다.

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