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 forfait spécifiés dans <StatusApplicationControl>, une mise à jour d'une restriction définie précédemment 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éfinies précédemment. Par exemple, si une durée de séjour minimale de deux jours a été précédemment définie et qu'un nouveau message ne contenant qu'une durée maximale de séjour 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 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 définie précédemment pour SetForwardMaxStay.

Élément / @Attribut	Occurrences	Type	Description
OTA_HotelAvailNotifRQ	1	Complex element	Élément racine d'un message qui définit la disponibilité des 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 - (trait d'union).
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. 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 du 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é dans l'élément <id> de l'élément <listing> du flux Hotel List Feed. L'ID 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 salles restantes pouvant être réservées pour la plage de dates définie dans <StatusApplicationControl>. Si BookingLimit est spécifié, <StatusApplicationControl> doit spécifier InvTypeCode, et <AvailStatusMessage> ne peut pas contenir <LengthOfStay> ni <RestrictionStatus>. La valeur doit être supérieure ou égale à zéro. La valeur par défaut est 0 si elle est négative ou n'est pas fournie. Remarque:Pour établir 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 qui inclut la plage de dates.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End	1	Date	Date de fin (en fonction du fuseau horaire de l'établissement), plage de dates comprise. Doit être supérieure ou égale à la valeur start. Si les valeurs start et end sont égales, 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 (en effet, ils sont 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 dans les champs "Début" et "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 (Données sur un établissement).
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 <StatusApplicationControl> dans les 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 modèle 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 liées à 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 s'il n'y avait aucune restriction. Par exemple, <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> signifie qu'il n'y a pas de durée maximale de séjour. 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 la suivante : Day Remarque:Une unité "Day" correspond à 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 les heures d'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 schéma de restriction de durée de séjour. Remarque:Cet élément doit être présent lorsque vous utilisez MinMaxMessageType="FullPatternLOS" et 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 de séjour. 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 valides 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 configurer cette option via la section "Disponibilité par défaut" des paramètres de tarification de Hotel Center. La valeur "Fermé" dans Hotel Center correspond à la valeur Close indiquée ici. Définir Master sur Close revient à "arrêter 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 (inclus). Departure: Cette valeur empêche les séjours dont la date de départ est comprise dans la plage de dates Start et End (inclus). 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 avant la date d'arrivée (heure locale de l'établissement) pendant laquelle ce prix 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'existe aucune restriction concernant 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 au moins six heures avant la fin de la date d'arrivée (18h00).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset	0..1	integer or duration	Durée maximale avant la date d'arrivée (heure locale de l'établissement) pendant laquelle ce prix 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 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'existe aucune restriction concernant le premier créneau 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 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 18h, soit 30 jours avant la date d'arrivée.

Exemples

Date d'arrivée (LoS)

Définissez les 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 les durées de séjour minimale et maximale (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>

Restriction 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 à l'arrivée

Définissez une restriction de fermeture aux arrivées. Cela permet d'éviter les séjours dont l'arrivée est prévue 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>

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 entièrement 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. On parle également de "vente arrêté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"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Restrictions de réservation à 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>

Date limite de réservation

Définissez une date limite de 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>

Restrictions multiples

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 la comptabilisation de l'inventaire pour un type de chambre sur des 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 sont autorisées. Les durées de séjour 1, 3, 5 et 7 et 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 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 demande 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

La réponse ci-dessous est une réponse à un message OTA_HotelAvailNotifRQ 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>