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 de disponibilité, de tarifs et d'inventaire (ARI).

ARI est un mode d'envoi des prix qui contrôle les tarifs par nuit, la disponibilité et l'inventaire, et qui fournit des contraintes sur la façon dont ils peuvent être combinés. L'ARI permet également d'inclure les taxes, les frais et les promotions.

ARI suit les protocoles standards de l'OpenTravel Alliance (OTA) pour certains des principaux types de messages permettant de définir la disponibilité et l'inventaire.

Tarification basée sur la durée du séjour

Les tarifs LOS-based vous permettent de spécifier les prix par date d'arrivée et durée du séjour, plutôt que par date de séjour. Lorsque vous spécifiez un élément <StatusApplicationControl> pour les tarifs basés sur la durée du séjour, les attributs @Start et @End indiquent une plage de dates d'arrivée pour lesquelles les tarifs de durée du séjour s'appliquent.

Bien que les tarifs basés sur la DDS ne comportent plus de tarifs par nuit, 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 sont plus proches d'un système de tarification basé sur la durée du séjour, vous pouvez toujours profiter de l'ensemble complet de fonctionnalités ARI, en plus de l'efficacité de la bande passante accordée par l'utilisation des mises à jour nocturnes des disponibilités et des restrictions.

Important : Chaque propriété de votre compte doit utiliser des tarifs basés sur la durée du séjour 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é) avant que les tarifs ne soient disponibles. Nous vous recommandons de limiter la taille des messages ARI, en particulier <OTA_HotelRateAmountNotifRQ>, à 5 Mo, avec un taux d'importation limité à 400 fichiers par seconde. Évitez d'envoyer plusieurs informations de voyage spécifiques à une date qui se chevauchent dans un intervalle de trois secondes après le dernier message.

ARI utilise les messages de requête suivants :

• Transaction (données sur un établissement) : Définit le type et les informations sur le forfait (plan tarifaire).

• OTA_HotelRateAmountNotifRQ : définit les montants des tarifs par date ou basés sur 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. L'inventaire peut également être mis à jour à l'aide de ce message, mais OTA_HotelInvCountNotifRQ est préférable.

• 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 obligatoire si l'élément 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 des règles de modification des tarifs pour certaines réservations, certains séjours et certains utilisateurs.

• ExtraGuestCharges (facultatif) : définit la façon dont les tarifs doivent être configurés 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 spécifiques, et un nombre de personnes.

Point clé : 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) ainsi que dans le guide ARI. Tout attribut, élément ou message OTA qui n'est pas spécifiquement décrit ici n'est pas disponible dans notre mise en œuvre ARI.

De plus, d'autres éléments de message Transaction non couverts par la documentation de référence XML sur l'inventaire et la tarification ne sont pas disponibles 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-en votre Technology Account Manager(TAM) afin qu'il puisse les traiter en priorité ou vous indiquer si elles sont prévues pour une prochaine version.

Historique des révisions de la documentation de référence XML sur ARI

Le tableau suivant répertorie les mises à jour de la documentation concernant uniquement les modifications apportées aux fonctionnalités.

Date	Modifications
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), ajout des éléments <AllowablePackageIDs> et <AllowableRoomIDs>
4 février 2021	Ajout des messages de réponse
25 février 2021	Ajout de OTA_HotelInvCountNotifRQ
21 octobre 2020	Ajout du type de message "Modifications de tarifs".