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

概要

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

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

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

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

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

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

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

税金を設定する方法

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

  • Basis = [room|person]
  • 期間 = [滞在|泊]
  • タイプ = [percent|amount]

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

税金関連のさまざまなシナリオの例については、方法をご覧ください。以下の方法など、税金に関する一般的なシナリオの例を紹介します。

  1. 宿泊施設ごとに適用される定額税とパーセンテージ税
  2. 1 泊目以降の宿泊にのみ適用される税率
  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 でデータが正しく表示されるようにするには、システムとの整合性が重要です。

次の例は、宿泊施設の税率を 10%、料金の金額を 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 を使用して税金をターゲティングする方法

説明

1 泊目以降の泊数にのみ、定額の税金を適用したい場合。たとえば、特定のアメニティの 1 日あたりの使用に必須の料金があり、その料金は 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 つを検討します。

  • 税金と課税対象手数料はどちらも、料金の割合として定義されます。
  • 税金は料金の割合で請求されますが、課税対象料金は宿泊ごとに一定の金額で請求されます。

例

課税対象の料金（%）

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

課税対象料金（金額）

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