Подключение к системе TravelLine WebPMS

В разделе описан порядок настройки интеграции TravelLine WebPMS с системой гостиничного телевидения TurnIP.
Синхронизируются гости, заезд и выезд, переселение.

Для использования интеграции отель должен иметь подписку в TravelLine уровня Standard или Premium.
С тарифами TravelLine можно ознакомится по ссылке https://www.travelline.ru/products/webpms/

Краткое описание принципа синхронизации

Синхронизация построена на двух API: Вебхуки и TravelLine Partner API.

• Вебхуки - при изменении брони, например при заезде гостя, сервер TravelLine создает событие в системе TurnIP. Это событие сразу обрабатывает TurnIP. Изменения в TurnIP происходят почти мгновенно.
• TravelLine Partner API - поскольку не на все события TravelLine создает WebHook, выполняется циклический опрос для синхронизации статусов гостей в TurnIP из WebPMS. Такие изменения происходят с задержкой. В частности, подселение гостя будет с задержкой. Такая задержка не превышает 10 минут. Важно отметить, что при такой циклической синхронизации опрашиваются только измененные брони с момента предыдущей синхронизации. Это является следствием того, что если изменить ранее синхронизированного гостя непосредственно в TurnIP, то при следующей синхронизации изменения по этому гостю загружены не будут до тех пор пока эти изменения не произойдут в брони WebPMS.
• Ведущей базой гостей следует считать WebPMS. Изменения по гостям в TurnIP не передаются обратно в WebPMS.
• Предусмотрен механизм полной принудительной синхронизации.

Настройка синхронизации

Настройка синхронизации с TL WebPMS производится в двух местах. В личном кабинете WebPMS и в TurnIP.
Сначала выполните настройку в WebPMS, а только потом в TurnIP.

Настройка в TravelLine WebPMS

В кабинете WebPMS перейдите в левом меню в раздел Настройки гостиницы > Подключения API.
Нажмите +Создать подключение

В каталоге доступных интеграций найдите интеграцию TurnIP и нажмите Подключить на кнопке карточки.

На следующем экране подтвердите, что вы готовы настроить синхронизацию, поставив флажок "Я подтверждаю, что у меня достигнуто соглашение об интеграции с TurnIP" и нажмите Продолжить.

На шагах 2 и 3 мастера ознакомьтесь с информацией о том какие API и вебхуки используются при интеграции

На шаге 4 мастера установите флажок "Я даю поручение на передачу TurnIP персональных данных гостей" и нажмите Продолжить.
Обращаем внимание, что TurnIP не хранит данных гостей после выезда, данные уничтожаются. Во избежании спорных моментов о персональных данных не рекомендуем выводить в приветственное сообщение фамилию гостя, а только имя, отчество. Например, Иван Иванович или Иван, но не Иванов Иван Иванович. Настройка вывода производится в TurnIP, см. далее.

На шаге 5 завершите настройку в TL WebPMS.

Перед переходом в настройку TurnIP запомните идентификатор вашего отеля в TL WebPMS, он вам пригодится в процессе настройки в TurnIP.
Увидеть этот идентификатор можно в левом верхнем углу кабинета TL WebPMS. Это пятизначное число.

Настройка в TurnIP

Перейдите в верхнем меню в раздел Настройки > Организация.

Выберете в списке гостиницу, к которой планируется подключить интеграцию с TL WebPMS, и нажмите Изменить  в этой же строке.

В открывшейся форме перейдите на закладку Сервисы.

В блоке TravelLine включите переключатель "Использовать сервис TravelLine" и обязательно укажите пятизначный идентификатор гостиницы, который вы запомнили ранее.

В подразделе "Приветствие гостя на экране ТВ" установите переключатели на полях, которые будут передаваться в TurnIP и в дальнейшем на экран ТВ. Мы рекомендуем использовать только Имя либо Имя и Отчество.

Выполните сохранение настроек .

При необходимости немедленной синхронизации гостей, еще раз зайдите в в настройки гостиницы, закладка Сервисы и нажмите кнопку "Синхронизировать проживающих с сервисом TravelLine". Обратите внимание, что сначала настройки должны быть сохранены, чтобы система знала, к какому отелю обращаться, только после этого можно запускать принудительную синхронизацию. При последующих открытиях настройки, сохранять их уже не требуется, можно сразу запускать принудительную синхронизацию при необходимости.
Принудительная синхронизация, в отличии от циклической синхронизации, описанной выше, выполняет синхронизацию всех активных броней в статусе Заезд в TL WebPMS.