Акции

Если у вас есть серверная часть, которая предоставляет каналы для нескольких учетных записей, это значение должно соответствовать значению атрибута ID , указанному в элементе <RequestorID> ваших сообщений <OTA_HotelRateAmountNotifRQ> и <OTA_HotelAvailNotifRQ> для одной и той же учетной записи.

Акции на недвижимость. Каждая акция распространяется на один объект недвижимости.

Если не используется <Stacking> , к бронированию применяется акция с наибольшей скидкой, если доступно несколько промоакций.

Если указано, значение должно быть "overlay" . Если установлено значение "overlay" , все сохраненные рекламные акции удаляются перед сохранением рекламных акций, указанных в текущем сообщении.

Если не указано, то каждая рекламная акция, указанная в текущем сообщении, является либо:

• Added (если ни одна из сохраненных рекламных акций не имеет одинаковый id )
• Updated (если сохраненная промоакция имеет тот же id )
• Deleted (если сохраненная акция имеет тот же id и значение атрибута action для акции, указанной в текущем сообщении, равно "delete" ).

Единая акция на объект. Обратите внимание: если action="overlay" и <Promotion> не указаны, все рекламные акции для свойства удаляются.

Если вам нужно использовать более 99 рекламных акций, обратитесь к своему техническому менеджеру по работе с клиентами (TAM).

Если указано, значение должно быть delete . Если не указано и акция с таким id не сохранена, то эта акция сохраняется. В противном случае, если не указано и сохраняется акция с тем же id , существующая акция обновляется.

Если указано delete , сохраненная акция с тем же id будет удалена. При использовании delete не включайте дочерние элементы в <Promotion> . Кроме того, delete не допускается в сочетании с <HotelPromotions action="overlay"/> .

Начальная дата или дата и время (в зависимости от часового пояса свойства) диапазона включительно.

• Дата или дата-время, указанные в параметре start должны быть раньше (или совпадать с) датой или датой-временем, указанными в параметре end .
• Если start не указан, диапазон фактически не ограничен с точки зрения времени начала.
• Если start указывается как дата «ГГГГ-ММ-ДД», оно интерпретируется как дата-время «ГГГГ-ММ-ДДТ00:00:00».

Конечная дата или дата и время (в зависимости от часового пояса свойства) диапазона включительно.

• Дата или дата-время, указанные в end должны быть позже (или совпадать с) датой или датой-временем, указанными в параметре start .
• Если end не указан, диапазон фактически не ограничен с точки зрения времени окончания.
• Если end указан как дата «ГГГГ-ММ-ДД», он интерпретируется как дата-время «ГГГГ-ММ-ДДТ23:59:59».

Дни недели, которые разрешены в диапазоне дат. Если не указано, в диапазоне дат разрешены все дни. Каждый символ в строке указывает день. Например, «MTWHF» указывает, что в диапазоне дат разрешены дни недели.

Допустимые символы:

• M на понедельник
• T во вторник
• W для среды
• H на четверг
• F для пятницы
• S для субботы
• U на воскресенье

Любая комбинация символов допустима.

Допустимые типы значений:

• Целое число: количество дней до даты заезда. Например, значение 30 означает, что акция распространяется только на бронирования не менее чем за 30 дней до даты заезда.
• ISO 8601 Продолжительность (дни, часы и минуты): количество дней (и, возможно, часов/минут) до даты регистрации. Например, значение P30D означает, что акция распространяется только на бронирования, сделанные не менее чем за 30 дней до даты заезда. Стоимость P30DT6H требует бронирования не позднее 18:00 30-го дня до прибытия.

Допустимые типы значений:

• Целое число: количество дней до даты заезда. Например, значение 30 означает, что акция распространяется только на бронирования, сделанные не позднее, чем за 30 дней до даты заезда.
• ISO 8601 Продолжительность (дни, часы и минуты): количество дней (и, возможно, часов/минут) до даты регистрации. Например, значение P30D означает, что акция распространяется только на бронирования, сделанные не позднее, чем за 30 дней до даты заезда. Стоимость P30DT6H требует бронирования не позднее 18:00 за 30-й день до прибытия.

Определяет ограничения на максимальное значение, которое может быть установлено для ставки после применения рекламных акций.

В рекламных акциях всегда должен быть указан <Discount> или <BestDailyDiscount> , поэтому для создания рекламной акции, которая применяет только <Ceiling> , одним из вариантов является установка <Discount> с percentage 0 .

Если настроено группирование, то к одному пребыванию можно применить несколько рекламных акций с <Ceiling> . Для каждой акции будет применяться своя скидка, за которой сразу же будет устанавливаться ее потолок. В следующем примере показано, как каждый потолок влияет на следующее вычисление повышения в стеке.

Пример:

Цена за 1 ночь проживания, при которой AmountBeforeTax равна 100 и действует пакет из двух рекламных акций:

1. Акция с типом штабелирования base , fixed_amount суммой 25 и amount_per_night ночь 60.
2. Промоакция с типом накопления second , fixed_amount суммой 25 и максимальной amount_per_night 90.

Вот порядок расчета:

1. base акция применяется первой и снижает значение AmountBeforeTax до 75, но затем потолок снижает его до 60 .
2. second акция снижает значение AmountBeforeTax с 60 до 35. Это ниже предельного значения в 90, поэтому второй верхний предел не применяется. Окончательная ставка 35 .

Тот факт, что 60 — это более строгий общий потолок, не имеет значения, поскольку он действителен только для своего собственного продвижения, и не может быть единого потолка, охватывающего весь стек промоакций.

Максимальная сумма, которую можно установить за ночь после применения скидки.

Если также указан элемент <Floor> , для него должно быть установлено значение, большее или равное атрибуту amount_per_night в <Floor> .

amount_per_night применяется к налогам и сборам, если они включены в стоимость ночи с помощью AmountAfterTax , но не к тем, которые указаны с помощью TaxFeeInfo.

Определяет ограничения на минимальное значение, которое может быть установлено для ставки после применения рекламных акций.

В рекламных акциях всегда должен быть указан <Discount> или <BestDailyDiscount> , поэтому для создания рекламной акции, которая применяет только <Floor> , можно установить <Discount> с percentage 0 .

Логика <Floor> по-прежнему применяется к скидкам <FreeNights> , даже если к бесплатной ночи применяется скидка 100% .

Если настроено группирование, то к одному пребыванию можно применить несколько рекламных акций с <Floor> . Для каждой акции будет применяться своя скидка, за которой сразу последует ее минимальная цена. В следующем примере показано, как каждый этаж участвует в расчете следующего повышения в стеке.

Пример:

Цена за 1 ночь проживания, при которой AmountBeforeTax равна 100 и действует пакет из двух рекламных акций:

1. Акция с типом штабелирования base , fixed_amount суммой 25 и минимальной amount_per_night ночь 90.
2. Промоакция с типом стека second , fixed_amount суммой 25 и минимальной amount_per_night 60.

Вот порядок расчета:

1. base поощрение применяется первым и снижает значение AmountBeforeTax до 75, но затем минимальное значение повышает его до 90 .
2. second акция снижает значение AmountBeforeTax с 90 до 65. Это выше нижнего уровня, равного 60, поэтому второй этаж не применяется. Окончательная ставка 65 .

Тот факт, что 90 является более строгим общим уровнем, не имеет значения, поскольку он действителен только для своего собственного повышения, и не может быть единого этажа, охватывающего весь стек повышений.

Минимальная сумма, которую можно установить за ночь после применения скидки.

Если также указан элемент <Ceiling> , для него должно быть установлено значение, меньшее или равное атрибуту amount_per_night в <Ceiling> .

amount_per_night применяется к налогам и сборам, если они включены в стоимость ночи с помощью AmountAfterTax , но не к тем, которые указаны с помощью TaxFeeInfo.

Чтобы акция могла быть применена, укажите диапазон дат, определяющий, когда должна произойти регистрация заезда. Этот элемент не является обязательным, если вы удаляете одну или несколько рекламных акций.

Также поддерживается формат YearlessDate .

• Если одна из start или end является безгодовой датой, обе должны быть указаны как безгодичные даты.
• Бесгодовые диапазоны дат не должны охватывать новый год. Вместо этого представьте диапазон как два соседних диапазона дат. Например, {"12-29", "01-05"} могут быть представлены как {"12-29", "12-31"} и {"01-01", "01-05"} .

Дни недели, которые разрешены в диапазоне дат. Если не указано, в диапазоне дат разрешены все дни. Каждый символ в строке указывает день. Например, «MTWHF» указывает, что в диапазоне дат разрешены дни недели.

Допустимые символы:

• M на понедельник
• T во вторник
• W для среды
• H на четверг
• F для пятницы
• S для субботы
• U на воскресенье

Любая комбинация символов допустима.

Чтобы акция могла быть применена, укажите диапазон дат, определяющий, когда должен произойти выезд. Этот элемент не является обязательным, если вы удаляете одну или несколько рекламных акций.

Также поддерживается формат YearlessDate .

• Если одна из start или end является безгодовой датой, обе должны быть указаны как безгодичные даты.
• Бесгодовые диапазоны дат не должны охватывать новый год. Вместо этого представьте диапазон как два соседних диапазона дат. Например, {"12-29", "01-05"} могут быть представлены как {"12-29", "12-31"} и {"01-01", "01-05"} .

Дни недели, которые разрешены в диапазоне дат. Если не указано, в диапазоне дат разрешены все дни. Каждый символ в строке указывает день. Например, «MTWHF» указывает, что в диапазоне дат разрешены дни недели.

Допустимые символы:

• M на понедельник
• T во вторник
• W для среды
• H на четверг
• F для пятницы
• S для субботы
• U на воскресенье

Любая комбинация символов допустима.

Необходимо указать ровно одно из значений Discount или BestDailyDiscount .

Указывает скидку, которая будет применена к этой акции.

Требуется ровно один из percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price или fixed_price_per_night .

Десятичное значение от 0 до 100, указывающее процентную скидку. Он применяется к AmountAfterTax (или AmountBeforeTax если AmountAfterTax не указан).

Примеры:

• Если AmountAfterTax равен 100, а percentage равен 20, то

  ставка продвижения = AmountAfterTax * (1 – процентная скидка)

  80,00 = 100 * (1 – 0,2)

• Если AmountBeforeTax равен 100, percentage равен 20, а TaxFeeInfo указывает налог 10, тогда

  ставка продвижения = AmountBeforeTax * (1 – процентная скидка) + налог

  90,00 = 100 * (1 – 0,2) + 10

Требуется ровно один из percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price или fixed_price_per_night .

Десятичное значение от 0 до 100, указывающее процент базовой скидки. Подобно percentage , он применяется к AmountAfterTax (или AmountBeforeTax если AmountAfterTax не указан).

