概览
TaxFeeInfo
消息根据网站上列出的房源税务法规,定义用户在预订房源时适用的税费及其他费用。如需添加税费及其他费用数据,请使用费率消息 (OTA_HotelRateAmountNotifRQ
)。
此消息唯一支持的操作是 overlay
,用于替换每个房源的税费和其他费用数据。当税费和其他费用发生变化时,请务必发送更新。
添加税费和其他费用的方法
添加税费和其他费用的常规方法有两种:第一种方法是在“费率”消息中指定 AmountAfterTax
;通过发送同时包含基本每晚费率(不含所有税费/其他费用)和每晚总费率(含所有税费/费用)的费率消息,您可以添加相应税费。由于这些房价是每晚收取的费率,因此此方法仅适用于按百分比计算的税费/费用或每晚的固定金额,不能使用每次入住税费/费用。
第二种(首选)方法是仅在费率消息中发送不含税/其他费用的基本每晚费率,并使用 TaxFeeInfo
在房源级别传达税费/其他费用。单独的税费/其他费用仍可限定为特定的客房类型和费率方案,并且/或者可以应用于特定日期范围。
设置税费的方法
您可以通过以下选项来设置税费:
- 基础 = [会议室|人员]
- 时间段 = [住宿|晚间]
- 类型 = [百分比|金额]
当“时间段”为 stay
且类型为“percent
”时,Google 会针对整个住宿收取税费/费用,即使行程中的单个日期与 StayDates
范围重叠也是如此。仅当行程中的所有日期与住宿日期日期范围重叠时,您无法指定应用税费/费用。
如需查看各种税务相关情景的示例,请参阅方法指南。 这些示例涵盖了一些最常见的税务场景,包括:
- 税费百分比
- 按房源收取固定税
- 仅适用于第 1 晚之后的晚数的税费百分比
- 用新税费替换旧税费的方法
- 针对国家/地区包含或排除税费
- 设置带方括号的平板税
- 设置税费和应税费用
以下各部分介绍了一般准则、一个基本示例以及有关如何开始添加和更新税务信息的几种方法。
必需元素和可选元素
XML 参考文档提供了必需元素和可选元素的说明。有关属性和子元素的详细信息,请参阅 TaxFeeInfo
元素和属性。
语法和架构
创建消息时,请参考 TaxFeeInfo
语法示例,以确保您采用正确的格式。在将 Feed 提交至 Google 之前,您可以使用第三方 XML 工具(如 xmllint)使用已发布的架构来验证这些 Feed。如需了解 TaxFeeinfo
消息架构,请参阅酒店广告架构。
指南
本部分将介绍关于设置税费和其他费用的通用准则和特殊说明。
Action
- 叠加层
- 使用
overlay
操作替换房源的所有税费。overlay
操作是默认操作,也是唯一受支持的操作。应用此更新后,此房源之前的所有税费和其他费用都将被清除。
一般措施
系统会对每个
Tax
进行求值,并根据BaseByGuestAmt
中指定的AmountBeforeTax
量计算该值(如果适用)。在计算所有适用的税费和其他费用后,将它们与基本价格相加,即可构成总价。
<Tax>
和<Fee>
的语法相同。税费/其他费用可能有如下限制:
- 仅适用于特定客房类型和/或费率方案。
- 仅适用于特定住宿日期。
这些限制条件是可选的,您无需设置所有类型的限制条件;如果这些限制条件适用于所有类型,则可以将其留空。
每当税费或其他费用发生变化时,发送
TaxFeeInfo
更新。
示例
本部分提供了一个使用必需元素和可选元素的 TaxFeeInfo
消息基本示例。准备好文件后,您需要通过向以下端点发送 POST 消息将其发送给 Google:
https://www.google.com/travel/hotels/uploads/taxes
如需详细了解如何推送/POST 消息,请参阅推送消息。
对于 hotel_id
属性,请使用您在系统中用于标识房源的唯一酒店 ID。此值必须与酒店列表 Feed 的 <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
定位税费
说明
您只想对第 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:如何针对国家/地区包含或排除税费
说明
您需要针对某些国家/地区包含税费,而针对其他国家/地区排除相应税费。例如,您需要为包含非欧盟税费的较小联邦联邦体扣除税费,同时向所有其他国家/地区征税。
解决方案
对 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,则免税。
- 如果每晚房价大于 1,000 且小于或等于 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>
应税费用(以金额)
此示例包含 100 美元的 AmountBeforeTax、18% 的 GST 以及 20 美元的固定税率,总计应税费用为 $23.60 ($20*1.18),总税率为 $141.60 [= 118 美元 (18% GST) + $23.60(固定税率 $23.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>