Promotions

Si vous avez un backend qui fournit des flux pour plusieurs comptes, cette valeur doit correspondre à la valeur de l'attribut ID spécifiée dans l'élément <RequestorID> de vos messages <OTA_HotelRateAmountNotifRQ> et <OTA_HotelAvailNotifRQ> pour le même compte.

Promotions pour un établissement. Chaque promotion s'applique à un seul établissement.

Sauf utilisation de <Stacking>, la promotion avec la plus grande remise est appliquée à la réservation lorsque plusieurs promotions sont éligibles.

Si cet attribut est spécifié, la valeur doit être "overlay". Dans ce cas, toutes les promotions stockées sont supprimées avant le stockage des promotions spécifiées dans le message actuel."overlay"

S'il n'est pas spécifié, chaque promotion spécifiée dans le message actuel est:

• Added (si aucune des promotions stockées ne possède le même id) ;
• Updated (si une promotion stockée a le même id)
• Deleted (si une promotion stockée a le même id et que la valeur de l'attribut action pour la promotion spécifiée dans le message actuel est "delete")

Promotion unique pour un établissement. Notez que si action="overlay" et qu'aucun élément <Promotion> n'est spécifié, toutes les promotions pour l'établissement sont supprimées.

Si vous devez utiliser plus de 99 promotions, contactez votre responsable de compte technique (TAM).

Si cet attribut est spécifié, la valeur doit être delete. S'il n'est pas spécifié et qu'aucune promotion ayant le même id n'est stockée, cette promotion est stockée. Sinon, s'il n'est pas spécifié et qu'une promotion ayant le même id est stockée, la promotion existante est mise à jour.

Si delete est spécifié, la promotion stockée ayant le même id est supprimée. En cas d'utilisation de delete, n'incluez aucun élément enfant dans <Promotion>. De plus, delete n'est pas autorisé avec <HotelPromotions action="overlay"/>.

Date ou heure de début (en fonction du fuseau horaire de l'établissement), incluse, de la plage.

• La date ou l'heure spécifiée par start doit être antérieure (ou identique) à la date ou l'heure spécifiée par end.
• Si start n'est pas spécifié, la plage est en fait illimitée en ce qui concerne l'heure de début.
• Si start est renseigné en tant que date "AAAA-MM-JJ", il est interprété comme une date et heure "AAAA-MM-JJT00:00:00".

Date de fin ou heure de fin (en fonction du fuseau horaire de l'établissement), incluse, de la plage.

• La date ou l'heure spécifiée par end doit être postérieure (ou identique) à la date ou l'heure spécifiée par start.
• Si end n'est pas spécifié, la plage est en fait illimitée en ce qui concerne l'heure de fin.
• Si end est fourni sous la forme de date "AAAA-MM-JJ", il est interprété comme une date et heure "AAAA-MM-JJT23:59:59".

Jours de la semaine autorisés dans la plage de dates. Si cet attribut n'est pas spécifié, tous les jours sont autorisés dans la plage de dates. Chaque caractère de la chaîne spécifie un jour. Par exemple, "MTWHF" indique que les jours de la semaine sont autorisés dans la plage de dates.

Caractères valides:

• M pour lundi
• T pour mardi
• W pour mercredi
• H pour jeudi
• F pour vendredi
• S pour samedi
• U pour dimanche

Toute combinaison de caractères est valide.

Les types de valeurs reconnus sont les suivants :

• Entier:nombre de jours avant la date d'arrivée. Par exemple, une valeur 30 indique que la promotion ne s'applique qu'aux réservations effectuées au moins 30 jours avant la date d'arrivée.
• Durée ISO 8601 (jours, heures et minutes) : nombre de jours (et éventuellement d'heures/minutes) avant la date d'arrivée. Par exemple, une valeur P30D indique que la promotion ne s'applique qu'aux réservations effectuées au moins 30 jours avant la date d'arrivée. La valeur P30DT6H nécessite une réservation avant le 30e jour avant l'arrivée, à 18h00 ou avant.

Les types de valeurs reconnus sont les suivants :

• Entier:nombre de jours avant la date d'arrivée. Par exemple, une valeur de 30 indique que la promotion ne s'applique qu'aux réservations effectuées au plus tard 30 jours avant la date d'arrivée.
• Durée ISO 8601 (jours, heures et minutes) : nombre de jours (et éventuellement d'heures/minutes) avant la date d'arrivée. Par exemple, une valeur de P30D indique que la promotion ne s'applique qu'aux réservations effectuées au plus tard 30 jours avant la date d'arrivée. La valeur P30DT6H nécessite une réservation à partir de 18h00 le 30e jour avant l'arrivée.

Définit les restrictions liées à la valeur maximale qu'un tarif peut atteindre après l'application des promotions.

Les promotions doivent toujours spécifier un <Discount> ou un <BestDailyDiscount>. Pour créer une promotion qui n'applique qu'un <Ceiling>, vous pouvez définir un <Discount> avec un percentage de 0.

Si l'empilement est configuré, plusieurs promotions avec <Ceiling> peuvent s'appliquer à un même séjour. Chaque promotion s'applique à son prix réduit, immédiatement suivi de son plafond. L'exemple suivant montre comment chaque plafond contribue au calcul de la promotion suivante dans la pile.

Exemple :

Fixer le tarif d'un séjour d'une nuit où AmountBeforeTax est égal à 100 et où deux promotions sont cumulées:

1. Promotion avec le type d'empilement base, un fixed_amount de 25 et un plafond amount_per_night de 60
2. Promotion avec type d'empilement second, fixed_amount de 25 et un plafond amount_per_night de 90

Voici l'ordre de calcul:

1. La promotion base est appliquée en premier et réduit le prix de AmountBeforeTax à 75, mais le plafond le réduit ensuite à 60.
2. La promotion second offre une remise de 60 à 35 € sur le AmountBeforeTax. Ce nombre est inférieur au plafond de 90 ; le deuxième plafond n'est donc pas appliqué. Le tarif final est de 35.

Le fait que 60 % soit un plafond global plus strict est sans importance, car il n'est valable que pour sa propre promotion. Il ne peut pas y avoir de plafond unique couvrant l'ensemble de la pile de promotions.

Montant maximal qu'un tarif par nuit peut atteindre après l'application de la remise.

Si un élément <Floor> est également spécifié, il doit être défini sur une valeur supérieure ou égale à l'attribut amount_per_night dans <Floor>.

amount_per_night est appliqué aux taxes et aux frais lorsqu'ils sont inclus dans le tarif par nuit à l'aide de AmountAfterTax, mais pas ceux spécifiés à l'aide de TaxFeeInfo.

Définit les restrictions concernant la valeur minimale qu'un tarif peut avoir après l'application des promotions.

Les promotions doivent toujours spécifier un <Discount> ou un <BestDailyDiscount>. Pour créer une promotion qui n'applique qu'un <Floor>, vous pouvez définir un <Discount> avec un percentage de 0.

La logique <Floor> s'applique toujours aux remises <FreeNights>, même si une remise 100% est appliquée à la nuit sans frais.

Si l'empilement est configuré, plusieurs promotions avec <Floor> peuvent s'appliquer à un même séjour. Chaque promotion s'applique à son prix réduit, immédiatement suivi de son prix plancher. L'exemple suivant montre comment chaque étage contribue au calcul de la promotion suivante dans la pile.

Exemple :

Fixer le tarif d'un séjour d'une nuit où AmountBeforeTax est égal à 100 et où deux promotions sont cumulées:

1. Promotion avec le type d'empilement base, un fixed_amount de 25 et un amount_per_night de 90
2. Promotion avec le type d'empilement second, fixed_amount de 25 et un amount_per_night de 60

Voici l'ordre de calcul:

1. La promotion base est appliquée en premier et réduit le prix de AmountBeforeTax à 75, mais le plancher le fait passer à 90.
2. La promotion second réduit le prix de la AmountBeforeTax de 90 à 65. Ce nombre est supérieur au niveau de plancher de 60. Le deuxième niveau n'est donc pas appliqué. Le tarif final est de 65.

Le fait que 90 % soit un plancher global plus strict est sans importance, car il n'est valide que pour sa propre promotion. Il ne peut pas y avoir de plancher unique couvrant l'ensemble de la pile de promotions.

Montant minimal auquel un tarif par nuit peut être défini après l'application de la remise.

Si un élément <Ceiling> est également spécifié, il doit être défini sur une valeur inférieure ou égale à l'attribut amount_per_night dans <Ceiling>.

amount_per_night est appliqué aux taxes et aux frais lorsqu'ils sont inclus dans le tarif par nuit à l'aide de AmountAfterTax, mais pas ceux spécifiés à l'aide de TaxFeeInfo.

Plage de dates indiquant le moment auquel l'arrivée doit avoir lieu pour que la promotion soit appliquée. Cet élément n'est pas obligatoire si vous supprimez une ou plusieurs promotions.

Le format YearlessDate est également accepté.

• Si start ou end est une date sans année, les deux attributs doivent être renseignés avec une valeur sans année.
• Les plages de dates sans année ne doivent pas se répéter à l'arrivée du Nouvel An. Représentez plutôt la plage en deux plages de dates adjacentes. Par exemple, {"12-29", "01-05"} peut être représenté par {"12-29", "12-31"} et {"01-01", "01-05"}.

Jours de la semaine autorisés dans la plage de dates. Si cet attribut n'est pas spécifié, tous les jours sont autorisés dans la plage de dates. Chaque caractère de la chaîne spécifie un jour. Par exemple, "MTWHF" indique que les jours de la semaine sont autorisés dans la plage de dates.

Caractères valides:

• M pour lundi
• T pour mardi
• W pour mercredi
• H pour jeudi
• F pour vendredi
• S pour samedi
• U pour dimanche

Toute combinaison de caractères est valide.

Plage de dates indiquant le moment auquel le départ doit avoir lieu pour que la promotion soit appliquée. Cet élément n'est pas obligatoire si vous supprimez une ou plusieurs promotions.

Le format YearlessDate est également accepté.

• Si l'un des attributs start ou end est une date sans année, les deux doivent être renseignés avec une valeur sans année.
• Les plages de dates sans année ne doivent pas se répéter à l'arrivée du Nouvel An. Représentez plutôt la plage en deux plages de dates adjacentes. Par exemple, {"12-29", "01-05"} peut être représenté par {"12-29", "12-31"} et {"01-01", "01-05"}.

Jours de la semaine autorisés dans la plage de dates. Si cet attribut n'est pas spécifié, tous les jours sont autorisés dans la plage de dates. Chaque caractère de la chaîne spécifie un jour. Par exemple, "MTWHF" indique que les jours de la semaine sont autorisés dans la plage de dates.

Caractères valides:

• M pour lundi
• T pour mardi
• W pour mercredi
• H pour jeudi
• F pour vendredi
• S pour samedi
• U pour dimanche

Toute combinaison de caractères est valide.

Vous devez spécifier un seul Discount ou BestDailyDiscount.

Indique la remise à appliquer pour cette promotion.

Vous devez spécifier exactement un seul des éléments suivants : percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price ou fixed_price_per_night.

Valeur décimale comprise entre 0 et 100 indiquant le pourcentage de remise. Elle est appliquée à AmountAfterTax (ou à AmountBeforeTax si AmountAfterTax n'est pas spécifié).

Exemples :

• Si AmountAfterTax est égal à 100 et que percentage est égal à 20, alors

  taux de promotion = AmountAfterTax * (1 - pourcentage de remise)

  80.00 = 100 * (1 - 0.2)

• Si AmountBeforeTax est égal à 100, que percentage est égal à 20 et que TaxFeeInfo spécifie une taxe de 10, alors

  taux de promotion = AmountBeforeTax * (1 - pourcentage de remise) + taxe

  90.00 = 100 * (1 - 0.2) + 10

Vous devez spécifier exactement un seul des éléments suivants : percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price ou fixed_price_per_night.

Valeur décimale comprise entre 0 et 100 indiquant le pourcentage de remise de base. Comme percentage, il est appliqué à AmountAfterTax (ou à AmountBeforeTax si AmountAfterTax n'est pas spécifié).

Contrairement à percentage, cette remise est toujours calculée en pourcentage des tarifs de base, quelles que soient les promotions précédentes appliquées dans l'ordre.

Exemple :

• Supposons que deux promotions soient appliquées de manière séquentielle à un séjour d'une nuit au prix de 100 €. La première est une remise de 10 %, et la seconde est une remise de 10% sur le prix de base. Le tarif réduit sera alors de 80, car les deux promotions offrent une remise de 10. Notez que si la deuxième promotion était également une remise de pourcentage standard, le tarif réduit serait de 81, car la deuxième promotion offre une remise de 10% sur 90.

Vous devez spécifier exactement un seul des éléments suivants : percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price ou fixed_price_per_night.

Montant fixe à soustraire de la somme des tarifs par nuit de AmountAfterTax (ou de la somme des tarifs par nuit AmountBeforeTax si AmountAfterTax n'est pas spécifié). Il est supposé être dans la même devise que les tarifs par nuit. Si ce nombre est supérieur à la somme des tarifs par nuit, la valeur obtenue est égale à zéro.

Exemples :

• Si nous fixons le tarif d'un séjour d'une nuit où AmountBeforeTax est égal à 90, AmountAfterTax à 100 et fixed_amount à 20, alors

  taux de promotion = AmountAfterTax - remise fixe

  80.00 = 100 - 20

• Si nous fixons le tarif d'un séjour d'une nuit où AmountBeforeTax est égal à 100, fixed_amount est égal à 20 et TaxFeeInfo indique une taxe de 8%, alors

  taux de promotion = (AmountBeforeTax - remise fixe) * (1 + pourcentage de taxe)

  86,40 = (100 - 20) * 1,08

• Si nous fixons le tarif d'un séjour d'une nuit où AmountBeforeTax est égal à 50, fixed_amount est égal à 60 et TaxFeeInfo indique une taxe de 10, alors

  taux de promotion = (AmountBeforeTax - remise fixe) * taxe

  10.00 = 0 + 10

• Si nous fixons le tarif d'un séjour de trois nuits où les valeurs AmountAfterTax sont 100, 110 et 120, et où fixed_amount est égal à 150, alors

  taux de promotion = somme(AmountAfterTax) - (remise fixe)

  180.00 = (100 + 110 + 120) - 150

Vous devez spécifier exactement un seul des éléments suivants : percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price ou fixed_price_per_night.

Remise fixe appliquée à chacun des tarifs par nuit AmountAfterTax (ou valeur N la plus basse si applied_nights est spécifié). Si AmountAfterTax n'est pas spécifié, la remise est appliquée à AmountBeforeTax. Il est supposé être dans la même devise que les tarifs par nuit. Si l'attribut fixed_amount_per_night est supérieur à un tarif par nuit, ce tarif est réduit à zéro. La remise ne peut pas générer un tarif négatif.

Exemples :

• Si nous fixons le tarif d'un séjour de trois nuits où les valeurs AmountAfterTax sont 100, 110 et 120, et où fixed_amount_per_night est égal à 10, alors

  taux de promotion = somme(AmountBeforeTax - montant fixe de la remise)

  300.00 = ((100 - 10) + (110 - 10) + (120 - 10))

• Si nous fixons le tarif d'un séjour de trois nuits où les valeurs AmountAfterTax sont 10, 50 et 100, et où fixed_amount_per_night est égal à 20, alors

  taux de promotion = somme(AmountAfterTax - montant fixe de la remise)

  110.00 = (0 + (50 - 20) + (100 - 20))

Vous devez spécifier exactement un seul des éléments suivants : percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price ou fixed_price_per_night.

Si des tarifs par nuit AmountAfterTax sont spécifiés, le prix du séjour, taxes et frais inclus, est défini sur la valeur spécifiée. Si AmountBeforeTax est spécifié, que AmountAfterTax soit spécifié ou non, le prix avant taxes du séjour est défini sur la valeur spécifiée. Il est supposé être dans la même devise que les tarifs par nuit.

Si AmountAfterTax est destiné à refléter une taxe en pourcentage, définir un prix fixe pour AmountBeforeTax peut entraîner des taxes et des frais inexacts. En règle générale, nous vous recommandons vivement d'utiliser TaxFeeInfo pour spécifier les taxes et les frais d'une propriété.

Exemples :

• Si nous fixons le tarif d'un séjour d'une nuit où AmountBeforeTax est égal à 90, AmountAfterTax à 100 et fixed_price à 80, alors le tarif promotionnel est de 80.
• Si nous fixons le tarif d'un séjour d'une nuit où AmountBeforeTax est égal à 100, fixed_amount est égal à 80 et TaxFeeInfo indique une taxe de 8%, alors

  taux de promotion = prix fixe * (1 + pourcentage de taxe)

  86,40 = 80 * 1,08

• Si nous fixons le tarif d'un séjour de trois nuits où les valeurs AmountAfterTax sont 100, 110 et 120, et où fixed_amount est égal à 300, alors

  taux de promotion = 300

Vous devez spécifier exactement un seul des éléments suivants : percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price ou fixed_price_per_night.

Si des tarifs par nuit AmountAfterTax sont spécifiés, le prix de chaque nuit du séjour, taxes et frais inclus, est défini sur la valeur spécifiée. Si AmountBeforeTax est spécifié, que AmountAfterTax soit spécifié ou non, le prix avant taxes pour chaque nuit de séjour est défini sur la valeur spécifiée. Il est supposé être dans la même devise que les tarifs par nuit.

Si AmountAfterTax est destiné à refléter une taxe en pourcentage, définir un prix fixe pour AmountBeforeTax peut entraîner des taxes et des frais inexacts. En règle générale, nous vous recommandons vivement d'utiliser TaxFeeInfo pour spécifier les taxes et les frais d'une propriété.

Si applied_nights est spécifié, le nouveau prix est appliqué aux N nuits les moins chères.

Exemples :

• Si nous fixons le tarif d'un séjour de deux nuits où les valeurs AmountBeforeTax sont 90, 90, les valeurs AmountAfterTax sont 100, 100 et fixed_price est 80, le tarif promotionnel est 80 + 80 = 160.
• Si nous fixons le tarif d'un séjour de deux nuits où AmountBeforeTax est égal à 100, fixed_amount à 80 et TaxFeeInfo indique une taxe de 8%, le tarif promotionnel est (80 + 80) * 1,08 = 172,8.
• Si nous fixons le tarif d'un séjour de trois nuits où les valeurs AmountAfterTax sont 100, 110 et 120, et où fixed_amount est égal à 110, alors le tarif promotionnel est 110 * 3 = 330.

Cet attribut ne doit être utilisé qu'avec percentage ou fixed_amount_per_night.

Nombre de nuits auxquelles la remise est appliquée, en commençant par le tarif le plus bas. Il doit s'agir d'un entier compris entre 1 et 99. Si cet attribut n'est pas spécifié, la remise est appliquée à toutes les nuits.

Nombre de nuits requises pour que la remise soit appliquée. Chaque remise s'applique à un segment distinct de nuits de séjour.

Par exemple, pour un séjour de 10 nuits où stay_nights est égal à 4 (et repeats est défini sur "true"), il existe deux segments de nuits de séjour: du 1er au 4e jour et du 5e au 8e jour. Les 9e et 10e jours ne font pas partie d'un segment de nuits de séjour.

Indique si la remise peut être appliquée à plusieurs segments de nuits de séjour. Si false, seul le segment de nuits de séjour au début de l'itinéraire est proposé avec remise. Si la valeur est true, tous les segments de nuits de séjour sont soumis à une remise.

Par exemple, si stay_nights est égal à 4 et que l'itinéraire comprend 10 nuits, si repeats est égal à true, deux segments sont proposés avec une remise (nuits 1 à 4 et nuits 5 à 8). Si repeats est égal à false, un seul segment est proposé avec une remise (nuits 1 à 4).

Vous devez spécifier un seul Discount ou BestDailyDiscount.

Spécifie une remise quotidienne pouvant être appliquée à une nuit de séjour. Contrairement à Discount, qui applique des remises à l'ensemble du séjour.

Chaque établissement peut avoir un seul groupe de promotions considérées comme "meilleures chaque jour". Cela signifie que pour chaque nuit de séjour, la promotion "meilleure quotidienne" éligible et offrant la remise la plus importante pour cette nuit est sélectionnée et peut être appliquée.

Stacking peut être spécifié avec BestDailyDiscount. Il doit être défini sur base ou none. Les remises "meilleures par jour" qui offrent la remise la plus élevée pour chaque nuit sont combinées et traitées comme une remise unique pour le séjour (Discount), tout en respectant le type de cumul configuré. Cette remise combinée est comparée à d'autres promotions <Réduction> éligibles et peut être cumulée avec elles afin de trouver la remise la plus intéressante. La combinaison de BestDailyDiscount ou un seul Discount, selon le prix le plus bas, est sélectionnée et appliquée pour le type d'empilement base.

StayDates peut être spécifié avec ce type de remise, mais application doit être défini sur overlap.

Vous devez indiquer exactement une seule des valeurs percentage, fixed_amount ou fixed_price.

Valeur décimale comprise entre 0 et 100 indiquant le pourcentage de remise. Elle est appliquée à AmountAfterTax (ou à AmountBeforeTax si AmountAfterTax n'est pas spécifié).

Exemples :

• Si AmountAfterTax pour une nuit de séjour est égal à 100 et que percentage est égal à 20, alors

  taux de promotion = AmountAfterTax * (1 - pourcentage de remise)

  80.00 = 100 * (1 - 0.2)

• Si AmountBeforeTax pour une nuit de séjour est égal à 100, que percentage est égal à 20 et que TaxFeeInfo spécifie une taxe de 10, alors

  taux de promotion = AmountBeforeTax * (1 - pourcentage de remise) + taxe

  90.00 = 100 * (1 - 0.2) + 10

Vous devez indiquer exactement une seule des valeurs percentage, fixed_amount ou fixed_price.

Montant fixe à soustraire d'un tarif par nuit AmountAfterTax (ou d'un tarif par nuit AmountBeforeTax si AmountAfterTax n'est pas spécifié). Il est supposé être dans la même devise que les tarifs par nuit. Si ce nombre est supérieur à la somme des tarifs par nuit, la valeur obtenue est égale à zéro.

Exemples :

• Si AmountBeforeTax pour une seule nuit est égal à 90, que AmountAfterTax est égal à 100 et que fixed_amount est égal à 20, alors

  taux de promotion = AmountAfterTax - remise fixe

  80.00 = 100 - 20

• Si AmountBeforeTax pour une seule nuit est égal à 100, que fixed_amount est égal à 20 et que TaxFeeInfo spécifie une taxe de 8%, alors

  taux de promotion = (AmountBeforeTax - remise fixe) * (1 + pourcentage de taxe)

  86,40 = (100 - 20) * 1,08

Vous devez indiquer exactement une seule des valeurs percentage, fixed_amount ou fixed_price.

Si des tarifs par nuit AmountAfterTax sont spécifiés, le prix de la nuit de séjour, taxes et frais inclus, est défini sur la valeur spécifiée. Si AmountBeforeTax est spécifié, que AmountAfterTax soit spécifié ou non, le prix avant taxes du séjour est défini sur la valeur spécifiée. Il est supposé être dans la même devise que les tarifs par nuit.

Exemples :

• Si AmountBeforeTax pour une seule nuit est égal à 90, que AmountAfterTax est égal à 100 et que fixed_price est égal à 80, le tarif promotionnel est de 80.
• Si AmountBeforeTax pour une seule nuit est égal à 100, que fixed_amount est égal à 80 et que TaxFeeInfo spécifie une taxe de 8%, alors

  taux de promotion = prix fixe * (1 + pourcentage de taxe)

  86,40 = 80 * 1,08

Conteneur d'une règle de tarif pour les membres qui déclenche un traitement spécifique de l'interface utilisateur pour la remise associée.

Cet élément ne doit pas être spécifié, sauf si <Discount> l'est également.

ID de la règle d'offre associée à un programme d'adhésion.

Selon ce paramètre, plusieurs promotions peuvent être appliquées à un même tarif:

• any: se combine avec toute autre promotion (sauf none), mais l'ordre dans lequel les promotions doivent être appliquées n'est pas garanti.
• base: la meilleure promotion base éligible est sélectionnée et appliquée en premier, avant les autres promotions. Il s'agissait auparavant de base_only.
• second: la meilleure promotion second éligible est sélectionnée et appliquée après une promotion base (le cas échéant) et avant les promotions any.
• none: ne peut pas se combiner avec d'autres promotions.

Parmi les combinaisons autorisées, l'ensemble de promotions qui offre la plus grande remise est appliqué au tarif.

Décrit le mode d'application de la promotion.

Les valeurs valides sont les suivantes :

• all: applique la promotion à chaque nuit du séjour si toutes les dates du séjour se superposent exactement aux dates de séjour définies.
• any: applique la promotion à toutes les nuits du séjour si une date de celui-ci se superpose à une date de la plage de dates de séjour.
• overlap: applique uniquement la promotion aux nuits du séjour qui se superposent à une date de la plage de dates de séjour.

Cet attribut doit toujours être spécifié.

• Si <Discount> spécifie percentage et que application est défini sur all ou any, la remise est appliquée en tant que pourcentage du séjour total.
• Si <Discount> spécifie percentage et que application est défini sur overlap, la remise est appliquée en tant que pourcentage des tarifs par nuit pour les nuits qui se chevauchent.
• <Discount> spécifiant fixed_amount et application défini sur overlap n'est pas une combinaison valide.
• <FreeNights> est compatible avec toutes les valeurs application. Notez que pour overlap, seules les nuits de séjour qui se chevauchent sont prises en compte pour les conditions requises pour la remise.

Plage de dates indiquant les dates auxquelles la promotion doit être appliquée.

Le format YearlessDate est également accepté.

• Si start ou end est une date sans année, les deux attributs doivent être renseignés avec une valeur sans année.
• Les plages de dates sans année ne doivent pas se répéter à l'arrivée du Nouvel An. Représentez plutôt la plage en deux plages de dates adjacentes. Par exemple, {"12-29", "01-05"} peut être représenté par {"12-29", "12-31"} et {"01-01", "01-05"}.

Si vous souhaitez définir une plage StayDates pour autoriser la promotion à des jours spécifiques de la semaine, vous devez définir la date start sur la date actuelle sans end afin que la promotion n'expire pas.

Vous devez spécifier la valeur start si la valeur end n'est pas fournie.

Vous devez spécifier la valeur end si la valeur start n'est pas fournie.

Jours de la semaine autorisés dans la plage de dates. Si cet attribut n'est pas spécifié, tous les jours sont autorisés dans la plage de dates. Chaque caractère de la chaîne spécifie un jour. Par exemple, "MTWHF" indique que les jours de la semaine sont autorisés dans la plage de dates.

Caractères valides:

• M pour lundi
• T pour mardi
• W pour mercredi
• H pour jeudi
• F pour vendredi
• S pour samedi
• U pour dimanche

Toute combinaison de caractères est valide.

Les valeurs valides sont include et exclude.

Si le type UserCountries est défini sur include, la promotion s'applique aux utilisateurs des pays listés.

Si la valeur de type UserCountries est exclude, la promotion s'applique aux utilisateurs situés en dehors des pays listés.

Si le type UserCountries n'est pas défini, il est traité comme include et la promotion est appliquée aux utilisateurs des pays listés.

Chaque message contient soit <Success>, soit <Issues>.

Chaque message contient soit <Success>, soit <Issues>.

Type de problème rencontré.

Les valeurs valides sont warning, error et failure.