Referencia de XML sobre disponibilidad, inventario y tarifas (ARI)
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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.
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.
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.
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.
Todos los derechos reservados. Java es una marca comercial de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[[["\u003cp\u003eThis XML reference guide details the messages, elements, and attributes for managing hotel availability, rates, and inventory using Availability, Rates, and Inventory (ARI) feeds.\u003c/p\u003e\n"],["\u003cp\u003eARI allows for LOS-based or per-date pricing, enabling flexible control over nightly rates, availability, inventory, taxes, fees, and promotions.\u003c/p\u003e\n"],["\u003cp\u003eKey ARI messages include: Transaction (Property Data), OTA_HotelRateAmountNotifRQ (Rates), OTA_HotelAvailNotifRQ (Availability), OTA_HotelInvCountNotifRQ (Inventory), and optional messages for taxes/fees, promotions, rate modifications, and extra guest charges.\u003c/p\u003e\n"],["\u003cp\u003eEach property should utilize either LOS-based or per-date rates, and all four primary message types (transaction, rate, inventory, and availability) are required for pricing to be available.\u003c/p\u003e\n"],["\u003cp\u003eOnly messages, elements, and attributes specifically documented in this ARI XML reference and the ARI guide are supported; for any additional pricing features used in your system, contact your Technology Account Manager (TAM).\u003c/p\u003e\n"]]],[],null,["# Availability, Rates, and Inventory (ARI) XML Reference\n\nThis XML reference guide provides detailed reference content and code\nexamples for the different messages, elements, and attributes available for\nAvailability, Rates, and Inventory (ARI) feeds.\n\nARI is a pricing delivery mode that controls nightly rates, availability,\nand inventory, and provides constraints on how these can be combined. ARI also\nprovides flexibility to include taxes, fees, and promotions.\n\nARI follows the standard protocols of OpenTravel Alliance (OTA) for some of\nthe main message types for defining availability and inventory.\n\n### LOS-based pricing\n\n`LOS-based` pricing lets you to specify rates per check-in date and length of\nstay, rather than per stay date. When you specify a\n`\u003cStatusApplicationControl\u003e` element for LOS-based pricing, the `@Start` and\n`@End` attributes signifies a range of check-in dates for which the LOS rates\napply.\n\nAlthough when using LOS-based pricing there are no longer nightly rates, all\nother ARI features (inventory, availability, rules, promotions, etc.) can still\nbe applied to these rates and are specified at a nightly level. This means if\nyour systems more closely align with an LOS-based pricing system, you can still\ntake advantage of the rich ARI feature set, in addition to the bandwidth\nefficiency that is granted by making use of the nightly availability and\nrestriction updates.\n| **Key Point:** Each property in your account should use either LOS-based rates or per-date rates.\n\nTo enable LOS-based pricing on your account, contact your TAM or\n[contact us](https://support.google.com/hotelprices/gethelp).\n| **Key Point:** You must send the four message types (transaction, rate, inventory, and availability) before pricing is available. It is recommended that you the size of ARI messages specifically `\u003cOTA_HotelRateAmountNotifRQ\u003e` to 5MB with a limit of 400 files per second upload rate.\n\nARI uses the following request messages:\n\n- [`Transaction` (Property Data)](/hotels/hotel-prices/xml-reference/ari-property). Defines the type and package\n (rate plan) information.\n\n- [`OTA_HotelRateAmountNotifRQ`](/hotels/hotel-prices/xml-reference/ari-rate). Defines the per-date or LOS-based\n occupancy rate amounts per product (room type and rate plan combination) for\n specific date ranges.\n\n- [`OTA_HotelAvailNotifRQ`](/hotels/hotel-prices/xml-reference/ari-avail). Defines availability and restrictions\n based on room type and rate plans. Inventory can also be updated using this\n message, but `OTA_HotelInvCountNotifRQ` is preferred.\n\n- [`OTA_HotelInvCountNotifRQ`](/hotels/hotel-prices/xml-reference/ari-inv). Defines the physical room inventory or\n number of rooms available to be sold.\n\n- [`TaxFeeInfo`](/hotels/hotel-prices/xml-reference/ari-tax). (Optional) Defines per-property taxes and fees. This\n message isn't required if `AmountAfterTax` is specified in the\n `OTA_HotelRateAmountNotifRQ` message.\n\n- [`Promotions`](/hotels/hotel-prices/xml-reference/ari-promotions). (Optional) Defines promotional rates for\n certain bookings, stays, and users.\n\n- [`RateModifications`](/hotels/hotel-prices/xml-reference/ari-rate-modifications). (Optional) Defines rate\n modification rules for certain bookings, stays, and users.\n\n- [`ExtraGuestCharges`](/hotels/hotel-prices/xml-reference/ari-extra-guest-charges). (Optional) Defines how rates\n should be configured for children and additional adults.\n\nEach message contains a subset of information that Google uses to compute the\nprices and availability displayed to users when they search for your\nproperties with specific check-in and check-out dates and occupancy.\n| **Key Point:** ARI features is limited to the messages and elements described within this Inventory \\& Pricing (ARI) XML reference and the ARI guide. Any OTA message, element, or attribute not specifically documented here is not supported in our ARI implementation.\n|\n|\n| Also, other [Transaction message](/hotels/hotel-prices/xml-reference/transaction-messages) elements not covered in\n| this Inventory \\& Pricing (ARI) XML reference are not supported when\n| using the ARI feed type.\n| Google continues to update and improve the API. If you use additional pricing features in your system, notify your `Technology Account Manager(TAM)` so that it can be prioritized with those features or they will let you know if those features are planned for a release.\n\nARI XML Reference revision history\n----------------------------------\n\nThe following table lists documentation updates for feature changes only.\n\n| Date | Changes |\n|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| August 14, 2020 | Initial release. |\n| October 21, 2020 | Added the Promotions message type. |\n| November 17, 2020 | For Transaction (Property Data) messages, updated the [endpoint](../dev-guide/ari-overview#pushing-messages) and added the `action` attribute to PropertyDataSet elements. |\n| November 24, 2020 | For Transaction (Property Data) messages, added the `\u003cAllowablePackageIDs\u003e` and `\u003cAllowableRoomIDs\u003e` elements. |\n| February 4, 2021 | Added response messages. |\n| February 25, 2021 | Added `OTA_HotelInvCountNotifRQ`. |\n| October 21, 2020 | Added the Rate Modifications message type. |"]]