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

세금 및 수수료 메시지

개요

TaxFeeInfo 메시지는 사용자가 숙박 시설을 예약할 때 적용되는 세금 및 수수료를 정의하며, 이는 웹사이트에 명시된 숙박 시설의 세금 규정을 기반으로 합니다. 세금 및 수수료 데이터를 추가하려면 요금 메시지 (OTA_HotelRateAmountNotifRQ)를 사용합니다.

이 메시지에 지원되는 유일한 작업은 각 숙박 시설의 세금 및 수수료 데이터를 대체하는 데 사용되는 overlay입니다. 변경사항이 있을 때마다 세금 및 수수료 업데이트를 전송하는 것이 중요합니다.

세금 및 수수료를 전송하는 방법과 요금의 구체적인 가격 책정 세부정보는 세금 및 수수료 정책을 참고하세요.

세금 및 수수료 추가 방법

세금과 수수료를 추가하는 방법에는 두 가지가 있습니다.

첫 번째 방법에서는 요금 메시지에 AmountAfterTax를 지정합니다. 모든 세금 및 수수료를 제외한 기본 1박 요금과 모든 세금 및 수수료를 포함한 총 1박 요금이 모두 포함된 요금 메시지를 전송하여 세금 및 수수료를 추가합니다. 이러한 요금은 1박 요금이므로 이 방법은 백분율 기반 세금 및 수수료 또는 1박당 고정 금액에만 적용되며 숙박당 세금 및 수수료는 사용할 수 없습니다.

두 번째 (권장) 방법은 요금 메시지에서 세금 및 수수료가 제외된 기본 숙박 요금만 전송하고 TaxFeeInfo를 사용하여 숙박 시설 수준에서 세금 및 수수료를 전달하는 것입니다. 개별 세금 및 수수료는 특정 기간에 적용되는 특정 객실 유형 및 요금제로 범위를 지정할 수 있습니다.

이 페이지에서는 TaxFeeInfo 사용의 기본 방법에 대해서만 설명하고 참조하며, Rate 메시지 (OTA_HotelRateAmountNotifRQ)에서 AmountAfterTax를 지정하는 방법은 설명하지 않습니다.

세금 설정 방법

세금을 설정하는 방법은 다음과 같습니다.

Basis = [room|person]
기간 = [stay|night]
Type = [percent|amount]

기간이 stay이고 유형이 percent인 경우 숙박 일정의 단일 날짜가 StayDates 범위와 겹치더라도 Google은 전체 숙박에 세금과 수수료를 적용합니다. 숙박 일정의 모든 날짜가 숙박 기간과 겹치는 경우에만 세금 및 수수료를 적용하도록 지정할 수는 없습니다. 서로 중복되는 숙박 날짜 범위가 여러 개인 경우 StayDates 범위는 단일 개방형 범위로 지정됩니다. TaxFeeInfo 예시를 참고하세요.

다양한 세금 관련 시나리오의 예는 방법을 참고하세요. 이 예에서는 다음을 포함한 주요 세금 시나리오를 다룹니다.

숙박 시설별로 적용되는 고정 세금 및 비율 세금
첫날 이후 숙박 일수에만 적용되는 비율 세금
이전 세금을 새 세금으로 대체하는 방법
국가별 세금 포함 또는 제외
구간별 세금 설정
세금 및 과세 대상 수수료 설정

다음 섹션에서는 세금 정보를 추가하고 업데이트하는 방법을 시작하는 데 도움이 되는 일반 가이드라인, 기본 예시, 사용 방법 시나리오를 다룹니다.

필수 요소 및 선택 요소

XML 참조에서는 필수 요소와 선택적 요소를 설명합니다. 속성 및 하위 요소에 관한 자세한 내용은 TaxFeeInfo 요소 및 속성을 참고하세요.

구문 및 스키마

