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

Ce guide de référence XML fournit des exemples de code et de contenu de référence détaillés pour les différents messages, éléments et attributs disponibles pour les flux ARI (Availability, Rates) et Inventory (ARI).

ARI est un mode d'envoi de prix qui contrôle les tarifs par nuit, la disponibilité et l'inventaire, et fournit des contraintes sur la manière de les combiner. Les ARI offrent également la flexibilité nécessaire pour inclure les taxes, les frais et les 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.

Utiliser la tarification basée sur la durée du séjour

La tarification LOS-based vous permet de spécifier les tarifs 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 une tarification basée sur la durée du séjour, les attributs @Start et @End représentent une plage de dates d'arrivée auxquelles les tarifs s'appliquent.

Bien que la tarification basée sur la durée de séjour ne soit plus disponible, toutes les autres fonctionnalités ARI (inventaire, disponibilité, règles, promotions, etc.) peuvent toujours être appliquées à ces tarifs et être spécifiées par nuit. Cela signifie que si vos systèmes sont plus proches d'un système de tarification basé sur la durée de séjour, vous pouvez toujours bénéficier de l'ensemble de fonctionnalités ARI enrichies, en plus de l'efficacité de la bande passante offerte par la mise à jour de la disponibilité et des restrictions par nuit.

Important :Chaque propriété de votre compte doit utiliser soit des tarifs LOS, soit des tarifs par date.

Pour activer la tarification basée sur la durée de séjour dans votre compte, veuillez contacter votre responsable de compte technique ou nous contacter.

Important :Vous devez envoyer les quatre types de messages (transaction, tarif, inventaire et disponibilité) avant que la tarification ne soit disponible.

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 les montants de tarif 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. L'inventaire peut également être mis à jour à l'aide de ce message, mais il est préférable de privilégier OTA_HotelInvCountNotifRQ.

• OTA_HotelInvCountNotifRQ : définit l'inventaire des salles 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 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 manière dont les tarifs doivent être configurés pour les enfants et les adultes supplémentaires.

Chaque message contient un sous-ensemble d'informations que Google utilise pour calculer les prix et la disponibilité affichés lorsque les utilisateurs recherchent vos établissements avec des dates d'arrivée et de départ spécifiques, et le nombre de personnes souhaité.

Important :La fonctionnalité ARI est limitée 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. Les messages, éléments ou attributs OTA non documentés ici ne sont pas compatibles avec notre implémentation ARI.

De plus, d'autres éléments de message Transaction non traités dans cette documentation de référence XML sur l'inventaire et la tarification (ARI) ne sont actuellement pas compatibles avec le type de flux ARI.

Nous continuons de mettre à jour et d'améliorer notre API. Si vous utilisez d'autres fonctionnalités de tarification dans votre système, veuillez nous en informer pour que nous puissions les hiérarchiser ou vous indiquer si elles sont prévues.

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

Le tableau suivant ne répertorie les mises à jour de la documentation que pour 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), nous avons mis à jour le point de terminaison et ajouté 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 de messages de réponse.
25 février 2021	Ajout d'OTA_HotelInvCountNotifRQ.
21 octobre 2020	Ajout du type de message "Modifications du tarif".