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

세금 및 수수료 메시지

개요

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

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

세금 및 수수료 추가 방법

세금 및 수수료를 추가하는 방법에는 일반적으로 두 가지가 있습니다.

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

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

이 페이지에서는 Rate 메시지(OTA_HotelRateAmountNotifRQ)에서 AmountAfterTax를 지정하는 메서드가 아닌 TaxFeeInfo를 사용하는 선호되는 메서드만 설명하고 참조합니다.

세금 설정 방법

다음과 같은 세금 설정 옵션이 있습니다.

Basis = [room|person]
기간 = [숙박|밤]
유형 = [percent|amount]

기간이 stay이고 유형이 percent인 경우 Google은 숙박 일정의 단일 날짜가 StayDates 범위와 중복되더라도 전체 숙박에 대해 세금 및 수수료를 적용합니다. 숙박 일정의 모든 날짜가 숙박 기간과 겹치는 경우에만 세금 및 수수료 적용을 지정할 수 없습니다.

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

세율
숙박 시설당 고정 세금이 적용됨
첫날 이후 밤에만 적용되는 비율 세금
기존 세금을 새 세금으로 대체하는 방법
국가의 세금 포함 또는 제외
대괄호로 세율 구간 설정
세금 및 과세 대상 수수료 설정

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

필수 요소 및 선택 요소

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

문법 및 스키마

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

가이드라인

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

작업

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

일반

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

예

이 섹션에서는 필수 및 선택적 요소를 사용하는 TaxFeeInfo 메시지의 기본 예를 제공합니다. 파일이 준비되면 이 엔드포인트에 대한 POST 메시지를 사용하여 Google에 파일을 보내야 합니다.

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

메시지를 푸시/POST하는 방법에 관한 자세한 내용은 메시지 푸시를 참고하세요.

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: 대괄호를 사용하여 슬라브 세금을 설정하는 방법

설명

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

솔루션

이 시나리오에서는 대상 국가의 GST 조세 범위가 다음과 같다고 가정합니다.

1박 요금이 1,000원 이하인 경우 세금이 부과되지 않습니다.
숙박 요금이 1,000원 이상 7,500원 이하인 경우 12%의 세금이 부과됩니다.
숙박 요금이 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: 세금 및 과세 수수료를 설정하는 방법

설명

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

솔루션

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

세금과 과세 수수료는 모두 비율 청구로 정의됩니다.
세금은 비율로 청구되지만 과세 수수료는 숙박당 고정 금액으로 청구됩니다.

예

과세 수수료(%)

이 예에는 AmountBeforeTax 100달러, GST 세금 18%, 추가 5% 서비스 요금이 적용되어 총 과세 수수료 비율은 5.9% (5*1.18), 총 세율은 $123.90입니다. [= 18%(GST 18%) + 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>