概要
TaxFeeInfo
メッセージは、宿泊施設を予約する際に、ウェブサイトに記載されている宿泊施設の税規制に基づいてユーザーに適用される税金と手数料を定義します。税金と手数料のデータを追加するには、料金メッセージ(OTA_HotelRateAmountNotifRQ
)を使用します。
このメッセージでサポートされているアクションは overlay
のみです。これは、各プロパティの税金と手数料のデータを置き換えるために使用されます。変更があった場合は、税金と手数料の更新データを送信することが重要です。
税金と手数料を追加する方法
税金と手数料を追加する一般的な方法は 2 つあります。1 つ目の方法では、Rate メッセージで AmountAfterTax
を指定します。1 つ目の方法では、1 泊の基本料金(すべての税金と手数料を除く)と 1 泊の合計料金(すべての税金と手数料を含む)の両方を含む料金メッセージを送信することで、税金と手数料を追加します。料金は 1 泊であるため、このアプローチが機能するのは 1 泊の料金ベースの税金/手数料または定額料金に限られ、1 滞在あたりの税金/手数料は使用できません。
もう 1 つの方法(推奨)は、税金/手数料を除く基本 1 泊の料金のみを料金メッセージで送信し、TaxFeeInfo
を使用して宿泊施設単位で税金/手数料を送信する方法です。ただし、個別の税金と手数料は、特定の客室タイプと料金プランに範囲を拡大することや、特定の期間に適用されることがあります。
税金を設定する方法
税金を設定するには、次の方法があります。
- ベース = [部屋|人]
- 生理期間 = [滞在|夜]
- タイプ = [percent|amount]
期間が stay
でタイプが percent
の場合、宿泊プランの 1 つの日付が StayDates
の範囲と重複していても、Google は宿泊全体に対して税金と手数料を適用します。宿泊プランのすべての日付が滞在日の期間と重複している場合にのみ、税金や手数料の適用を指定することはできません。
税金に関するさまざまなシナリオの例については、入門ガイドをご覧ください。以下の例では、税金に関する主要なシナリオを取り上げています。以下の入門ガイドをご参照ください。
- 税率
- 宿泊施設ごとに均一税率
- 1 泊目以降の宿泊にのみ適用されます。
- 古い税金を新しい税金に差し替える方法
- 国ごとの税金を含める、または除外する
- かっこでスラブ税金を設定
- 税金と課税手数料の設定
以下のセクションでは、税務情報の追加と更新を開始するための一般的なガイドライン、基本的な例、手順のシナリオについて説明します。
必須要素と省略可能な要素
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
メッセージを push/POST する方法については、メッセージの push をご覧ください。
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
を使用して税金をターゲットに設定する方法
説明
1 泊目以降の宿泊に対してのみ均一料金の税金を適用するとします。たとえば、特定の設備については、毎日の使用に必須の料金があり、初日の宿泊には適用されません。そのような設備では、宿泊客がその設備を使用する機会がありません。
解決策
<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: 税金と課税手数料を設定する方法
説明
VAT などの税金と、その税金に適用される別のサービス手数料を追加します。
解決策
このシナリオでは、課税手数料の 2 つのユースケース例について説明します。
- 税金と課税対象となる手数料は、いずれもパーセンテージ料金で定義されます。
- 税金はパーセンテージで計算されますが、課税対象となるのは宿泊 1 件あたりの定額料金です。
例
課税手数料(%)
この例では、AmountBeforeTax は $100、物品サービス税は 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)、合計レート額は $118(GST の 18% + 均一税率 $23.60)となります。 ]
次のスニペットでは、税金(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>