Message d'inventaire

Présentation

Le message d'inventaire (OTA_HotelInvCountNotifRQ) définit le 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 chambre de ce type n'est disponible, les produits impliquant ce type de chambre et cette date ne s'afficheront pas.

Les sections suivantes couvrent les consignes générales, un exemple de base et des scénarios pratiques pour vous aider à ajouter et à mettre à jour l'inventaire, et à envoyer des 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 référence XML fournit des descriptions des éléments obligatoires et facultatifs. Pour en savoir plus sur les attributs et les éléments enfants, consultez Éléments et attributs d'inventaire.

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 de respecter 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 le schéma du message "Inventaire", consultez Schémas des annonces d'hôtel.

Consignes

Voici les consignes à suivre pour un message Inventory :

• L'inventaire est associé à un hôtel, une date et un type de chambre.

• Le nombre d'unités disponibles doit être supérieur à 0 pour toutes les nuits du séjour afin que le prix du forfait et de l'occupation associés s'affiche.

• Si le nombre de chambres disponibles est égal à 0, les chambres ne pourront pas être réservées pour l'ID de chambre et la plage de dates spécifiés.

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

• Envoyez l'inventaire mis à jour chaque fois qu'une réservation ou une annulation de chambre a lieu 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 utilisant l'attribut <BookingLimit> du message OTA_HotelAvailNotifRQ.

Inventaire et disponibilité

L'inventaire correspond au nombre de chambres réservables en fonction du nombre physique de chambres. La disponibilité indique si la combinaison d'un type de chambre et d'un plan tarifaire peut être réservée. Pour ARI, la disponibilité et l'inventaire peuvent varier en fonction d'un ensemble de dates ou d'un type d'hébergement. Les deux ont des types de messages correspondants. L'inventaire et la disponibilité sont associés à l'hôtel, à la date et au type de chambre, ainsi qu'au plan tarifaire pour la disponibilité.

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

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

L'inventaire doit être un nombre 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 votre fichier préparé, vous devrez l'envoyer à Google via un message POST à ce point de terminaison :

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

Pour savoir comment envoyer/POSTER le message, consultez Envoyer des messages.

Important : Envoyez à Google un message d'inventaire mis à jour chaque fois que votre inventaire change, par exemple en cas de réservations et 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 le même ID que celui que vous avez utilisé dans votre système pour les types de chambres. Il est essentiel que vos données soient cohérentes avec votre système pour que Google les affiche correctement.

Remarque : <CountType=2> est la seule option valide, car elle indique un nombre de places "disponibles".

Cet exemple montre comment définir l'inventaire de 13 chambres réservables 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 obtenir d'autres exemples, consultez 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 : Bloquer la réservation de salles

Description

Vous devez indiquer qu'aucune chambre de ce type ne peut être réservée pour un ensemble de dates spécifiques, généralement parce qu'elles sont toutes réservées.

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 le nombre d'inventaire d'une chambre est de 0 pour une nuit du séjour, 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>