OTA_HotelAvailNotifRQ

Requêtes

Syntaxe

Le message OTA_HotelAvailNotifRQ utilise la syntaxe suivante:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="message_ID"
                       TimeStamp="timestamp"
                       Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <AvailStatusMessages HotelCode="HotelID">
    <AvailStatusMessage BookingLimit="integer">
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID"/>
      <LengthsOfStay FixedPatternLength="integer">
        <LengthOfStay Time="integer"
                      TimeUnit="[Day]"
                      MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
                      SetForwardMinStay|FullPatternLOS]">
          <LOS_Pattern FullPatternLOS="pattern"/>
        </LengthOfStay>
      </LengthsOfStay>
      <RestrictionStatus Status="[Close|Open]"
                         Restriction="[Arrival|Departure|Master]"
                         MaxAdvancedBookingOffset="integer_or_duration"
                         MinAdvancedBookingOffset="integer_or_duration"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Important :Chaque message <OTA_HotelAvailNotifRQ> est traité comme une mise à jour delta. Pour chaque établissement, date, chambre et formule spécifiés dans <StatusApplicationControl>, une mise à jour d'une restriction précédemment définie ne remplace que la valeur de la même restriction, tandis que l'ajout d'une nouvelle restriction n'affecte pas les autres restrictions déjà définies. Par exemple, si une durée minimale de séjour de deux jours a été définie précédemment, puis qu'un nouveau message ne contenant qu'une durée de séjour maximale de sept jours a été modifié, cette action n'efface pas la valeur précédente.

Éléments et attributs

Le message OTA_HotelAvailNotifRQ comporte les éléments et les attributs suivants:

Remarque:Chaque type de restriction de durée de séjour est défini indépendamment. Par exemple, un message qui définit SetMaxLOS ne remplace pas une valeur précédemment définie pour SetForwardMaxStay.

