Message d'inventaire

Présentation

Le message d'inventaire (OTA_HotelInvCountNotifRQ) définit le nombre d'inventaires (nombre de chambres physiques) disponibles à la réservation pour des types de chambres spécifiques. Lorsque vous envoyez un message d'inventaire, vous indiquez le nombre de chambres de ce type disponibles à une date donnée. Si aucune pièce de ce type n'est disponible, les produits associés à ce type et à cette date ne s'affichent pas.

Les sections suivantes présentent les consignes générales, un exemple de base et des procédures pour vous aider à ajouter et à mettre à jour un inventaire, et à envoyer des messages d'inventaire.

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

Éléments obligatoires et facultatifs

La 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'exemple de syntaxe d'inventaire comme référence lorsque vous créez le message d'inventaire pour 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 connaître le schéma du message d'inventaire, consultez la section Schémas des annonces d'hôtel.

Consignes

Pour un message d'inventaire, procédez comme suit:

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

• Le nombre d'inventaires doit être supérieur à 0 pour toutes les nuits du séjour afin d'afficher le prix pour le plan tarifaire et le nombre de personnes associés.

• Si le nombre d'inventaires est égal à 0, aucune chambre ne sera disponible à la réservation pour l'ID de chambre et la période spécifiés.

• CountType doit toujours avoir la valeur 2 pour être valide, car il indique un nombre de "disponibilité définie".

• Envoyez un inventaire à jour chaque fois qu'une réservation ou une annulation de salle est effectuée dans votre système.

Remarque :Envoyez le nombre de chambres disponibles à l'aide de OTA_HotelInvCountNotifRQ (méthode recommandée) ou de la méthode alternative à l'aide de l'attribut <BookingLimit> du message OTA_HotelAvailNotifRQ.

Inventaire ou disponibilité

L'inventaire correspond au nombre de chambres pouvant être réservées en fonction du nombre de personnes. La disponibilité indique si la combinaison du type de chambre et du plan tarifaire est autorisée à être réservée. Pour les flux ARI, la disponibilité et l'inventaire peuvent tous deux varier en fonction d'un ensemble de dates ou d'un type d'hébergement, et sont associés à des types de messages correspondants. Les stocks et les disponibilités sont classés par hôtel, date et type de chambre, avec l'ajout d'un plan tarifaire pour la disponibilité.

Il peut y avoir "aucune disponibilité" même s'il y a un inventaire, car l'inventaire et la disponibilité sont indépendants l'un de l'autre.

Il existe deux concepts de disponibilité. Tout d'abord, la disponibilité globale d'un produit pour un séjour donné dépend de facteurs tels que le tarif défini pour chaque nuit, l'inventaire pour le type de chambre associé et les restrictions de disponibilité. Ensuite, il existe la restriction spécifique appliquée à un produit à une date donnée, représentée par <RestrictionStatus Restriction="Master" Status="Open"/> dans OTA_HotelAvailNotifRQ, et la fermeture de cette disponibilité est appelée "arrêt de la vente".

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

Remarque :Si une chambre est complète, les plans tarifaires associés ne peuvent plus être vendus.

Exemple

Cette section fournit un exemple de base de message d'inventaire utilisant des éléments obligatoires et facultatifs. Une fois le 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 manière de transférer/envoyer le message via la méthode POST, consultez la section Envoyer des messages.

Important :Envoyez à Google un message d'inventaire actualisé à chaque fois que votre inventaire change, par exemple en cas de réservations ou d'annulations.

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

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

Cet exemple montre comment définir l'inventaire de 13 salles pouvant être réservées pour le 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 plus d'exemples, consultez la section Exemples d'inventaire.

Guides pratiques

Cette section présente un scénario que vous pouvez rencontrer lors de l'envoi d'un message d'inventaire.

Scénario: Empêcher la réservation de salles

Description

Vous devez indiquer qu'aucune chambre restante ne peut être réservée pour ce type de chambre à des dates spécifiques, généralement parce qu'elles sont déjà complètes.

Solution

Vous définissez <InvCount Count> sur une valeur de 0 et ajoutez la plage de dates souhaitée.

Échantillon

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

Remarque :Si le nombre d'inventaires d'une chambre est de 0 pour n'importe quelle nuit de séjour, le séjour ne peut être réservé pour aucun des 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>