OTA_HotelRateAmountNotifRQ

요청

구문

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

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="message_ID"
                            TimeStamp="timestamp"
                            Version="3.0"
                            NotifType="[Overlay|Delta|Remove]"
                            NotifScopeType="[ProductRate]">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID"
                                RatePlanType="[26]" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="float"
                            AmountAfterTax="float"
                            CurrencyCode="currency"
                            NumberOfGuests="integer"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="float"
                                   AgeQualifyingCode="[10|8]"
                                   MaxAge="integer"/>
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

요소 및 속성

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

요소 / @Attribute 발생 횟수 유형 설명
OTA_HotelRateAmountNotifRQ 1 Complex element 요금 메시지의 루트 요소입니다.
OTA_HotelRateAmountNotifRQ / @xmlns 0..1 string (URI) XML 네임스페이스입니다.
OTA_HotelRateAmountNotifRQ / @EchoToken 1 string 이 요청 메시지의 고유 식별자입니다. 이 값이 반환됩니다. 을 입력합니다. 허용되는 문자는 a-z, A-Z, 0-9, _ (underscore), - (dash)입니다.
OTA_HotelRateAmountNotifRQ / @TimeStamp 1 DateTime 이 메시지를 작성한 날짜 및 시간입니다.
OTA_HotelRateAmountNotifRQ / @Version 1 decimal OpenTravel 메시지 버전입니다.
OTA_HotelRateAmountNotifRQ / @NotifType 0..1 enum

<RateAmountMessage>

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

이러한 속성의 작동 방식을 알아보려면 예시

  • Overlay: 다음을 모두 삭제 객실 유형, 요금제, 날짜에 따른 숙박 인원당 요금 <StatusApplicationControl> 및 새 요율로 교체하세요
  • Remove: 기존 항목을 모두 삭제 객실 유형, 요금제, 날짜에 따른 숙박 인원당 요금 <StatusApplicationControl>에 지정됩니다.
  • Delta: (NotifType인 경우 기본값) 지정되지 않음) 객실 유형, 요금제, 날짜 <StatusApplicationControl>입니다.
OTA_HotelRateAmountNotifRQ / @NotifScopeType 0..1 enum

각 항목에 적용할 NotifType의 범위입니다. <RateAmountMessage>입니다.

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

  • ProductRate: (NotifScopeType인 경우 기본값) 지정되지 않음) NotifType는 제품 - 객실 유형 조합 (InvTypeCode개) 및 요금제 (RatePlanCode)를 방문하세요.
OTA_HotelRateAmountNotifRQ / POS 0..1 POS 이 메시지의 파트너 계정을 지정하기 위한 컨테이너입니다. (일반적으로 백엔드에서 가격 피드를 제공하는 경우 여러 파트너 계정)
OTA_HotelRateAmountNotifRQ / POS / Source 1 Source <POS>가 있는 경우 필수입니다. 컨테이너는 <RequestorID>
OTA_HotelRateAmountNotifRQ / POS / RequestorID 1 RequestorID <POS>가 있는 경우 필수입니다. 파트너 정의 있습니다.
OTA_HotelRateAmountNotifRQ / POS / RequestorID / @ID 1 string 이 메시지의 파트너 계정입니다. 이 문자열 값은 '파트너 키' 값이 <ph type="x-smartling-placeholder"></ph> 계정 설정 페이지로 이동합니다.

