Referencia de XML sobre disponibilidad, inventario y tarifas (ARI)

En esta guía de referencia de XML, se proporcionan ejemplos de código y contenido de referencia detallados para los diferentes mensajes, elementos y atributos disponibles para los feeds de disponibilidad, tarifas e inventario (ARI).

El ARI es 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 proporciona flexibilidad para incluir impuestos, comisiones y promociones.

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

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

Los precios de LOS-based te permiten especificar tarifas por fecha de entrada y duración de la estadía, en lugar de por fecha de estadía. Cuando especificas un elemento <StatusApplicationControl> para los precios basados en la duración de la estadía, los atributos @Start y @End indican un rango de fechas de entrada para las que se aplican las tarifas de duración de la estadía.

Si bien cuando se usan precios basados en la duración de la estadía ya no hay tarifas por noche, todas las demás funciones del ARI (inventario, disponibilidad, reglas, promociones, etcétera) se pueden seguir aplicando a estas tarifas y se especifican a nivel de la noche. Esto significa que, si tus sistemas se alinean más con un sistema de precios basado en el LOS, aún puedes aprovechar el amplio conjunto de funciones del ARI, además de la eficiencia del ancho de banda que se otorga al utilizar las actualizaciones nocturnas de disponibilidad y restricciones.

Punto clave: Cada propiedad de tu cuenta debe usar tarifas basadas en la duración de la estadía o tarifas por fecha.

Para habilitar los precios basados en la duración de la estadía en tu cuenta, comunícate con tu TAM o envíanos un mensaje.

Punto clave: Debes enviar los cuatro tipos de mensajes (transacción, tarifa, inventario y disponibilidad) antes de que los precios estén disponibles. Se recomienda que limites el tamaño de los mensajes de la ARI específicamente <OTA_HotelRateAmountNotifRQ> a 5 MB, con un límite de 400 archivos por segundo de velocidad de carga. Evita enviar varios mensajes con información superpuesta sobre el itinerario para una fecha específica en un intervalo de 3 segundos desde el último mensaje.

La ARI usa los siguientes mensajes de solicitud:

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

• OTA_HotelRateAmountNotifRQ: Define los importes de las tarifas 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 y ocupación específicas.

Punto clave: Las funciones de la API de ARI se limitan a los mensajes y elementos que se describen en esta referencia XML de Inventory & Pricing (ARI) y en la guía de la API de ARI. Los mensajes, elementos o atributos de OTA que no se documentan específicamente aquí no son compatibles con nuestra implementación de ARI.

Además, no se admiten otros elementos del mensaje de transacción que no se incluyen en esta referencia de XML de inventario y precios (ARI) cuando se usa el tipo de feed de ARI.

Google sigue actualizando y mejorando la API. Si usas funciones de precios adicionales en tu sistema, notifica a tu Technology Account Manager(TAM) para que se prioricen con esas funciones o te informen si se planea lanzar esas funciones.

Historial de revisiones de la referencia de XML del ARI

En la siguiente tabla, se enumeran las actualizaciones de la documentación solo para los cambios en las funciones.

Fecha	Cambios
14 de agosto de 2020	Versión inicial
21 de octubre de 2020	Se agregó el tipo de mensaje de Promociones.
17 de noviembre de 2020	En el caso de los mensajes de Transaction (datos de la propiedad), se actualizó el endpoint y se agregó el atributo action a los elementos PropertyDataSet.
24 de noviembre de 2020	Para los mensajes de Transaction (Property Data), se agregaron los elementos <AllowablePackageIDs> y <AllowableRoomIDs>.
4 de febrero de 2021	Se agregaron mensajes de respuesta.
25 de febrero de 2021	Se agregó OTA_HotelInvCountNotifRQ.
21 de octubre de 2020	Se agregó el tipo de mensaje Rate Modifications.