Акции

Если у вас есть серверная часть, которая предоставляет каналы для нескольких учетных записей, это значение должно соответствовать значению атрибута 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 , 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 , 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 , 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 , 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 , 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 UserCountries не установлен, он рассматривается как include , и акция применяется к пользователям из перечисленных стран.

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

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

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

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