В отличие от percentage , эта скидка всегда рассчитывается как процент от базовой ставки, независимо от предыдущих промоакций, которые применялись последовательно.

Пример:

• Предположим, у нас есть две промоакции, которые последовательно применяются к однодневному пребыванию по цене 100. Первая — это обычная процентная скидка 10 %, а вторая — процентная скидка 10 % от базовой скидки. Тогда скидка составит 80, поскольку в обеих акциях скидка 10. Обратите внимание, что если вторая акция также представляла собой обычную процентную скидку, то ставка скидки будет равна 81, поскольку вторая акция дает скидку 10 % от 90.

Требуется ровно один из percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price или fixed_price_per_night .

Фиксированная сумма, которая вычитается из суммы ночных ставок AmountAfterTax (или суммы ночных ставок AmountBeforeTax , если AmountAfterTax не указана). Предполагается, что он будет в той же валюте, что и ночные тарифы. Если оно больше суммы ночных тарифов, результирующее значение равно нулю.

Примеры:

• Если мы устанавливаем цену за 1 ночь проживания, где AmountBeforeTax равна 90, AmountAfterTax равна 100, а fixed_amount равна 20, то

  ставка продвижения = AmountAfterTax - фиксированная скидка

  80,00 = 100 – 20

• Если мы устанавливаем цену за 1 ночь проживания, где AmountBeforeTax равно 100, fixed_amount равно 20, а TaxFeeInfo указывает налог в размере 8 %, то

  ставка продвижения = ( AmountBeforeTax – фиксированная скидка) * (1 + процентный налог)

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

• Если мы устанавливаем цену за 1 ночь проживания, где AmountBeforeTax равен 50, fixed_amount равен 60, а TaxFeeInfo указывает налог в размере 10, то

  ставка акции = ( AmountBeforeTax — фиксированная скидка) * налог

  10.00 = 0 + 10

• Если мы устанавливаем цену проживания на 3 ночи, где значения AmountAfterTax равны 100, 110 и 120; и fixed_amount равна 150, тогда

  ставка продвижения = сумма( AmountAfterTax ) - (фиксированная скидка)

  180,00 = (100 + 110 + 120) - 150

Требуется ровно один из percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price или fixed_price_per_night .

Фиксированная скидка, применяемая к каждой ночной ставке AmountAfterTax (или самой дешевой N, если указано applied_nights ). Если AmountAfterTax не указан, он применяется к AmountBeforeTax . Предполагается, что он будет в той же валюте, что и ночные тарифы. Если fixed_amount_per_night больше ночной ставки, эта ночная ставка уменьшается до нуля — скидка не может привести к тому, что ночная ставка станет отрицательной.

Примеры:

• Если мы устанавливаем цену проживания на 3 ночи, где значения AmountAfterTax равны 100, 110 и 120; и fixed_amount_per_night равна 10, тогда

  ставка продвижения = сумма( AmountBeforeTax - скидка фиксированной суммы)

  300,00 = ((100 – 10) + (110 – 10) + (120 – 10))

• Если мы устанавливаем цену проживания на 3 ночи, где значения AmountAfterTax равны 10, 50 и 100; и fixed_amount_per_night равна 20, тогда

  ставка продвижения = сумма( AmountAfterTax - скидка фиксированной суммы)

  110,00 = (0 + (50 – 20) + (100 – 20))

Требуется ровно один из percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price или fixed_price_per_night .

Если указаны ночные тарифы AmountAfterTax , то цена проживания, включая налоги и сборы, будет установлена ​​на указанное значение. Если указан AmountBeforeTax , то вне зависимости от того, указан ли AmountAfterTax , цена пребывания до уплаты налогов будет равна указанному значению. Предполагается, что он будет в той же валюте, что и ночные тарифы.

Если AmountAfterTax предназначен для отражения процентного налога, то установка фиксированной цены для AmountBeforeTax может привести к неточным расчетам налогов и сборов. Как правило, настоятельно рекомендуется использовать TaxFeeInfo для указания налогов и сборов объекта недвижимости.

Примеры:

• Если мы устанавливаем цену за 1 ночь проживания, где AmountBeforeTax равна 90, AmountAfterTax — 100, а fixed_price — 80, то ставка продвижения равна 80.
• Если мы устанавливаем цену за 1 ночь проживания, где AmountBeforeTax равно 100, fixed_amount равно 80, а TaxFeeInfo указывает налог в размере 8 %, то

  ставка продвижения = фиксированная цена * (1 + процентный налог)

  86,40 = 80 * 1,08

• Если мы устанавливаем цену проживания на 3 ночи, где значения AmountAfterTax равны 100, 110 и 120; и fixed_amount равна 300, тогда

  ставка продвижения = 300

Требуется ровно один из percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price или fixed_price_per_night .

Если указаны ночные тарифы AmountAfterTax , то цена за каждую ночь пребывания, включая налоги и сборы, устанавливается на указанное значение. Если указано AmountBeforeTax , то вне зависимости от того, указано ли AmountAfterTax , цена до уплаты налогов за каждую ночь пребывания устанавливается равной указанному значению. Предполагается, что он будет в той же валюте, что и ночные тарифы.

Если AmountAfterTax предназначен для отражения процентного налога, то установка фиксированной цены для AmountBeforeTax может привести к неточным расчетам налогов и сборов. Как правило, настоятельно рекомендуется использовать TaxFeeInfo для указания налогов и сборов объекта недвижимости.

Если указано applied_nights , то новая цена применяется к самым дешевым N ночам.

Примеры:

• Если мы устанавливаем цену проживания на 2 ночи, где значения AmountBeforeTax равны 90, 90; Значения AmountAfterTax — 100, 100; а fixed_price равна 80, то ставка продвижения равна 80 + 80 = 160.
• Если мы устанавливаем цену проживания на 2 ночи, где AmountBeforeTax равна 100, 100; fixed_amount — 80, а TaxFeeInfo указывает налог в размере 8 %, тогда ставка продвижения равна (80 + 80) * 1,08 = 172,8.
• Если мы устанавливаем цену проживания на 3 ночи, где значения AmountAfterTax равны 100, 110 и 120; а fixed_amount равна 110, то ставка продвижения равна 110 * 3 = 330.

Это следует использовать только с percentage или fixed_amount_per_night .

Количество ночей, на которые распространяется скидка, начиная с самых дешевых. Должно быть целое число от 1 до 99. Если не указано, скидка распространяется на все ночи.

Количество необходимых ночей для применения скидки. Каждая скидка распространяется на отдельный сегмент ночей проживания.

Например, для пребывания на 10 ночей, где stay_nights равно 4 (и repeats верно), существует два сегмента ночей пребывания: с 1-й по 4-ю ночи и с 5-й по 8-ю ночи; 9-я и 10-я ночи не являются частью сегмента ночей пребывания.

Можно ли применить скидку к нескольким сегментам проживания на сутки. Если false , то скидка предоставляется только на сегмент ночей пребывания в начале маршрута. Если true , то любой сегмент ночей проживания предоставляется со скидкой.

Например, если stay_nights равно 4, а маршрут — 10 ночей, то, если repeats равно true , скидка дается на 2 сегмента (ночи 1–4 и ночи 5–8); но если repeats имеют false , скидка предоставляется только на 1 сегмент (ночи 1–4).

Необходимо указать ровно одно из значений Discount или BestDailyDiscount .

Определяет ежедневную скидку, которая может быть применена к одной ночи проживания. Это отличие от Discount , которая применяет скидки на весь период проживания.

У каждого объекта может быть одна группа акций, которые считаются «лучшими за день». Это означает, что для каждой ночи проживания выбирается и может быть применена одна «лучшая дневная» акция, которая соответствует критериям и дает наибольшую скидку за эту ночь.

Stacking можно указать с помощью BestDailyDiscount . Для него должно быть установлено значение base или none . «Лучшие ежедневные» скидки, дающие максимальную скидку за каждую ночь, объединяются и рассматриваются как скидка на однократное проживание (т. е. Discount ) с учетом настроенного типа суммирования. Эта объединенная скидка сравнивается с другими подходящими акциями <Discount> и может суммироваться с ними, чтобы найти ту или комбинацию, которая обеспечивает наибольшую скидку. Либо комбинация BestDailyDiscount , либо одна Discount , в зависимости от того, что дает более низкую цену, выбирается и применяется для base типа накопления.

StayDates можно указать с учетом этого типа скидки, но в application необходимо настроить overlap

Требуется ровно один из percentage , fixed_amount или fixed_price .

Десятичное значение от 0 до 100, указывающее процентную скидку. Он применяется к AmountAfterTax (или AmountBeforeTax если AmountAfterTax не указан).

Примеры:

• Если AmountAfterTax за ночь проживания равна 100, а percentage равен 20, то

  ставка продвижения = AmountAfterTax * (1 – процентная скидка)

  80,00 = 100 * (1 – 0,2)

• Если AmountBeforeTax за срок пребывания равен 100, percentage равен 20, а TaxFeeInfo указывает налог в размере 10, тогда

  ставка продвижения = AmountBeforeTax * (1 – процентная скидка) + налог

  90,00 = 100 * (1 – 0,2) + 10

Требуется ровно один из percentage , fixed_amount или fixed_price .

Фиксированная сумма, которая вычитается из одной ночной ставки AmountAfterTax (или ночной ставки AmountBeforeTax , если AmountAfterTax не указана). Предполагается, что он будет в той же валюте, что и ночные тарифы. Если оно больше суммы ночных тарифов, результирующее значение равно нулю.

Примеры:

• Если AmountBeforeTax за одну ночь равен 90, AmountAfterTax — 100, а fixed_amount — 20, то

  ставка продвижения = AmountAfterTax - фиксированная скидка

  80,00 = 100 – 20

• Если AmountBeforeTax за одну ночь равен 100, fixed_amount равен 20, а TaxFeeInfo указывает налог в размере 8 %, то

  ставка продвижения = ( AmountBeforeTax – фиксированная скидка) * (1 + процентный налог)

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

Требуется ровно один из percentage , fixed_amount или fixed_price .

Если указаны ночные тарифы AmountAfterTax , то цена за ночь проживания, включая налоги и сборы, устанавливается на указанное значение. Если указан AmountBeforeTax , то вне зависимости от того, указан ли AmountAfterTax , цена пребывания до уплаты налогов будет равна указанному значению. Предполагается, что он будет в той же валюте, что и ночные тарифы.

Примеры:

• Если AmountBeforeTax за одну ночь равен 90, AmountAfterTax — 100, а fixed_price — 80, то ставка продвижения равна 80.
• Если AmountBeforeTax за одну ночь равен 100, fixed_amount равен 80, а TaxFeeInfo указывает налог в размере 8 %, то

  ставка продвижения = фиксированная цена * (1 + процентный налог)

  86,40 = 80 * 1,08

