稅金和相關費用訊息

總覽

TaxFeeInfo 訊息會根據網站上列出的房源稅務法規，定義使用者預訂房源時適用的稅金和費用。如要新增稅金和相關費用資料，請使用費率訊息 (OTA_HotelRateAmountNotifRQ)。

這則訊息只支援 overlay 動作，用於取代各項房產的稅金和費用資料。如有異動，請務必傳送稅金和費用更新。

如要進一步瞭解如何傳送稅金和費用，以及費率的具體定價詳細資料，請參閱稅金與費用政策。

新增稅金和費用的方法

新增稅金和費用的方式大致有兩種：

第一種方法是在「房價」訊息中指定 AmountAfterTax；如要新增稅金和費用，請傳送房價訊息，其中包含每晚基本房價 (不含所有稅金和費用) 和每晚總房價 (含所有稅金和費用)。由於這些費率是以每晚為單位，因此這種做法只適用於以百分比為準的稅金和相關費用，或是每晚的固定金額，且不適用於以住宿為單位的稅金和相關費用。

第二種 (建議) 方法是在房價訊息中只傳送不含稅金和費用的每晚基本房價，並使用 TaxFeeInfo 在房源層級傳達稅金和費用。個別稅金和費用仍可限定於特定房型和費率方案，適用於特定日期範圍。

本頁面僅說明並參照使用 TaxFeeInfo 的偏好方法，而非在費率訊息 (OTA_HotelRateAmountNotifRQ) 中指定 AmountAfterTax 的方法。

設定稅金的方法

你可以透過下列選項設定稅金：

  • Basis = [room|person]
  • 週期 = [stay|night]
  • 類型 = [百分比|金額]

如果「週期」為 stay 且「類型」為 percent，即使行程中的單一日期與 StayDates 範圍重疊，Google 也會針對整個住宿期套用稅金和相關費用。您無法指定只有在行程中的所有日期都與住宿日期範圍重疊時，才套用稅金和相關費用。如有多個住宿日期範圍彼此重疊，則 StayDates 範圍會指定為單一開放範圍。請參閱TaxFeeInfo範例。

如需各種稅務相關情境的範例，請參閱操作說明。 這些範例涵蓋一些常見的稅務情境，包括：

  1. 為每項房產套用固定稅額和百分比稅額
  2. 稅率僅適用於第一晚後的住宿夜數
  3. 以新稅率取代舊稅率的方法
  4. 納入或排除國家/地區的稅金
  5. 設定含稅級距的稅率
  6. 設定稅金和應稅費用

以下各節將介紹一般指南、基本範例，以及操作情境，協助你開始新增及更新稅務資訊。

必要和選用元素

XML 參考資料提供必要和選用元素的說明。如要瞭解屬性和子元素的詳細資料，請參閱「TaxFeeInfo 元素和屬性」。

語法和結構定義

建立訊息時，請參考TaxFeeInfo語法範例，確保格式正確。你可以使用 xmllint 等第三方 XML 工具，先透過已發布的架構驗證動態饋給，再將動態饋給提交給 Google。如需 TaxFeeinfo 訊息架構，請參閱飯店廣告架構。

指南規範

本節說明設定稅金和費用的常見規範和特殊指示。

動作

重疊廣告
使用 overlay 動作，取代資源的所有稅金。overlay 動作是預設動作，也是唯一支援的動作。套用這項更新後，系統會清除此房源先前的所有稅金和費用。

一般

  • 系統會評估每個 Tax，並根據 BaseByGuestAmt 中指定的 AmountBeforeTax 金額計算 (如適用)。

  • 計算完所有適用稅金和相關費用後，系統會將這些費用加到基本價格，得出總價。

  • <Tax> 和 <Fee> 的語法相同。

  • 稅金和手續費可能會有以下限制：

    • 僅適用於特定房型和房價方案。
    • 僅適用於特定住宿日期。

    這些限制為選用項目，您不必設定每種限制，如果適用於所有項目，可以留空。

  • 只要稅金或費用有異動，就傳送 TaxFeeInfo 更新。

範例

本節提供 TaxFeeInfo 訊息的基本範例，其中使用必要和選用元素。準備好檔案後，請使用 POST 訊息將檔案傳送至下列端點：

https://www.google.com/travel/hotels/uploads/taxes

如要進一步瞭解如何推送/POST 訊息，請參閱「推送訊息」。

如要使用 hotel_id 屬性，請使用系統中用於識別房源的專屬飯店 ID。這個值必須與飯店清單動態饋給中 <listing> 元素內使用 <id> 指定的飯店 ID 相符。與系統保持一致性至關重要，可確保 Google 正確顯示資料。

以下範例說明如何為房源設定住宿總價 (而非每晚) 的 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：如何新增固定稅率

這個稅金範例說明如何為每項房產設定固定稅額。

說明

您想為每間房或每次住宿套用固定稅額，而非百分比稅額。

解決方案

請使用 amount 而不是 percentage 新增單一稅率選項。

範例

這個範例說明如何使用 amount 新增固定稅率，而非 percentage：

<?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：如何納入或排除國家/地區的稅金

說明

你必須為特定國家/地區的產品價格加上稅金，但其他國家/地區則不需加稅。舉例來說，您需要為較小的邦聯排除非歐盟稅金，同時對所有其他國家/地區課稅。

解決方案

為 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 稅率級距如下：

  • 如果每晚房價小於或等於 1000，則免稅。
  • 如果每晚房價大於 1000 且小於或等於 7500，則稅率為 12%。
  • 如果每晚房價超過 7500，則稅率為 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：如何設定稅金和應稅費用

說明

您想新增加值稅等稅金，以及適用於該稅金的另一項服務費。

解決方案

這個情境考量了兩個應稅費用的範例用途：

  • 稅金和應稅費用都以百分比計算。
  • 稅金是以百分比計算，而應稅費用則是每筆住宿的固定金額。

範例

可課稅費用百分比

在這個例子中，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 美元固定費率)]。

下列程式碼片段會以百分比定義稅金 (商品及服務稅)，並以固定費率金額定義應稅費用 (服務費)：

<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>