稅金和相關費用訊息

總覽

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

這則訊息唯一支援的動作是 overlay，用來取代每個房源的稅金和相關費用資料。每當有異動時，請務必傳送稅金和相關費用的最新資訊。

新增稅金和相關費用的方法

新增稅金與費用的一般方式有兩種：在第一種方法中，您可以在費率訊息中指定 AmountAfterTax；透過傳送包含基本每晚房價 (不含所有稅金/手續費) 和每晚總費率 (含所有稅金/相關費用) 的費率訊息來新增稅金/手續費。由於這些是每晚的房價，因此這種方法僅適用於依據百分比計算的稅金/手續費，或是每晚的固定金額，而且無法使用按入住的稅金/手續費。

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

稅金設定方法

設定稅金的選項如下：

  • 低音 = [房間|人]
  • 經期 = [入住|晚上]
  • 類型 = [百分比|金額]

當期間為 stay 且類型為 percent 時，即使行程中的單一日期與 StayDates 範圍重疊，Google 也會針對整天收取稅金/手續費。只有在行程中的所有日期與住宿日期範圍重疊時，您才能指定套用稅金/相關費用。

如需各種稅務相關情境的範例，請參閱操作說明。以下列舉幾種主要稅務情況，包括以下項目：

  • 稅百分比
  • 每項房源套用固定稅金
  • 只適用第一晚過後的住宿百分比稅金
  • 以新稅金取代舊稅的方法
  • 納入或排除國家/地區稅金
  • 使用括號設定基礎板稅金
  • 設定稅金和應稅費用

以下各節將說明一般原則、基本範例以及實際操作情境，協助您開始新增及更新稅務資訊。

必要和選用元素

XML 參考資料提供必要及選用元素的說明。如要進一步瞭解屬性和子元素，請參閱 TaxFeeInfo 元素和屬性。

語法和結構定義

建立訊息時，請使用 TaxFeeInfo 語法範例做為參考，確保遵循正確的格式。您可以使用第三方 XML 工具 (例如 XMLlint) 以已發布的結構定義驗證動態饋給，再提交給 Google。如要瞭解 TaxFeeinfo 訊息結構定義，請參閱「飯店廣告結構定義」。

規範

本節說明設定稅金和相關費用的一般規範和特殊操作說明。

動作

重疊
使用 overlay 動作來取代房源的所有稅金。overlay 動作為預設值，也是唯一支援的動作。套用這項更新後，系統會清除這項屬性的所有先前稅金和相關費用。

一般

  • 系統會評估每個 Tax，如果適用，也會根據 BaseByGuestAmt 中指定的 AmountBeforeTax 金額進行計算。

  • 計算所有適用稅金和相關費用後，系統會將這些稅金加入基本價格，藉此形成總價。

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

  • 稅金/手續費可能有限制，例如：

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

    這些限制為選用項目，您不必設定所有類型的限制；如果所有限制都適用，可留空。

  • 稅金或費用有異動時，請傳送TaxFeeInfo更新。

範例

本節將提供使用必要和選用元素的基本 TaxFeeInfo 訊息範例。準備好檔案後，您需要透過 POST 訊息，將檔案傳送給 Google 這個端點：

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

如要進一步瞭解如何推送/張貼訊息，請參閱推送訊息。

針對 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 美元、18% 的商品及服務稅 (GST) 和額外的 5% 服務費 (按 5.9% (5*1.18) 收取應課費用總額) 和 $123.90 美元的總稅率：$118 (18% 商品及服務稅) + $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 美元 ($2.60 美元)

下列程式碼片段定義以固定稅率 (百分比) 和應課稅 (服務費) 形式的稅金 (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>