Syntaxe
Le messageOTA_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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 :
|
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
Remarque : Si vous souhaitez établir la disponibilité des chambres et des prix pour un paramètre |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction | 0..1 | Énumération | Cet attribut est obligatoire si l'attribut Les valeurs valides sont les suivantes :
|
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>