메시지를 만들 때 TaxFeeInfo 구문 예시를 참고하여 올바른 형식을 따르고 있는지 확인하세요. xmllint와 같은 서드 파티 XML 도구를 사용하여 게시된 스키마로 피드의 유효성을 검사한 후 Google에 제출할 수 있습니다. TaxFeeinfo 메시지 스키마는 호텔 광고 스키마를 참고하세요.

가이드라인

이 섹션에서는 세금 및 수수료 설정에 관한 일반적인 가이드라인과 특별 안내를 다룹니다.

작업

오버레이: overlay 작업을 사용하여 속성의 모든 세금을 바꿉니다. overlay 작업은 기본값이며 지원되는 유일한 작업입니다. 이 업데이트가 적용되면 이 숙박 시설의 이전 세금 및 수수료가 삭제됩니다.

일반

각 Tax는 평가되고, 해당하는 경우 BaseByGuestAmt에 지정된 AmountBeforeTax 금액을 기준으로 계산됩니다.
관련 세금 및 수수료가 모두 계산되면 기본 가격에 추가되어 총 가격이 됩니다.
<Tax> 및 <Fee>의 문법은 동일합니다.
세금 및 수수료에는 다음과 같은 제약이 있을 수 있습니다.
- 특정 객실 유형 및 요금제에만 적용됩니다.
- 특정 숙박 날짜에만 적용됩니다.
이러한 제약 조건은 선택사항이며 모든 유형의 제약 조건을 설정하지 않아도 됩니다. 모든 유형에 적용되는 경우 비워 둘 수 있습니다.
세금 또는 수수료가 변경될 때마다 TaxFeeInfo 업데이트를 전송합니다.

예

이 섹션에서는 필수 요소와 선택적 요소를 사용하는 TaxFeeInfo 메시지의 기본 예를 제공합니다. 파일을 준비한 후에는 다음 엔드포인트에 POST 메시지를 사용하여 Google에 파일을 전송해야 합니다.

https://www.google.com/travel/hotels/uploads/taxes

메시지를 푸시/게시하는 방법을 자세히 알아보려면 메시지 푸시를 참고하세요.

hotel_id 속성의 경우 시스템 내에서 숙박 시설을 식별하는 데 사용한 고유한 호텔 ID를 사용합니다. 이 값은 호텔 목록 피드의 <listing> 요소에서 <id>를 사용하여 지정된 호텔 ID와 일치해야 합니다. Google에서 데이터를 올바르게 표시하려면 시스템과의 일관성이 중요합니다.

다음 예에서는 숙박 전체 (박당 아님)에 대해 10% 의 세금 비율과 50달러의 수수료 금액을 설정하는 방법을 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-20T16:20:00-04:00"
            partner="partner_key"
            id="12345678">
  <Property>
    <ID>HOTELID</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>10</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>50</Amount>
        <Currency>USD</Currency>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

연령 관련 세금 추가 예시 및 기타 예시는 세금 예시를 참고하세요.

방법

이 섹션에서는 세금 및 수수료를 설정하는 동안 발생할 수 있는 시나리오에 대한 해결 방법을 제공합니다.

시나리오 1: 고정 세율을 추가하는 방법

이 세금 예시에서는 속성당 고정 세금을 설정하는 방법을 보여줍니다.

설명

백분율 세금이 아닌 숙박 시설별 객실 또는 숙박에 정액 세금을 적용하려는 경우

솔루션

정액세 옵션을 추가하려면 percentage 대신 amount를 사용하세요.

샘플

이 샘플은 percentage 대신 amount를 사용하여 고정 세금을 추가하는 방법을 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>30</Amount>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

시나리오 2: `ApplicableNights`을 사용하여 세금을 타겟팅하는 방법

설명

첫날 이후의 숙박 일수에만 고정 요금 세금을 적용하고 싶습니다. 예를 들어 게스트가 특정 편의시설을 사용할 기회가 없었던 첫날에는 제외되는 특정 편의시설의 일일 사용에 대한 필수 요금이 있습니다.

솔루션

<ApplicableNights excluded="1"/>를 사용하여 세금이 적용되는 숙박일을 관리합니다.

샘플

이 샘플은 ApplicableNights을 사용하는 방법을 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Amount>50</Amount>
        <ApplicableNights excluded="1"/>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

시나리오 3: 이전 세금 및 수수료를 새 세금 및 수수료로 대체하는 방법

설명

현재 세금 및 수수료가 변경되어 새 세금 및 수수료로 대체해야 합니다.

솔루션

overlay 작업을 사용하여 기존 세금과 수수료를 모두 삭제합니다.

샘플

다음 샘플은 숙박 시설의 모든 세금과 수수료를 삭제하는 방법을 보여줍니다.

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

시나리오 4: 국가별 세금을 포함하거나 제외하는 방법

설명

일부 국가의 세금은 포함하고 다른 국가의 세금은 제외해야 합니다. 예를 들어 EU 외 세금이 있는 소규모 연합의 세금을 제외하면서 다른 모든 국가에 세금을 부과해야 합니다.

솔루션

UserCountries type에 include 또는 exclude 옵션을 사용합니다. include를 사용하여 나열된 국가에만 세금을 적용하거나 exclude를 사용하여 나열된 국가를 제외한 모든 국가에 세금을 적용합니다.

샘플

다음 샘플은 호텔 국가 (이스라엘) 외부 사용자의 세금을 설정하는 방법을 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16: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>
        <UserCountries type="exclude">
          <Country code="IL"/>
        </UserCountries>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

시나리오 5: 구간을 사용하여 슬랩 세금을 설정하는 방법

설명

1박 요금을 기준으로 적용되는 GST 슬래브 세금을 추가하려고 합니다.

솔루션

이 시나리오에서는 타겟 국가의 GST 세율이 다음과 같다고 가정합니다.

1박 요금이 1,000 이하인 경우 세금이 부과되지 않습니다.
1박 요금이 1,000보다 크고 7,500 이하인 경우 12% 세금
1박 요금이 7,500을 초과하는 경우 18% 세금

샘플

다음 샘플은 구간을 사용하여 슬래브 세금을 설정하는 방법을 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-28T16: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>

시나리오 6: 세금 및 과세 수수료를 설정하는 방법

설명

부가가치세와 같은 세금과 해당 세금에 적용되는 다른 서비스 수수료를 추가하려고 합니다.

솔루션

이 시나리오에서는 과세 대상 수수료의 두 가지 사용 사례를 고려합니다.

세금과 과세 대상 수수료는 모두 비율 요금으로 정의됩니다.
세금은 비율로 청구되는 반면 과세 대상 수수료는 숙박당 고정 금액입니다.

예

과세 대상 수수료(%)

이 예에서는 AmountBeforeTax가 100달러, GST 세금이 18%, 추가 서비스 요금이 5% 이므로 총 과세 수수료 비율은 5.9% (5*1.18)이고 총 요금 금액은 123.90달러[= 118달러 (18% GST) + 5.9달러 (5.9% 서비스 요금)]입니다.

다음 스니펫은 세금 (GST)과 과세 대상 수수료 (서비스 요금)를 백분율로 정의합니다.

<TaxFeeInfo timestamp="2022-08-16T16: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>18</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>5.9</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

과세 대상 수수료(금액)

이 예에서는 AmountBeforeTax이 $100이고, GST 세금이 18%이며, 추가 정액 요금이 $20이므로 총 과세 대상 요금은 $23.60($20*1.18)이고 총 요금 금액은 $141.60[= $118 (18% GST) + $23.60($20 정액 요금)]입니다.

다음 스니펫은 세금 (GST)을 백분율로 정의하고 과세 대상 수수료(서비스 요금)를 고정 요금 금액으로 정의합니다.

<TaxFeeInfo timestamp="2022-08-16T16: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>18</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>23.6</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>