Message de disponibilité

Présentation

Le message de disponibilité (OTA_HotelAvailNotifRQ) définit si un produit (type de chambre associé à un plan tarifaire) pour un séjour donné peut être vendu pour les dates applicables. Lorsque vous envoyez un message de disponibilité, vous indiquez si la disponibilité ou les restrictions d'un produit ont changé.

Important : L'inventaire peut également être mis à jour à l'aide du type de message "Disponibilité", mais le type de message "Inventaire" (OTA_HotelInvCountNotifRQ) est la méthode recommandée.

Les sections suivantes couvrent les consignes générales, un exemple de base et des scénarios pratiques pour vous aider à ajouter et à modifier la disponibilité à l'aide du message de disponibilité.

Restriction de disponibilité la nuit

Le message "Disponibilité" vous permet de définir des restrictions qui contrôlent la disponibilité globale d'une réservation. Un type de restriction notable est la "disponibilité par nuit", qui indique si le produit peut être vendu à une date donnée. Pour qu'un séjour (de l'arrivée au départ) puisse être réservé, il doit y avoir des disponibilités pour chaque nuit et toutes les autres restrictions de réservation et de séjour doivent être respectées.

Remarque : Pour en savoir plus sur le concept de disponibilité et sur les différences entre l'inventaire et la disponibilité, consultez Inventaire et disponibilité.

Paramètres de restriction

Par défaut, RestrictionStatus pour Restriction="Master" est fermé. En d'autres termes, par défaut, la vente est arrêtée chaque nuit.

Pour pouvoir être vendu, un produit doit avoir <RestrictionStatus Restriction="Master" Status="Open"> pour toutes les combinaisons de produits et pour toutes les nuits d'un séjour. Vous devez envoyer à Google un Open explicite pour chaque produit ou modifier la valeur par défaut dans Hotel Center. Pour ce faire, accédez à la page Prix > Paramètres dans Hotel Center et modifiez le champ "Disponibilité par défaut".

Autres restrictions

Arrivée/Départ

Empêche la vente d'un itinéraire arrivant ou partant à la date spécifiée. La valeur par défaut est Open.

Décalage minimal et maximal des réservations

Indique que le séjour doit être acheté au moins ou au plus un certain nombre de jours avant l'arrivée.

Durée de séjour minimale et maximale

Restreint la durée du séjour pour les séjours dont la date d'arrivée correspond à cette date.

Durée de séjour minimale et maximale (ou "séjour")

Restreint la durée du séjour pour les itinéraires qui contiennent cette date de séjour.

Modèle de durée de séjour

 : permet de contrôler précisément les durées de séjour autorisées pour cette date d'arrivée.

Consignes générales

• Les restrictions de disponibilité sont associées à l'hôtel, à la date, au type de chambre et au plan tarifaire.

• Un produit n'est réservable que s'il n'y a aucune restriction imposée qui s'applique au séjour (de l'arrivée au départ) ou au moment où l'utilisateur peut réserver le séjour.

• Envoyez à Google un message de mise à jour de la disponibilité chaque fois que les restrictions de disponibilité du produit changent pour des dates spécifiques.

Exemple

Cette section fournit un exemple de base de message de disponibilité 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_avail_notif

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

Important : Envoyez un message mis à jour à Google chaque fois que la disponibilité change.

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. La cohérence avec votre système est essentielle pour que Google affiche correctement vos données.

Cet exemple montre comment définir des restrictions de disponibilité :

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <AvailStatusMessages HotelCode="HOTELID">
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="202X-03-20"
                                End="202X-03-25"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay MinMaxMessageType="SetMinLOS" Time="2" TimeUnit="Day" />
      </LengthsOfStay>
      <RestrictionStatus Restriction="Master" Status="Open" />
    </AvailStatusMessage>
</OTA_HotelAvailNotifRQ>

Pour obtenir d'autres exemples, consultez Exemples de disponibilité.

Guides pratiques

Cette section fournit des solutions aux scénarios que vous pouvez rencontrer lors de l'envoi de messages de disponibilité, en particulier des informations sur la restriction de disponibilité nocturne (également appelée "stop sell").

Scénario 1 : Vendre des produits à des dates spécifiques

Description

Vous souhaitez rendre une combinaison de type de chambre et de plan tarifaire (produit) disponible à des dates spécifiques.

Remarque : Par défaut, Google considère que l'option "Arrêter la vente" est activée pour les produits (disponibilité nocturne fermée). Toutefois, vous pouvez configurer si la restriction de disponibilité nocturne est ouverte ou fermée par défaut. Vous devez envoyer à Google un Open explicite pour chaque produit ou modifier la valeur par défaut dans Hotel Center.

Solution

Définissez la restriction Master sur Open et spécifiez les dates.

Échantillon

Cet exemple montre comment ouvrir la disponibilité nocturne d'un produit pendant quelques semaines en mars.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-03-20"
                                End="2022-03-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Remarque : Pour que le prix d'un produit s'affiche, la restriction de disponibilité par nuit doit être définie sur Open (et l'inventaire doit être un nombre entier supérieur à 0 pour la chambre).

Pour savoir comment définir les prix, consultez Résoudre les problèmes de prix manquants ou incomplets.

Scénario 2 : Arrêter de vendre des produits à des dates spécifiques

Description

Vous souhaitez explicitement arrêter la vente d'un produit (plutôt que de le déclarer en rupture de stock) à des dates spécifiques.

Remarque : Si le produit est complètement désactivé, car le type de chambre, le plan tarifaire ou leur combinaison sont désactivés, il est préférable d'utiliser le message Transaction (Données sur l'établissement) pour dissocier le produit, car il ne dépend pas de la date.

Solution

Définissez la restriction Master sur Close et spécifiez les dates.

Échantillon

Cet exemple montre comment "arrêter la vente" ou fermer la disponibilité de nuit pour un produit à des dates spécifiques.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-04-20"
                                End="2022-04-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>