OTA_HotelAvailNotifRQ

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"
                       TimeStamp="timestamp"
                       Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_account_name"/>
    </Source>
  </POS>
  <AvailStatusMessages HotelCode="HotelID">
    <AvailStatusMessage BookingLimit="integer">
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID"/>
      <LengthsOfStay>
        <LengthOfStay Time="integer"
                      TimeUnit="[Day]"
                      MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
                      SetForwardMinStay]"/>
      </LengthsOfStay>
      <RestrictionStatus Status="[Close|Open]"
                         Restriction="[Arrival|Departure|Master]"
                         MaxAdvancedBookingOffset="integer"
                         MinAdvancedBookingOffset="integer"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Éléments et attributs

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

Élément / @Attribut	Occurrences	Type	Description
OTA_HotelAvailNotifRQ	1	Élément complexe	Élément racine d'un message qui définit la disponibilité des prix des chambres.
OTA_HotelAvailNotifRQ / AvailStatusMessages	1	AvailStatusMessages	Conteneur pour un ou plusieurs éléments `<AvailStatusMessage>`.
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode	1	Chaîne	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 / POS	0..1	POS	Conteneur permettant de spécifier le compte partenaire pour ce message (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	Chaîne	Compte partenaire pour ce message. Cette valeur de chaîne correspond à la valeur "Partner key" (Clé partenaire) 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 / 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	Entier	Nombre de chambres restantes pouvant être réservées pour la plage de dates dans `<StatusApplicationControl>`. Si l'attribut `BooklingLimit` 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. Si aucune valeur n'est indiquée, cet attribut est défini par défaut sur 0. 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 de la plage de dates.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End	1	Date	Date de fin 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	Booléen	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` et `End`.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue	0..1	Booléen	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	Booléen	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	Booléen	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	Booléen	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	Booléen	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` et `End`.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun	0..1	Booléen	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	Chaîne	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	Chaîne	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 / 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	1	Entier	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.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit	0..1	Énumération	Unité de temps. Si aucune valeur n'est indiquée, cet attribut est défini par défaut sur "Day" (Jour). Les valeurs valides sont les suivantes : Jour
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType	1	Énumération	Différents types de restrictions liées à la durée du séjour. `SetMaxLOS` et `SetMinLOS` 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 / 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	Énumération	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 : Si vous souhaitez établir la disponibilité des chambres et des prix pour un paramètre `<StatusApplicationControl>` donné, l'attribut `Status` doit être défini sur Open (Ouvert) et l'attribut `Restriction` doit être défini sur Master (Maître) au moins une fois. Les partenaires peuvent également demander à Google de configurer leur compte de sorte que l'attribut `Status` soit défini par défaut sur Open (Ouvert) lorsqu'ils nous ont indiqué un prix et que `BookingLimit` est supérieur à 0.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction	0..1	Énumération	Cet attribut est obligatoire si l'attribut `Status` est indiqué. Les valeurs valides sont les suivantes : Arrival (Arrivée) : 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 (Départ) : 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 (Maître) : cette valeur indique si le prix de la chambre est disponible pour réservation à la date spécifiée.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset	0..1	Entier	Nombre minimal de jours avant la date d'arrivée où ce prix de chambre peut être réservé.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset	0..1	Entier	Nombre maximal de jours avant la date d'arrivée où ce prix de chambre peut être réservé.

Exemples

Exemple 1

Durée minimale/maximale du séjour (en fonction de la date d'arrivée) + Délai minimal/maximal d'achat à l'avance + Fermé aux arrivées + Nombre d'inventaires

<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage BookingLimit="5">
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5"
                      MinMaxMessageType="SetMaxLOS"/>
        <LengthOfStay Time="2"
                      MinMaxMessageType="SetMinLOS"/>
      </LengthsOfStay>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close"
                         Restriction="Arrival"
                         MaxAdvancedBookingOffset="30"
                         MinAdvancedBookingOffset="7"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Exemple 2

Durée minimale/maximale du séjour (en fonction du séjour)

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

Exemple 3

Fermé aux départs (empêche 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"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close"
                         Restriction="Departure"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Exemple 4

Fermé aux arrivées (empêche 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"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close"
                         Restriction="Arrival"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Exemple 5

Disponibilité ouverte, aucune restriction

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage BookingLimit="5">
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open"
                         Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Exemple 6

Restrictions liées à la période minimale/maximale de réservation à l'avance appliquées le week-end uniquement

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-01-01"
                                End="2020-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>

Exemple 7

Permet de définir 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"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close"
                         Restriction="Master"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open"
                         Restriction="Arrival"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open"
                         Restriction="Departure"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>