税金と手数料に関するメッセージ

概要

TaxFeeInfo メッセージは、ユーザーが宿泊施設を予約する際に適用される税金と手数料を定義します。これは、ウェブサイトに記載されている宿泊施設の税法に基づいています。税金と手数料のデータを追加するには、料金メッセージ（OTA_HotelRateAmountNotifRQ）を使用します。

このメッセージでサポートされているアクションは overlay のみです。これは、各宿泊施設の税金と手数料のデータを置き換えるために使用されます。税金と手数料の変更があった場合は、必ず更新情報を送信してください。

税金と手数料の送信方法、料金の具体的な詳細については、税金と手数料に関するポリシーをご覧ください。

税金と料金を追加する方法

税金と手数料を追加する方法は、一般的に次の 2 つがあります。

1 つ目の方法では、料金メッセージで AmountAfterTax を指定します。税金と手数料を追加するには、基本の 1 泊料金（すべての税金と手数料を除く）と 1 泊の合計料金（すべての税金と手数料を含む）の両方を含む料金メッセージを送信します。これらの料金は 1 泊あたりの料金であるため、この方法はパーセンテージベースの税金と手数料、または 1 泊あたりの定額料金にのみ適用され、滞在ごとの税金と手数料は使用できません。

2 つ目の方法（推奨）は、税金と手数料を除いた基本の宿泊料金のみを料金メッセージで送信し、TaxFeeInfo を使用して税金と手数料を宿泊施設レベルで伝える方法です。個々の税金と手数料は、特定の期間に適用される特定の客室タイプと料金プランに引き続きスコープ設定できます。

このページでは、TaxFeeInfo の推奨される使用方法についてのみ説明し、料金メッセージ（OTA_HotelRateAmountNotifRQ）で AmountAfterTax を指定する方法については説明しません。

税金を設定する方法

税金を設定するには、次の方法があります。

  • Basis = [room|person]
  • 期間 = [滞在|泊]
  • Type = [percent|amount]

期間が stay でタイプが percent の場合、旅行プランの 1 日でも StayDates の範囲と重複していれば、Google は滞在期間全体に税金と手数料を適用します。旅行プランのすべての日付が滞在日の期間と重複する場合にのみ税金と手数料を適用することはできません。複数の宿泊期間が重複している場合は、StayDates の期間を 1 つのオープン期間で指定します。TaxFeeInfo の例を参照してください。

税金関連のさまざまなシナリオの例については、ハウツーをご覧ください。この例では、次のような税金に関する一般的なシナリオを取り上げています。

  1. 宿泊施設ごとに適用される定額税と割合税
  2. 最初の夜以降の宿泊にのみ適用される税率（%）
  3. 古い税金を新しい税金に置き換える方法
  4. 国ごとの税金を含めるか除外する
  5. ブラケットを使用してスラブ税を設定する
  6. 税金と課税対象の手数料を設定する

以降のセクションでは、税務情報の追加と更新を開始するための一般的なガイドライン、基本的な例、ハウツー シナリオについて説明します。

必須要素と省略可能な要素

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> を使用して指定した HotelID と一致する必要があります。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、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>

Taxable fee as amount

この例では、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>