Calificar mensaje

Descripción general

El mensaje de tarifa (OTA_HotelRateAmountNotifRQ) define la tarifa tasas de ocupación para cada combinación de tipo de habitación y plan de tarifas en una fecha específica o rangos. Como parte del mensaje de tarifa, Google admite precios basados en la ocupación, lo que permite que se especifiquen tarifas nocturnas diferentes en función de la cantidad máxima de los ocupantes previstos.

En las siguientes secciones, se abordan lineamientos generales, un ejemplo básico e instructivos para comenzar a agregar y actualizar tarifas, y enviar un Calificar mensaje.

Comportamiento del porcentaje de coincidencias

Dado que los usuarios solicitan ocupaciones específicas, la tarifa que ven depende de cómo defines los precios en tu mensaje de tarifa. En esta sección, se explica cómo estos las solicitudes de los usuarios se hacen coincidir con tus tarifas según la ocupación de sus solicitar 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.

• Las solicitudes de ocupaciones superiores a las definidas se consideran no posibles.

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

Beneficios y ejemplos

Eficiencia

Para varias ocupaciones con el mismo importe de tarifa, no necesitas establecer una la tarifa de cada ocupación. Para simplificar los mensajes, establece solo la el valor de ocupación más alto que admite el tipo de habitación y el plan de tarifas. Los usuarios verán una tarifa para cada ocupación inferior o igual a tu conjunto valor.

Ejemplo: Las tarifas de un tipo de habitación y un plan de tarifas son las mismas para ocupaciones de uno a cuatro. Usa el mensaje Tarifa para establecer una tarifa para el máx. una ocupación de 4. Usuarios que buscan habitaciones individuales, dobles y triples verán esa misma tarifa. Los usuarios que busquen 5 o más no verán las tarifas.

Control

Se pueden proporcionar de forma explícita tarifas diferentes para las ocupaciones alternativas. Enviar una tarifa diferente para cada valor de ocupación si deseas tener más control sobre cómo Google vincula 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 ocupación individual, una búsqueda de ocupación doble mostrará la tarifa 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 diversas 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 atributos y elementos secundarios, consulta Elementos de tarifa y Atributos.

Sintaxis y esquemas

Usa el ejemplo de sintaxis de la tarifa como referencia cuando crees el mensaje de tarifa para asegurarte de que estás siguiendo el formato correcto.

Puede usar una herramienta XML de terceros, como xmllint, para validar sus feeds los esquemas publicados antes de enviarlos a Google. Para el mensaje Tarifa 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 per-date El modelo de precios se basa en las tarifas establecidas, que se suman en todas las fechas de estadía para llegan al precio total. En este modelo, todas las tarifas con un elemento Rate se se interpreta como aplicable 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 basados en la duración de la estadía (duración de la estadía) se basa en las tarifas establecidas para un combinación de fecha de llegada y duración de la estadía. Las tasas especificadas en el Los modelos de precios basados en la duración de la estadía 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 × USD 100=USD 300.

Para usar el modelo de precios basado en la duración de la estadía, especifica RatePlanType="26" en elementos StatusApplicationControl. También debes establece 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 modelos de precios por fecha y basados en la duración de la estadía en una sola sin embargo, cada propiedad debe usar un solo modelo de precios. Ten en cuenta lo siguiente cuando implementes los precios basados en la duración de la estadía:

• Las tarifas para las diferentes duraciones de la estadía no se combinan cuando se utiliza un plan de estadía basado en la duración de la estadía. los precios. Por ejemplo, una tarifa de estadía de 3 no se combina con una duración de la estadía de 1 para fijar el precio de una tarifa de estadía de 4. La tasa de duración de la estadía de 4 debe ser explícita especificada.
• La tarifa por 1 noche en los precios basados en la duración de la estadía no se usa como tarifa por noche individual. en precios por fecha.
• Cada propiedad debe usar solo precios basados en la duración de la estadía o 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 de los lugares especificados. combinaciones de tipo de habitación, plan de tarifas y fechas de estadía especificadas en <StatusApplicationControl>

• Las actualizaciones de tarifas usan la acción Delta de forma predeterminada.
• Una actualización de Delta no altera las tarifas almacenadas previamente para otros ocupaciones. Por ejemplo, si especificaste tarifas para una y otra vez habitaciones dobles y envía una actualización de la tarifa de Delta para la habitación habitación de ocupación doble, la tarifa de habitación doble no se modifica.

Overlay: Borra todas las tarifas por ocupación existentes del tipo de habitación. el plan de tarifas y las fechas especificadas en el archivo <StatusApplicationControl>, y reemplazar con tarifas nuevas. Por ejemplo, si especificaste tarifas para una y otra habitaciones dobles, y enviarás una actualización de Overlay para una habitación individual habitación, Google quitará todas las tarifas anteriores (sencillas y dobles) ocupaciones) y solo permanecerá la tarifa de ocupación individual después de la actualización.

Remove: Borra todas las tarifas por ocupación existentes del 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 duración de la estadía solo para el valor especificado. las combinaciones de tipo de habitación, plan de tarifas y fechas de entrada especificadas 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 las tarifas almacenadas previamente para otros la duración de la estadía. Por ejemplo, si especificaste tarifas para la estadía 1 y 2, y envía una actualización de la tarifa de Delta para la estadía 1 y, luego, las tarifas por ocupación de la estadía 2. permanezcan sin cambios.
• Una actualización de Delta reemplaza todas las tarifas por ocupación almacenadas previamente la duración determinada de la estadía. Por ejemplo, si especificaste una única Tarifas de ocupación doble para la estadía 1 y envía una actualización de la tarifa de Delta para la estadía 1 Si solo hay una tarifa de ocupación individual, se quita la tarifa de habitación doble.

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

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

Relacionado con los impuestos

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

En general, Google recomienda usar TaxFeeInfo en lugar de AmountAfterTax

Si es posible, debes incluir AmountBeforeTax (incluso si especificas AmountAfterTax), ya que en ciertas configuraciones regionales (por ejemplo, US) se muestra el valor precio antes de impuestos de forma predeterminada.

Todos los impuestos y tarifas que debe pagar el usuario (IVA, impuestos de estadía, tarifas de limpieza, ciudad impuestos, etc.), aunque no se pague en el momento de la reserva o no se pagan directamente en la propiedad.

Ejemplo

Esta sección ofrece un ejemplo básico de un mensaje de tarifa con elementos opcionales. Después de preparar el 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 Cómo enviar mensajes.

Para 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 usando <id> en el elemento <listing> en el feed de lista de hoteles. Para <PackageID> y <RoomID>, usa los mismos IDs que usar en tu sistema para los planes de tarifas y los tipos de habitaciones (respectivamente). 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 pueden surgir durante el envío Calificar mensajes

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 definían solo para la habitación doble (que también se aplica a las habitaciones individuales), pero ahora hay una tarifa más económica para las unidades individuales. y la ocupación.

Solución

Envía la nueva tarifa de ocupación 1 con la actualización predeterminada centrada en Delta. Esta nueva no afecta a la tarifa de ocupación 2.

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

Descripción

Anteriormente, definiste 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 determinada. el tipo de habitación, el plan de tarifas y las fechas. En este caso, la acción Overlay las tarifas de lista 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 este situación, puedes simplificar tus mensajes enviando solo la actualización de 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 se usará automáticamente ese valor para ocupaciones más bajas. Es decir, no es necesario repetir la misma tarifa nocturna para las ocupaciones del 1 al 6 si son todas iguales. Solo configúrala para 6.