Documentation de référence XML sur la disponibilité, les tarifs et l'inventaire (ARI)
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ce guide de référence XML fournit des exemples de code et des contenus de référence détaillés pour les différents messages, éléments et attributs disponibles pour les flux ARI (Availability, Rates, Inventory).
Les flux ARI sont un mode d'envoi des prix qui contrôle les tarifs par nuit, la disponibilité et l'inventaire, et qui définit des contraintes liées à leur combinaison. Les flux ARI vous permettent également d'inclure des taxes, des frais et des promotions.
ARI suit les protocoles standards d'OpenTravel Alliance (OTA) pour certains des principaux types de messages permettant de définir la disponibilité et l'inventaire.
Tarifs basés sur la DDS
Les tarifs LOS-based vous permettent de spécifier des tarifs par date d'arrivée et durée de séjour, plutôt que par date de séjour. Lorsque vous spécifiez un élément <StatusApplicationControl> pour un tarif basé sur la DDS, les attributs @Start et @End correspondent à une plage de dates d'arrivée pour laquelle les tarifs DDS s'appliquent.
Lorsque vous utilisez la tarification basée sur la DDS, il n'existe plus de tarifs par nuit, mais toutes les autres fonctionnalités ARI (inventaire, disponibilité, règles, promotions, etc.) peuvent toujours être appliquées à ces tarifs et sont spécifiées au niveau de la nuit. Cela signifie que si vos systèmes s'alignent plus étroitement sur un système de tarification basé sur la DDS, vous pouvez toujours profiter de l'ensemble des fonctionnalités ARI, en plus de l'efficacité de la bande passante obtenue grâce aux mises à jour nocturnes de disponibilité et de restrictions.
Pour activer la tarification basée sur la DDS dans votre compte, contactez votre TAM ou contactez-nous.
OTA_HotelRateAmountNotifRQ : définit le taux d'occupation par date ou en fonction de la durée du séjour par produit (combinaison de type de chambre et de plan tarifaire) pour des plages de dates spécifiques.
OTA_HotelAvailNotifRQ : définit la disponibilité et les restrictions en fonction du type de chambre et des plans tarifaires. Vous pouvez également mettre à jour l'inventaire à l'aide de ce message, mais il est préférable d'utiliser OTA_HotelInvCountNotifRQ.
OTA_HotelInvCountNotifRQ : définit l'inventaire des chambres physiques ou le nombre de chambres disponibles à la vente.
TaxFeeInfo (facultatif) : définit les taxes et les frais pour chaque établissement. Ce message n'est pas nécessaire si AmountAfterTax est spécifié dans le message OTA_HotelRateAmountNotifRQ.
Promotions (facultatif) : définit des tarifs promotionnels pour certaines réservations, certains séjours et certains utilisateurs.
RateModifications (facultatif) : définit les règles de modification des tarifs pour certaines réservations, certains séjours et certains utilisateurs.
ExtraGuestCharges (facultatif) : définit la configuration des tarifs pour les enfants et les adultes supplémentaires.
Chaque message contient un sous-ensemble d'informations permettant à Google de calculer les prix et la disponibilité présentés aux utilisateurs lorsqu'ils recherchent vos établissements avec des dates d'arrivée et de départ et un nombre de personnes spécifiques.
Historique des révisions de la documentation de référence XML ARI
Le tableau suivant répertorie les mises à jour de la documentation concernant les modifications des fonctionnalités uniquement.
Date
Changements
14 août 2020
Version initiale.
21 octobre 2020
Ajout du type de message Promotions.
17 novembre 2020
Pour les messages Transaction (Données sur un établissement), mise à jour du point de terminaison et ajout de l'attribut action aux éléments PropertyDataSet
24 novembre 2020
Pour les messages Transaction (Données sur un établissement), ajoutez les éléments <AllowablePackageIDs> et <AllowableRoomIDs>.
4 février 2021
Ajout de messages de réponse.
25 février 2021
Ajout d'OTA_HotelInvCountNotifRQ.
21 octobre 2020
Ajout du type de message "Modifications des tarifs".
Tous droits réservés. Java est une marque déposée d'Oracle et/ou ses affiliés.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]