Élément / @Attribut	Occurrences	Type	Description
OTA_HotelAvailNotifRQ	1	Complex element	Élément racine d'un message qui définit la disponibilité du prix des chambres.
OTA_HotelAvailNotifRQ / @xmlns	0..1	string (URI)	Espace de noms XML.
OTA_HotelAvailNotifRQ / @EchoToken	1	string	Identifiant unique de ce message de requête. Cette valeur est renvoyée dans le message de réponse. Les caractères autorisés sont a-z, A-Z, 0-9, _ (trait de soulignement) et - (tiret).
OTA_HotelAvailNotifRQ / @TimeStamp	1	DateTime	Date et heure de création de ce message.
OTA_HotelAvailNotifRQ / @Version	1	decimal	Version du message OpenTravel.
OTA_HotelAvailNotifRQ / POS	0..1	POS	Conteneur permettant de spécifier le compte partenaire pour ce message. Il est généralement utilisé si votre backend fournit des flux de prix pour plusieurs comptes partenaires.
OTA_HotelAvailNotifRQ / POS/ Source	1	Source	Obligatoire si <POS> est présent. Un conteneur pour <RequestorID>.
OTA_HotelAvailNotifRQ / POS / RequestorID	1	RequestorID	Obligatoire si <POS> est présent. Définit le compte partenaire.
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID	1	string	Compte partenaire pour ce message. Cette valeur de chaîne correspond à la valeur Partner key indiquée sur la page Paramètres du compte dans Hotel Center. Remarque:Si vous disposez d'un backend qui fournit des flux pour plusieurs comptes, cette valeur doit correspondre à la valeur de l'attribut partner de votre message Transaction (Données sur un établissement) et à celle de l'attribut ID dans l'élément <RequestorID> de votre message <OTA_HotelRateAmountNotifRQ> pour le même compte.
OTA_HotelAvailNotifRQ / AvailStatusMessages	1	AvailStatusMessages	Conteneur pour un ou plusieurs éléments <AvailStatusMessage>.
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode	1	string	Identifiant unique de 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. L'identifiant de l'hôtel est également indiqué dans Hotel Center.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage	1..n	AvailStatusMessage	Définit la disponibilité des prix des chambres et les restrictions applicables pour différentes périodes et pour un même établissement.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit	1	integer	Remarque:Il est préférable d'utiliser le message OTA_HotelInvCountNotifRQ plutôt que de définir cet attribut. Nombre de chambres restantes pouvant être réservées pour la plage de dates dans <StatusApplicationControl>. Si BookingLimit est spécifié, <StatusApplicationControl> doit spécifier InvTypeCode, et <AvailStatusMessage> ne peut pas contenir <LengthOfStay> ni <RestrictionStatus>. Doit être supérieure ou égale à 0. La valeur par défaut est 0 si elle est négative ou n'est pas fournie. Remarque:Afin de déterminer la disponibilité des chambres pour un paramètre <StatusApplicationControl> donné, l'attribut BookingLimit doit être défini au moins une fois.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl	1	StatusApplicationControl	Définit la plage de dates, ainsi que les identifiants du type de chambre (InvTypeCode) et du plan tarifaire (RatePlanCode).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start	1	Date	Date de début basée sur le fuseau horaire de l'établissement, incluant la plage de dates.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End	1	Date	Date de fin (basée sur le fuseau horaire de l'établissement), y compris la plage de dates. Doit être supérieure ou égale à la valeur start. Si start et end sont égaux, la mise à jour s'applique à cette date.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon	0..1	boolean	Définissez cet attribut sur true ou 1 pour inclure explicitement les lundis. Si la valeur est true, les autres jours de la semaine qui ne sont pas explicitement définis sur "true" sont exclus (ils sont donc exclus des dates comprises dans la plage Start and End).)
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue	0..1	boolean	Définissez cet attribut sur true ou 1 pour inclure explicitement les mardis. Si la valeur est true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont exclus des dates comprises entre Start et End.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds	0..1	boolean	Définissez cet attribut sur true ou 1 pour inclure explicitement les mercredis. Si la valeur est true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont exclus des dates comprises entre Start et End.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur	0..1	boolean	Définissez cet attribut sur true ou 1 pour inclure explicitement les jeudis. Si la valeur est true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont exclus des dates comprises entre Start et End.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri	0..1	boolean	Définissez cet attribut sur true ou 1 pour inclure explicitement les vendredis. Si la valeur est true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont exclus des dates comprises entre Start et End.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat	0..1	boolean	Définissez cet attribut sur true ou 1 pour inclure explicitement les samedis. Si la valeur est true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont exclus des dates comprises entre les dates de début et de fin End.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun	0..1	boolean	Définissez cet attribut sur true ou 1 pour inclure explicitement les dimanches. Si la valeur est true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont exclus des dates comprises entre Start et End.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode	1	string	Identifiant unique de l'inventaire (type de chambre). Cette valeur correspond à <RoomID> dans un message Transactions (Property Data).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode	0..1	string	Identifiant unique du plan tarifaire. Cet identifiant correspond à la valeur de <PackageID> dans un message Transaction (Données sur un établissement). Le plan tarifaire est également défini et référencé dans l'élément <StatusApplicationControl> des messages <OTA_HotelRateAmountNotifRQ> et <OTA_HotelAvailNotifRQ>. L'attribut RatePlanCode n'est pas applicable et ne doit pas être spécifié lorsque <AvailStatusMessage> contient l'attribut BookingLimit. Doit être spécifié si <RestrictionStatus> ou <LengthOfStay> est spécifié.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay	0..1	LengthsOfStay	Conteneur permettant de définir des restrictions de durée de séjour. Ce champ est absent si <AvailStatusMessage> inclut l'attribut BookingLimit.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength	0..1	integer	Longueur du motif défini dans FullPatternLOS. Remarque:Cet attribut doit être défini lorsque vous utilisez MinMaxMessageType="FullPatternLOS" et absent dans le cas contraire.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay	1..n	LengthOfStay	Définit les restrictions applicables à la durée du séjour. Lorsque vous utilisez plusieurs éléments <LengthOfStay>, chacun doit spécifier une valeur MinMaxMessageType différente.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time	0..1	integer	Valeur unitaire de la mesure de la durée du séjour. Notez qu'une valeur de zéro est traitée comme une absence de restriction. Par exemple, <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> signifie qu'il n'y a pas de durée de séjour maximale. Remarque:Cet attribut doit être défini, sauf si vous utilisez MinMaxMessageType="FullPatternLOS".
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit	0..1	enum	Unité de temps. Si aucune valeur n'est fournie, la valeur par défaut est "Day". La valeur valide est : Day Remarque:Une unité "Day" équivaut à un séjour d'une nuit.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType	1	enum	Différents types de restrictions liées à la durée du séjour SetMaxLOS, SetMinLOS et FullPatternLOS sont basés sur l'arrivée. SetForwardMinStay et SetForwardMaxStay sont basés sur le séjour. Les valeurs maximales doivent être supérieures ou égales aux valeurs minimales.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern	0..1	LOS_Pattern	Définit le modèle de restriction pour la durée du séjour. Remarque:Cet élément doit être présent lorsque vous utilisez MinMaxMessageType="FullPatternLOS" et être absent dans le cas contraire.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS	1	string	Séquence de caractères Y et N indiquant si chaque durée de séjour est autorisée, d'une nuit à la valeur indiquée dans FixedPatternLength. Toute durée de séjour supérieure à FixedPatternLength hérite de la valeur à la position finale. Par exemple, avec FixedPatternLength="4" et FullPatternLOS="YNYN", seules les durées de séjour 1 et 3 sont autorisées.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus	0..1	RestrictionStatus	Définit les restrictions liées aux séjours. Ce champ est absent si <AvailStatusMessage> inclut l'attribut BookingLimit.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status	0..1	enum	Indique si le type de restriction spécifié par l'attribut Restriction est ouvert ou fermé. Les valeurs possibles sont les suivantes : Open Close Remarque : Par défaut, Google suppose que le paramètre Master est défini sur Close pour tous les produits. Vous pouvez le configurer via "Disponibilité par défaut" dans les paramètres de tarification Hotel Center. La valeur "Fermé" dans Hotel Center correspond à la valeur Close indiquée ici. Si vous définissez Master sur Close, on parle d'arrêt de la vente.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction	0..1	enum	Cet attribut est obligatoire si Status est fourni. Les valeurs possibles sont les suivantes : Arrival: Cette valeur empêche les séjours dont la date d'arrivée est comprise dans la plage de dates Start et End (incluse). Departure: Cette valeur empêche les séjours dont la date de départ est comprise dans la plage de dates Start et End (incluse). Master: : cette valeur indique si le prix de la chambre est disponible à la réservation à la date indiquée. Remarque:Si Restriction n'est pas spécifié, la valeur par défaut est Master.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset	0..1	integer or duration	Durée minimale de réservation avant la date d'arrivée (heure locale de l'établissement) pour laquelle ce tarif de chambre peut être réservé. Les types de valeurs reconnus sont les suivants : Integer: : nombre de jours avant la date d'arrivée. Par exemple, la valeur 1 indique que la chambre doit être réservée à ce tarif au moins un jour avant la date d'arrivée. La valeur 0 (valeur par défaut) indique qu'il n'y a aucune restriction sur la dernière heure de réservation. ISO 8601 Duration (days, hours, and minutes): Nombre de jours (et éventuellement d'heures/minutes) avant la date d'arrivée. Par exemple, la valeur P1D indique que la chambre doit être réservée à ce tarif un jour avant la date d'arrivée. La valeur P0DT6H indique que la réservation doit avoir lieu six heures avant la date d'arrivée (par exemple, 18h) ou avant.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset	0..1	integer or duration	Durée maximale de réservation de ce tarif de chambre avant la date d'arrivée (heure locale de l'établissement). Les types de valeurs reconnus sont les suivants : Integer: : nombre de jours avant la date d'arrivée. Par exemple, la valeur 30 indique que la chambre ne peut pas être réservée à ce tarif plus de 30 jours avant la date d'arrivée. La valeur 0 (valeur par défaut) indique qu'il n'y a aucune restriction sur la date de réservation au plus tôt. ISO 8601 Duration (days, hours, and minutes): Nombre de jours (et éventuellement d'heures/minutes) avant la date d'arrivée. Par exemple, la valeur P30D indique que la chambre ne peut pas être réservée à ce tarif plus de 30 jours avant la date d'arrivée. La valeur P30DT6H indique que la réservation ne peut pas avoir lieu avant 18h00, soit 30 jours avant la date d'arrivée.