참고: 여러 리소스에 대한 피드를 제공하는 백엔드가 있는 경우 계정의 경우 이 값은 partner과(와) 일치해야 합니다. 거래 (숙박 시설 데이터) 메시지의 속성 값과 ID 속성 값을 <RequestorID> 요소 동일한 메시지 <OTA_HotelAvailNotifRQ>개 있습니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages 1 RateAmountMessages 다음과 같은 <RateAmountMessage> 요소의 컬렉션입니다. 요율을 정의합니다
OTA_HotelRateAmountNotifRQ / RateAmountMessages / @HotelCode 1 string 숙박 시설의 고유 식별자입니다. 이 값은 <id>를 사용하여 지정한 호텔 ID 인치 호텔의 <listing> 요소 피드 나열 호텔 ID는 Hotel Center에도 표시됩니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage 1..n RateAmountMessage 객실 요금 (객실 유형 및 요금)의 가격을 설정하기 위한 컨테이너입니다. 계획 조합)을 사용할 수도 있습니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl 1 StatusApplicationControl 기간 및 객실 유형의 식별자를 정의합니다. (InvTypeCode) 및 요금제 (RatePlanCode)
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Start 1 Date (숙박 시설의 시간대를 기준으로 함) 시작일 확인할 수 있습니다
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @End 1 Date 기간을 설정할 수 있습니다. start 값 이상이어야 합니다. start와 end가 같으면 업데이트가 적용됩니다. 할 수 있습니다. Google에서는 최대 3년간의 데이터를 지원합니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Mon 0..1 boolean 명시적으로 포함하려면 true 또는 1로 설정하세요. 월요일

true(으)로 설정하면 일정이 아닌 다른 요일 명시적으로 true로 설정된 키워드는 제외됩니다. Start 내의 날짜에서 필터링되었으며 End)을 입력합니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Tue 0..1 boolean 명시적으로 포함하려면 true 또는 1로 설정하세요. 매주 화요일

true(으)로 설정하면 일정이 아닌 다른 요일 명시적으로 true로 설정된 키워드는 제외됩니다. Start 내의 날짜에서 필터링되었으며 End)을 입력합니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Weds 0..1 boolean 명시적으로 포함하려면 true 또는 1로 설정하세요. 수요일

true(으)로 설정하면 일정이 아닌 다른 요일 명시적으로 true로 설정된 키워드는 제외됩니다. Start 내의 날짜에서 필터링되었으며 End)을 입력합니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Thur 0..1 boolean 명시적으로 포함하려면 true 또는 1로 설정하세요. 매주 목요일

true(으)로 설정하면 일정이 아닌 다른 요일 명시적으로 true로 설정된 키워드는 제외됩니다. Start 내의 날짜에서 필터링되었으며 End)을 입력합니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Fri 0..1 boolean 명시적으로 포함하려면 true 또는 1로 설정하세요. 금요일

true(으)로 설정하면 일정이 아닌 다른 요일 명시적으로 true로 설정된 키워드는 제외됩니다. Start 내의 날짜에서 필터링되었으며 End)을 입력합니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sat 0..1 boolean 명시적으로 포함하려면 true 또는 1로 설정하세요. 토요일.

true(으)로 설정하면 일정이 아닌 다른 요일 명시적으로 true로 설정된 키워드는 제외됩니다. Start 내의 날짜에서 필터링되었으며 End)을 입력합니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sun 0..1 boolean 명시적으로 포함하려면 true 또는 1로 설정하세요. 일요일

true(으)로 설정하면 일정이 아닌 다른 요일 명시적으로 true로 설정된 키워드는 제외됩니다. Start 내의 날짜에서 필터링되었으며 End)을 입력합니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @InvTypeCode 1 string 인벤토리의 고유 식별자입니다 (방 유형). 이 값은 트랜잭션 (숙박 시설 데이터) 메시지에서 <RoomID>로 전송됩니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanCode 1 string 요금제의 고유 식별자입니다. 이 식별자는 거래 (숙박 시설 데이터)에서의 <PackageID> 메시지가 표시됩니다. 요금제가 추가로 정의되고 참조됨 둘 다 <StatusApplicationControl>에서 <OTA_HotelRateAmountNotifRQ> 및 <OTA_HotelAvailNotifRQ> 메시지
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanType 0..1 string ARI 가격 모델의 유형을 나타내는 이 가격 업데이트에 적용됩니다 이것은 값 26(LOS 기반 가격 책정 모델을 사용하는 경우) 제외 이 속성이 날짜별 가격임을 나타냅니다. 업데이트.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates 0..1 Rates <Rate> 요소 컬렉션의 컨테이너입니다. 만약 NotifType이(가) "Remove"이며 이 요소는 허용되지 않습니다. 지정해야 합니다. 그렇지 않으면 이 요소를 정확히 한 번만 지정해야 합니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate 1 Rate <BaseByGuestAmts> 컬렉션의 컨테이너 요소
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @RateTimeUnit 0..1 String 숙박 기간이 지정되는 단위입니다. 유일하게 지원되는 값은 "Day"이며, 이는 숙박 기간이 다음과 같음을 의미합니다. 일 단위로 지정됩니다.

LOS 기반 가격 책정을 사용하려면 다음 안내를 따르세요. RateTimeUnit 및 UnitMultiplier는 다음과 같아야 합니다. 지정합니다. 그 외의 경우에는 둘 다 지정하지 않아야 합니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @UnitMultiplier 0..1 Integer 길이를 구성하는 RateTimeUnits의 수 숙박하실 수 있습니다.

예를 들어 RateTimeUnits 값이 "Day"인 경우 5개 중 UnitMultiplier는 지정된 요율을 나타냅니다. 이 Rate 객체 아래에서 5박 숙박 중 1박에 적용됩니다.

이 Rate에 지정된 점유율입니다. 객체에는 UnitMultiplier가 곱해집니다. 총 숙박 일수를 계산할 수 있습니다.

LOS 기반 가격 책정을 사용하려면 다음 안내를 따르세요. RateTimeUnit 및 UnitMultiplier는 다음과 같아야 합니다. 지정합니다. 그 외의 경우에는 둘 다 지정하지 않아야 합니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts 1 BaseByGuestAmts 기본 요금 모음의 컨테이너입니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt 1..n BaseByGuestAmt 지정된 통화로 객실 가격을 지정합니다. 가격은 여러 <BaseByGuestAmt> 사용 시 숙박 인원당 요소(NumberOfGuests에 대해 각각 다른 값을 가짐) 그 외의 경우 가격은 최대 숙박 인원 수에 적용됩니다. NumberOfGuests에 의해 정의됨.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountBeforeTax 0..1 float

세금 및 수수료를 제외한 객실 요금의 일일 가격입니다.

AmountBeforeTax 및 AmountAfterTax를 지정할 수 있습니다. 만약 AmountBeforeTax가 지정되지 않은 경우 AmountAfterTax을(를) 지정해야 합니다. 만약 AmountBeforeTax가 지정되고 AmountAfterTax을(를) 지정하지 않으면 세금 및 수수료가 청구됩니다. <TaxFeeInfo> 메시지에 지정해야 합니다.

프로모션을 사용하는 경우 AmountBeforeTax에 할인이 적용됩니다. 비율 AmountAfterTax 할인도 적용됩니다. 이후 일부 과세 구조에는 적용되지 않으므로 여기에서 AmountBeforeTax를 지정하고 <TaxFeeInfo>: 세금 및 수수료를 지정합니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountAfterTax 0..1 float 관련 세금 및 있습니다. AmountAfterTax가 지정된 경우 속성별로 구분 메시지 <TaxFeeInfo>개를 전송할 필요가 없습니다. 이 속성은 AmountBeforeTax와 함께 사용할 수 있습니다. 을(를) 사용하여 특정 리전으로 지정할 수 있습니다

경고: 프로모션을 사용하는 경우 AmountAfterTax 사용 바람직하지 않음 있습니다. 할인을 사용하려면 다음 날짜까지 세금 및 수수료를 지정하세요. <TaxFeeInfo> 메시지 사용 할인은 다음과 같이 적용됩니다. 이후 AmountBeforeTax 금액에 적용됩니다.

참고: AmountBeforeTax 가 지정되지 않으면 AmountAfterTax을 지정해야 합니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @CurrencyCode 1 enum 특정 통화 단위의 ISO 4217 (3) 알파 문자 코드입니다.

