- Как работает интеграция
- Перед настройкой: создайте подключение к API TL: WebPMS
- Как настроить интеграцию
- Как синхронизируются данные
Интеграция TravelLine с UDS позволяет гостям использовать накопленные баллы для частичной оплаты проживания при бронировании на сайте средства размещения.
После настройки интеграции гости смогут:
- авторизоваться в программе лояльности при бронировании;
- просматривать баланс баллов;
- оплачивать баллами часть стоимости бронирования;
- получать доступ к закрытым тарифам по уровню лояльности, если они настроены.
Обратите внимание. Интеграция с UDS:
- доступна только при работе в TL: WebPMS,
- поддерживает только балльный тип программы лояльности.
Как работает интеграция
1. Гость выбирает проживание на сайте средства размещения.
2. Авторизуется или регистрируется в личном кабинете гостя по номеру телефона, который указан в UDS.
3. TravelLine находит карту лояльности и показывает актуальный баланс баллов.
4. На этапе оплаты гость подтверждает списание баллов в пределах доступного процента.
5. После успешного оформления бронирования баллы списываются в UDS.
6. После выезда гостя TravelLine передает в UDS данные о проживании, и UDS начисляет баллы за проживание.
Примечание. Начисление баллов после выезда гостя работает только при настроенном подключении к API TL: WebPMS.
7. При отмене бронирования UDS возвращает списанные баллы гостю.
Перед настройкой: создайте подключение к API TL: WebPMS
1. В личном кабинете TravelLine перейдите в раздел «Настройки гостиницы» → «Подключения API» → «Создать подключение».
2. Выберите тип «Свое подключение» и нажмите «Создать».
3. Задайте название подключения, например «UDS».
4. На вкладке «Публичные API» включите:
- Read Reservation API,
- Content API,
- PMS API.
5. Сохраните изменения. Ключ и токен доступа сгенерируются автоматически в полях: client_id и client_secret.
6. Скопируйте ключ и токен и передайте специалистам поддержки UDS по защищенным каналам связи: по ним UDS будет получать данные о проживании и начислять баллы.
Как настроить интеграцию
Шаг 1. Подключите UDS
1. В личном кабинете TravelLine перейдите в раздел «Управление гостями» → «Программа лояльности».
2. В блоке «UDS» нажмите «Подключить» или «Редактировать».
Если блок «UDS» не отображается в разделе «Программа лояльности», обратитесь в техническую поддержку TravelLine по адресу support@travelline.ru.
Откроется страница «Настройки подключения UDS».
3. Заполните параметры подключения:
- API URL (адресная строка для взаимодействия систем) — адрес API UDS.
- API token — ключ доступа для подключения к API UDS.
4. Сохраните параметры подключения.
5. «Точка продаж» — выберите точку продаж, настроенную в UDS.
Примечание. В поле «Тип программы лояльности» по умолчанию выбран вариант «Баллы».
Шаг 2. Настройте списание баллов и уровни лояльности
1. В блоке «Уровни лояльности» выберите, как ограничить часть стоимости бронирования, которую гость может оплатить баллами:
- «Одинаковый для всех уровней» — укажите единое значение в поле «Какой процент можно оплатить баллами?»;
Примечание. В поле процента можно указать целое число от 0 до 99. - «Разный для каждого уровня» — укажите отдельное значение при настройке каждого уровня.
2. Нажмите «Добавить уровень».
3. Укажите название уровня, которое будет отображаться в TravelLine.
4. Выберите соответствующий код уровня лояльности в UDS.
5. Если для уровней используются разные ограничения, укажите процент, который гость сможет оплатить баллами на этом уровне.
6. Таким же способом добавьте остальные уровни.
Шаг 3. При необходимости настройте закрытые тарифы
1. Включите параметр «Настраивать закрытые тарифы в зависимости от уровня лояльности».
2. Перейдите в раздел «Управление номерами» → «Тарифы» и укажите, для каких уровней лояльности доступен каждый закрытый тариф.
Шаг 4. Активируйте интеграцию
1. Убедитесь, что подключение к API TL: WebPMS создано и его ключ и токен переданы поддержке UDS.
2. Скопируйте автоматически сформированный вебхук (инструмент передачи данных между разными системами) из поля «Webhook url».
3. Запросите токен для вебхука у техподдержки TravelLine по адресу support@travelline.ru.
4. Передайте Webhook url и токен техподдержке UDS, чтобы настроить передачу изменений по картам лояльности в TravelLine.
5. Включите переключатель активации программы лояльности в верхней части страницы.
6. Сохраните изменения.
Как синхронизируются данные
- Полная синхронизация карт выполняется при активации интеграции и при изменении сопоставления уровней в активной интеграции.
- Изменения данных карты и баланса передаются из UDS в TravelLine при настроенном вебхуке.
- Данные о проживании и выезде гостя передаются в UDS через API TL: WebPMS: на их основе UDS начисляет баллы.