Exemples

Date d'arrivée DDS

Définissez des durées de séjour minimale et maximale (en fonction de la date d'arrivée).

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Durée de la DDS

Définissez des durées de séjour minimales et maximales (en fonction du séjour).

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Restrictions au départ

Définissez une restriction de fermeture aux départs. Cela permet d'éviter les séjours dont la date de départ correspond aux dates spécifiées.

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

Restriction d'arrivée

Définissez une restriction de fermeture aux arrivées. Cela permet d'éviter les séjours dont la date d'arrivée correspond aux dates spécifiées.

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

Ouvrir les dates de disponibilité

Ouvrir la disponibilité pour un type de chambre et un plan tarifaire aux dates spécifiées.

Remarque:Pour que les prix soient complètement disponibles, vous devez également indiquer un tarif par nuit, ainsi qu'un inventaire supérieur à 0 pour le type de chambre.

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

Fermer les dates de disponibilité

Fermez les disponibilités pour un type de chambre et un plan tarifaire aux dates spécifiées. (ce processus est également appelé "arrêt de vente").

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

Restrictions liées aux réservations à l'avance

Définissez des restrictions minimales et maximales pour la période de réservation à l'avance, appliquées uniquement le week-end.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                Mon=”false”
                                Tue=”false”
                                Weds=”false”
                                Thur=”false”
                                Fri=”false”
                                Sat=”true”
                                Sun=”true”
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MaxAdvancedBookingOffset="30"
                         MinAdvancedBookingOffset="2"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Arrêter la réservation

Définissez une heure limite pour la réservation le jour d'arrivée, à 18h (heure locale de l'hôtel).

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MinAdvancedBookingOffset="P0DT6H0M"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Plusieurs restrictions

