Calificar mensaje

Descripción general

El mensaje Tarifa (OTA_HotelRateAmountNotifRQ) define las tarifas de ocupación nocturna de cada combinación de tipo de habitación y plan de tarifas para períodos específicos. Como parte del mensaje de tarifa, Google admite precios basados en la ocupación, lo que permite que se especifiquen diferentes tarifas por noche según la cantidad máxima de ocupantes previstos.

En las siguientes secciones, se abordan los lineamientos generales, un ejemplo básico y situaciones prácticas para que comiences a agregar y actualizar tarifas, y a enviar un mensaje de tarifa.

Comportamiento del porcentaje de coincidencias

A medida que los usuarios solicitan ocupaciones específicas, la tarifa que ven depende de cómo definas los precios en el mensaje de tarifa. En esta sección, se explica cómo coinciden estas solicitudes de usuarios con tus tarifas según la ocupación de su solicitud y las tarifas que definas.

Principios clave

  • Una tarifa definida para una ocupación específica se aplica a todas las ocupaciones menores, a menos que se defina lo contrario.

  • No se pueden realizar solicitudes de ocupación superiores a las definidas.

  • Los precios basados en la ocupación se aplican a los precios por fecha y a los modelos de precios basados en la duración de la estadía que se describen a continuación. Esto significa que puedes especificar tarifas para cada ocupación. Si no existe una tarifa para una ocupación específica, se usa la tarifa de la siguiente ocupación más alta. También puedes definir cargos para huéspedes adicionales y niños mediante AdditionalGuestAmounts o ExtraGuestCharges, que se aplican hasta la capacidad definida para una habitación.

Beneficios y ejemplos

Eficiencia

Si tienes varias ocupaciones con el mismo importe de tarifa, no necesitas establecer una tarifa para cada una. Puedes simplificar tus mensajes si configuras solo el valor de ocupación más alto que admita el tipo de habitación y el plan de tarifas. Los usuarios verán esa tarifa para cada ocupación inferior o igual a tu valor establecido.

Ejemplo: Las tarifas de un tipo de habitación y un plan de tarifas son las mismas para las ocupaciones del uno al cuatro. Usa el mensaje Tarifa para establecer una tarifa con una ocupación máxima de 4. Los usuarios que busquen ocupación única, doble y triple verán la misma tarifa. Los usuarios que buscan 5 o más no verán las tarifas.

Control

Se pueden proporcionar tarifas distintas para ocupaciones alternativas de forma explícita. Envía una tarifa diferente para cada valor de ocupación si deseas tener más control sobre la forma en que Google hace coincidir las solicitudes con las tasas de ocupación.

Ejemplo: Si se definen tarifas para las ocupaciones 3 y 1, las búsquedas de ocupación individual mostrarán la tarifa de solteros, una búsqueda de ocupación doble mostrará la de ocupación triple y los usuarios que busquen 4 o más personas no verán las tarifas.

Para ver más ejemplos de varias situaciones relacionadas con las tarifas, consulta Instructivos.

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

Sintaxis y esquemas

Usa el ejemplo de la sintaxis de tarifas como referencia cuando crees el mensaje de tarifa para asegurarte de estar siguiendo 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 obtener el esquema de mensajes de tarifas, consulta Esquemas de Anuncios de hoteles.

Modelos de precios

Precios por fecha

Este es el modelo de precios estándar que se usa para la mayoría de las propiedades. El modelo de precios per-date se basa en la configuración de las tarifas que se suman en las fechas de la estadía para llegar a un precio total. En este modelo, todas las tarifas de un elemento Rate se interpretan como que se aplican a un rango de fechas de estadía especificado en <StatusApplicationControl>.

Precios basados en la duración de la estadía

El modelo de precios basado en la duración de la estadía se basa en las tarifas establecidas para una combinación de fecha de llegada y duración de la estadía. Las tarifas especificadas en el modelo de precios basados en la LOS son por día. Por ejemplo, si envías una tarifa de USD 100 para una duración de la estadía de 3, el precio total se calcula como 3 x USD 100=USD 300.

Puedes usar el modelo de precios basado en la duración de la estadía si especificas RatePlanType="26" en los elementos StatusApplicationControl. También debes establecer los atributos RateTimeUnit y UnitMultiplier en los elementos Rate de tu XML. Esto hace que todas las tarifas del elemento Rate determinado se apliquen a las estadías definidas por las fechas de llegada especificadas en <StatusApplicationControl> y el valor de LOS especificado para UnitMultiplier.

Puedes usar los modelos de precios por fecha y basados en la duración de la estadía en una sola cuenta. Sin embargo, cada propiedad debe usar un solo modelo de precios. Ten en cuenta lo siguiente cuando implementes precios basados en la duración de la estadía:

  • Las tarifas para diferentes duraciones de la estadía no se combinan cuando se usan los precios basados en la duración de la estadía. Por ejemplo, una tasa de estadía de 3 no se combina con una duración de la estadía de 1 para fijar un precio de tarifa de duración de 4. La tasa de duración de la estadía de 4 debe especificarse de manera explícita.
  • La tarifa de 1 noche en los precios basados en la duración de la estadía no se usa como una tarifa por noche individual en los precios por fecha.
  • Cada propiedad solo debe usar precios basados en la duración de la estadía o precios por fecha, según cómo se representen las tarifas en tu sistema.

Para habilitar los precios basados en la duración de la estadía en tu cuenta, realiza la solicitud a través de tu TAM o comunícate con nosotros.

Lineamientos o acciones

Precios por fecha

Delta: Agrega o actualiza las tarifas por ocupación solo para las combinaciones especificadas de tipo de habitación, plan de tarifas y fechas de estadía en <StatusApplicationControl>.

  • Las actualizaciones de tarifas usan la acción Delta de forma predeterminada.
  • Una actualización de Delta no altera ninguna tarifa almacenada con anterioridad para otras ocupaciones. Por ejemplo, si especificaste tarifas de habitaciones individuales y dobles, y envías una actualización de la tarifa de Delta para la habitación individual, la tarifa de ocupación doble no se modificará.

Overlay: Borra todas las tarifas por ocupación existentes para el tipo de habitación, el plan de tarifas y las fechas especificadas en <StatusApplicationControl>, y reemplázalas por tarifas nuevas. Por ejemplo, si especificaste tarifas para habitaciones individuales y dobles, y envías una actualización de Overlay para habitaciones individuales, Google quitará todas las tarifas anteriores (habitaciones individuales y dobles) y solo permanecerá la tarifa de ocupación individual después de la actualización.

Remove: Borra todas las tarifas por ocupación existentes para el tipo de habitación, el plan de tarifas y las fechas especificadas en <StatusApplicationControl>.

Precios basados en la duración de la estadía

Delta: Agrega o actualiza las tarifas por valor de la duración de la estadía solo para las combinaciones especificadas de tipo de habitación, plan de tarifas y fechas de entrada en <StatusApplicationControl>. Reemplaza todas las tarifas por ocupación asociadas con los valores de duración de la estadía actualizados.

  • Las actualizaciones de tarifas usan la acción Delta de forma predeterminada.
  • Una actualización de Delta no altera ninguna tarifa almacenada con anterioridad para otras duraciones de estadía. Por ejemplo, si especificaste tarifas para la duración de la estadía 1 y 2, y envías una actualización de tarifa de Delta para la duración de la estadía 1, las tarifas por ocupación de la duración de la duración de la estadía 2 permanecerán sin cambios.
  • Una actualización de Delta reemplaza todas las tarifas por ocupación almacenadas anteriormente para la duración de la estadía determinada. Por ejemplo, si especificaste tarifas de ocupación única y doble para la duración de estadía 1 y envías una actualización de tarifa de Delta para la duración de estadía 1 con una sola tasa de ocupación única, se quitará la tasa de ocupación doble.