자세한 내용은 지원되는 통화).
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @NumberOfGuests 0..1 integer 이 요금으로 수용할 수 있는 최대 투숙객 수입니다. 투숙객 2명이 제공되지 않을 경우 기본값은 2명입니다.

<AdditionalGuestAmounts>가 아동에 대한 요금이 포함되어 있음, NumberOfGuests에 대한 요금만 청구함 성인 대상입니다. <AdditionalGuestAmounts>인 경우 지정되지 않았거나 아동에 대한 요금이 포함되어 있지 않은 경우 NumberOfGuests는 총 숙박 인원 수를 나타냅니다. 여기에는 성인과 아동 모두 포함됩니다.

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts 0..1 AdditionalGuestAmounts 추가 투숙객에 대한 요금 모음의 컨테이너입니다.

이 구문은 추가 투숙객 또는 어린이 요금 자동으로 변경됩니다. 보다 효율적인 ExtraGuestCharges 메시지가 표시됩니다(금액을 속성에서 정적으로 정의할 수 있는 경우). 있습니다.

추가 투숙객 금액은 다음과 같이 적용됩니다.
  • 요금은 기본 숙박 인원 요금에 추가로 적용됩니다. 기본 좌석 점유율은 <BaseByGuestAmts> 작거나 같음 사용자 검색의 성인 수
  • 추천은 사용자 검색에서 숙박 인원이 최대 24시간이 필요합니다.
  • <AdditionalGuestAmounts> 항상 바꾸기 이전에 지정한 추가 금액을 새 금액으로 NotifType는 델타 또는 오버레이입니다.
  • <AdditionalGuestAmounts>이(가) 전송될 수 있음 NotifType이(가) 다음인 경우에만 기본 요율과 관계없이 델타. <BaseByGuestAmts>를 지정해야 합니다. NotifType이 Overlay일 때.
  • 다음이 포함된 빈 <AdditionalGuestAmounts> 요소 NotifType을(를) Delta(으)로 설정하면 기존 기본 요율에 영향을 주지 않고 금액을 추가할 수 있습니다.
  • 통화는 <BaseByGuestAmt>

예를 들어 기본 요율이 1과 2로 지정되었다고 가정해 보겠습니다. 있습니다.

  • 사용자가 성인 3명을 검색하면 숙박 인원 2인 요금은 기본 요금으로 선택할 수 있으며, 1인에 숙박할 경우 추가 투숙객 요금이 그 위에 성인이 적용됩니다.
  • 사용자가 성인 1명과 어린이 2명을 검색하면 좌석 요금이 기본 요금으로 선택된 후 금액이 더해 두 아이에 대해 적용됩니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount 0..n AdditionalGuestAmount 투숙객 유형에 따라 가격을 지정하며 AgeQualifyingCode 및 해당하는 경우 투숙객의 연령 MaxAge를 통해 지정됩니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @AgeQualifyingCode 1 enum 추가 투숙객의 유형(성인 또는 어린이)을 정의합니다. 유효함 옵션은 다음과 같습니다.
  • 10: 성인.
  • 8: 하위.

AgeQualifyingCode을(를) 10(으)로 설정할 수 있습니다. 최대 1개의 AdditionalGuestAmount 요소가 있어야 합니다.

다음 경우에 MaxAge를 지정해야 합니다. 현재 AgeQualifyingCode이(가) 8입니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @MaxAge 0..1 integer 다음 경우에 MaxAge를 지정해야 합니다. 현재 AgeQualifyingCode이(가) 8입니다. 허용되지 않습니다. AgeQualifyingCode이 10일 때 지정됩니다.

MaxAge은(는) 0에서 사이의 정수여야 합니다. <ph type="x-smartling-placeholder">17.</ph>

값을 0로 지정하면 하위 숙박자가 사용 중지됩니다.

