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

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

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

ARI sigue los protocolos estándar de OpenTravel Alliance (OTA) para algunos de los tipos de mensajes principales a fin de definir 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 a las que se aplican las tarifas de duración de la estadía.

Aunque cuando se usan los precios basados en la duración de la estadía, ya no hay tarifas por noche, se pueden aplicar todas las demás funciones de ARI (inventario, disponibilidad, reglas, promociones, etc.) a estas tarifas y se especifican a nivel nocturno. Esto significa que, si tus sistemas se alinean más estrechamente con un sistema de precios basado en la duración de la estadía, puedes aprovechar el conjunto enriquecido de funciones de ARI, además de la eficiencia del ancho de banda que se otorga cuando se usan las actualizaciones de disponibilidad y restricción nocturna.

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 comunícate con nosotros.

Punto clave: Debes enviar los cuatro tipos de mensajes (transacción, tarifa, inventario y disponibilidad) para que los precios estén disponibles. Se recomienda que el tamaño de los mensajes de ARI sea de <OTA_HotelRateAmountNotifRQ> a 5 MB, con un límite de 400 archivos por segundo en la velocidad de carga.

ARI usa los siguientes mensajes de solicitud:

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

• OTA_HotelRateAmountNotifRQ. Define los importes de la tasa de ocupación por fecha o según la duración de la 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 es preferible que uses OTA_HotelInvCountNotifRQ.

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

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

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

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

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

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 ocupación y fechas de entrada y salida específicas.

Punto clave: Las funciones de ARI se limitan a los mensajes y elementos descritos en esta referencia de XML de inventario y precios (ARI) y de la guía de ARI. Cualquier mensaje, elemento o atributo de OTA que no se documente de forma específica aquí no se admite en nuestra implementación de ARI.

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

Google continúa actualizando y mejorando la API. Si usas funciones de precios adicionales en tu sistema, notifica a tu Technology Account Manager(TAM) para que se pueda priorizar con esas funciones. De lo contrario, te informará si hay un lanzamiento planificado.

Historial de revisión de la referencia XML de ARI

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

Fecha	Cambios
14 de agosto de 2020	Versión inicial
21 de octubre de 2020	Se agregó el tipo de mensaje Promociones.
17 de noviembre de 2020	Para los mensajes de transacción (datos de propiedad), se actualizó el extremo y se agregó el atributo action a los elementos PropertyDataSet.
24 de noviembre de 2020	Para los mensajes de transacción (datos de propiedad), 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 Modificaciones de tarifas.