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>

Chaque message <OTA_HotelAvailNotifRQ> est traité comme une mise à jour delta. Pour chaque propriété, date, chambre et forfait spécifiés dans <StatusApplicationControl>, une modification apportée à une restriction précédemment définie ne remplace que la valeur de cette restriction. L'ajout d'une nouvelle restriction n'affecte pas les autres restrictions précédemment définies. Par exemple, si une durée de séjour minimale de deux jours a été définie précédemment, puis qu'un nouveau message contenant uniquement une durée de séjour maximale de sept jours a été mis à jour, cette action n'effacera pas la valeur de durée de séjour minimale précédente.

Éléments et attributs

Le message OTA_HotelAvailNotifRQ inclut 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 n'écrase 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é des prix des chambres.
OTA_HotelAvailNotifRQ / @xmlns 0..1 string (URI) Espace de noms XML.
OTA_HotelAvailNotifRQ / @EchoToken 1 string Identifiant unique pour ce message de demande. 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. Conteneur pour l'élément <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 avez 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 de propriété)" et à la valeur 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'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 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>.

Il doit être supérieur ou égal à 0. La valeur par défaut est 0 en cas de valeur négative ou non fournie.

Remarque : Si vous souhaitez é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 (en fonction du fuseau horaire de l'établissement), incluse, de la plage de dates.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End 1 Date Date de fin (en fonction du fuseau horaire de l'établissement), incluse, de la plage de dates. 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.

S'il est défini sur true, les autres jours de la semaine qui ne sont pas explicitement définis sur "true" sont exclus. En effet, ils sont éliminés des dates comprises entre les valeurs 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.

S'il est défini sur true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont éliminés des dates comprises entre les valeurs 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.

S'il est défini sur true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont éliminés des dates comprises entre les valeurs 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.

S'il est défini sur true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont éliminés des dates comprises entre les valeurs 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.

S'il est défini sur true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont éliminés des dates comprises entre les valeurs 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.

S'il est défini sur true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont éliminés des dates comprises entre les valeurs de 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.

S'il est défini sur true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont éliminés des dates comprises entre les valeurs 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 Transaction (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 l'élément <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. Il doit être spécifié si <RestrictionStatus> ou <LengthOfStay> est indiqué.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay 0..1 LengthsOfStay Conteneur permettant de définir des restrictions liées à la durée du séjour. Il ne doit pas être présent 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 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 pour 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 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 indiquée, cet attribut est défini par défaut sur "Day". La valeur valide est la suivante :
  • Day
Remarque : Une unité "Day" équivaut à une nuitée.
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 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 dans FixedPatternLength. Toute durée de séjour supérieure à FixedPatternLength hérite de la valeur en dernière position. Par exemple, avec FixedPatternLength="4" et FullPatternLOS="YNYN", seules les durées de séjour de 1 et 3 nuits sont autorisées.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus 0..1 RestrictionStatus Définit les restrictions liées au séjour. Il ne doit pas être présent 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

Les valeurs Open et Close sont compatibles avec toutes les valeurs de l'élément <Restriction>. Lorsque les valeurs Open et Close sont utilisées avec les valeurs Arrival et Departure, elles limitent les dates spécifiques d'arrivée et de départ dans le séjour.

  • Open et Close avec Arrival : cette combinaison spécifie les dates du séjour disponibles pour l'arrivée.
  • Open et Close avec Departure : cette combinaison spécifie les dates de départ disponibles dans le séjour.

    • La date Arrival ne limite pas la disponibilité des nuits de séjour après la date d'arrivée.

    Par exemple, un séjour du 1er au 4 avril, dont les dates du 2 au 4 avril sont fermées aux arrivées, reste réservable.

    Remarque :

    • Par défaut, Google suppose que le paramètre Master est défini sur Close pour tous les produits. Vous pouvez configurer ce paramètre dans votre "Disponibilité par défaut" des paramètres de prix Hotel Center. La valeur "Fermé" dans Hotel Center correspond à la valeur Close ici.
    • Définir Master sur Close est appelé "arrêt de la vente".
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction 0..1 enum

    Cet attribut est obligatoire si l'attribut Status est indiqué.

    Les valeurs valides 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 pour réservation à la date spécifiée.

    Arrival et Departure doivent tous deux être disponibles pour le séjour en question. La valeur par défaut pour Arrival et Departure est Open, sauf si un message précédent a été envoyé indiquant que la session a été fermée. De plus, la combinaison chambre/forfait doit être disponible pour toutes les dates du séjour, à l'exception du dernier jour. Cette disponibilité peut être définie par les paramètres par défaut dans Hotel Center ou par l'élément <Status> ou <Restriction>. Si le paramètre par défaut est Close, vous devez envoyer une valeur Status de Open et une valeur restriction de Master pour les dates concernées afin de rouvrir la disponibilité pour les dates de l'itinéraire.

    Par exemple, pour un séjour de trois nuits avec une date d'arrivée le 1er avril, l'itinéraire complet est du 1er au 4 avril. La valeur Status doit être définie sur Open et la valeur Restriction doit être définie sur Master pour le séjour du 1er au 3 avril. Le dernier jour du séjour (4 avril) est fermé, car seules les dates de séjour d'une nuit nécessitent un état Open.

    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 à l'avance de la chambre à ce tarif avant la date d'arrivée (dans le fuseau horaire local 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 1 indique que la chambre peut ê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'aucune restriction ne s'applique quant au moment de la 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 peut ê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 l'heure de fin de la date d'arrivée (par exemple, 18h00).
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset 0..1 integer or duration Durée maximale de réservation à l'avance de la chambre à ce tarif 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'aucune restriction ne s'applique quant au moment de la 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 plus tôt que 18h00, 30 jours avant la date d'arrivée.

    Exemples

    Date d'arrivée de la durée du séjour

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

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

    Supprimer les restrictions liées aux conditions d'utilisation

    Si vous définissez Time="0" sur <LengthOfStay>, cela signifie qu'il n'y a aucune restriction pour la durée du séjour spécifiée. Par exemple, <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> signifie qu'il n'y a pas de restriction de durée maximale de séjour.

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

    Restriction de 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>


    Dates de disponibilité

    Ouvrez des disponibilités 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 des dates de disponibilité

    Fermez les disponibilités pour un type de chambre et un plan tarifaire aux dates spécifiées. (ou "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 anticipée

    Définissez des restrictions minimales et maximales sur la période de réservation à l'avance, applicables 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>

    Réservation à la limite

    Appliquez une heure limite de réservation à 18h00 le jour de l'arrivée, à l'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>


    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 enregistrement le 26 juillet 2023, seules les durées de séjour de 2, 4 et 6 nuits sont autorisées. Les durées de séjour de 1, 3, 5 et 7 nuits 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 inclut 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 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

    Voici 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

    Voici 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>