이 페이지는 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 메시지에는 다음과 같은 요소와 속성이 있습니다.

요소/@속성	발생 횟수	유형	설명
TaxFeeInfo	1	Complex element	단일 숙박 시설의 세금 및 수수료를 정의하는 메시지의 루트 요소입니다.
TaxFeeInfo / @timestamp	1	DateTime	이 메시지를 작성한 날짜 및 시간입니다.
TaxFeeInfo / @id	1	string	이 요청 메시지의 고유 식별자입니다. 이 값은 응답 메시지에 반환됩니다. 허용되는 문자는 `a-z`, `A-Z`, `0-9`, `_`(밑줄), `-` (대시)입니다.
TaxFeeInfo / @partner	1	string	이 메시지의 파트너 계정입니다. 이 문자열 값은 Hotel Center의 계정 설정 페이지에 나열된 '파트너 키' 값입니다. 참고: 여러 계정의 피드를 제공하는 백엔드가 있는 경우 이 값은 동일한 계정의 `<OTA_HotelRateAmountNotifRQ>` 및 `<OTA_HotelAvailNotifRQ>` 메시지의 `<RequestorID>` 요소에 지정된 `ID` 속성 값과 일치해야 합니다.
TaxFeeInfo / Property	1..n	Property	단일 숙박 시설의 세금 및 수수료를 정의하는 컨테이너입니다.
TaxFeeInfo / Property / @action	0..1	string	업데이트가 적용되는 방식을 지정합니다. `overlay`만 지원되며 기본값은 `overlay`입니다. 업데이트가 적용되기 전에 이 속성의 이전 `Taxes` 및 `Fees`가 모두 삭제됩니다.
TaxFeeInfo / Property / ID	1	string	숙박 시설의 고유 식별자입니다. 이 값은 호텔 목록 피드의 <listing> 요소에서 <id>를 사용하여 지정된 호텔 ID와 일치해야 합니다. 호텔 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를 사용하여 식별됩니다. `<RoomID>` 값은 `OTA_HotelRateAmountNotifRQ` 메시지의 `InvTypeCode` 속성에 의해서도 참조됩니다.
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 메시지에 정의된 패키지, 요금, 이용 가능 여부의 조합으로 정의되며 PackageID로 식별됩니다.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id	1	string	요금제의 고유 식별자입니다. 이 값은 거래(숙박 시설 데이터) 메시지의 `<PackageData>`에 있는 PackageID 값과 `<OTA_HotelRateAmountNotifRQ>` 및 `<OTA_HotelAvailNotifRQ>` 메시지 모두의 `<StatusApplicationControl>` 속성 아래에 설정된 `RatePlanCode` 값에 매핑됩니다. 허용되는 최대 문자 수는 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	세 글자로 된 세금 통화 코드입니다(예: USD). 참고: `<Currency>`가 지정되지 않았지만 `<Amount>`가 지정된 경우 `<Currency>` 값은 기본 요금 통화로 기본 설정됩니다.
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	첫 번째 대괄호의 `starts_at` 값 아래에 있는 숙박 요금에 적용되는 세율 또는 세금 금액입니다.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket	1..n	Bracket	숙박 요금을 기준으로 세금 구간을 정의합니다.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at	1	float	소득 계층의 하한을 정의합니다. 상한은 후속 대괄호의 `starts_at` 필드에 지정됩니다. 마지막 대괄호에는 상한이 없습니다. 숙박 요금이 구간의 `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	UserCountries 사양의 유형입니다. 유효한 값은 `include` 및 `exclude`입니다. UserCountries `type`가 `include`로 설정된 경우 세금은 나열된 국가의 사용자에게만 적용됩니다. 사용자 국가 `type`이 `exclude`인 경우 나열된 국가 외의 사용자에게만 세금이 적용됩니다. UserCountries `type`가 설정되지 않은 경우 `include`로 간주되며 세금은 나열된 국가의 사용자에게만 적용됩니다.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country	1..n	Country	UserCountries 목록에 국가 하나를 정의합니다.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code	1	string	`DE` 또는 `FR`와 같은 CLDR 국가 코드입니다. 일부 국가의 경우 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="2024-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="2024-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,000원 이상이고 7,500원 이하인 경우 12%의 세금이 부과됩니다.
숙박 요금이 7,500원을 초과하는 경우 18% 의 세금이 부과됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-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="2024-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="2024-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</TaxFeeInfoResponse>

문제

다음은 오류로 인해 처리되지 않은 TaxFeeInfo 메일에 대한 응답입니다.

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