Mensaje de impuestos y tarifas

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).

Nota: Se recomienda el tipo de mensaje TaxFeeinfo, y no es obligatorio si se especifica AmountAfterTax en el mensaje Tasa.

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.

Punto clave: Debes incluir todos los impuestos y las tarifas que debe pagar un usuario (IVA, impuesto de estadía, impuesto de la ciudad, etc.), incluso si no se pagan en el momento de la reserva o si no se pagan directamente a la propiedad.

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.

Nota: En esta página, se describe solo el método preferido para usar TaxFeeInfo y no el método para especificar AmountAfterTax en el mensaje Tasa (OTA_HotelRateAmountNotifRQ).

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ón overlay 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 de AmountBeforeTax que se especificó en BaseByGuestAmt.

• 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.

Punto clave: Envía a Google un mensaje TaxFeeInfo actualizado cada vez que cambien tus impuestos y tarifas.

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.

Nota: La acción overlay es la acción predeterminada si no se especifica, lo que significa que solo es posible reemplazar todos los impuestos o las tarifas de cada propiedad y no puedes agregar impuestos o tarifas nuevos de forma incremental.

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.

Nota: En esta situación, usa Brackets (conjunto de corchetes de impuestos no superpuestos) para configurar esta opción.

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>