稅金和相關費用訊息

總覽

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

這則訊息唯一支援的操作是 overlay，用來取代每個屬性的稅金和費用資料。請務必在稅金和費用有異動時傳送更新內容。

新增稅金和費用的方法

一般來說，新增稅金和費用的方式有兩種：

在第一個方法中，您可以在「費率」訊息中指定 AmountAfterTax，透過傳送含有基本每晚房價 (不含所有稅金和相關費用) 和每晚總價 (包含所有稅金和費用) 的費率訊息，加入稅金和相關費用。由於這些房價是按晚計算，因此這種方法只適用於以百分比計算的稅金和費用，或按晚計算的固定金額，無法使用每住宿次的稅金和費用。

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

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

設定稅金的方法

您可以設定以下稅金：

  • 基準 = [房間|人]
  • 週期 = [stay|night]
  • 類型 = [百分比|金額]

當 Period 為 stay 且 Type 為 percent 時，即使行程中單一日期與 StayDates 範圍重疊，Google 也會針對整個住宿期間收取稅金和相關費用。您無法指定只在行程內的所有日期與住宿日期範圍重疊時，才套用稅金和相關費用。

如需各種稅務相關情境的示例，請參閱操作說明。範例涵蓋一些主要稅務情境，包括以下項目的操作說明：

  • 百分比稅
  • 每個資源適用的固定稅
  • 百分比稅金僅適用於第一晚後的住宿晚數
  • 將舊稅率替換為新稅率的方法
  • 納入或排除國家/地區的稅金
  • 使用括號設定階梯稅
  • 設定稅金和應稅費用

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

必要和選用元素

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 級距稅。

解決方案

在這個情境中，假設指定國家/地區的 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% 服務費)]。

下列程式碼片段將稅金 (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 美元，商品及服務稅為 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>