Overlay: Borra todas las tarifas por ocupación existentes de la duración de la estadía, el tipo de habitación, el plan de tarifas y las fechas de entrada especificadas en <StatusApplicationControl> y reemplázalas por tarifas nuevas. Por ejemplo, si especificaste tarifas para los niveles de duración 1 y 2, y envías una actualización de Overlay para la duración de la estadía 1, Google quitará todas las tarifas anteriores (tanto la duración 1 como la 2) y solo permanecerá la tasa de la duración 1 después de la actualización.

Remove: Borra todas las tarifas por ocupación existentes para toda la duración de la estadía del tipo de habitación, el plan de tarifas y las fechas de entrada especificados en <StatusApplicationControl>.

Relacionado con impuestos

Si los impuestos y las tarifas son simples, el importe total se puede especificar con AmountAfterTax. No se pueden representar en AmountAfterTax los impuestos complejos, como los impuestos y las tarifas que se aplican por estadía (en lugar de por noche).

En general, Google recomienda usar TaxFeeInfo en lugar de AmountAfterTax.

Si es posible, debes incluir AmountBeforeTax (incluso si especificas AmountAfterTax), ya que algunas configuraciones regionales (por ejemplo, EE.UU.) muestran el precio antes de impuestos de forma predeterminada.

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

Ejemplo

En esta sección, se proporciona un ejemplo básico de un mensaje de tarifa con elementos obligatorios y opcionales. Después de preparar tu archivo, debes enviarlo a Google mediante un mensaje POST al siguiente extremo: https://www.google.com/travel/hotels/uploads/property_data

Para obtener más información sobre cómo enviar o PUBLICAR el mensaje, consulta Enviar mensajes.

En HotelCode, 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 con <id> en el elemento <listing> del feed de lista de hoteles. En el caso de <PackageID> y <RoomID>, usa los mismos ID que usas en tu sistema para los planes de tarifas y los tipos de habitación (respectivamente). La coherencia con tu sistema es fundamental para garantizar que Google muestre correctamente tus precios y datos.

En este ejemplo, se muestra cómo establecer tarifas con una acción Delta:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

Instructivos

En esta sección, se proporcionan soluciones a situaciones que puedes encontrar cuando envías mensajes de tarifa.

Para ver ejemplos de cómo agregar, quitar y actualizar tarifas, consulta Ejemplos de tarifas.

Situación 1: Cómo cambiar los precios por ocupación

Descripción

Anteriormente, las tarifas por noche se definieron solo para una ocupación doble (que también se aplica a una ocupación individual), pero ahora hay una tarifa más económica para una ocupación individual.

Solución

Envía la nueva tarifa de ocupación 1 con la actualización predeterminada del alcance de Delta. Este valor nuevo no afecta la tasa de ocupación 2.

Situación 2: Cómo reemplazar las tarifas por ocupación en una propiedad

Descripción

Anteriormente, definiste las tarifas para las ocupaciones 1 a 4, pero ahora solo las ocupaciones 1 y 2 son válidas.

Solución

Usa NotifType="Overlay" para reemplazar todas las tasas de ocupación de una propiedad, un tipo de habitación, un plan de tarifas y una fecha determinados. En este caso, la acción Overlay enumeraría las tarifas para las ocupaciones 1 y 2.

Situación 3: Cómo establecer la misma tarifa para varias ocupaciones

Descripción

Se puede vender una tarifa para una ocupación determinada a un grupo con menos personas. En esta situación, puedes simplificar tus mensajes si envías solo la actualización de la tarifa para la ocupación máxima aplicable.

Solución

Si tienes el mismo precio para varias ocupaciones, establece el valor de ocupación más alto que admita el tipo de habitación y el plan de tarifas, y usará ese valor automáticamente para las ocupaciones más bajas. Es decir, no es necesario repetir la misma tarifa por noche para las ocupaciones 1 a 6 si son todas iguales; solo establece la tarifa en 6.