Контейнер для правила уровня членства, которое запускает специальную обработку пользовательского интерфейса для соответствующей скидки.

Этот элемент не следует указывать, если также не указан <Discount> .

Идентификатор правила тарифа , связанного с программой членства.

В зависимости от этого параметра к одному тарифу можно применить несколько промоакций:

• any : можно комбинировать с любой другой рекламной акцией (кроме none ), но порядок применения промоакций не гарантируется.
• base : лучшая base акция, соответствующая критериям, выбирается и применяется в первую очередь, перед другими акциями. Ранее это называлось base_only .
• second : лучшая подходящая second акция выбирается и применяется после base акции (если применимо) и перед any рекламными акциями.
• none : не суммируется с другими акциями.

Из разрешенных комбинаций к ставке применяется тот набор акций, который дает наибольшую скидку.

Описывает, как следует применять поощрение.

Допустимые значения:

• all : акция применяется к каждой ночи в маршруте, если все даты в маршруте совпадают с датами пребывания.
• any : акция применяется ко всем ночам в маршруте, если какая-либо дата в маршруте совпадает с датой в диапазоне дат пребывания.
• overlap : акция применяется только к тем ночам в маршруте, которые совпадают с датой в диапазоне дат пребывания.

Этот атрибут должен быть указан всегда.

• Если <Discount> указывает percentage , а application установлено значение all или any , скидка применяется как процент от полной стоимости проживания.
• Если <Discount> указывает percentage , а application настроено на overlap , скидка применяется как процент от ночных тарифов для перекрывающихся ночей.
• <Discount> , указывающая fixed_amount и набор application для overlap является недопустимой комбинацией.
• <FreeNights> поддерживает все значения application . Обратите внимание, что в случае overlap учитываются только перекрывающиеся ночи пребывания.

Диапазон дат, определяющий даты, когда будет применяться акция.

Также поддерживается формат YearlessDate .

• Если одна из start или end является безгодовой датой, обе должны быть указаны как безгодичные даты.
• Бесгодовые диапазоны дат не должны охватывать новый год. Вместо этого представьте диапазон как два соседних диапазона дат. Например, {"12-29", "01-05"} могут быть представлены как {"12-29", "12-31"} и {"01-01", "01-05"} .

Если вы хотите установить диапазон StayDates , чтобы разрешить продвижение акции в определенные дни недели, вам следует установить дату start как текущую дату без end , чтобы срок действия акции не истек.

Вам следует указать start значение, если end значение не указано.

Вам следует указать end значение, если start значение не указано.

Дни недели, которые разрешены в диапазоне дат. Если не указано, в диапазоне дат разрешены все дни. Каждый символ в строке указывает день. Например, «MTWHF» указывает, что в диапазоне дат разрешены дни недели.

Допустимые символы:

• M на понедельник
• T во вторник
• W для среды
• H на четверг
• F для пятницы
• S для субботы
• U на воскресенье

Любая комбинация символов допустима.

Допустимые значения include и exclude .

Если type UserCountries устанавливается как include , то повышение применяется к пользователям из перечисленных стран.

Если type Usercountries exclude , рекламная акция применяется к пользователям из -за пределов перечисленных стран.

Если type USCROUNTRIES не является, он рассматривается как include , и продвижение применяется к пользователям из перечисленных стран.

Либо <Success> или <Issues> присутствует в каждом сообщении.

Либо <Success> или <Issues> присутствует в каждом сообщении.

Тип проблемы столкнулся.

Допустимые значения - это warning , error и failure .

Если у вас есть бэкэнд, который предоставляет каналы для нескольких учетных записей, это значение должно соответствовать значению атрибута ID , указанного в элементе <RequestorID> вашего <OTA_HotelRateAmountNotifRQ> и <OTA_HotelAvailNotifRQ> для той же учетной записи.

Акции для имущества. Каждое повышение применяется к одному свойству.

Если не используется <Stacking> , продвижение с самой большой скидкой применяется к бронированию, когда имеют право на участие в нескольких рекламных акциях.

Если указано, значение должно быть "overlay" . Когда значение является "overlay" , все сохраненные рекламные акции удаляются до хранения рекламных акций, указанных в текущем сообщении.

Если не указано, то каждая акция, указанная в текущем сообщении, либо:

• Added (если ни у одного из хранимых акций нет такого же id )
• Updated (если хранимая акция имеет тот же id )
• Deleted (если хранящаяся акция имеет тот же id , а значение атрибута action для акции, указанной в текущем сообщении, - "delete" )

Единственное повышение по службе для недвижимости. Обратите внимание, что если action="overlay" и A <Promotion> не указаны, все рекламные акции для свойства удалены.

Если вам нужно использовать более 99 рекламных акций, свяжитесь с вашим техническим менеджером учетных записей (TAM).

Если указано, значение должно быть delete . Если не указано, и продвижение с тем же id не хранится, то эта акция сохраняется. В противном случае, если не указано, и продвижение с тем же id сохраняется, то существующая акция обновляется.

Если указан delete , сохраненная акция с тем же id удалена. При использовании delete не включайте дочерние элементы в <Promotion> . Кроме того, delete не допускается в сочетании с <HotelPromotions action="overlay"/> .

Дата начала или DateTime (на основе часового пояс собственности), включительно, диапазона.

• Дата или DateTime, указанная в start должна быть раньше (или та же, что и) дата или DateTime, указанная до end .
• Если start не указан, диапазон фактически неограничен с точки зрения начала времени.
• Если start заполняется как дата «yyyy-mm-dd», он интерпретируется как DateTime "yyyy-mm-DDT00: 00: 00".

Дата окончания или DateTime (на основе часового пояса собственности), включительно, диапазона.

• Дата или DateTime, указанная на end должны быть позже (или та же, что и) дата или DateTime, указанная в start .
• Если end не указан, диапазон фактически не ограничен с точки зрения времени окончания.
• Если end предоставляется как дата «yyyy-mm-dd», он интерпретируется как DateTime "yyyy-mm-DDT23: 59: 59".

Дни недели, которые разрешены в диапазоне дат. Если не указано, все дни разрешены в диапазоне дат. Каждый символ в строке указывает день. Например, «MTWHF» указывает, что в диапазоне даты разрешены будние.

Допустимые символы:

• M в понедельник
• T на вторник
• W на среду
• H на четверг
• F на пятницу
• S на субботу
• U в воскресенье

Любая комбинация символов действительна.

Допустимые типы значений:

• Целое число: количество дней до даты регистрации. Например, значение 30 указывает на то, что повышение применяется только к бронированию не менее чем за 30 дней до даты регистрации.
• Продолжительность ISO 8601 (дни, часы и минуты): количество дней (и необязательно часы/минуты) до даты регистрации. Например, значение P30D указывает, что повышение применяется только к бронированию не менее чем за 30 дней до даты регистрации. Значение P30DT6H требует бронирования в 18:00 или до 30:00 на 30 -й день до прибытия.

Допустимые типы значений:

• Целое число: количество дней до даты регистрации. Например, значение 30 указывает на то, что повышение применяется только к бронированию не более 30 дней до даты регистрации.
• Продолжительность ISO 8601 (дни, часы и минуты): количество дней (и необязательно часы/минуты) до даты регистрации. Например, значение P30D указывает, что повышение применяется только к бронированию не более 30 дней до даты регистрации. Значение P30DT6H требует бронирования в 18:00 на 30 -й день до прибытия.

Определяет ограничения на максимальное значение, на которое можно установить скорость после применения рекламных акций.

Акции должны всегда указывать <Discount> или <BestDailyDiscount> , поэтому для создания акции, которая применяет только <Ceiling> , один из вариантов - установить <Discount> с percentage от 0 .

Если настраивается укладка, то несколько рекламных акций с <Ceiling> могут применяться к одному пребыванию. Каждое повышение будет применять свою скидку, сразу же с последующей его потолком. В следующем примере демонстрируется, как каждый потолок вносит вклад в следующий расчет продвижения в стеке.

Пример:

Цены на 1-дневное пребывание, где AmountBeforeTax составляет 100, и есть стопка из двух акций:

1. Продвижение с base типа укладки, fixed_amount 25 и потолка amount_per_night 60
2. Продвижение с типом укладки second , fixed_amount 25 и потолок amount_per_night 90

Вот порядок расчета:

1. Сначала применяется base акция и скизывает AmountBeforeTax до 75, но затем потолок снижает его до 60 .
2. second продвижение скидки на AmountBeforeTax от 60 до 35. Это ниже потолка 90, поэтому второй потолок не применяется. Окончательная скорость 35 .

Тот факт, что 60 является более строгим общим потолком, не имеет значения, поскольку он действителен только для своей собственной продвижения, и не может быть единого потолка, который охватывает весь стек акции.

Максимальная сумма, на которую можно установить ночную ставку после применения скидки.

Если также указан элемент <Floor> , он должен быть установлен на значение, большее или равное атрибуту amount_per_night в <Floor> .

amount_per_night применяется к налогам и сборам, когда они включены в ночную ставку с использованием AmountAfterTax , но не те, которые указаны с использованием TaxFeeInfo.

Определяет ограничения на минимальное значение, на которое можно установить скорость после применения рекламных акций.

Акции должны всегда указывать <Discount> или <BestDailyDiscount> , поэтому для создания акции, которая применяет только <Floor> , один из вариантов - установить <Discount> с percentage от 0 .

<Floor> Логика по -прежнему применяется к скидкам <FreeNights> , даже если к ней применяется скидка 100% свободную ночь.

Если настраивается укладка, то несколько рекламных акций с <Floor> могут применяться к одному пребыванию. Каждое продвижение по службе применяет свою скидку, сразу же следовала бы пол. В следующем примере демонстрируется, как каждый этаж вносит вклад в следующий расчет продвижения в стеке.

Пример:

Цены на 1-дневное пребывание, где AmountBeforeTax составляет 100, и есть стопка из двух акций:

1. Продвижение с base типа укладки, fixed_amount 25 и полом amount_per_night 90
2. Продвижение с типом укладки second , fixed_amount 25, и amount_per_night пола.

Вот порядок расчета:

1. Сначала применяется base акция и скизывает AmountBeforeTax до 75, но затем пол поднимает его до 90 .
2. second продвижение скидки на AmountBeforeTax от 90 до 65. Это выше пола 60, поэтому второй этаж не применяется. Окончательная ставка 65 .

Тот факт, что 90 является более строгим общим полом, не имеет значения, поскольку он действителен только для его собственной продвижения, и не может быть единого этажа, который охватывает весь стек акции.

Минимальная сумма, на которую можно установить ночную ставку после применения скидки.

Если также указан элемент <Ceiling> , он должен быть установлен на значение, меньшее, чем или равное атрибуту amount_per_night в <Ceiling> .

amount_per_night применяется к налогам и сборам, когда они включены в ночную ставку с использованием AmountAfterTax , но не те, которые указаны с использованием TaxFeeInfo.

