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

세금 수수료

요청

구문

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

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="timestamp"
            id="message_ID"
            partner="partner_key">
  <Property action="[overlay]">
    <ID>HotelID</ID>
    <Taxes>
      <Tax>
        <RoomTypes>
          <RoomType id="RoomID_1"/>
          <RoomType id="RoomID_2"/>
        </RoomTypes>
        <RatePlans>
          <RatePlan id="PackageID_1"/>
          <RatePlan id="PackageID_2"/>
        </RatePlans>
        <BookingDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </BookingDates>
        <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>
        <StayDates application="[all|any|overlap]">
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </StayDates>
        <Type>[percent|amount|cumulative_percent]</Type>
        <Basis>[room|person]</Basis>
        <Period>[stay|night]</Period>
        <Currency>currency_code</Currency>
        <Amount>tax_amount</Amount>
        <ApplicableNights max="integer" excluded="integer"/>
        <LengthOfStay min="integer" max="integer"/>
        <!-- Use either <Amount> or <Brackets> -->
        <Brackets base_amount="tax_amount"/>
          <Bracket starts_at="nightly_rate" amount="tax_amount"/>
        </Brackets>
        <AgeBrackets>
          <AdultCharge amount="tax_amount"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="max_age" amount="tax_amount"/>
          </ChildAgeBrackets>
        </AgeBrackets>
        <UserCountries type="[include|exclude]">
          <Country code="country_code1"/>
          <Country code="country_code2"/>
        </UserCountries>
        <Rank>integer</Rank>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <RoomTypes>
          <RoomType id="RoomID_1"/>
          <RoomType id="RoomID_2"/>
        </RoomTypes>
        <RatePlans>
          <RatePlan id="PackageID_1"/>
          <RatePlan id="PackageID_2"/>
        </RatePlans>
        <BookingDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </BookingDates>
        <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>
        <StayDates application="[all|any|overlap]">
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </StayDates>
        <Type>[percent|amount|cumulative_percent]</Type>
        <Basis>[room|person]</Basis>
        <Period>[stay|night]</Period>
        <Currency>currency_code</Currency>
        <Amount>fee_amount</Amount>
        <ApplicableNights max="integer" excluded="integer"/>
        <LengthOfStay min="integer" max="integer"/>
        <!-- Use either <Amount> or <Brackets> -->
        <Brackets base_amount="tax_amount"/>
          <Bracket starts_at="nightly_rate" amount="tax_amount"/>
        </Brackets>
        <AgeBrackets>
          <AdultCharge amount="tax_amount"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="max_age" amount="tax_amount"/>
          </ChildAgeBrackets>
        </AgeBrackets>
        <UserCountries type="[include|exclude]">
          <Country code="country_code1"/>
          <Country code="country_code2"/>
        </UserCountries>
        <Rank>integer</Rank>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

요소 및 속성

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

