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 tarifas para cada y la 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
oExtraGuestCharges
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, la ocupación es individual. Las búsquedas mostrarán la tarifa para personas solteras y las búsquedas de ocupación doble la tasa de ocupación triple, y los usuarios que busquen 4 o más no verán la opción y tasas de cambio.
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 la sintaxis de tarifas ejemplo como referencia cuando crees el mensaje de tarifa para garantizar 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 debajo del elemento Rate
especificado se apliquen a las estadías.
definido por las fechas de llegada especificadas en el <StatusApplicationControl>
y las
Valor de duración de la estadía especificada 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 habitaciones dobles y envía una actualización de la tarifa deDelta
para la habitación habitación de ocupación doble, la tarifa de habitación doble no se modifica.
- Las actualizaciones de tarifas usan la acción
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 deOverlay
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 los 1 y el 2 de duración, y envía una actualización de la tarifa deDelta
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 deDelta
para la estadía 1 Si solo hay una tarifa de ocupación individual, se quita la tarifa de habitación doble.
- Las actualizaciones de tarifas usan la acción
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 deOverlay
para la clase 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
Impuestos complejos, como impuestos y tarifas que se aplican por (en lugar de por noche) no se pueden representar enAmountAfterTax
.En general, Google recomienda usar
TaxFeeInfo
en lugar deAmountAfterTax
Si es posible, debes incluir
AmountBeforeTax
(incluso si especificasAmountAfterTax
), 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, impuesto de estadía, tarifa de limpieza, nombre de la 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 Envía 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 sobre cómo agregar, quitar y actualizar tarifas, consulta Tarifas Ejemplos.
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 tasa de ocupación 1 nueva con la actualización predeterminada con alcance de 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, configura la ocupación más alta que admite el tipo de habitación y el plan de tarifas, y automáticamente usa ese valor para las ocupaciones más bajas. Es decir, no es necesario repetir el mismo tarifa por noche para las ocupaciones de 1 a 6 si todas son iguales; simplemente configúralo en 6.