OTA_HotelAvailNotifRQ

Demandes

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 établissement, date, chambre et formule spécifiés dans <StatusApplicationControl>, la 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 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é 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 liée à la durée du 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 de 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 sur un établissement) 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'identifiant de l'hôtel est également répertorié 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 l'attribut BookingLimit est spécifié, <StatusApplicationControl> doit spécifier InvTypeCode, et <AvailStatusMessage> ne peut pas contenir <LengthOfStay> ni <RestrictionStatus>.

Doit être égal ou supérieur à 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 dans 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 "Start" (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 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 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 ne doit pas être présent 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 :
  • Day
Remarque:Une unité "Day" équivaut à 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 de durée du 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 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 de l'itinéraire pour l'arrivée et le départ, respectivement.

  • Open et Close avec Arrival : cette combinaison spécifie les dates du voyage disponibles pour l'enregistrement.
  • Open et Close avec Departure : cette combinaison spécifie les dates du voyage disponibles pour le départ.

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

    Par exemple, pour un séjour du 1er au 4 avril, les dates du 2 au 4 avril étant fermées, vous pouvez toujours réserver.

    Remarque :

    • Par défaut, Google suppose que le paramètre Master pour tous les produits est Close. Vous pouvez le configurer dans "Disponibilité par défaut" dans les paramètres de tarification Hotel Center. La valeur "Fermé" dans Hotel Center correspond à la valeur Close ici.
    • Définir Master sur Close est appelé "stop sell".
    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 avoir une disponibilité ouverte pour le voyage donné. La valeur par défaut pour Arrival et Departure est Open, sauf si un message précédent a été envoyé indiquant qu'il a été fermé. 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 d'Hotel Center ou via 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 réouvrir 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 s'étend 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 par 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 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 (selon l'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 du DDS

    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 de la DDS

    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 de visibilité

    Définir Time="0" sur <LengthOfStay> indique qu'il n'y a pas de restrictions pour la durée de 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>

    Dates de fin 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>

    Heure limite de réservation

    Appliquez une limite de réservation à 18h00 (heure locale de l'hôtel) pour 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-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>


    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 complète sur la durée du séjour du modèle.

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

    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>