17보다 큰 값은 최댓값으로 처리됩니다. 허용되는 17 값입니다.

여러 개의 어린이 연령대는 별도의 AdditionalGuestAmount 요소. 연령대는 다음과 같아야 합니다. 서로 겹치지 않아야 합니다.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @Amount 1 float 각 항목의 기본 요금에 세전 금액 및 수수료를 더한 금액 추가 투숙객.

숙박자에 따른 세금 및 수수료 연령은 <AgeBrackets> 요소 <TaxFeeInfo> 메시지

예

이 섹션에서는 다음을 수행하는 방법을 강조하는 코드 예를 제공합니다.

add, overlay 또는 remove 값을 설정하면 기간을 같거나 다를 수 있습니다 예를 들어 overlay - 12월 휴일을 몇 주 동안만 '요금 추가'에 설정된 전체 범위가 메시지가 표시됩니다. 이렇게 하면 숙박 인원이 대체됩니다. 확인할 수 있습니다.

날짜별 가격 책정

객실 및 요금제당 숙박 인원은 최대 50명일 수 있습니다. 속성 모든 숙박 인원의 요금이 동일한 경우 필요한 가격으로 최대 숙박 인원을 예약할 수 있습니다. 이를 통해 Google은 숙박 인원이 적은 경우에도 동일한 기본 요금이 적용됩니다.

기본 요율 및 총 요율 설정

예시 1

기본 숙박 인원 (2배)의 기본 요금 (세금 또는 수수료 제외)입니다. 이 속성 모델, 세금, 수수료는 <TaxFeeInfo> 메시지가 표시됩니다. 기본 요율은 특정 지역에서 검색하는 사용자에게 광고가 눈에 더 잘 띄도록 할 수 있습니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

예 2

기본 숙박 인원 (2배)의 기본 및 총 요금입니다. 이 모델에서는 세금이 수수료는 <TaxFeeInfo>를 사용하여 별도로 정의해서는 안 됩니다. 메시지를 보낼 수 있습니다 기본 요금이 가장 높은 위치에서 검색되는 사용자에게 특정 리전으로 지정할 수 있습니다

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            AmountAfterTax="110.00"
                            CurrencyCode="USD"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

예시 3

여러 숙박 인원의 총 요금 (세금 및 수수료 포함) 이 모델에서는 세금 및 수수료는 <TaxFeeInfo>를 사용하여 별도로 정의하면 안 됩니다. 메시지를 보낼 수 있습니다

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountAfterTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountAfterTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
            <BaseByGuestAmt AmountAfterTax="120.00"
                            CurrencyCode="USD"
                            NumberOfGuests="3"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

예 4

여러 객실 유형 및 요금제의 기본 및 총 요금 기간을 설정할 수 있습니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            AmountAfterTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-01"
                                End="2020-05-31"
                                InvTypeCode="RoomID_2"
                                RatePlanCode="PackageID_2"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            AmountAfterTax="220.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
요금 추가, 오버레이, 삭제

제품은 객실 유형 및 패키지 등 5,000개로 제한됩니다. 조합할 수 있습니다. Overlay 또는 Remove 알림 사용 유형을 사용하는 것이 좋습니다.

요금 추가

숙박 인원당 요금을 추가하려면 NotifType을(를) Delta(으)로 설정하세요. 2021년 10월 20일부터 2021년 12월 31일 사이에 RoomID_1 및 PackageID_1 참고: Google은 최대 3년간의 데이터를 지원합니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountBeforeTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
            <BaseByGuestAmt AmountBeforeTax="120.00"
                            CurrencyCode="USD"
                            NumberOfGuests="3"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

오버레이 비율

숙박 인원당 모든 인원을 삭제하려면 NotifType를 Overlay로 설정하세요. 2021년 10월 20일부터 2021년 12월 31일까지 RoomID_1 및 PackageID_1 요금 새로 지정된 숙박 인원당 요금으로 바꿉니다.

