세금 수수료

요청

문법

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]</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>
      </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]</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>
      </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 이 메시지의 파트너 계정입니다. 이 문자열 값은 Hotel Center의 계정 설정 페이지에 나열된 '파트너 키' 값입니다.

참고: 백엔드가 여러 계정에 대한 피드를 제공하는 경우 이 값은 동일한 계정에 대한 <OTA_HotelRateAmountNotifRQ><RequestorID> 메시지의 <RequestorID> 요소에 지정된 ID 속성 값과 일치해야 합니다.<OTA_HotelAvailNotifRQ>

TaxFeeInfo / Property 1..n Property 단일 숙박 시설의 세금 및 수수료를 정의하는 컨테이너입니다.
TaxFeeInfo / Property / @action 0..1 string 업데이트가 적용되는 방식을 지정합니다. overlay만 지원되며 기본값은 overlay입니다. 이 업데이트가 적용되기 전에 이 속성의 이전 TaxesFees가 삭제됩니다.
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 객실 유형을 지정합니다. 객실 유형은 Transaction (Property Data) 메시지의 <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>에 있는 패키지 ID 값과, <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: 최종 요율에 추가할 정액 요금
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 첫 번째 대괄호의 starts_at 값 미만 1박 요금에 적용되는 세율 또는 세액 값입니다.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket 1..n Bracket 1박 요금에 따른 과세 유형을 정의합니다.
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 UserCountry 사양의 유형입니다.

유효한 값은 includeexclude입니다.

UserCountry typeinclude로 설정되면 나열된 국가의 사용자에게만 세금이 적용됩니다.

반면 사용자 국가 typeexclude인 경우 세금은 나열된 국가 외의 사용자에게만 적용됩니다.

UserCountry type이 설정되지 않은 경우 include로 처리되며 세금은 나열된 국가의 사용자에게만 적용됩니다.

TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country 1..n Country UserCountry 목록에 하나의 국가를 정의합니다.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code 1 string CLDR 국가 코드(예: DE 또는 FR) 일부 국가에서는 CLDR 국가 코드가 2자리 ISO 국가 코드와 다릅니다. 또한 CLDR 지역 코드는 지원되지 않습니다.
TaxFeeInfo / Property / Fees 0..1 Fees 하나 이상의 <Fee> 요소에 대한 컨테이너입니다.
TaxFeeInfo / Property / Fees / Fee 1..n Fee

숙박 시설에 적용되는 개인 수수료입니다.

<Tax>의 모든 하위 요소는 동일한 문법의 <Fee>에도 지원됩니다.

기본 메시지

기본 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>

Slab 세금

인도 GST 슬라브 세금(1박 요금 기준 적용됨) 세율은 다음과 같습니다.

  • 1박 요금이 1,000 이하인 경우 세금이 부과되지 않습니다.
  • 1박 요금이 1,000 이상, 7,500 이하인 경우 세금 12%
  • 1박 요금이 7,500 초과인 경우 세금 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>

문제

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

<?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>