Диапазон дат, указывающий, когда должен произойти регистрация для применения акции. Этот элемент не требуется, если вы удаляете одно или несколько акций.

Годовой формат также поддерживается.

• Если один из start или end - это беседа, оба должны быть заполнены как бесконечные даты.
• Бесзодранные даты не должны обертываться вокруг нового года. Вместо этого представляют диапазон как два смежных диапазона даты. Например, {"12-29", "01-05"} может быть представлен как {"12-29", "12-31"} и {"01-01", "01-05"} .

Дни недели, которые разрешены в диапазоне дат. Если не указано, все дни разрешены в диапазоне дат. Каждый символ в строке указывает день. Например, «MTWHF» указывает, что в диапазоне даты разрешены будние.

Допустимые символы:

• M в понедельник
• T на вторник
• W на среду
• H на четверг
• F на пятницу
• S на субботу
• U в воскресенье

Любая комбинация символов действительна.

Диапазон дат, указанный при выходе, должен произойти для применения акции. Этот элемент не требуется, если вы удаляете одно или несколько акций.

Годовой формат также поддерживается.

• Если один из start или end - это беседа, оба должны быть заполнены как бесконечные даты.
• Бесзодранные даты не должны обертываться вокруг нового года. Вместо этого представляют диапазон как два смежных диапазона даты. Например, {"12-29", "01-05"} может быть представлен как {"12-29", "12-31"} и {"01-01", "01-05"} .

Дни недели, которые разрешены в диапазоне дат. Если не указано, все дни разрешены в диапазоне дат. Каждый символ в строке указывает день. Например, «MTWHF» указывает, что в диапазоне даты разрешены будние.

Допустимые символы:

• M в понедельник
• T на вторник
• W на среду
• H на четверг
• F на пятницу
• S на субботу
• U в воскресенье

Любая комбинация символов действительна.

Точно одна из Discount или BestDailyDiscount должна быть указана.

Определяет скидку, которая будет применена для этой акции.

Требуется именно один из percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price или fixed_price_per_night .

Десятичное значение от 0-100, которое указывает процентную скидку. Он применяется к AmountAfterTax (или AmountBeforeTax если AmountAfterTax не указан).

Примеры:

• Если AmountAfterTax составляет 100, а percentage - 20, тогда

  Коэффициент продвижения = AmountAfterTax * (1 - процентная скидка)

  80,00 = 100 * (1 - 0,2)

• Если AmountBeforeTax составляет 100, percentage составляет 20, а TaxFeeInfo определяет налог в размере 10, тогда

  Ставка продвижения = AmountBeforeTax * (1 - процентная скидка) + налог

  90,00 = 100 * (1 - 0,2) + 10

Требуется именно один из percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price или fixed_price_per_night .

Десятичное значение от 0-100, которое указывает процент базовой скидки. Подобно percentage , он применяется к AmountAfterTax (или AmountBeforeTax если AmountAfterTax не указан).

В отличие от percentage , эта скидка всегда рассчитывается как процент базовых ставок независимо от предыдущих акций, которые были применены в последовательности.

Пример:

• Предположим, что у нас есть два акции, которые применяются в последовательности к одному ночи, который стоит 100. Первая - это обычная скидка на 10% процентных, а второй - 10% процент базовой скидки. Затем скидка составит 80, так как оба акции снимают 10 скидок. Обратите внимание, что если вторая акция была также регулярной процентной скидкой, то дисконтированная ставка составит 81, поскольку вторая рекламная скидка 10% от 90.

Требуется именно один из percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price или fixed_price_per_night .

Фиксированная сумма, которая должна быть вычтена из суммы ночных ставок AmountAfterTax (или суммы ночных ставок AmountBeforeTax , если AmountAfterTax не указан). Предполагается, что он находится в той же валюте, что и ночные ставки. Если это больше, чем сумма ночных ставок, полученное значение равно нулю.

Примеры:

• Если мы ценим пребывание на 1 ноч, где AmountBeforeTax составляет 90, AmountAfterTax составляет 100, а fixed_amount -20, тогда

  Скорость продвижения = AmountAfterTax - фиксированная скидка

  80,00 = 100 - 20

• Если мы ценим пребывание на 1 номе, где AmountBeforeTax составляет 100, fixed_amount составляет 20, а TaxFeeInfo определяет налог в размере 8%, тогда

  Ставка продвижения = ( AmountBeforeTax - Фиксированная скидка) * (1 + процентный налог)

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

• Если мы ценим пребывание на 1 номе, где AmountBeforeTax составляет 50, fixed_amount -60, а TaxFeeInfo определяет налог в размере 10, тогда

  Ставка продвижения = ( AmountBeforeTax - Фиксированная скидка) * налог

  10.00 = 0 + 10

• Если мы ценим 3-дневное пребывание, где значения AmountAfterTax составляют 100, 110 и 120; и fixed_amount - 150, тогда

  Скорость продвижения = sum ( AmountAfterTax ) - (фиксированная скидка)

  180,00 = (100 + 110 + 120) - 150

Требуется именно один из percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price или fixed_price_per_night .

Фиксированная скидка, применяемая к каждой из ночных тарифов AmountAfterTax (или самая дешевая n, если applied_nights ). Если AmountAfterTax не указан, он применяется к AmountBeforeTax . Предполагается, что он находится в той же валюте, что и ночные ставки. Если fixed_amount_per_night больше ночной скорости, эта ночная скорость снижается до нуля - скидка не может привести к тому, что ночная скорость становится отрицательной.

Примеры:

• Если мы ценим 3-дневное пребывание, где значения AmountAfterTax составляют 100, 110 и 120; и fixed_amount_per_night - 10, тогда

  Скорость продвижения = сумма ( AmountBeforeTax - скидка фиксированной суммы)

  300,00 = ((100 - 10) + (110 - 10) + (120 - 10))

• Если мы ценим 3-дневное пребывание, где значения AmountAfterTax составляют 10, 50 и 100; и fixed_amount_per_night - 20, тогда

  Скорость продвижения = сумма ( AmountAfterTax - скидка фиксированной суммы)

  110,00 = (0 + (50 - 20) + (100 - 20))

Требуется именно один из percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price или fixed_price_per_night .

Если указаны ночные ставки AmountAfterTax , то это устанавливает цену на пребывание, включая налоги и сборы, на указанную стоимость. Если указан AmountBeforeTax , то указано ли AmountAfterTax , это устанавливает цену до налогообложения для пребывания на указанное значение. Предполагается, что он находится в той же валюте, что и ночные ставки.

Если AmountAfterTax предназначен для отражения процентного налога, то установление фиксированной цены для AmountBeforeTax может привести к неточным налогам и сборам. В целом, настоятельно рекомендуется использовать TaxFeeInfo для указания налогов и сборов имущества.

Примеры:

• Если мы ценим пребывание на 1 номе, где AmountBeforeTax составляет 90, AmountAfterTax составляет 100, а fixed_price -80, то уровень продвижения по службе-80.
• Если мы ценим пребывание на 1 ноч, где AmountBeforeTax составляет 100, fixed_amount -это 80, а TaxFeeInfo определяет налог в размере 8%, тогда

  Скорость продвижения = фиксированная цена * (1 + процентный налог)

  86,40 = 80 * 1,08

• Если мы ценим 3-дневное пребывание, где значения AmountAfterTax составляют 100, 110 и 120; и fixed_amount 300, затем

  Уровень продвижения = 300

Требуется именно один из percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price или fixed_price_per_night .

Если указаны ночные ставки AmountAfterTax , то это устанавливает цену на каждую ночь пребывания, включая налоги и сборы, на указанную стоимость. Если указан AmountBeforeTax , то указано ли AmountAfterTax , это устанавливает цену до налогообложения для каждой ночи пребывания в указанном значении. Предполагается, что он находится в той же валюте, что и ночные ставки.

Если AmountAfterTax предназначен для отражения процентного налога, то установление фиксированной цены для AmountBeforeTax может привести к неточным налогам и сборам. В целом, настоятельно рекомендуется использовать TaxFeeInfo для указания налогов и сборов имущества.

Если указан applied_nights , то новая цена применяется к самым дешевым N Nights.

Примеры:

• Если мы ценим пребывание на 2 дня, где значения AmountBeforeTax составляют 90, 90; Значения AmountAfterTax составляют 100, 100; и fixed_price составляет 80, тогда скорость продвижения составляет 80 + 80 = 160.
• Если мы ценим, 2-дневное пребывание, где AmountBeforeTax составляет 100, 100; fixed_amount составляет 80, а TaxFeeInfo определяет налог в размере 8%, тогда ставка продвижения (80 + 80) * 1,08 = 172,8.
• Если мы ценим 3-дневное пребывание, где значения AmountAfterTax составляют 100, 110 и 120; и fixed_amount составляет 110, то скорость продвижения составляет 110 * 3 = 330.

Это должно использоваться только с percentage или fixed_amount_per_night

Количество ночей, к которым применяется скидка, начиная с наименее дорогих. Должно быть целое число от 1 до 99. Если не указано, скидка применяется на все ночи.

Количество необходимых ночей для применения скидки. Каждая скидка применяется к отдельному сегменту ночей пребывания.

Например, для 10-дневного пребывания, где stay_nights составляет 4 (и repeats правда), то есть два сегмента «Снай»: «С 1 по 4 ночи» и с 5 по 8 ночей; 9 -й и 10 -й ночи не являются частью сегмента Night Night.

Может ли скидка применяться к нескольким ночным сегментам. Если false , то только сегмент ночей пребывания в начале маршрута скидывается. Если true , то любой сегмент ночей пребывания со скидки.

Например, если stay_nights составляет 4, а маршрут составляет 10 ночей, то, если repeats true , то 2 сегмента скидываются (ночи 1-4 и ночи 5-8); Но, если repeats является false , то только 1 сегмент дисконтируется (ночи 1-4).

Точно одна из Discount или BestDailyDiscount должна быть указана.

Указывает ежедневную скидку, которая может быть применена к ночи пребывания. Это в отличие от Discount , которая применяет скидки на целое пребывание.

Каждое свойство может иметь одну группу рекламных акций, которые считаются «лучшими ежедневно». Это означает, что для каждой ночи пребывания выбирается единственная реклама «Лучшая ежедневная», которая имеет право и дает самую глубокую скидку на эту ночь и может быть применена.

Stacking может быть указана с помощью BestDailyDiscount . Он должен быть установлен на base или none . «Лучшие ежедневные» скидки, дающие самую глубокую скидку для каждой ночи, объединяются и рассматриваются как единая скидка (то есть Discount ) при соблюдении настроенного типа укладки. Эта комбинированная скидка сравнивается с и может быть сложена с другими подходящими для <Scint> рекламными акциями, чтобы найти одну или комбинацию, которая обеспечивает самую глубокую скидку. Либо комбинация BestDailyDiscount или одной Discount , в зависимости от того, что дает более низкую цену, выбирается и применяется для base типа укладки.