예를 들어 이 메시지가 '요금 추가' 메시지가 표시되면 숙박 인원 1, 2, 3의 요금이 삭제되고 새로운 숙박 인원 1만 요율이 저장됩니다. 기간을 더 짧게 설정할 수도 있습니다. (예: 2021년 12월 20일 및 2021년 12월 31일)을 통해 일부 숙박 인원만 대체했습니다. 특정 날짜의 요금(예: 휴일) 

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

요금 삭제

숙박 인원당 모든 인원을 삭제하려면 NotifType를 Remove로 설정하세요. 2021년 10월 20일부터 2021년 12월 31일까지 RoomID_1 및 PackageID_1 요금에 관한 요금 청구

예를 들어 이 메시지가 메시지, 점유율은 저장되지 않습니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">>
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
추가 투숙객 금액 추가, 오버레이, 삭제

금액 추가

NotifType을(를) Delta(으)로 설정하여 기본 요율을 추가하세요. 숙박 인원 1, 2, 추가 투숙객 수 PackageID_1(2021년 10월 20일~2021년 12월 31일)

기본 요금에 추가 투숙객 금액이 적용되어 사용자 검색에서 점유율에 따라 결정될 수 있습니다. 사용자가 숙박 인원은 RoomID_1의 수용 인원 이내여야 합니다.

이 예에서 추가 투숙객 금액은 다음과 같이 적용됩니다.

  • 만 0~10세 어린이의 경우 5달러 (포함)입니다.
  • 만 11~17세 어린이의 경우 10달러 (포함)
  • 성인은 20달러입니다.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountBeforeTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="5.00" AgeQualifyingCode="8" MaxAge="10" />
            <AdditionalGuestAmount Amount="10.00" AgeQualifyingCode="8" MaxAge="17" />
            <AdditionalGuestAmount Amount="20.00" AgeQualifyingCode="10" />
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

오버레이 분량

숙박 인원당 모든 인원을 삭제하려면 NotifType를 Overlay로 설정하세요. RoomID_1 및 PackageID_1의 요금 및 모든 추가 투숙객 금액 2021년 10월 20일부터 2021년 12월 31일까지 지정된 숙박 인원당 요금 및 추가 금액이 있습니다.

예를 들어 이 메시지가 '요금 추가' 메시지가 표시되면 기본 숙박 인원 1 및 2 요금이 삭제되고 새로운 기본 요금만 숙박 인원 1의 요금이 저장됩니다. 이전의 추가 게스트 세트 금액이 삭제되고 새로운 금액 집합만 저장됩니다. 이제 추가 투숙객 수에는 새로운 숙박 인원 1 요금이 기본 요율로 설정합니다. 이번 업데이트 이후에는 어린이에 대해 정의된 요금 

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="30.00" AgeQualifyingCode="10" />
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

금액 삭제

숙박 인원당 모든 인원을 삭제하려면 NotifType를 Delete로 설정하세요. RoomID_1 및 PackageID_1의 기본 요금, 모든 추가 투숙객 금액 2021년 10월 20일부터 2021년 12월 31일까지입니다.

예를 들어 이 메시지가 숙박 인원당 기본 요금 없음, 추가 투숙객 금액 없음 저장할 수 있습니다

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">>
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

추가 투숙객 수만 삭제

NotifType를 빈 값을 사용하여 Delta로 설정합니다. <AdditionalGuestAmounts>개 요소로 모두 삭제 추가 투숙객 수에 영향을 주지 않고 RoomID_1 및 PackageID_1 기본 요율을 적용합니다.

예를 들어 이 메시지가 메시지를 보내면 기본 금액만 저장됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <AdditionalGuestAmounts/>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

LOS 기반 가격 책정

LOS 기반 세율 설정

예시 1

2020년 5월 18일부터 1박, 2박, 3박 숙박에 대한 요금을 설정합니다. 이 이 예에서 1박, 2박, 3박 총 요금은 100달러입니다. 각각 $180, $240입니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="1" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
        <Rate UnitMultiplier="2" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="90.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
