Descripción general
El mensaje TaxFeeInfo
define los impuestos y las tarifas que se aplican a un usuario cuando reserva una propiedad y según las reglamentaciones fiscales de la propiedad que se describen en el sitio web. Para agregar datos de impuestos y tarifas, usa el mensaje Tarifas (OTA_HotelRateAmountNotifRQ
).
La única acción admitida para este mensaje es overlay
, que se usa a fin de reemplazar los datos de impuestos y tarifas de cada propiedad. Es importante enviar actualizaciones de impuestos y tarifas siempre que haya cambios.
Métodos para agregar impuestos y tarifas
Existen dos maneras generales de agregar impuestos y tarifas. En el primer método, debes especificar AmountAfterTax
en el mensaje de tarifa. Para agregar los impuestos o las tarifas, debes enviar mensajes de tarifas que contengan las tarifas base por noche (sin incluir todos los impuestos ni las tarifas) y las tarifas totales por noche (incluidos todos los impuestos o las tarifas). Debido a que estas tarifas son nocturnas, este enfoque solo funciona para los impuestos o las tarifas basados en porcentajes o los importes fijos que son por noche. No se pueden usar los impuestos ni las tarifas por estadía.
El segundo método (preferido) es enviar solo las tarifas base por noche
que no incluyen impuestos o tarifas en los mensajes de tarifas y usar TaxFeeInfo
para indicar los impuestos o las tarifas
a nivel de la propiedad. Las tarifas o los impuestos individuales aún pueden aplicarse a tipos de habitación y planes de tarifas específicos, o a determinados períodos.
Métodos para establecer impuestos
Tienes las siguientes opciones para configurar los impuestos:
- Base = [sala|persona]
- Período = [Estadía|noche]
- Tipo = [percent|amount]
Cuando el período es stay
y el tipo es percent
, Google aplica impuestos o tarifas para toda la estadía, incluso si una sola fecha del itinerario se superpone con el rango StayDates
. No puedes especificar que se aplique un impuesto o una tarifa solo si TODAS las fechas del itinerario se superponen con el período de las fechas de la estadía.
Para ver ejemplos de diversas situaciones relacionadas con impuestos, consulta Instructivos. Los ejemplos abarcan algunas de las principales situaciones fiscales, incluidos los instructivos de:
- Porcentaje de impuesto
- Impuesto fijo aplicado por propiedad
- Porcentaje de impuesto que se aplica solo a las noches posteriores a la primera noche
- Método para reemplazar los impuestos antiguos por los nuevos
- Cómo incluir o excluir impuestos para países
- Establecer el impuesto sobre losa con corchetes
- Establecer los impuestos y las tarifas impositivas
En las siguientes secciones, se describen los lineamientos generales, un ejemplo básico y situaciones prácticas para comenzar a agregar y actualizar tu información fiscal.
Elementos obligatorios y opcionales
La referencia de XML proporciona descripciones de los elementos obligatorios y opcionales. Para obtener detalles sobre los atributos y los elementos secundarios, consulta Elementos y atributos de TaxFeeInfo
.
Sintaxis y esquemas
Usa el ejemplo de la sintaxis TaxFeeInfo
como referencia cuando crees el mensaje para asegurarte de
seguir el formato correcto. Puedes usar una herramienta XML de terceros, como xmllint, para validar tus feeds con los esquemas publicados antes de enviarlos a Google. Para ver el esquema del mensaje TaxFeeinfo
, consulta Esquemas de Anuncios de hoteles.
Lineamientos
En esta sección, se describen los lineamientos comunes y las instrucciones especiales para establecer impuestos y tarifas.
Acciones
- Superposición
- Usa la acción
overlay
para reemplazar todos los impuestos de una propiedad. La acciónoverlay
es la predeterminada y la única acción compatible. Se borrarán todos los impuestos y las tarifas anteriores de esta propiedad una vez que se aplique esta actualización.
General
Cada
Tax
se evalúa y, si corresponde, se calcula en función del importe deAmountBeforeTax
que se especificó enBaseByGuestAmt
.Después de calcular todos los impuestos y las tarifas aplicables, se agregan al precio base para formar el precio total.
Las sintaxis de
<Tax>
y<Fee>
son las mismas.Los impuestos o las tarifas pueden tener restricciones, como las siguientes:
- Solo se aplica a tipos de habitación o planes de tarifas específicos.
- Solo se aplica a fechas de estadía específicas.
Estas restricciones son opcionales y no tienes que establecer cada tipo de restricción. Puedes dejarlas vacías si se aplica a todas.
Envía una actualización de
TaxFeeInfo
cada vez que se produzca un cambio en los impuestos o las tarifas.
Ejemplo
En esta sección, se proporciona un ejemplo básico de un mensaje TaxFeeInfo
con elementos obligatorios y opcionales. Una vez que prepares tu archivo, tendrás que enviarlo a Google a través de un mensaje POST a este extremo:
https://www.google.com/travel/hotels/uploads/taxes
Para obtener más información sobre cómo enviar o PUBLICAR el mensaje, consulta Envía mensajes.
Para el atributo hotel_id
, usa el ID de hotel único que usaste en tu sistema para identificar la propiedad. Este valor debe coincidir con el ID de hotel especificado mediante <id>
en el elemento <listing>
del feed de lista de hoteles. La coherencia con tu sistema es fundamental para garantizar que Google muestre tus datos de forma correcta.
En este ejemplo, se muestra cómo establecer un porcentaje de impuestos del 10% y un importe de tarifa de USD 50 para una propiedad por la estadía total (no por noche):
<?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>
Para ver ejemplos de cómo agregar impuestos relacionados con la edad, así como otros ejemplos, consulta Ejemplos de impuestos.
Instructivos
En esta sección, se proporcionan soluciones para las situaciones que puedes encontrar cuando configuras los impuestos y las tarifas.
Situación 1: Cómo agregar un impuesto fijo
En este ejemplo de impuestos, se muestra cómo establecer un impuesto fijo por propiedad.
Descripción
Quieres aplicar un impuesto fijo por habitación o estadía por propiedad en lugar de un porcentaje de impuesto.
Solución
Usa amount
en lugar de percentage
para agregar la opción de impuestos fijos.
Ejemplo
En este ejemplo, se muestra cómo agregar un impuesto fijo mediante amount
en lugar de 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>
Situación 2: Cómo segmentar impuestos con ApplicableNights
Descripción
Quieres aplicar una tarifa fija solo a las noches posteriores a la primera. Por ejemplo, se aplica una tarifa obligatoria por el uso diario de un servicio determinado que no esté incluido en la primera noche, en la que los huéspedes no habrían tenido la oportunidad de usar ese servicio en particular.
Solución
Usa <ApplicableNights excluded="1"/>
para controlar a qué noches se les aplican impuestos.
Ejemplo
En esta muestra, se muestra cómo usar 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>
Situación 3: Cómo reemplazar los impuestos y tarifas anteriores por otros nuevos
Descripción
Los impuestos o las tarifas actuales cambiaron y se deben reemplazar por otros nuevos.
Solución
Usa la acción overlay
para quitar todos los impuestos y las tarifas existentes.
Ejemplo
En el siguiente ejemplo, se indica cómo quitar todos los impuestos o las tarifas de una propiedad:
<?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>
Situación 4: Cómo incluir o excluir impuestos para países
Descripción
Debes incluir el impuesto para ciertos países y excluirlo de otros. Por ejemplo, debes excluir impuestos para una confederación más pequeña con impuestos ajenos a la UE y aplicar impuestos a todos los demás países.
Solución
Usa las opciones include
o exclude
para UserCountries type
.
Usa include
para aplicar el impuesto solo al país indicado o exclude
para aplicarlo a todos los países, excepto el indicado.
Ejemplo
En el siguiente ejemplo, se muestra cómo establecer impuestos para los usuarios que no pertenecen al país del hotel (Israel):
<?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>
Situación 5: Cómo establecer un impuesto sobre losa con corchetes
Descripción
Quieres agregar un impuesto sobre las laas del GST que se aplica según las tarifas por noche.
Solución
En este caso, supongamos que los grupos fiscales del GST del país de segmentación son los siguientes:
- No se aplican impuestos si la tarifa por noche es inferior o igual a 1,000.
- Impuesto del 12% si la tarifa por noche es superior a 1,000 e inferior o igual a 7,500.
- 18% de impuesto si la tarifa por noche es superior a 7,500.
Ejemplo
En el siguiente ejemplo, se muestra cómo configurar un impuesto de bloque con corchetes:
<?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>
Caso 6: Cómo establecer impuestos y tarifas imponibles
Descripción
Quieres agregar un impuesto, como el IVA, y otro cargo del servicio que también se aplique a ese impuesto.
Solución
En esta situación, se consideran dos casos de uso de ejemplo de tarifas imponibles:
- Tanto el impuesto como la tarifa imponible se definen como cargos porcentuales.
- El impuesto es un cargo porcentual, mientras que la tarifa imponible es un importe fijo por estadía.
Ejemplos
Tarifa imponible en porcentaje
En este ejemplo, se tiene un AmountBeforeTax de $100, un impuesto GST del 18% y un cargo adicional del servicio del 5%, lo que hace que el porcentaje total de la tarifa imponible es del 5.9% (5*1.18) y el importe total de la tarifa de $123.90 [= $118 (18% GST) + $5.9 (5.9% por el servicio)].
En el siguiente fragmento, se definen los impuestos (GST) y las tarifas impositivas (cargos del servicio) como porcentajes:
<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>
Tarifa imponible como importe
Este ejemplo tiene un importe de AmountBeforeTax de USD 100, un impuesto del GST del 18% y una tarifa fija adicional de USD 20, lo que equivale a una tarifa total de USD 23.60 (USD 20*1.18) y el importe total de la tarifa de USD 141.60 [= USD 118 (18% de GST) + USD 23.60 (tasa fija de USD 23.60) (USD 20.60)
En el siguiente fragmento, se define el impuesto (GST) en porcentaje y la tarifa imponible (cargo del servicio) como un importe de tasa fija:
<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>