StayDates могут быть указаны с помощью этого типа скидки, но application должно быть установлено для overlap

Требуется именно один из percentage , fixed_amount или fixed_price .

Десятичное значение от 0-100, которое указывает процентную скидку. Он применяется к AmountAfterTax (или AmountBeforeTax если AmountAfterTax не указан).

Примеры:

• Если AmountAfterTax для ночи пребывания составляет 100, а percentage - 20, тогда

  Коэффициент продвижения = AmountAfterTax * (1 - процентная скидка)

  80,00 = 100 * (1 - 0,2)

• Если AmountBeforeTax для пребывания составляет 100, percentage составляет 20, а TaxFeeInfo определяет налог в размере 10, тогда

  Ставка продвижения = AmountBeforeTax * (1 - процентная скидка) + налог

  90,00 = 100 * (1 - 0,2) + 10

Требуется именно один из percentage , fixed_amount или fixed_price .

Фиксированная сумма, которая должна быть вычтена по одной ночной ставке AmountAfterTax (или ночной ставке AmountBeforeTax , если AmountAfterTax не указан). Предполагается, что он находится в той же валюте, что и ночные ставки. Если это больше, чем сумма ночных ставок, полученное значение равно нулю.

Примеры:

• Если AmountBeforeTax для одной ночи составляет 90, AmountAfterTax составляет 100, а fixed_amount - 20, тогда

  Скорость продвижения = AmountAfterTax - фиксированная скидка

  80,00 = 100 - 20

• Если AmountBeforeTax для одной ночи составляет 100, fixed_amount - 20, а TaxFeeInfo определяет налог в размере 8%, тогда

  Ставка продвижения = ( AmountBeforeTax - Фиксированная скидка) * (1 + процентный налог)

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

Требуется именно один из percentage , fixed_amount или fixed_price .

Если указаны ночные ставки AmountAfterTax , то это устанавливает цену за ночь пребывания, включая налоги и сборы, на указанную стоимость. Если указан AmountBeforeTax , то указано ли AmountAfterTax , это устанавливает цену до налогообложения для пребывания на указанное значение. Предполагается, что он находится в той же валюте, что и ночные ставки.

Примеры:

• Если AmountBeforeTax для одной ночи составляет 90, AmountAfterTax составляет 100, а fixed_price - 80, то показатель продвижения - 80.
• Если AmountBeforeTax для одной ночи составляет 100, fixed_amount - 80, а TaxFeeInfo определяет налог в размере 8%, тогда

  Скорость продвижения = фиксированная цена * (1 + процентный налог)

  86,40 = 80 * 1,08

Container for a membership rate rule that triggers a specific UI treatment for the associated discount.

This element should not be specified unless <Discount> is also specified.

ID of the rate rule associated with a membership program.

Multiple promotions can be applied to a single rate depending on this setting:

• any : Can be combined with any other promotion (except none ), but the order in which the promotions should be applied is not guaranteed.
• base : The best eligible base promotion is selected and applied first, before other promotions. This was previously named base_only .
• second : The best eligible second promotion is selected and applied after a base promotion (if applicable) and before any promotions.
• none : Can not be combined with other promotions.

Of the allowed combinations, the set of promotions which yields the largest discount are applied to the rate.

Describes how the promotion should be applied.

Valid values are:

• all : Applies the promotion to each night in the itinerary if all dates in the itinerary overlap with the stay dates.
• any : Applies the promotion to all nights in the itinerary if any date in the itinerary overlaps with a date in the stay dates range.
• overlap : Applies the promotion only to those nights in the itinerary that overlap with a date in the stay dates range.

This attribute must always be specified.

• If <Discount> specifies percentage and application is set to all or any , the discount is applied as a percentage of the full stay.
• If <Discount> specifies percentage and application is set to overlap , the discount is applied as a percentage of nightly rates for overlapping nights.
• <Discount> specifying fixed_amount and application set to overlap is an invalid combination.
• <FreeNights> supports all application values. Note that for overlap , only overlapping nights of stay are considered for the discount requirements.

A date range specifying dates when the promotion is to be applied.

The YearlessDate format is also supported.

• If one of start or end is a yearless date, both must be populated as yearless dates.
• Yearless date ranges must not wrap around the new year. Instead, represent the range as two adjacent date ranges. For example, {"12-29", "01-05"} can be represented as {"12-29", "12-31"} and {"01-01", "01-05"} .

If you want to set StayDates range to allow the promotion on specific days of the week, you should set the start date as the current date with no end so that the promotion doesn't expire.

You should specify start value if the end value isn't provided.

You should specify end value if the start value isn't provided.

The days of the week that are allowed in the date range. If not specified, all days are allowed in the date range. Each character in the string specifies a day. For example, "MTWHF" specifies that weekdays are allowed in the date range.

Valid characters are:

• M for Monday
• T for Tuesday
• W for Wednesday
• H for Thursday
• F for Friday
• S for Saturday
• U for Sunday

Any character combination is valid.

Valid values are include and exclude .

If the UserCountries type is set as include , the promotion applies to users from the listed countries.

If the UserCountries type is exclude , the promotion applies to users from outside the listed countries.

If the UserCountries type is unset, it is treated as include and the promotion is applied to users from the listed countries.

Either <Success> or <Issues> is present in each message.

Either <Success> or <Issues> is present in each message.

The type of issue encountered.

Valid values are warning , error , and failure .

If you have a backend that provides feeds for multiple accounts, this value needs to match the ID attribute value specified in the <RequestorID> element of your <OTA_HotelRateAmountNotifRQ> and <OTA_HotelAvailNotifRQ> messages for the same account.

Promotions for a property. Each promotion applies to a single property.

Unless <Stacking> is used, the promotion with the biggest discount is applied to the booking when multiple promotions are eligible.

If specified, the value must be "overlay" . When the value is "overlay" , all stored promotions are deleted prior to storing the promotions specified in the current message.

If not specified, then each promotion specified in the current message is either:

• Added (if none of the stored promotions has the same id )
• Updated (if a stored promotion has the same id )
• Deleted (if a stored promotion has the same id and the value of the action attribute for the promotion specified in the current message is "delete" )

A single promotion for a property. Note that if action="overlay" and a <Promotion> is not specified, all promotions for the property are deleted.

If you need to use more than 99 promotions, contact your Technical Account Manager (TAM).

If specified, the value must be delete . If not specified and a promotion with the same id isn't stored, then this promotion is stored. Otherwise, if not specified and a promotion with the same id is stored, then the existing promotion is updated.

If delete is specified, the stored promotion with the same id is deleted. When using delete , don't include any child elements in <Promotion> . Also, delete is not allowed in conjunction with <HotelPromotions action="overlay"/> .