요소 / @Attribute	발생 횟수	유형	설명
TaxFeeInfo	1	Complex element	단일 서비스에 대한 세금 및 수수료를 정의하는 메시지의 루트 요소입니다. 속성
TaxFeeInfo / @timestamp	1	DateTime	이 메시지를 작성한 날짜 및 시간입니다.
TaxFeeInfo / @id	1	string	이 요청 메시지의 고유 식별자입니다. 이 값이 반환됩니다. 을 입력합니다. 허용되는 문자는 `a-z`, `A-Z`님, `0-9`님, `_`님 (밑줄) 및 `-` (대시)가 있습니다.
TaxFeeInfo / @partner	1	string	이 메시지의 파트너 계정입니다. 이 문자열 값은 '파트너 키' 값이 <ph type="x-smartling-placeholder"></ph> 계정 설정 페이지로 이동합니다. 참고: 한 리소스에 대한 피드를 제공하는 백엔드가 있는 경우 계정이 여러 개인 경우 이 값은 `ID`와(과) 일치해야 합니다. `<RequestorID>`에 지정된 속성 값 `<OTA_HotelRateAmountNotifRQ>`의 요소 및 동일한 계정에 대해 `<OTA_HotelAvailNotifRQ>`개의 메시지가 있습니다.
TaxFeeInfo / Property	1..n	Property	단일 숙박 시설의 세금 및 수수료를 정의하는 컨테이너입니다.
TaxFeeInfo / Property / @action	0..1	string	업데이트가 적용되는 방식을 지정합니다. `overlay`만 지원되며 기본값은 `overlay`입니다. 모든 이전 이 속성의 `Taxes` 및 `Fees`은(는) 이 업데이트가 적용되기 전에 삭제되었습니다.
TaxFeeInfo / Property / ID	1	string	숙박 시설의 고유 식별자입니다. 이 값은 <id>를 사용하여 지정한 호텔 ID 인치 호텔의 <listing> 요소 피드 나열 호텔 ID는 Hotel Center에도 표시됩니다.
TaxFeeInfo / Property / Taxes	0..1	Taxes	하나 이상의 `<Tax>` 요소의 컨테이너입니다.
TaxFeeInfo / Property / Taxes / Tax	1..n	Tax	숙박 시설에 적용되는 개별 세금입니다.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes	0..1	RoomTypes	세금이 적용되는 객실 유형 목록의 컨테이너입니다. 세금이 각 `<RoomType>`에 적용됩니다. 지정합니다. `<RoomTypes>`를 지정하지 않으면 모든 객실에 세금이 부과됩니다.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType	1..n	RoomType	방 유형을 지정합니다. 객실 유형은 다음의 `<RoomData>` 요소 트랜잭션 (숙박 시설 데이터) 메시지에 포함되어 있으며 할 수 있습니다. ( `<RoomID>` 값은 `OTA_HotelRateAmountNotifRQ`의 `InvTypeCode` 속성 messages.)
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id	1	string	인벤토리의 고유 식별자입니다 (방 유형). 이 값은 거래에서 `<RoomID>`에게 (속성 데이터) 메시지로 응답합니다. 허용되는 최대 문자 수는 자입니다. 50.
TaxFeeInfo / Property / Taxes / Tax / RatePlans	0..1	RatePlans	세금이 적용되는 요금제 목록의 컨테이너입니다. `<RatePlans>`을 지정하지 않으면 세금이 부과됩니다. 모든 요금제에 적용됩니다.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan	1..n	RatePlan	요금제를 지정합니다. 요금제는 거래에 정의된 패키지, 요금, 예약 가능 여부 (숙박 시설 데이터), OTA_HotelRateAmountNotifRQ, OTA_HotelAvailNotifRQ 패키지 ID로 식별됩니다.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id	1	string	요금제의 고유 식별자입니다. 이 값은 패키지 ID 값을 트랜잭션 (숙박 시설 데이터) 메시지 `<PackageData>` 및 하위 집합에서 설정된 `RatePlanCode` 값을 양쪽에 `<StatusApplicationControl>` 속성 있음 `<OTA_HotelRateAmountNotifRQ>` 및 `<OTA_HotelAvailNotifRQ>` 메시지 허용되는 최대 문자 수는 50자(영문 기준)입니다.
TaxFeeInfo / Property / Taxes / Tax / BookingDates	0..1	BookingDates	예약 시기를 정의하는 하나 이상의 기간에 대한 컨테이너는 필수 항목입니다. 발생해야 합니다.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange	1..99	DateRange	세금을 부과하기 위해 예약이 발생해야 하는 시기를 지정하는 날짜 범위 적용됩니다.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @start	0..1	Date	(숙박 시설의 시간대를 기준으로 함) 시작일 확인할 수 있습니다 이 날짜는 `end` 날짜입니다. `start`를 지정하지 않으면 날짜 기간은 시작일 측면에서 사실상 무제한입니다.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @end	0..1	Date	기간을 설정할 수 있습니다. 이 날짜는 `start`과(와) 같거나 그 이후여야 합니다. 있습니다. `end`를 지정하지 않으면 날짜 종료일은 사실상 무제한입니다.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @days_of_week	0..1	string	기간에 허용되는 요일입니다. 그렇지 않은 경우 지정된 경우 기간 내의 모든 요일이 허용됩니다. 각 문자는 일을 지정합니다. 예: 'MTWHF' 지정 선택할 수 있습니다. 유효한 문자는 다음과 같습니다. 월요일 `M` 화요일의 경우 `T` 수요일의 경우 `W` 목요일의 경우 `H` 금요일의 경우 `F` 토요일의 경우 `S` 일요일의 경우 `U` 모든 문자 조합을 사용할 수 있습니다.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates	0..1	CheckinDates	체크인해야 하는 시간을 정의하는 하나 이상의 기간에 대한 컨테이너입니다. 발생합니다.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange	1..20	DateRange	세금이 적용됩니다.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start	0..1	Date	(숙박 시설의 시간대를 기준으로 함) 시작일 확인할 수 있습니다 이 날짜는 `end` 날짜입니다. `start`를 지정하지 않으면 날짜 기간은 시작일 측면에서 사실상 무제한입니다.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @end	0..1	Date	기간을 설정할 수 있습니다. 이 날짜는 `start`과(와) 같거나 그 이후여야 합니다. 있습니다. `end`를 지정하지 않으면 날짜 종료일은 사실상 무제한입니다.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @days_of_week	0..1	string	기간에 허용되는 요일입니다. 그렇지 않은 경우 지정된 경우 기간 내의 모든 요일이 허용됩니다. 각 문자는 일을 지정합니다. 예: 'MTWHF' 지정 선택할 수 있습니다. 유효한 문자는 다음과 같습니다. 월요일 `M` 화요일의 경우 `T` 수요일의 경우 `W` 목요일의 경우 `H` 금요일의 경우 `F` 토요일의 경우 `S` 일요일의 경우 `U` 모든 문자 조합을 사용할 수 있습니다.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates	0..1	CheckoutDates	체크아웃 시점을 정의하는 하나 이상의 기간에 대한 컨테이너입니다. 이(가) 되어야 세금이 적용됩니다.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange	1..20	DateRange	세금이 적용됩니다.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start	0..1	Date	(숙박 시설의 시간대를 기준으로 함) 시작일 확인할 수 있습니다 이 날짜는 `end` 날짜입니다. `start`를 지정하지 않으면 날짜 기간은 시작일 측면에서 사실상 무제한입니다.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @end	0..1	Date	기간을 설정할 수 있습니다. 이 날짜는 `start`과(와) 같거나 그 이후여야 합니다. 있습니다. `end`를 지정하지 않으면 날짜 종료일은 사실상 무제한입니다.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @days_of_week	0..1	string	기간에 허용되는 요일입니다. 그렇지 않은 경우 지정된 경우 기간 내의 모든 요일이 허용됩니다. 각 문자는 일을 지정합니다. 예: 'MTWHF' 지정 선택할 수 있습니다. 유효한 문자는 다음과 같습니다. 월요일 `M` 화요일의 경우 `T` 수요일의 경우 `W` 목요일의 경우 `H` 금요일의 경우 `F` 토요일의 경우 `S` 일요일의 경우 `U` 모든 문자 조합을 사용할 수 있습니다.
TaxFeeInfo / Property / Taxes / Tax / StayDates	0..1	StayDates	특정 기간 동안만 사용할 수 있는 광고인지, 시즌별 할인을 수용하기 위해 세금이 부과됩니다.
TaxFeeInfo / Property / Taxes / Tax / StayDates / @application	1	enum	세금이 적용되는 방식을 설명합니다. 유효한 값은 다음과 같습니다. `all`: 숙박 일정의 모든 날짜가 겹치는 경우 숙박 일정 숙박 날짜도 함께 표시됩니다 `any`: 일정에 있는 날짜가 숙박 기간입니다. `overlap`: 숙박 기간 내의 날짜와 겹치는 운항 일정입니다. 참고: `overlap`는 다음 경우에만 유효합니다. `<Period>`가 `night`로 설정됩니다. 이 속성은 항상 지정해야 합니다.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange	1..99	DateRange	세금이 적용되는 날짜를 지정하는 기간입니다.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @start	0..1	Date	(숙박 시설의 시간대를 기준으로 함) 시작일 확인할 수 있습니다 이 날짜는 `end` 날짜입니다. `start`를 지정하지 않으면 날짜 기간은 시작일 측면에서 사실상 무제한입니다.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @end	0..1	Date	기간을 설정할 수 있습니다. 이 날짜는 `start`과(와) 같거나 그 이후여야 합니다. 있습니다. `end`를 지정하지 않으면 날짜 종료일은 사실상 무제한입니다.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @days_of_week	0..1	string	기간에 허용되는 요일입니다. 그렇지 않은 경우 지정된 경우 기간 내의 모든 요일이 허용됩니다. 각 문자는 일을 지정합니다. 예: 'MTWHF' 지정 선택할 수 있습니다. 유효한 문자는 다음과 같습니다. 월요일 `M` 화요일의 경우 `T` 수요일의 경우 `W` 목요일의 경우 `H` 금요일의 경우 `F` 토요일의 경우 `S` 일요일의 경우 `U` 모든 문자 조합을 사용할 수 있습니다.
TaxFeeInfo / Property / Taxes / Tax / Type	1	enum	유효한 값은 다음과 같습니다. `percent:` 총 요율의 비율 `amount:` 최종 요율에 추가할 고정 금액 `cumulative_percent:` 총 수수료, 세금 및 수수료를 계산한 다음 이 세금 또는 수수료가 적용됩니다. 이 값이 지정되면 `<Rank>` 도 지정해야 합니다. `<Brackets>` 및 `<AgeBrackets>` 로 지정할 수 없습니다. `cumulative_percent`을 유형으로 정의합니다.
TaxFeeInfo / Property / Taxes / Tax / Basis	1	enum	유효한 값은 다음과 같습니다. `room:` `<Amount>`이 방에 적용됩니다. `person:` `<Amount>`은(는) 1인당 적용됩니다. 이 값은 `<Type>`이(가) '금액'으로 설정된 경우에만 적용됩니다.
TaxFeeInfo / Property / Taxes / Tax / Period	1	enum	유효한 값은 다음과 같습니다. `stay:` `<Amount>`가 다음에 추가됩니다. 총 숙박 요금과 같습니다. `night:` `<Amount>`가 추가되었습니다. 1박당
TaxFeeInfo / Property / Taxes / Tax / Currency	0..1	string	세금의 3글자 통화 코드 (예: USD)입니다.
TaxFeeInfo / Property / Taxes / Tax / Amount	0..1	float	세금의 비율 또는 금액 값입니다.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights	0..1	ApplicableNights	이 값은 `<Type>`이(가) 다음과 같이 설정된 경우에만 적용됩니다. amount 및 `<Period>`가 다음과 같이 설정됨 night로 이동합니다. 세금이 적용될 수 있는 숙박 일수를 제한합니다. `max` 또는 `excluded`를 지정하지만 지정하지 않음 있습니다
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @max	0..1	integer	`<ApplicableNights max="N">`은(는) 밤이 되었음을 나타냅니다. 처음 N일 후의 값은 제외되어야 합니다.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded	0..1	integer	`<ApplicableNights excluded="N">`는 처음 N박을 제외해야 합니다.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay	0..1	LengthOfStay	이 세금이 적용될 수 있는 숙박 기간 한도를 정의합니다. 숙박 기간이 최솟값과 최댓값을 벗어나면 세금이 적용되지 않습니다. 제한하기 때문입니다.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @min	0..1	integer	세금이 적용될 수 있는 숙박에 허용되는 최소 숙박 일수입니다. 지정되지 않으면 최솟값이 없습니다.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @max	0..1	integer	세금이 적용될 수 있는 숙박 일수의 최대 숙박 일수입니다. 지정되지 않으면 최댓값이 없습니다.
TaxFeeInfo / Property / Taxes / Tax / Brackets	0..1	Brackets	하나 이상의 `<Bracket>` 요소의 컨테이너입니다. 연속적이고 겹치지 않는 과세 범위 집합을 정의합니다. 예: 인도 GST 슬래브 세금. 이 요소는 `<Period>`가 `night` 및 `<Amount>`가 지정되지 않았습니다.
TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount	0..1	float	1박 요금에 적용되는 세액 비율 또는 세액의 값 첫 번째 괄호의 `starts_at` 값 미만입니다.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket	1..n	Bracket	1박 요금을 기준으로 세액을 정의합니다.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at	1	float	소득 계층의 하한을 정의합니다. 상한값은 그 다음 대괄호의 `starts_at` 필드에 지정됩니다. 마지막 괄호에는 상한값이 없습니다. 1박 요금이 이상이면 조세 브래킷이 활성화됩니다. 괄호의 `starts_at` 값으로 변경, 엄격히 다음보다 작음 후속 괄호의 `starts_at` 값입니다. 이 값은 0보다 커야 합니다.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount	1	float	이 조세 괄호에 적용된 세액의 비율 또는 액수입니다.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets	0..1	AgeBrackets	숙박 인원에 따라 세금을 지정할 수 있습니다. 연령 이 요소는 `<Brackets>` 및 `<Amount>`가 지정되지 않았습니다. `<Basis>`가 `person`로 설정되어 있으며 `<Type>`가 `amount`로 설정됩니다.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge	0..1	AdultCharge	성인에 대한 세금을 지정하기 위한 컨테이너입니다.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount	1	float	성인에게 적용되는 고정 세액입니다.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets	0..1	ChildAgeBrackets	하나 이상의 `<ChildAgeBracket>`를 보관하기 위한 컨테이너 요소
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket	1..n	ChildAgeBracket	자녀의 연령대와 해당 세액을 정의합니다.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age	1	integer	자녀 연령의 상한값을 정의합니다. 하한값은 이전 괄호의 `max_age` 필드 + 1에 지정된 값 상한과 하한 모두 포함됩니다. 공식의 하한값은 첫 번째 대괄호는 0입니다. `max_age`은 (는) 0 이상 17 범위 내에 있어야 합니다.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount	1	float	이 연령대의 어린이에게 적용되는 고정 세액입니다.
TaxFeeInfo / Property / Taxes / Tax / UserCountries	0..1	UserCountries	세금이 다음 중 하나에 해당하는 사용자 국가를 나열하기 위한 컨테이너 포함할 수 있습니다. 있는 경우 세금은 제외되지 않습니다.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type	0..1	enum	사용자 국가 사양의 유형입니다. 유효한 값은 `include` 및 `exclude`입니다. 사용자 국가 `type`가 다음과 같이 설정된 경우 `include`의 경우 다음 국가의 사용자에게만 세금이 적용됩니다. 없습니다. 반면 사용자 국가 `type`가 다음과 같은 경우 `exclude`, 세금은 없습니다. 사용자 국가 `type`가 설정되지 않은 경우 다음과 같이 처리됩니다. `include` 및 다음 국가의 사용자에게만 세금이 적용됩니다. 없습니다.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country	1..n	Country	사용자 국가 목록에 하나의 국가를 정의합니다.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code	1	string	CLDR 국가 코드 (예: `DE`, `FR`) 일부의 경우 CLDR 국가 코드는 2자리 ISO와 다릅니다. 국가 코드. 또한 CLDR 리전 코드도 지원되지 않습니다.
TaxFeeInfo / Property / Taxes / Tax / Rank	1	integer	이 세금 또는 수수료를 적용하는 순서를 지정하는 순위입니다. 예를 들어 값이 2이면 이 세금이 두 번째로 적용됨을 의미합니다. `<Type>`가 다음과 같은 경우 이 요소를 항상 지정해야 합니다. `cumulative_percent`로 설정합니다. 일반적으로 이 순서는 세금 및 수수료 모두에 적용됩니다 중복 순위 값이 허용됩니다. 확인할 수 있지만 이로 인해 정의되지 않은 동작이 발생할 수 있습니다. 세금 및 수수료는 임의 및 누적 방식으로 적용됩니다. 순위가 없는 세금 및 수수료는 모든 순위 참가작보다 먼저 적용됩니다. `<Rank>`은 (는) 1 이상 99 범위 내에 있어야 합니다.
TaxFeeInfo / Property / Fees	0..1	Fees	하나 이상의 `<Fee>` 요소의 컨테이너입니다.
TaxFeeInfo / Property / Fees / Fee	1..n	Fee	숙박 시설에 적용되는 개별 수수료입니다. `<Tax>`의 모든 하위 요소도 동일한 문법을 사용하는 `<Fee>`에서 지원됩니다.

