Documentation de référence XML sur la disponibilité, les tarifs et l'inventaire (ARI)

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.

Important :Chaque établissement de votre compte doit utiliser des tarifs basés sur la DDS ou des tarifs par date.

Pour activer la tarification basée sur la DDS dans votre compte, contactez votre TAM ou contactez-nous.

Important :Vous devez envoyer les quatre types de messages (transaction, tarif, inventaire et disponibilité) pour que les prix soient disponibles. Nous vous recommandons de définir spécifiquement une taille de <OTA_HotelRateAmountNotifRQ> à 5 Mo pour les messages ARI, avec une limite d'importation de 400 fichiers par seconde.

ARI utilise les messages de requête suivants:

• Transaction (Données sur un établissement). Définit les informations sur le type et le package (plan tarifaire).

• 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.

Important :Les fonctionnalités ARI sont limitées aux messages et aux éléments décrits dans la documentation de référence XML sur l'inventaire et la tarification (ARI) et dans le guide ARI. Les messages, éléments ou attributs OTA qui ne sont pas spécifiquement décrits ici ne sont pas compatibles avec notre implémentation ARI.

En outre, les autres éléments de message Transaction non couverts par cette documentation de référence XML sur l'inventaire et la tarification (ARI) ne sont pas compatibles avec le type de flux ARI.

Google continue de mettre à jour et d'améliorer l'API. Si vous utilisez des fonctionnalités de tarification supplémentaires dans votre système, informez votre Technology Account Manager(TAM) afin qu'il puisse être traité en priorité avec ces fonctionnalités. Sinon, il vous indiquera si ces fonctionnalités sont prévues pour une version ultérieure.

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".