Définissez plusieurs restrictions sur les mêmes dates pour un type de chambre et un plan tarifaire.

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

Remarque :Si Restriction n'est pas spécifié, la valeur par défaut est Master.

Limite de réservation

Définissez l'inventaire d'un type de chambre aux dates spécifiées.

Remarque:Il est préférable d'utiliser le message OTA_HotelInvCountNotifRQ plutôt que de définir cet attribut.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage BookingLimit="5">
      <!-- Note: RatePlanCode must not be specified here when setting inventory counts. -->
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

FullPatternLoS

Définissez une restriction de durée de séjour complète.

Pour un arrivée le 26 juillet 2023, seules les durées de séjour de 2, 4 et 6 personnes sont autorisées. Les durées de séjour 1, 3, 5 et 7 ou plus ne sont pas disponibles.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-26"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay FixedPatternLength="7">
        <LengthOfStay MinMaxMessageType="FullPatternLOS">
          <LOS_Pattern FullPatternLOS="NYNYNYN"/>
        </LengthOfStay>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Réponses

Syntaxe

Le message OTA_HotelAvailNotifRS utilise la syntaxe suivante:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="timestamp"
                       EchoToken="echo_token"
                       Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelAvailNotifRS>

Éléments et attributs

Le message OTA_HotelAvailNotifRS comporte les éléments et les attributs suivants:

Élément / @Attribut	Occurrences	Type	Description
OTA_HotelAvailNotifRS	1	Complex element	Élément racine d'une réponse à un message de disponibilité.
OTA_HotelAvailNotifRS / @TimeStamp	1	DateTime	Date et heure de création de ce message.
OTA_HotelAvailNotifRS / @EchoToken	1	string	Identifiant unique du message OTA_HotelAvailNotifRQ associé.
OTA_HotelAvailNotifRS / Success	0..1	Success	Indique que le message OTA_HotelAvailNotifRQ a bien été traité. Chaque message contient soit <Success>, soit <Errors>.
OTA_HotelAvailNotifRS / Errors	0..1	Errors	Conteneur pour un ou plusieurs problèmes rencontrés lors du traitement du message OTA_HotelAvailNotifRQ. Chaque message contient soit <Success>, soit <Errors>.
OTA_HotelAvailNotifRS / Errors / Error	1..n	Error	Description d'une erreur rencontrée lors du traitement du message OTA_HotelAvailNotifRQ. Pour en savoir plus sur ces erreurs, consultez Messages d'erreur concernant l'état du flux.
OTA_HotelAvailNotifRS / Errors / Error / @Type	1	integer	Type d'avertissement d'erreur (EWT) OpenTravel Alliance associé à l'erreur. Seule la valeur 12 (Processing exception) est utilisée.
OTA_HotelAvailNotifRS / Errors / Error / @Code	1	integer	Code d'erreur (ERR) OpenTravel Alliance associé à l'erreur. Seule la valeur 450 (Unable to process) est utilisée.
OTA_HotelAvailNotifRS / Errors / Error / @Code	1	enum	État de la requête d'origine. Seule la valeur NotProcessed est utilisée.
OTA_HotelAvailNotifRS / Errors / Error / @ShortText	1	string	Identifiant Google du problème. Pour en savoir plus sur ces erreurs, consultez Messages d'erreur concernant l'état du flux.

Exemples

Opération réussie

Vous trouverez ci-dessous une réponse à un message OTA_HotelAvailNotifRQ traité avec succès.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Success/>
</OTA_HotelAvailNotifRS>

Erreurs

Vous trouverez ci-dessous une réponse à un message OTA_HotelAvailNotifRC non traité en raison d'erreurs.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelAvailNotifRS>