Интеграция с программой лояльности TL Loyalty
Интеграция с программой лояльности TL Loyalty позволяет проверять данные о текущей скидке гостя и номере его карты лояльности, которые хранятся в системе TL Loyalty. Запрос на наличие скидки и карты выполняется автоматически при подстановке профиля гостя в Карточке заявки. Таким образом, для корректного использования интеграции важно запрашивать данные о скидке при создании бронирования вручную в Ecvi. Для канальных бронирований, которые передаются через менеджер каналов TravelLine, скидочные условия уже применяются автоматически на этапе самостоятельного бронирования гостем.
Интеграция также работает в обратном направлении: один раз в сутки запускается процедура расчета и отправки данных о количестве проведенных суток или сумме оказанных услуг (в зависимости от настроек) на бонусные счета гостей в системе TL Loyalty.
Настройка интеграции
Подготовительные работы и установка признаков применения скидки
Следующий важный этап — это настройка параметров для применения скидок. Эти настройки доступны в следующих разделах справочников системы (модуль Администрирование):
- Раздел "Отель" → "Группы ресурсов":
- Перейдите к редактированию группы ресурсов.
- Найдите поле "Не начислять статистику проживания".
- В зависимости от установленного параметра система будет отправлять статистику проживания гостей либо исходя из количества суток проживания, либо из суммы оказанных услуг.
Эта настройка позволяет управлять сегментами номерного фонда. Например, для долгосрочной аренды можно отключить расчет и отправку статистики в систему лояльности TL Loyalty (данные отправляются один раз в сутки по выехавшим гостям). - Раздел "Услуги" → "Список услуг", "Список пакетов услуг", "Список тарифов":
- При редактировании записей в этих справочниках найдите поле "Применять скидки".
- Это поле позволяет регулировать возможность применения скидок для соответствующих услуг, пакетов или тарифов.
Для тарифов с включенными услугами, которые могут автоматически подставляться в бронировании, настройка "Применять скидки" в тарифе является главной. Если для такого сложного, составного тарифа эта настройка не активирована, то скидка не будет применяться ни для самого тарифа, ни для всех связанных с ним услуг.
Тем не менее, если гость воспользуется дополнительными услугами или пакетами, которые не входят в состав тарифа, то скидка будет применена только при наличии соответствующей настройки для таких услуг или пакетов ("Применять скидки").
Активация интеграции
Для включения интеграции следует направить запрос на электронную почту support@ecvi.ru со следующей информацией:
1. Наименование средства размещения;
2. API-key (запрашивается у поддержки TL)
3. CompaingID (запрашивается у поддержки TL)
4. Отметить желаемый принцип учета по гостям для обновления статистики проживания гостя по его карте обратно в систему TL Loyalty - по суткам или по сумме услуг
Описание принципа работы
На этапе ввода данных о госте через ранее созданный профайл - Ecvi в автоматическом режиме отправляет запрос в TL Loyalty на предмет соответствия введенного номера телефона:
Исходя из этого возможны два варианта развития событий:
- По указанному в профайле номеру телефона найдено соответствие и в этом случае система проинформирует пользователя диалоговым окном с вопросом о применении скидки:
- По указанному телефону сопоставлений не найдено и в этом случае система выведет уведомление в правом верхнем углу:
Это означает, что в системе TL Loyalty нет гостя с таким номером телефона.
Так же при активации интерфейса интеграции в Карточке заявки появится новая кнопка
, с помощью которой пользователи могут в ручном режиме осуществлять запуск процедуры проверки установленного профайла гостя с номером телефона в системе TL Loyalty.
При каждом запросе проверяется значение скидки и обновляется в профайле гостя, при этом сохраняется и номер карты лояльности гостя в TL Loyalty:
Установленная скидка может быть применена как к одному периоду заявки, так и при наличии в заявке нескольких периодов с бронированием более одного номера система выведет диалоговое окно с вопросом применения скидки ко всем периодам в заявке:
При выборе пункта "Нет" скидка применится только к первому периоду.
Ограничения применения скидки
Для применения скидки могут быть ограничения (учитывая, в том числе, что пользователь может
запустить операцию смены гостя по заявке в любой момент):
- Не применять скидку для периодов проживания, по которым уже выполнено начисление услуг
проживания; - Не применять скидку для периода проживания, если в используемом тарифе не установлен флаг "Применять скидки"
- Не применять скидку для периода проживания, в котором ранее уже была назначена какая-либо скидка.
Выгрузка статистики по гостям-держателям карты лояльности
Для предоставления гибкости при выгрузке данных из Ecvi в TL:Loyalty в настройках системы возможно использовать следующие режимы выгрузки
Таким образом, у пользователя появляется возможность и устанавливать правила выгрузки данных:
- только проживание (ночи+сумма услуг "Проживание");
- только услуги (сумма дополнительных услуг группы "Питание", "Общие");
- и проживание и услуги (установка двух галок одновременно).
Пример:
Начисления по тарифу с ценой за сутки 4845.00р., итого за 4 суток = 19040,00р.
Начисленная дополнительная услуга на сумму 40000.00:
При срабатывании операции по выгрузке статистических данных в TL будут переданы данные в следующем формате:
Особенности выгрузки данных в TL:Loyalty
Обратите внимание на следующие условия, которые влияют на выгрузку данных о бронированиях и услугах в систему лояльности.
1. Учитываются только данные с главного счета:
- В выгрузку попадают услуги, начисленные на главный счет бронирования, где учитываются основные услуги по тарифу.
- Если в бронировании несколько гостей, дополнительные услуги, начисленные на их индивидуальные счета, в TL:Loyalty не передаются.
2. Приоритет компании-плательщика над гостем с картой лояльности
- Если в бронировании указан гость с картой лояльности, но при этом назначена компания-плательщик, данные по услугам для этого гостя выгружены не будут.
- Причина: система предполагает, что проживание оплачивает компания безналичным расчетом, а не личные средства гостя.
- Следствие: В TL:Loyalty не будут переданы данные о количестве ночей, стоимости проживания и дополнительных услуг.
3. Бронирование с несколькими номерами (периодами проживания)
- Если в бронировании несколько номеров и главным гостем указан держатель карты TL:Loyalty, он считается плательщиком за весь заказ.
- В этом случае сумма начисленных услуг со всех номеров будет учтена для этого гостя в программе лояльности.
- Важно: Количество ночей будет выгружено отдельно для каждого периода проживания, в котором участвует этот гость.
4. Несколько гостей с картами лояльности в одном бронировании
- Если в одном бронировании несколько гостей с персональными картами TL:Loyalty, данные выгружаются только для главного гостя, указанного в карточке бронирования.
- Решение: Чтобы статистика учитывалась для каждого гостя с картой, необходимо для каждого из них создать отдельное бронирование, где они будут указаны как главные гости.
5. Учет данных при продлении проживания
- Если проживание было продлено (добавлен новый период), статистика будет выгружена в TL:Loyality после наступления даты выезда из добавленного периода.