LOS 기반 요율 추가, 오버레이, 삭제

숙박 기간 추가

LOS 기반 가격 책정을 사용하면 Delta 작업을 통해 요금을 다음과 같이 설정할 수 있습니다. ( <StatusApplicationControl> 및 모든 숙박 기간 각 하위 Rate 요소의 UnitMultiplier입니다.

해당하는 체크인 날짜 및 숙박 기간에 따라 모든 숙박 인원 요율을 지정해야 합니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

오버레이 숙박 기간

LOS 기반 가격 책정을 사용하면 Overlay 작업 모든 제품 숙박 기간 및 체크인 날짜에 대한 요금을 대체합니다. 범위(<StatusApplicationControl>에 표시됨)

이 메시지를 통해 지정된 도착 날짜가 삭제되고 2인실로 대체됩니다. 요금입니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

숙박 기간 삭제

LOS 기반 가격 책정을 사용하면 Remove 작업이 요율을 삭제합니다. <StatusApplicationControl>입니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

대답

구문

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

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                            TimeStamp="timestamp"
                            EchoToken="echo_token"
                            Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelRateAmountNotifRS>

요소 및 속성

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

요소 / @Attribute 발생 횟수 유형 설명
OTA_HotelRateAmountNotifRS 1 Complex element 참석 여부 메시지에 대한 응답의 루트 요소입니다.
OTA_HotelRateAmountNotifRS / @TimeStamp 1 DateTime 이 메시지를 작성한 날짜 및 시간입니다.
OTA_HotelRateAmountNotifRS / @EchoToken 1 string 연결된 OTA_HotelRateAmountNotifRQ 메시지가 표시됩니다.
OTA_HotelRateAmountNotifRS / Success 0..1 Success OTA_HotelRateAmountNotifRQ 메시지가 처리할 수 있습니다.

<Success> 또는 <Errors>가 표시됩니다.
OTA_HotelRateAmountNotifRS / Errors 0..1 Errors 처리 중에 발생한 하나 이상의 문제에 대한 컨테이너입니다. OTA_HotelRateAmountNotifRQ 메시지가 표시됩니다.

<Success> 또는 <Errors>가 표시됩니다.
OTA_HotelRateAmountNotifRS / Errors / Error 1..n Error 처리 중 발생한 오류에 대한 설명입니다. OTA_HotelRateAmountNotifRQ 메시지가 표시됩니다. 관련 세부정보 오류는 피드 상태 오류 메시지에서 확인할 수 있습니다.
OTA_HotelRateAmountNotifRS / Errors / Error / @Type 1 integer 관련 OpenTravel Alliance EWT (오류 경고 유형)는 오류가 발생했습니다. 12 (Processing exception) 값만 사용됩니다.
OTA_HotelRateAmountNotifRS / Errors / Error / @Code 1 integer 오류와 관련된 OpenTravel Alliance ERR (오류 코드)입니다. 450 (Unable to process) 값만 사용됩니다.
OTA_HotelRateAmountNotifRS / Errors / Error / @Code 1 enum 원래 요청의 상태입니다. 값만 NotProcessed가 사용됩니다.
OTA_HotelRateAmountNotifRS / Errors / Error / @ShortText 1 string 문제의 Google 식별자입니다. 이러한 오류에 대한 세부정보는 피드 상태 오류 메시지에서 찾을 수 있습니다.

예

성공

다음은 성공적으로 처리된 OTA_HotelRateAmountNotifRQ 메시지로 응답합니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2021-10-20T20:50:37-05:00"
                       Version="3.0">
  <Success/>
</OTA_HotelRateAmountNotifRS>

오류

다음은 OTA_HotelRateAmountNotifRQ 메시지에 대한 응답입니다. 처리할 수 없습니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2021-10-20T20:50:37-05:00"
                       Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelRateAmountNotifRS>