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

세금 및 수수료 메시지

개요

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

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

세금 및 수수료를 추가하는 방법

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

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

세금을 설정하는 방법

다음과 같은 옵션으로 세금을 설정할 수 있습니다.

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

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

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

세율
속성당 고정 세금 적용됨
첫째 날 밤 이후 숙박 일수에만 백분율세 적용
기존 세금을 새 세금으로 대체하는 방법
국가별 세금 포함 또는 제외
슬래브 세금(대괄호로 묶음) 설정
세금 및 과세 대상 수수료 설정

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

필수 및 선택 요소

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

메시지를 푸시/POST하는 방법에 대해 자세히 알아보려면 메시지 푸시를 참조하세요.

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

이 예시에서는 1박이 아닌 총 숙박에 대한 속성의 세율 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 Slab 세금을 추가하려고 합니다.

해결 방법

이 시나리오에서는 대상 국가의 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: 세금 및 과세 대상 수수료를 설정하는 방법

설명

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

해결 방법

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

세금과 과세 대상 수수료는 모두 비율 요금으로 정의됩니다.
세금은 일정 비율의 요금이며, 과세 대상 수수료는 숙박 건당 고정 금액입니다.

예

과세 대상 수수료(%)

이 예시의 AmountBeforeTax는 $100, GST 세금은 18%, 추가 서비스 요금은 5% 입니다. 따라서 총 과세 대상 수수료 비율은 5.9% (5*1.18), 총 세율 금액이 $123.90 [= $118 (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달러 (GST 18%) + 고정 요금 23.60달러)(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>

세금 및 수수료 메시지

개요

세금 및 수수료를 추가하는 방법

세금을 설정하는 방법

필수 및 선택 요소

구문 및 스키마

가이드라인

작업

일반

예

방법

시나리오 1: 고정세 추가 방법

설명

해결 방법

샘플

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

설명

해결 방법

샘플

시나리오 3: 기존 카드를 새 세금 및 수수료로 대체하는 방법

설명

해결 방법

샘플

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

설명

해결 방법

샘플

시나리오 5: 괄호를 사용해 슬래브 세금을 설정하는 방법

설명

해결 방법

샘플

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

설명

해결 방법

예

과세 대상 수수료(%)

과세 대상 수수료(금액)

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