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

概要

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

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

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

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

税金と手数料を追加する方法は、大きく分けて 2 つあります。

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

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

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

税金を設定する方法

税金を設定するには、次のオプションがあります。

  • Basis = [room|person]
  • Period = [stay|night]
  • Type = [percent|amount]

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

税金に関するさまざまなシナリオの例については、入門ガイドをご覧ください。 この例では、次のような一般的な税金に関するシナリオについて説明します。

  1. 宿泊施設ごとに適用される定額税とパーセンテージ税
  2. 最初の宿泊日以降の宿泊にのみ適用されるパーセンテージ税
  3. 古い税金を新しい税金に置き換える方法
  4. 国ごとの税金の追加または除外
  5. 段階的な税金を設定する
  6. 税金と課税対象の料金を設定する

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

必須要素とオプション要素

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

メッセージを push/POST する方法について詳しくは、メッセージを push するをご覧ください。

TaxFeeInfo

hotel_id 属性には、宿泊施設を識別するためにシステム内で使用した一意のホテル ID を使用します。この値は、ホテルリスト フィードの <listing> 要素の <id> を使用して指定した HotelID と一致する必要があります。Google がデータを正しく表示するためには、システムとの整合性が重要です。

次の例は、宿泊施設に 10% の税率と 50 ドルの手数料を滞在全体に設定する方法を示しています（1 泊あたりではありません）。

<?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,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 などの税金と、その税金にも適用される別のサービス手数料を追加したい。

ソリューション

このシナリオでは、課税対象の手数料の 2 つのユースケースを想定しています。

  • 税金と課税対象の手数料の両方がパーセンテージ料金として定義されている。
  • 税金はパーセンテージ料金で、課税対象の手数料は滞在ごとの定額料金である。

例

課税対象の手数料をパーセントで指定する

この例では、AmountBeforeTax が 100 ドル、GST 税が 18%、追加のサービス手数料が 5% です。課税対象の手数料の合計パーセンテージは 5.9%（5*1.18）、合計料金は 123.90 ドル [= 118 ドル（18% GST）+ 5.9 ドル（5.9% サービス手数料）] です。

次のスニペットは、税金（物品サービス税）と課税対象の手数料（サービス手数料）をパーセンテージで定義しています。

<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 ドル、物品サービス税が 18%、追加のフラットレート料金が 20 ドルです。課税対象の手数料の合計は 23.60 ドル（20*1.18）、合計料金は 141.60 ドル [= 118 ドル（18% 物品サービス税）+ 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>