稅金和相關費用訊息

總覽

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

此訊息僅支援 overlay 這項動作，用於取代每個資源的稅金和費用資料。請務必在稅金和費用有異動時傳送更新內容。

新增稅金和費用的方法

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

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

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

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

設定稅金的方法

您可以使用下列選項設定稅金：

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

當 Period 為 stay 且 Type 為 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) 級距稅金。

解決方案

在這個情況下，假設指定國家/地區的 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>