Descripción general del ARI

La disponibilidad, las tarifas y el inventario (ARI) son un modo de entrega de precios que controla las tarifas por noche, la disponibilidad y el inventario, y proporciona restricciones sobre cómo se pueden combinar estos elementos. El ARI también ofrece flexibilidad para incluir impuestos, tarifas y promociones.

A diferencia de los modos de entrega de precios basados en itinerarios, como las solicitudes de precios a terceros y los precios modificados, los feeds de ARI no se consultan para obtener precios o itinerarios específicos. En cambio, envías mensajes cuando tu modelo de precios tiene datos nuevos o modificados, como cambios en los detalles de las tarifas, las restricciones y la disponibilidad.

Beneficios

La ARI ofrece los siguientes beneficios:

  • Eficiencia del ancho de banda: Aumenta la eficiencia del ancho de banda, ya que reduce el volumen de datos que se deben transmitir. Si envías datos del ARI todas las noches y solo los cambios incrementales, Google puede calcular los precios y las actualizaciones para una amplia variedad de valores de compra anticipada y duración de la estadía.

  • Precisión del precio: Mejora la precisión del precio con un modelo de eventos de inserción en el cambio para proporcionar actualizaciones en tiempo real.

  • Mayor cobertura de precios: Se logra una mayor cobertura de precios (cantidad de itinerarios con precios) con datos detallados que se combinan en varios itinerarios.

  • Flexibilidad: Permite una mayor flexibilidad para ofrecer promociones y paquetes.

  • Facilidad de uso: Transmite los datos de una manera que se alinea con la forma en que se almacenan en tu sistema, lo que evita la necesidad de calcular o almacenar en caché los precios de muchos itinerarios.

Tipos de mensajes de solicitud

Los mensajes de ARI que se envían a Google se denominan mensajes de "solicitud" de ARI. Posteriormente, Google devuelve mensajes de "respuesta" que indican si la operación se realizó correctamente o no.

La API de ARI sigue los protocolos estándar de OpenTravel Alliance (OTA) para algunos de los principales tipos de mensajes que definen la disponibilidad y el inventario.

La API de ARI usa los siguientes mensajes de solicitud:

  • Transaction (Datos de la propiedad) Define el tipo de habitación y la información del paquete (plan de tarifas).

  • OTA_HotelRateAmountNotifRQ. Define los importes de la tarifa de ocupación por fecha o por estadía por producto (combinación de tipo de habitación y plan de tarifas) para períodos específicos.

  • OTA_HotelAvailNotifRQ: Define la disponibilidad y las restricciones según el tipo de habitación y los planes de tarifas. El inventario también se puede actualizar con este mensaje, pero se prefiere OTA_HotelInvCountNotifRQ.

  • OTA_HotelInvCountNotifRQ. Define el inventario de habitaciones físicas o la cantidad de habitaciones disponibles para la venta.

  • TaxFeeInfo: (Opcional) Define los impuestos y las comisiones por propiedad. Este mensaje no es obligatorio si se especifica AmountAfterTax en el mensaje OTA_HotelRateAmountNotifRQ.

  • Promotions. (Opcional) Define tarifas promocionales para ciertas reservas, estadías y usuarios.

  • RateModifications: (Opcional) Define reglas de modificación de tarifas para ciertas reservas, estadías y usuarios.

  • ExtraGuestCharges. (Opcional) Define cómo se deben configurar las tarifas para los niños y los adultos adicionales.

Cada mensaje contiene un subconjunto de información que Google usa para calcular los precios y la disponibilidad que se muestran a los usuarios cuando buscan tus propiedades con fechas de entrada y salida específicas, y la ocupación deseada.

Para obtener más información sobre la ARI, consulta la Referencia de XML.

Mensajes push

Para actualizar la información de la propiedad y del ARI, envía los mensajes asociados cada vez que cambien los datos en tu sistema.

Usa los siguientes lineamientos cuando envíes mensajes:

  • Usa la herramienta de autoservicio en la página Configuración de precios de Hotel Center para agregar o actualizar tus direcciones IP en nuestro sistema.

  • Usa la siguiente ruta base para el extremo:

    • https://www.google.com o Host: www.google.com Port: 443

  • Envía mensajes con el método HTTP POST.

  • Configurar el encabezado Content-Type como application/xml.

  • Existe una tasa de actualización máxima a nivel de la cuenta de 400 mensajes por segundo. Si superas este límite, se mostrará el código de error 6032.

  • Usa las siguientes rutas según los datos que se actualicen:

    • Transaction (datos de la propiedad): /travel/hotels/uploads/property_data
    • OTA_HotelRateAmountNotifRQ: /travel/hotels/uploads/ota/hotel_rate_amount_notif
    • OTA_HotelAvailNotifRQ: /travel/hotels/uploads/ota/hotel_avail_notif
    • OTA_HotelInvCountNotifRQ: /travel/hotels/uploads/ota/hotel_inv_count_notif
    • TaxFeeInfo: /travel/hotels/uploads/taxes
    • Promotions: /travel/hotels/uploads/promotions
    • RateModifications: /travel/hotels/uploads/rate_modifications
    • ExtraGuestCharges:/travel/hotels/uploads/extra_guest_charges

Para cada mensaje de solicitud que reciba, Google responderá con un HTTP 200 OK si la conexión al servidor se realizó correctamente y se incluirá un cuerpo con un mensaje de respuesta que indique si las actualizaciones se aplicaron correctamente o si se encontraron advertencias o errores. Si Google responde con un código de error HTTP, vuelve a enviar el mensaje. Si el cuerpo de la respuesta HTTP contiene advertencias o errores, se deben corregir antes de volver a enviar el mensaje. También puedes ver los problemas que se encontraron en mensajes específicos en la página Estado del feed de Hotel Center.

Publicados en Google (LoG)

Live on Google (LoG) te permite mostrar tus hoteles en los sitios web de Google. Dado que el valor predeterminado del LoG para un hotel es true, todos los hoteles nuevos se mostrarán automáticamente en Google.

Usa Publicados en Google para activar o desactivar los anuncios de tus propiedades y los vínculos gratuitos para reservar en tu cuenta de Hotel Center, independientemente del estado de Google Ads o de si la propiedad tiene tarifas en Google.

Existen dos formas de establecer el valor del LoG de un hotel: el Travel Partner API or the Hotel Center properties page. You can change the status of your existing properties in the Live on Google column on the Hotel Center properties page, or if you want to change the status of a large number of properties at the same time, you can use the Travel Partner API.

Para obtener más detalles sobre LoG, consulta la Ayuda de Hotel Center.

Cómo usar el Travel Partner API, you can do the following:

  • Consulta el estado de tus propiedades a través de Hotel Center o usa el extremo hotelViews.list.

  • Recupera una lista de todos tus hoteles que se muestran en Google con el parámetro filter con liveOnGoogle = TRUE en el extremo hotelViews.list.

  • Obtén un resumen de las propiedades de una cuenta específica, incluido el número de propiedades activas en Google, con hotelViews.summary.

Para obtener más información sobre cómo configurar el LoG con la API, consulta el artículo sobre hotelViews.list y la referencia de la API.