The starting date or datetime (based on the property's time zone), inclusive, of the range.

• The date or datetime specified by start must be earlier than (or the same as) the date or datetime specified by end .
• If start isn't specified, the range is effectively unlimited in terms of a start time.
• If start is populated as date "YYYY-MM-DD", it is interpreted as datetime "YYYY-MM-DDT00:00:00".

The ending date or datetime (based on the property's time zone), inclusive, of the range.

• The date or datetime specified by end must be later than (or the same as) the date or datetime specified by start .
• If end isn't specified, the range is effectively unlimited in terms of an end time.
• If end is provided as date "YYYY-MM-DD", it is interpreted as datetime "YYYY-MM-DDT23:59:59".

The days of the week that are allowed in the date range. If not specified, all days are allowed in the date range. Each character in the string specifies a day. For example, "MTWHF" specifies that weekdays are allowed in the date range.

Valid characters are:

• M for Monday
• T for Tuesday
• W for Wednesday
• H for Thursday
• F for Friday
• S for Saturday
• U for Sunday

Any character combination is valid.

Valid value types are:

• Integer: The number of days before the check-in date. For example, a value of 30 indicates the promotion only applies to bookings at least 30 days before the check-in date.
• ISO 8601 Duration (days, hours, and minutes): The number of days (and optionally hours/minutes) before the check-in date. For example, a value of P30D indicates the promotion only applies to bookings at least 30 days before the check-in date. A value of P30DT6H requires booking on or before 18:00 on the 30th day before arrival.

Valid value types are:

• Integer: The number of days before the check-in date. For example, a value of 30 indicates the promotion only applies to bookings at most 30 days before the check-in date.
• ISO 8601 Duration (days, hours, and minutes): The number of days (and optionally hours/minutes) before the check-in date. For example, a value of P30D indicates the promotion only applies to bookings at most 30 days before the check-in date. A value of P30DT6H requires booking on or after 18:00 on the 30th day before arrival.

Defines restrictions on the maximum value that a rate can be set to after promotions are applied.

Promotions must always specify a <Discount> or a <BestDailyDiscount> , so to create a promotion that only applies a <Ceiling> , one option is to set a <Discount> with a percentage of 0 .

If stacking is configured, then multiple promotions with <Ceiling> could apply to a single stay. Each promotion would apply its discount, immediately followed by its ceiling. The following example demonstrates how each ceiling contributes to the next promotion calculation in the stack.

Пример:

Pricing a 1-night stay where AmountBeforeTax is 100 and there is a stack of two promotions:

1. Promotion with stacking type base , a fixed_amount of 25, and a ceiling amount_per_night of 60
2. Promotion with stacking type second , fixed_amount of 25, and a ceiling amount_per_night of 90

Here is the order of calculation:

1. The base promotion is applied first and discounts the AmountBeforeTax to 75, but then the ceiling lowers it to 60 .
2. The second promotion discounts the AmountBeforeTax from 60 to 35. This is below the ceiling of 90 so the second ceiling is not applied. The final rate is 35 .

The fact that 60 is a stricter overall ceiling is irrelevant since it is valid only for its own promotion, and there can be no single ceiling that spans the entire promotion stack.

The maximum amount that a nightly rate can be set to after the discount is applied.

If a <Floor> element is also specified, this must be set to a value greater than or equal to the amount_per_night attribute in <Floor> .

amount_per_night is applied to taxes and fees when they are included in the nightly rate using AmountAfterTax , but not those specified using TaxFeeInfo.

Defines restrictions on the minimum value that a rate can be set to after promotions are applied.

Promotions must always specify a <Discount> or a <BestDailyDiscount> , so to create a promotion that only applies a <Floor> , one option is to set a <Discount> with a percentage of 0 .

<Floor> logic still applies to <FreeNights> discounts, even if the free night has a 100% discount applied to it.

If stacking is configured, then multiple promotions with <Floor> could apply to a single stay. Each promotion would apply its discount, immediately followed by its floor. The following example demonstrates how each floor contributes to the next promotion calculation in the stack.

Пример:

Pricing a 1-night stay where AmountBeforeTax is 100 and there is a stack of two promotions:

1. Promotion with stacking type base , a fixed_amount of 25, and a floor amount_per_night of 90
2. Promotion with stacking type second , fixed_amount of 25, and a floor amount_per_night of 60

Here is the order of calculation:

1. The base promotion is applied first and discounts the AmountBeforeTax to 75, but then the floor raises it up to 90 .
2. The second promotion discounts the AmountBeforeTax from 90 to 65. This is above the floor of 60 so the second floor is not applied. The final rate is 65 .

The fact that 90 is a stricter overall floor is irrelevant since it is valid only for its own promotion, and there can be no single floor that spans the entire promotion stack.

The minimum amount that a nightly rate can be set to after the discount is applied.

If a <Ceiling> element is also specified, this must be set to a value less than or equal to the amount_per_night attribute in <Ceiling> .

amount_per_night is applied to taxes and fees when they are included in the nightly rate using AmountAfterTax , but not those specified using TaxFeeInfo.

A date range specifying when check-in must occur for the promotion to be applied. This element is not required if you're deleting one or more promotions.

The YearlessDate format is also supported.

• If one of start or end is a yearless date, both must be populated as yearless dates.
• Yearless date ranges must not wrap around the new year. Instead, represent the range as two adjacent date ranges. For example, {"12-29", "01-05"} can be represented as {"12-29", "12-31"} and {"01-01", "01-05"} .

The days of the week that are allowed in the date range. If not specified, all days are allowed in the date range. Each character in the string specifies a day. For example, "MTWHF" specifies that weekdays are allowed in the date range.

Valid characters are:

• M for Monday
• T for Tuesday
• W for Wednesday
• H for Thursday
• F for Friday
• S for Saturday
• U for Sunday

Any character combination is valid.

A date range specifying when check-out must occur for the promotion to be applied. This element is not required if you're deleting one or more promotions.

The YearlessDate format is also supported.

• If one of start or end is a yearless date, both must be populated as yearless dates.
• Yearless date ranges must not wrap around the new year. Instead, represent the range as two adjacent date ranges. For example, {"12-29", "01-05"} can be represented as {"12-29", "12-31"} and {"01-01", "01-05"} .

The days of the week that are allowed in the date range. If not specified, all days are allowed in the date range. Each character in the string specifies a day. For example, "MTWHF" specifies that weekdays are allowed in the date range.

Valid characters are:

• M for Monday
• T for Tuesday
• W for Wednesday
• H for Thursday
• F for Friday
• S for Saturday
• U for Sunday

Any character combination is valid.

Exactly one of Discount or BestDailyDiscount must be specified.

Specifies the discount to be applied for this promotion.

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

A decimal value from 0-100 which specifies the percentage discount. It is applied to AmountAfterTax (or AmountBeforeTax if AmountAfterTax isn't specified).

Примеры:

• If AmountAfterTax is 100 and percentage is 20, then

  promotion rate = AmountAfterTax * (1 - percentage discount)

  80.00 = 100 * (1 - 0.2)

• If AmountBeforeTax is 100, percentage is 20 and TaxFeeInfo specifies a tax of 10, then

  promotion rate = AmountBeforeTax * (1 - percentage discount) + tax

  90.00 = 100 * (1 - 0.2) + 10

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

A decimal value from 0-100 which specifies the percentage of base discount. Similar to percentage , it is applied to AmountAfterTax (or AmountBeforeTax if AmountAfterTax isn't specified).

Unlike percentage , this discount is always calculated as a percentage of base rates regardless of prior promotions that have been applied in sequence.

Пример:

• Suppose we have two promotions that are applied in sequence to a one night stay that is priced at 100. The first is a regular 10% percentage discount and the second is a 10% percentage of base discount. Then the discounted rate will be 80 since both promotions take 10 off. Note if the second promotion were also a regular percentage discount, then the discounted rate will be 81 since the second promotion discounts 10% of 90.

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

A fixed amount to be subtracted from the sum of the AmountAfterTax nightly rates (or sum of AmountBeforeTax nightly rates if AmountAfterTax isn't specified). It is assumed to be in the same currency as nightly rates. If this is larger than the sum of nightly rates, the resulting value is zero.

Примеры:

• If we're pricing a 1-night stay where AmountBeforeTax is 90, AmountAfterTax is 100, and fixed_amount is 20, then

  promotion rate = AmountAfterTax - fixed discount

  80.00 = 100 - 20

• If we're pricing a 1-night stay where AmountBeforeTax is 100, fixed_amount is 20, and TaxFeeInfo specifies a tax of 8%, then

  promotion rate = ( AmountBeforeTax - fixed discount) * (1 + percentage tax)

  86.40 = (100 - 20) * 1.08

• If we're pricing a 1-night stay where AmountBeforeTax is 50, fixed_amount is 60, and TaxFeeInfo specifies a tax of 10, then

  promotion rate = ( AmountBeforeTax - fixed discount) * tax

  10.00 = 0 + 10

• If we're pricing a 3-night stay where the AmountAfterTax values are 100, 110, and 120; and fixed_amount is 150, then

  promotion rate = sum( AmountAfterTax ) - (fixed discount)

  180.00 = (100 + 110 + 120) - 150

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

A fixed discount applied to each of the AmountAfterTax nightly rates (or the cheapest N if applied_nights is specified). If AmountAfterTax isn't specified, it is applied to AmountBeforeTax . It is assumed to be in the same currency as nightly rates. If fixed_amount_per_night is larger than a nightly rate, that nightly rate is reduced to as zero—the discount cannot cause a nightly rate to become negative.

Примеры:

• If we're pricing a 3-night stay where the AmountAfterTax values are 100, 110, and 120; and the fixed_amount_per_night is 10, then

  promotion rate = sum( AmountBeforeTax - fixed amount discount)

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

• If we're pricing a 3-night stay where the AmountAfterTax values are 10, 50, and 100; and the fixed_amount_per_night is 20, then

  promotion rate = sum( AmountAfterTax - fixed amount discount)

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

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

If AmountAfterTax nightly rates are specified, then this sets the price for the stay, including taxes and fees, to the specified value. If AmountBeforeTax is specified, then whether or not AmountAfterTax is specified, this sets the pre-tax price for the stay to the specified value. It is assumed to be in the same currency as nightly rates.

If AmountAfterTax is intended to reflect a percentage tax, then setting a fixed price for AmountBeforeTax can result in inaccurate taxes and fees. In general, it is strongly recommended to use TaxFeeInfo to specify a property's taxes and fees.

Примеры:

• If we're pricing a 1-night stay where AmountBeforeTax is 90, AmountAfterTax is 100, and fixed_price is 80, then the promotion rate is 80.
• If we're pricing a 1-night stay where AmountBeforeTax is 100, fixed_amount is 80, and TaxFeeInfo specifies a tax of 8%, then

  promotion rate = fixed price * (1 + percentage tax)

  86.40 = 80 * 1.08

• If we're pricing a 3-night stay where the AmountAfterTax values are 100, 110, and 120; and fixed_amount is 300, then

  promotion rate = 300

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

If AmountAfterTax nightly rates are specified, then this sets the price for each night of stay, including taxes and fees, to the specified value. If AmountBeforeTax is specified, then whether or not AmountAfterTax is specified, this sets the pre-tax price for each night of stay to the specified value. It is assumed to be in the same currency as nightly rates.

If AmountAfterTax is intended to reflect a percentage tax, then setting a fixed price for AmountBeforeTax can result in inaccurate taxes and fees. In general, it is strongly recommended to use TaxFeeInfo to specify a property's taxes and fees.

If applied_nights is specified, then the new price is applied to the cheapest N nights.

Примеры:

• If we're pricing a 2-night stay where AmountBeforeTax values are 90, 90; AmountAfterTax values are 100, 100; and fixed_price is 80, then the promotion rate is 80 + 80 = 160.
• If we're pricing a 2-night stay where AmountBeforeTax is 100, 100; fixed_amount is 80, and TaxFeeInfo specifies a tax of 8%, then the promotion rate is (80 + 80) * 1.08 = 172.8.
• If we're pricing a 3-night stay where the AmountAfterTax values are 100, 110, and 120; and fixed_amount is 110, then the promotion rate is 110 * 3 = 330.

This should only be used with percentage or fixed_amount_per_night .

The number of nights to which the discount is applied, starting with the least expensive. Must be an integer from 1 to 99. If not specified, discount is applied to all nights.

Number of required nights for the discount to be applied. Each discount is applied to a separate segment of stay nights.

For example, for a 10-night stay where stay_nights is 4 (and repeats is true), then there are two stay night segments: the 1st through 4th nights and the 5th through 8th nights; the 9th and 10th nights are not part of a stay night segment.

Whether the discount may be applied to multiple stay night segments. If false , then only the segment of stay nights at the beginning of the itinerary is discounted. If true , then any segment of stay nights is discounted.

For example, if stay_nights is 4 and the itinerary is 10 nights, then, if repeats is true , then 2 segments are discounted (nights 1-4 and nights 5-8); but, if repeats is false , then only 1 segment is discounted (nights 1-4).

Exactly one of Discount or BestDailyDiscount must be specified.

Specifies a daily discount which may be applied to a night of stay. This is in contrast with Discount , which applies discounts to entire stays.

Each property may have a single group of promotions that are considered "best daily." This means that for each night of stay, the single "best daily" promotion that is eligible and yields the deepest discount for that night is selected and may be applied.

Stacking may be specified with BestDailyDiscount . It must be set to either base or none . The "best daily" discounts yielding the deepest discount for each night are combined and treated as a single stay discount (ie Discount ) while respecting the configured stacking type. This combined discount is compared against, and can be stacked with, other eligible <Discount> promotions to find the one or combination that provides the deepest discount. Either the combination of BestDailyDiscount or a single Discount , whichever yields the lower price, is selected and applied for the base stacking type.

StayDates can be specified with this type of discount, but the application must be set to overlap

Exactly one of percentage , fixed_amount , or fixed_price is required.

A decimal value from 0-100 which specifies the percentage discount. It is applied to AmountAfterTax (or AmountBeforeTax if AmountAfterTax isn't specified).

Примеры:

• If AmountAfterTax for a night of stay is 100 and percentage is 20, then

  promotion rate = AmountAfterTax * (1 - percentage discount)

  80.00 = 100 * (1 - 0.2)

• If AmountBeforeTax for an ight of stay is 100, percentage is 20 and TaxFeeInfo specifies a tax of 10, then

  promotion rate = AmountBeforeTax * (1 - percentage discount) + tax

  90.00 = 100 * (1 - 0.2) + 10

Exactly one of percentage , fixed_amount , or fixed_price is required.

A fixed amount to be subtracted from a single AmountAfterTax nightly rate (or AmountBeforeTax nightly rate if AmountAfterTax isn't specified). It is assumed to be in the same currency as nightly rates. If this is larger than the sum of nightly rates, the resulting value is zero.

Примеры:

• If AmountBeforeTax for a single night is 90, AmountAfterTax is 100, and fixed_amount is 20, then

  promotion rate = AmountAfterTax - fixed discount

  80.00 = 100 - 20

• If AmountBeforeTax for a single night is 100, fixed_amount is 20, and TaxFeeInfo specifies a tax of 8%, then

  promotion rate = ( AmountBeforeTax - fixed discount) * (1 + percentage tax)

  86.40 = (100 - 20) * 1.08

Exactly one of percentage , fixed_amount , or fixed_price is required.

If AmountAfterTax nightly rates are specified, then this sets the price for the night of stay, including taxes and fees, to the specified value. If AmountBeforeTax is specified, then whether or not AmountAfterTax is specified, this sets the pre-tax price for the stay to the specified value. It is assumed to be in the same currency as nightly rates.

Примеры:

• If AmountBeforeTax for a single night is 90, AmountAfterTax is 100, and fixed_price is 80, then the promotion rate is 80.
• If AmountBeforeTax for a single night is 100, fixed_amount is 80, and TaxFeeInfo specifies a tax of 8%, then

  promotion rate = fixed price * (1 + percentage tax)

  86.40 = 80 * 1.08

Container for a membership rate rule that triggers a specific UI treatment for the associated discount.

This element should not be specified unless <Discount> is also specified.

ID of the rate rule associated with a membership program.

Multiple promotions can be applied to a single rate depending on this setting:

• any : Can be combined with any other promotion (except none ), but the order in which the promotions should be applied is not guaranteed.
• base : The best eligible base promotion is selected and applied first, before other promotions. This was previously named base_only .
• second : The best eligible second promotion is selected and applied after a base promotion (if applicable) and before any promotions.
• none : Can not be combined with other promotions.

Of the allowed combinations, the set of promotions which yields the largest discount are applied to the rate.

Describes how the promotion should be applied.

Valid values are:

• all : Applies the promotion to each night in the itinerary if all dates in the itinerary overlap with the stay dates.
• any : Applies the promotion to all nights in the itinerary if any date in the itinerary overlaps with a date in the stay dates range.
• overlap : Applies the promotion only to those nights in the itinerary that overlap with a date in the stay dates range.

This attribute must always be specified.

• If <Discount> specifies percentage and application is set to all or any , the discount is applied as a percentage of the full stay.
• If <Discount> specifies percentage and application is set to overlap , the discount is applied as a percentage of nightly rates for overlapping nights.
• <Discount> specifying fixed_amount and application set to overlap is an invalid combination.
• <FreeNights> supports all application values. Note that for overlap , only overlapping nights of stay are considered for the discount requirements.

A date range specifying dates when the promotion is to be applied.

The YearlessDate format is also supported.

• If one of start or end is a yearless date, both must be populated as yearless dates.
• Yearless date ranges must not wrap around the new year. Instead, represent the range as two adjacent date ranges. For example, {"12-29", "01-05"} can be represented as {"12-29", "12-31"} and {"01-01", "01-05"} .

If you want to set StayDates range to allow the promotion on specific days of the week, you should set the start date as the current date with no end so that the promotion doesn't expire.

You should specify start value if the end value isn't provided.

You should specify end value if the start value isn't provided.

The days of the week that are allowed in the date range. If not specified, all days are allowed in the date range. Each character in the string specifies a day. For example, "MTWHF" specifies that weekdays are allowed in the date range.

Valid characters are:

• M for Monday
• T for Tuesday
• W for Wednesday
• H for Thursday
• F for Friday
• S for Saturday
• U for Sunday

Any character combination is valid.

Valid values are include and exclude .

If the UserCountries type is set as include , the promotion applies to users from the listed countries.

If the UserCountries type is exclude , the promotion applies to users from outside the listed countries.

If the UserCountries type is unset, it is treated as include and the promotion is applied to users from the listed countries.

Either <Success> or <Issues> is present in each message.

Either <Success> or <Issues> is present in each message.

The type of issue encountered.

Valid values are warning , error , and failure .

If you have a backend that provides feeds for multiple accounts, this value needs to match the ID attribute value specified in the <RequestorID> element of your <OTA_HotelRateAmountNotifRQ> and <OTA_HotelAvailNotifRQ> messages for the same account.

Promotions for a property. Each promotion applies to a single property.

Unless <Stacking> is used, the promotion with the biggest discount is applied to the booking when multiple promotions are eligible.

If specified, the value must be "overlay" . When the value is "overlay" , all stored promotions are deleted prior to storing the promotions specified in the current message.

If not specified, then each promotion specified in the current message is either:

• Added (if none of the stored promotions has the same id )
• Updated (if a stored promotion has the same id )
• Deleted (if a stored promotion has the same id and the value of the action attribute for the promotion specified in the current message is "delete" )

A single promotion for a property. Note that if action="overlay" and a <Promotion> is not specified, all promotions for the property are deleted.

If you need to use more than 99 promotions, contact your Technical Account Manager (TAM).

If specified, the value must be delete . If not specified and a promotion with the same id isn't stored, then this promotion is stored. Otherwise, if not specified and a promotion with the same id is stored, then the existing promotion is updated.

If delete is specified, the stored promotion with the same id is deleted. When using delete , don't include any child elements in <Promotion> . Also, delete is not allowed in conjunction with <HotelPromotions action="overlay"/> .

The starting date or datetime (based on the property's time zone), inclusive, of the range.

• The date or datetime specified by start must be earlier than (or the same as) the date or datetime specified by end .
• If start isn't specified, the range is effectively unlimited in terms of a start time.
• If start is populated as date "YYYY-MM-DD", it is interpreted as datetime "YYYY-MM-DDT00:00:00".

The ending date or datetime (based on the property's time zone), inclusive, of the range.

• The date or datetime specified by end must be later than (or the same as) the date or datetime specified by start .
• If end isn't specified, the range is effectively unlimited in terms of an end time.
• If end is provided as date "YYYY-MM-DD", it is interpreted as datetime "YYYY-MM-DDT23:59:59".

The days of the week that are allowed in the date range. If not specified, all days are allowed in the date range. Each character in the string specifies a day. For example, "MTWHF" specifies that weekdays are allowed in the date range.

Valid characters are:

• M for Monday
• T for Tuesday
• W for Wednesday
• H for Thursday
• F for Friday
• S for Saturday
• U for Sunday

Any character combination is valid.

Valid value types are:

• Integer: The number of days before the check-in date. For example, a value of 30 indicates the promotion only applies to bookings at least 30 days before the check-in date.
• ISO 8601 Duration (days, hours, and minutes): The number of days (and optionally hours/minutes) before the check-in date. For example, a value of P30D indicates the promotion only applies to bookings at least 30 days before the check-in date. A value of P30DT6H requires booking on or before 18:00 on the 30th day before arrival.

Valid value types are:

• Integer: The number of days before the check-in date. For example, a value of 30 indicates the promotion only applies to bookings at most 30 days before the check-in date.
• ISO 8601 Duration (days, hours, and minutes): The number of days (and optionally hours/minutes) before the check-in date. For example, a value of P30D indicates the promotion only applies to bookings at most 30 days before the check-in date. A value of P30DT6H requires booking on or after 18:00 on the 30th day before arrival.

Defines restrictions on the maximum value that a rate can be set to after promotions are applied.

Promotions must always specify a <Discount> or a <BestDailyDiscount> , so to create a promotion that only applies a <Ceiling> , one option is to set a <Discount> with a percentage of 0 .

If stacking is configured, then multiple promotions with <Ceiling> could apply to a single stay. Each promotion would apply its discount, immediately followed by its ceiling. The following example demonstrates how each ceiling contributes to the next promotion calculation in the stack.

Пример:

Pricing a 1-night stay where AmountBeforeTax is 100 and there is a stack of two promotions:

1. Promotion with stacking type base , a fixed_amount of 25, and a ceiling amount_per_night of 60
2. Promotion with stacking type second , fixed_amount of 25, and a ceiling amount_per_night of 90

Here is the order of calculation:

1. The base promotion is applied first and discounts the AmountBeforeTax to 75, but then the ceiling lowers it to 60 .
2. The second promotion discounts the AmountBeforeTax from 60 to 35. This is below the ceiling of 90 so the second ceiling is not applied. The final rate is 35 .

The fact that 60 is a stricter overall ceiling is irrelevant since it is valid only for its own promotion, and there can be no single ceiling that spans the entire promotion stack.

The maximum amount that a nightly rate can be set to after the discount is applied.

If a <Floor> element is also specified, this must be set to a value greater than or equal to the amount_per_night attribute in <Floor> .

amount_per_night is applied to taxes and fees when they are included in the nightly rate using AmountAfterTax , but not those specified using TaxFeeInfo.

Defines restrictions on the minimum value that a rate can be set to after promotions are applied.

Promotions must always specify a <Discount> or a <BestDailyDiscount> , so to create a promotion that only applies a <Floor> , one option is to set a <Discount> with a percentage of 0 .

<Floor> logic still applies to <FreeNights> discounts, even if the free night has a 100% discount applied to it.

If stacking is configured, then multiple promotions with <Floor> could apply to a single stay. Each promotion would apply its discount, immediately followed by its floor. The following example demonstrates how each floor contributes to the next promotion calculation in the stack.

Пример:

Pricing a 1-night stay where AmountBeforeTax is 100 and there is a stack of two promotions:

1. Promotion with stacking type base , a fixed_amount of 25, and a floor amount_per_night of 90
2. Promotion with stacking type second , fixed_amount of 25, and a floor amount_per_night of 60

Here is the order of calculation:

1. The base promotion is applied first and discounts the AmountBeforeTax to 75, but then the floor raises it up to 90 .
2. The second promotion discounts the AmountBeforeTax from 90 to 65. This is above the floor of 60 so the second floor is not applied. The final rate is 65 .

The fact that 90 is a stricter overall floor is irrelevant since it is valid only for its own promotion, and there can be no single floor that spans the entire promotion stack.

The minimum amount that a nightly rate can be set to after the discount is applied.

If a <Ceiling> element is also specified, this must be set to a value less than or equal to the amount_per_night attribute in <Ceiling> .

amount_per_night is applied to taxes and fees when they are included in the nightly rate using AmountAfterTax , but not those specified using TaxFeeInfo.

A date range specifying when check-in must occur for the promotion to be applied. This element is not required if you're deleting one or more promotions.

The YearlessDate format is also supported.

• If one of start or end is a yearless date, both must be populated as yearless dates.
• Yearless date ranges must not wrap around the new year. Instead, represent the range as two adjacent date ranges. For example, {"12-29", "01-05"} can be represented as {"12-29", "12-31"} and {"01-01", "01-05"} .

The days of the week that are allowed in the date range. If not specified, all days are allowed in the date range. Each character in the string specifies a day. For example, "MTWHF" specifies that weekdays are allowed in the date range.

Valid characters are:

• M for Monday
• T for Tuesday
• W for Wednesday
• H for Thursday
• F for Friday
• S for Saturday
• U for Sunday

Any character combination is valid.

A date range specifying when check-out must occur for the promotion to be applied. This element is not required if you're deleting one or more promotions.

The YearlessDate format is also supported.

• If one of start or end is a yearless date, both must be populated as yearless dates.
• Yearless date ranges must not wrap around the new year. Instead, represent the range as two adjacent date ranges. For example, {"12-29", "01-05"} can be represented as {"12-29", "12-31"} and {"01-01", "01-05"} .

The days of the week that are allowed in the date range. If not specified, all days are allowed in the date range. Each character in the string specifies a day. For example, "MTWHF" specifies that weekdays are allowed in the date range.

Valid characters are:

• M for Monday
• T for Tuesday
• W for Wednesday
• H for Thursday
• F for Friday
• S for Saturday
• U for Sunday

Any character combination is valid.

Exactly one of Discount or BestDailyDiscount must be specified.

Specifies the discount to be applied for this promotion.

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

A decimal value from 0-100 which specifies the percentage discount. It is applied to AmountAfterTax (or AmountBeforeTax if AmountAfterTax isn't specified).

Примеры:

• If AmountAfterTax is 100 and percentage is 20, then

  promotion rate = AmountAfterTax * (1 - percentage discount)

  80.00 = 100 * (1 - 0.2)

• If AmountBeforeTax is 100, percentage is 20 and TaxFeeInfo specifies a tax of 10, then

  promotion rate = AmountBeforeTax * (1 - percentage discount) + tax

  90.00 = 100 * (1 - 0.2) + 10

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

A decimal value from 0-100 which specifies the percentage of base discount. Similar to percentage , it is applied to AmountAfterTax (or AmountBeforeTax if AmountAfterTax isn't specified).

Unlike percentage , this discount is always calculated as a percentage of base rates regardless of prior promotions that have been applied in sequence.

Пример:

• Suppose we have two promotions that are applied in sequence to a one night stay that is priced at 100. The first is a regular 10% percentage discount and the second is a 10% percentage of base discount. Then the discounted rate will be 80 since both promotions take 10 off. Note if the second promotion were also a regular percentage discount, then the discounted rate will be 81 since the second promotion discounts 10% of 90.

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

A fixed amount to be subtracted from the sum of the AmountAfterTax nightly rates (or sum of AmountBeforeTax nightly rates if AmountAfterTax isn't specified). It is assumed to be in the same currency as nightly rates. If this is larger than the sum of nightly rates, the resulting value is zero.

Примеры:

• If we're pricing a 1-night stay where AmountBeforeTax is 90, AmountAfterTax is 100, and fixed_amount is 20, then

  promotion rate = AmountAfterTax - fixed discount

  80.00 = 100 - 20

• If we're pricing a 1-night stay where AmountBeforeTax is 100, fixed_amount is 20, and TaxFeeInfo specifies a tax of 8%, then

  promotion rate = ( AmountBeforeTax - fixed discount) * (1 + percentage tax)

  86.40 = (100 - 20) * 1.08

• If we're pricing a 1-night stay where AmountBeforeTax is 50, fixed_amount is 60, and TaxFeeInfo specifies a tax of 10, then

  promotion rate = ( AmountBeforeTax - fixed discount) * tax

  10.00 = 0 + 10

• If we're pricing a 3-night stay where the AmountAfterTax values are 100, 110, and 120; and fixed_amount is 150, then

  promotion rate = sum( AmountAfterTax ) - (fixed discount)

  180.00 = (100 + 110 + 120) - 150

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

A fixed discount applied to each of the AmountAfterTax nightly rates (or the cheapest N if applied_nights is specified). If AmountAfterTax isn't specified, it is applied to AmountBeforeTax . It is assumed to be in the same currency as nightly rates. If fixed_amount_per_night is larger than a nightly rate, that nightly rate is reduced to as zero—the discount cannot cause a nightly rate to become negative.

Примеры:

• If we're pricing a 3-night stay where the AmountAfterTax values are 100, 110, and 120; and the fixed_amount_per_night is 10, then

  promotion rate = sum( AmountBeforeTax - fixed amount discount)

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

• If we're pricing a 3-night stay where the AmountAfterTax values are 10, 50, and 100; and the fixed_amount_per_night is 20, then

  promotion rate = sum( AmountAfterTax - fixed amount discount)

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

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

If AmountAfterTax nightly rates are specified, then this sets the price for the stay, including taxes and fees, to the specified value. If AmountBeforeTax is specified, then whether or not AmountAfterTax is specified, this sets the pre-tax price for the stay to the specified value. It is assumed to be in the same currency as nightly rates.

If AmountAfterTax is intended to reflect a percentage tax, then setting a fixed price for AmountBeforeTax can result in inaccurate taxes and fees. In general, it is strongly recommended to use TaxFeeInfo to specify a property's taxes and fees.

Примеры:

• If we're pricing a 1-night stay where AmountBeforeTax is 90, AmountAfterTax is 100, and fixed_price is 80, then the promotion rate is 80.
• If we're pricing a 1-night stay where AmountBeforeTax is 100, fixed_amount is 80, and TaxFeeInfo specifies a tax of 8%, then

  promotion rate = fixed price * (1 + percentage tax)

  86.40 = 80 * 1.08

• If we're pricing a 3-night stay where the AmountAfterTax values are 100, 110, and 120; and fixed_amount is 300, then

  promotion rate = 300

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

If AmountAfterTax nightly rates are specified, then this sets the price for each night of stay, including taxes and fees, to the specified value. If AmountBeforeTax is specified, then whether or not AmountAfterTax is specified, this sets the pre-tax price for each night of stay to the specified value. It is assumed to be in the same currency as nightly rates.

If AmountAfterTax is intended to reflect a percentage tax, then setting a fixed price for AmountBeforeTax can result in inaccurate taxes and fees. In general, it is strongly recommended to use TaxFeeInfo to specify a property's taxes and fees.

If applied_nights is specified, then the new price is applied to the cheapest N nights.

Примеры:

• If we're pricing a 2-night stay where AmountBeforeTax values are 90, 90; AmountAfterTax values are 100, 100; and fixed_price is 80, then the promotion rate is 80 + 80 = 160.
• If we're pricing a 2-night stay where AmountBeforeTax is 100, 100; fixed_amount is 80, and TaxFeeInfo specifies a tax of 8%, then the promotion rate is (80 + 80) * 1.08 = 172.8.
• If we're pricing a 3-night stay where the AmountAfterTax values are 100, 110, and 120; and fixed_amount is 110, then the promotion rate is 110 * 3 = 330.

This should only be used with percentage or fixed_amount_per_night .

The number of nights to which the discount is applied, starting with the least expensive. Must be an integer from 1 to 99. If not specified, discount is applied to all nights.

Number of required nights for the discount to be applied. Each discount is applied to a separate segment of stay nights.

For example, for a 10-night stay where stay_nights is 4 (and repeats is true), then there are two stay night segments: the 1st through 4th nights and the 5th through 8th nights; the 9th and 10th nights are not part of a stay night segment.

Whether the discount may be applied to multiple stay night segments. If false , then only the segment of stay nights at the beginning of the itinerary is discounted. If true , then any segment of stay nights is discounted.

For example, if stay_nights is 4 and the itinerary is 10 nights, then, if repeats is true , then 2 segments are discounted (nights 1-4 and nights 5-8); but, if repeats is false , then only 1 segment is discounted (nights 1-4).

Exactly one of Discount or BestDailyDiscount must be specified.

Specifies a daily discount which may be applied to a night of stay. This is in contrast with Discount , which applies discounts to entire stays.

Each property may have a single group of promotions that are considered "best daily." This means that for each night of stay, the single "best daily" promotion that is eligible and yields the deepest discount for that night is selected and may be applied.

Stacking may be specified with BestDailyDiscount . It must be set to either base or none . The "best daily" discounts yielding the deepest discount for each night are combined and treated as a single stay discount (ie Discount ) while respecting the configured stacking type. This combined discount is compared against, and can be stacked with, other eligible <Discount> promotions to find the one or combination that provides the deepest discount. Either the combination of BestDailyDiscount or a single Discount , whichever yields the lower price, is selected and applied for the base stacking type.

StayDates can be specified with this type of discount, but the application must be set to overlap

Exactly one of percentage , fixed_amount , or fixed_price is required.

A decimal value from 0-100 which specifies the percentage discount. It is applied to AmountAfterTax (or AmountBeforeTax if AmountAfterTax isn't specified).

Примеры:

• If AmountAfterTax for a night of stay is 100 and percentage is 20, then

  promotion rate = AmountAfterTax * (1 - percentage discount)

  80.00 = 100 * (1 - 0.2)

• If AmountBeforeTax for an ight of stay is 100, percentage is 20 and TaxFeeInfo specifies a tax of 10, then

  promotion rate = AmountBeforeTax * (1 - percentage discount) + tax

  90.00 = 100 * (1 - 0.2) + 10

Exactly one of percentage , fixed_amount , or fixed_price is required.

A fixed amount to be subtracted from a single AmountAfterTax nightly rate (or AmountBeforeTax nightly rate if AmountAfterTax isn't specified). It is assumed to be in the same currency as nightly rates. If this is larger than the sum of nightly rates, the resulting value is zero.

Примеры:

• If AmountBeforeTax for a single night is 90, AmountAfterTax is 100, and fixed_amount is 20, then

  promotion rate = AmountAfterTax - fixed discount

  80.00 = 100 - 20

• If AmountBeforeTax for a single night is 100, fixed_amount is 20, and TaxFeeInfo specifies a tax of 8%, then

  promotion rate = ( AmountBeforeTax - fixed discount) * (1 + percentage tax)

  86.40 = (100 - 20) * 1.08

Exactly one of percentage , fixed_amount , or fixed_price is required.

If AmountAfterTax nightly rates are specified, then this sets the price for the night of stay, including taxes and fees, to the specified value. If AmountBeforeTax is specified, then whether or not AmountAfterTax is specified, this sets the pre-tax price for the stay to the specified value. It is assumed to be in the same currency as nightly rates.

Примеры:

• If AmountBeforeTax for a single night is 90, AmountAfterTax is 100, and fixed_price is 80, then the promotion rate is 80.
• If AmountBeforeTax for a single night is 100, fixed_amount is 80, and TaxFeeInfo specifies a tax of 8%, then

  promotion rate = fixed price * (1 + percentage tax)

  86.40 = 80 * 1.08