예

세금 및 수수료는 숙박 시설당 300개로 제한됩니다. 자세한 내용은 '세금 삭제' 숙박 시설에서 세금 및 수수료를 삭제하는 예입니다.

기본 메시지

기본 TaxFeeInfo 메시지:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2020-05-18T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>10.00</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>person</Basis>
        <Period>night</Period>
        <Currency>USD</Currency>
        <Amount>5.00</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

세금 삭제

지정된 호텔의 모든 숙박 시설 수준의 세금 및 수수료를 삭제합니다.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-06-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key"
  <Property action="overlay"/>
    <ID>Property_1</ID>
  </Property>
</TaxFeeInfo>

슬래브 세금

인도 GST 슬래브 세금으로, 야간 요금을 기준으로 적용됩니다. 과세 대상 다음과 같습니다.

1박 요금이 1,000 이하이면 세금이 없습니다.
1박 요금이 1,000보다 크고 7500과 같습니다
1박 요금이 7500을 초과하는 경우 18% 의 세금이 부과됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2020-05-18T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Brackets base_amount="0">
          <Bracket starts_at="1000.01" amount="12"/>
          <Bracket starts_at="7500.01" amount="18"/>
        </Brackets>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

연령 기준 세금

거주자 연령에 따라 적용되는 세금:

성인 숙박객의 경우 세금이 $20입니다.
만 11~17세 어린이의 경우 세금 10달러가 부과됩니다.
만 0~10세 어린이의 경우 세금 5달러가 부과됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2020-05-18T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>person</Basis>
        <Period>night</Period>
        <AgeBrackets>
          <AdultCharge amount="20"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="10" amount="5"/>
            <ChildAgeBracket max_age="17" amount="10"/>
          </ChildAgeBrackets>
        </AgeBrackets>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

대답

구문

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

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

요소 및 속성

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

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

예

성공

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

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

문제

다음은 오류가 발생했습니다.

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