Message d'inventaire

Présentation

Le message "Inventory" (OTA_HotelInvCountNotifRQ) définit les décomptes d'inventaire. (nombre de salles physiques) pouvant être réservées pour une salle spécifique de données. Lorsque vous envoyez un message d'inventaire, vous indiquez le nombre de salles sont disponibles à une date donnée. Si aucune salle de ce type n'est disponible, les produits associés à ce type de chambre et à cette date ne s'affichent pas.

Les sections suivantes fournissent des consignes générales, un exemple de base et des instructions pour vous lancer dans l'ajout et la mise à jour d'un inventaire, Messages d'inventaire.

Pour obtenir des exemples de différents scénarios liés à l'inventaire, consultez les tutoriels.

Éléments obligatoires et facultatifs

La documentation de référence XML fournit une description des éléments obligatoires et facultatifs. Pour en savoir plus sur les attributs et les éléments enfants, consultez la section Éléments d'inventaire et Attributs.

Syntaxe et schémas

Utilisez l'onglet "Inventaire" syntaxique comme code lorsque vous créez le message "Inventory" (Inventaire) afin de vous assurer que vous suivez le bon format.

Vous pouvez utiliser un outil XML tiers tel que xmllint pour valider vos flux avec les schémas publiés avant de les envoyer à Google. Pour l'inventaire consultez Schémas Hotel Ads.

Consignes

Respectez les consignes suivantes pour un message d'inventaire:

• L'inventaire est classé par hôtel, date et type de chambre.

• Le nombre d'inventaires doit être supérieur à 0 pour toutes les nuits du séjour dans l'ordre pour afficher le prix correspondant au forfait et au nombre de personnes associés.

• Si le nombre d'inventaires est égal à 0, les salles ne seront pas disponibles pour pour l'identifiant de chambre et la plage de dates spécifiés.

• CountType doit toujours avoir la valeur 2 pour être valide, car il indique le nombre de « disponibilités déterminées ».

• Envoyer l'inventaire à jour pour chaque réservation ou annulation d'une chambre se produit dans votre système.

Remarque :Envoyez le nombre d'inventaires de chambres à l'aide de OTA_HotelInvCountNotifRQ (méthode recommandée) ou une autre méthode en utilisant Attribut <BookingLimit> du message OTA_HotelAvailNotifRQ.

Inventaire et disponibilité

L'inventaire correspond au nombre de salles réservables en fonction du nombre physique et disponibilité indique si la combinaison du type de chambre et du plan tarifaire est peuvent être réservées. Pour les flux ARI, la disponibilité et l'inventaire peuvent pour un ensemble de dates ou un type d'hébergement, et ont toutes les deux messages d'erreur. L'inventaire et la disponibilité sont déterminés par hôtel, date et chambre ainsi qu'un plan tarifaire pour la disponibilité.

Il peut y avoir « aucune disponibilité » même s'il y a un inventaire, et la disponibilité sont indépendantes les unes des autres.

Il existe deux concepts de disponibilité. Tout d'abord, il y a la disponibilité globale d'un produit pour un séjour donné, en fonction de facteurs tels que si un tarif défini pour chaque nuit, l'inventaire pour le type de chambre associé, et la restriction de disponibilité est ouverte. Deuxièmement, restriction appliquée à un produit à une date donnée (représentée par <RestrictionStatus Restriction="Master" Status="Open"/> dans OTA_HotelAvailNotifRQ) et cette disponibilité est connue sous le nom de « vente arrêtée ».

L'inventaire doit être un nombre entier supérieur à 0 pour la chambre et la disponibilité doit être ouverte pour que le prix d'un produit s'affiche.

Remarque :Si une chambre est pleine, les plans tarifaires qui lui sont associés ne seront plus vendues.

Exemple

Cette section fournit un exemple basique de message d'inventaire utilisant les attributs et les éléments facultatifs. Une fois votre fichier préparé, vous devez l'envoyer à Google via un message POST à ce point de terminaison :

https://www.google.com/travel/hotels/uploads/ota/hotel_inv_count_notif

Pour en savoir plus sur la méthode Push/POST du message, consultez la section Push messages.

Important :Envoyez à Google un message "Inventory" mis à jour dès que votre inventaire en cas de réservation ou d'annulation, par exemple.

Pour HotelCode, saisissez l'identifiant d'hôtel unique que vous avez indiqué dans votre système pour identifiant l'établissement. Cette valeur doit correspondre à l'identifiant de l'hôtel spécifié via <id> dans le <listing> de l'élément Hotel List Feed. Pour <RoomID>, utilisez l'ID que vous avez utilisé dans votre système pour types de chambres. La cohérence avec votre système est essentielle pour que Google affiche correctement vos données.

Remarque : <CountType=2> est la seule option valide, car elle indique un nombre de "disponibilités définitives".

Cet exemple montre comment définir un inventaire pour 13 salles réservables pour mois de décembre:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Pour voir d'autres exemples, consultez la section Inventaire exemples.

Guides pratiques

Cette section présente un scénario que vous pouvez rencontrer lors de l'envoi d'une Message "Inventory" (Inventaire).

Scénario: Comment empêcher la réservation de salles

Description

Vous devez indiquer qu'il ne reste aucune salle à réserver pour ce type de chambre à des dates spécifiques, généralement parce qu'elles complet.

Solution

Définissez <InvCount Count> sur une valeur 0 et ajoutez la période souhaitée.

Échantillon

Cet exemple montre comment utiliser InvCount pour définir l'inventaire sur 0 pour la chambre et les dates spécifiées (par exemple, les premières semaines de janvier).

Remarque :Si l'inventaire d'une chambre est de 0 pour n'importe quelle nuit d'un séjour, alors le séjour ne peut pas être réservé pour les produits associés à cette chambre.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>