Онлайн-бронирование TravelLine (КУС) — различия между версиями

Материал из КинтВики
Перейти к: навигация, поиск
(Закладка Настройка синхронизации)
 
(не показано 127 промежуточных версий этого же участника)
Строка 1: Строка 1:
 +
{{video|[https://youtu.be/1ELgdJ-6-wA Интеграция с TravelLine]}}
 +
{{video2|[https://rutube.ru/video/bb5a8b6510a5a8f7832f20e6e9bcdb2b/ Интеграция с TravelLine]}}
 
<noinclude>[[Категория:Онлайн-бронирование (КУС)]]</noinclude>
 
<noinclude>[[Категория:Онлайн-бронирование (КУС)]]</noinclude>
 
{| align="right"
 
{| align="right"
 
| __TOC__
 
| __TOC__
 
|}
 
|}
Настройки для онлайн-бронирования номеров с помощью сервиса [https://www.travelline.ru/ Travelline] открываются из раздела БРОНИРОВАНИЕ — '''Онлайн-бронирование''' — '''Настройка интеграции Travelline'''.
+
Интеграция c сервисом онлайн-бронирования [https://www.travelline.ru/ Travelline] позволяет получать новые брони и управлять доступностью номерного фонда и ценами на платформе Travelline.
  
== Настройка ==
+
Настройки для онлайн-бронирования номеров с помощью сервиса Travelline выполняются в разделе БРОНИРОВАНИЕ — '''Онлайн-бронирование''' — '''Настройка интеграции Travelline'''.
=== Закладка Служебная ===
 
  
Содержит настройки подключения к сервису TravelLine.
+
== Настройка подключения==
  
: [[Файл:Travelline Параметры.png]]
+
Для настройки подключения к сервису TravelLine перейдите на закладку '''Служебная'''.
 +
: [[Файл:Travelline Параметры.png|600px]]
  
 
# Включите настройку «Интеграция активна».
 
# Включите настройку «Интеграция активна».
Строка 17: Строка 19:
 
#:* '''Логин:''' ХХХХ
 
#:* '''Логин:''' ХХХХ
 
#:* '''Пароль:''' пароль
 
#:* '''Пароль:''' пароль
#:* '''Код отеля:''' ХХХХ
+
#:* '''Код гостиницы:''' ХХХХ
 
# Нажмите кнопку '''''Сохранить настройки''''' вверху окна.
 
# Нажмите кнопку '''''Сохранить настройки''''' вверху окна.
 
# Проверьте соединение, нажав кнопку '''''Проверить подключение'''''.
 
# Проверьте соединение, нажав кнопку '''''Проверить подключение'''''.
 
# Выполните настройки получения данных бронирования:
 
# Выполните настройки получения данных бронирования:
 
#:* Укажите вариант учета периода: ''по ночам'' или ''по дням'';
 
#:* Укажите вариант учета периода: ''по ночам'' или ''по дням'';
#:* Включите опцию «Использовать заявки на бронь», если требуется, чтобы при получении данных от сервиса создавались документы «Заявка на бронь»;
 
 
#:* Включите опцию «Выполнять автоматический запрос данных каждые 5 минут», для того чтобы программа автоматически делала запросы на получение новых броней.
 
#:* Включите опцию «Выполнять автоматический запрос данных каждые 5 минут», для того чтобы программа автоматически делала запросы на получение новых броней.
# Выполните настройки интеграции с программой «TL Loyality: Баллы», если требуется объединить программу лояльности, используемую в «Кинт: Управление санаторием», с программой, используемой на платформе TravelLine. Подробная информации о настройке интеграции с программой «TL Loyality: Баллы» — в разделе Программа «TL Loyality».  
+
# Выполните настройки интеграции с программой «TL Loyality: Баллы», если требуется объединить программу лояльности, используемую в «Кинт: Управление санаторием», с программой, используемой на платформе TravelLine. Подробная информации о настройке интеграции с программой «TL Loyality: Баллы» — в разделе [[Онлайн-бронирование TravelLine (КУС)#Настройка интеграции с программой TL Loyalty|Настройка интеграции с программой TL Loyalty]].
  
 
'''Рабочий кабинет TravelLine''' — ссылка позволяет перейти в [https://www.travelline.ru/secure/Enter.aspx?ReturnUrl=%2fsecure%2f Личный кабинет] пользователя на сервисе [https://www.travelline.ru/ TravelLine].
 
'''Рабочий кабинет TravelLine''' — ссылка позволяет перейти в [https://www.travelline.ru/secure/Enter.aspx?ReturnUrl=%2fsecure%2f Личный кабинет] пользователя на сервисе [https://www.travelline.ru/ TravelLine].
  
В разделе «Протокол» отображается протокол обмена сообщениями с сервисом. В поле «Файл протокола» укажите путь к текстовому файлу протокола.
+
В разделе «Протокол» отображается протокол обмена сообщениями с сервисом. В поле «Файл протокола» укажите путь к текстовому файлу протокола.
  
<!-- # Введите данные полученные от менеджера TravelLine.
+
== Необходимая подготовка ==
#: '''Адрес сервиса:''' www.travelline.ru
 
#: '''Логин:''' TLConnect.ХХХХ
 
#: '''Пароль:''' пароль
 
#: '''Код отеля:''' ХХХХ
 
# Нажмите кнопку вверху окна '''''Сохранить настройки'''''.
 
# Проверьте соединение, нажав кнопку '''''Проверить подключение''''' (ниже введенных данных).
 
  
: [[Файл:Travelline Параметры.png]]
+
Для того чтобы синхронизация и обмен данными между программой и сервисом TravelLine были возможны, должны быть настроены ключевые элементы.
  
'''Рабочий кабинет TravelLine'''
+
В личном кабинете «TravelLine» должны быть добавлены:
: [https://www.travelline.ru/secure/Enter.aspx?ReturnUrl=%2fsecure%2f Личный кабинет] пользователя на сервисе [https://www.travelline.ru/ TravelLine].
+
# Категории номеров. При создании укажите в них:
 +
#* Тип предложения (номер или место в номере; чтобы определить, продается ли номер целиком или по отдельным местам).
 +
#* Количество основных мест и варианты размещения при типе предложения «Номер» (чтобы определить, для какого количества гостей номер доступен при бронировании).
 +
#* Доп. места и условия размещения детей — при необходимости.
 +
#: [[Файл:ЛК Travelline Категории номеров.png|600px]]
 +
# Тарифы.
 +
#: [[Файл:ЛК Travelline Тарифы.png|600px]]
 +
# Возрастные группы детей (при необходимости).
 +
#: [[Файл:ЛК Travelline Возрастные группы.png|600px]]
  
'''Использовать заявки на бронь'''
+
В программе «Кинт: Управление санаторием» должны быть созданы и корректно заполнены:
: При получении данных онлайн-бронирования будут создаваться документы [[Документ "Заявка" (КУС)|«Заявка на бронь»]].-->
+
* категории номеров;
 +
* номерной фонд;
 +
* варианты проживания;
 +
* варианты лечения и варианты питания;
 +
* возрастные группы (если требуется выделять возрастные группы детей);
 +
* категории путевок;
 +
* номенклатура пребывания;
 +
* документы установки цен по типам:
 +
** цена проживания;
 +
** цена лечения;
 +
** цена питания.
 +
* квота для Travelline (с документами установки квоты).  
  
=== Закладка Настройка синхронизации ===
+
'''Обратите внимание:'''
<!-- На этой закладке указывается соответствие категорий номеров в КУС и ЛК TravelLine.
 
# Предварительно в личном кабинете сервиса нужно создать необходимые категории номеров и тариф (тарифы, если цены для разных условий проживания и категорий отличаются).
 
# Закончив  работу в ЛК, вернитесь на закладку '''Настройка синхронизации''' и нажмите кнопку '''''Обновить категории номеров и тарифы'''''. Таблицы на закладке должны заполниться данными.-->
 
На закладке устанавливается соответствие категорий номеров, тарифов и каналов продаж, созданных в «Кинт: Управление санаторием», аналогичным объектам в ЛК «TravelLine».
 
: [[Файл:Travelline Настройка синхронизации.png]]
 
  
# Предварительно в «Кинт: Управление санаторием» должны быть подготовлены категории номеров, варианты проживания, номерной фонд, категории путевок, номенклатура пребывания, возрастные группы (если требуется выделять возрастные группы детей) и тарифы.
+
* При настройке номенклатуры пребывания:
# В личном кабинете «TravelLine» необходимо:
+
# В карточке номенклатуры заполните ключевые атрибуты (категорию путевки, вариант питания, вариант лечения или другие), от которых будет зависеть расчет цены номенклатуры пребывания (стоимости пребывания) по документам «Установка цен».
## добавить категории номеров
+
#: [[Файл:Travelline Номенклатура пребывани атрибуты.png|900px]]
##: [[Файл:ЛК Travelline Категории номеров.png]]
+
# Сверьте эти атрибуты с аналитикой, которая содержится в документах установки цен разных типов. В частности, параметры «Категория путевки», «Категория номера» и «Вариант проживания» должны присутствовать как в аналитике типа цены «Цена проживания», так и в перечне ключевых атрибутов номенклатуры пребывания.
## создать тарифы
+
#: [[Файл:Travelline Тип цены (проживание) Аналитика.png|500px]]
##: [[Файл:ЛК Travelline Тарифы.png]]
+
# При необходимости откройте из карточки номенклатуры пребывания карточку категории номенклатуры и активируйте в ней недостающий атрибут.
## при необходимости указать возрастные группы детей
+
#:[[Файл:Travelline Категория Номенклатура пребывания Атрибуты.png|500px]]  
##: [[Файл:ЛК Travelline Возрастные группы.png]]
 
  
==== Категории номеров ====
+
* В документах «Установка цен», участвующих в расчете стоимости пребывания, прайс должен быть либо одинаковым, либо отсутствовать. При несоблюдении этого условия стоимость пребывания может рассчитаться некорректно.
В левом столбце указываются категории номеров КУС, им соответствует колонка «TravelLine. Имя». Щелкните в свободное поле и выберите нужную категорию из справочника «Категории номеров».
 
  
{{notice|TravelLine не предоставляет полноценной информации о размещении в номере. Поэтому настройки надо дублировать в КУС.
+
* При создании квоты для TravelLine в документе «Квота» необходимо установить галочку «По категориям номеров» и выбрать в поле «Онлайн-квота» значение «TravelLine».
Наименования категорий в КУС и личном кабинете TravelLine могут не совпадать. Если категории «Люкс» из справочника ЛК TravelLine соответствует категория «Стандарт» из справочника КУС, новая бронь на номер «Люкс» из TravelLine придет в базу КУС как бронь номера «Стандарт».}}
+
:[[Файл:Travelline КУС Документ Квота заполнение .png|700px]]
Travelline не предоставляет полноценной информации о размещении в номере. Поэтому настройки надо дублировать в КУС.
 
* Если в Travelline в категории номера установлен тип размещения "Место в номере"
 
[[Файл:Travelline тип место.png]]
 
* В КУС нужно установить флаг "По местам". Если этот флаг стоит, то флаги из группы "Размещение в номере при продаже номера целиком" не используются при выгрузке цен.
 
* Если в TravelLine стоит тип предложения "Номер".
 
[[Файл:Travelline тип номер.png]]
 
*В КУС флаг "По местам" устанавливать не надо. [[Файл:Travelline КУС тип номер.png]]
 
  
* Если тип предложения "Номер", то в Travelline флагами устанавливаются типы размещений.
+
== Настройка синхронизации ==
[[Файл:Travelline КУС типы размещений.png]]
+
Перейдите на закладку '''Настройка синхронизации''', чтобы сопоставить объекты, настроенные в личном кабинете TravelLine, с соответствующими объектами, созданными в «Кинт: Управление санаторием».
* Чтобы корректно посчитались цены, настройка флагов видов размещений группы "Размещение в номере при продаже номера целиком" должна повторять Travelline.
 
[[Файл:Travelline типы размещений.png]]
 
* Если в Travelline включены доп. места.
 
[[Файл:Travelline допместа.png]]
 
* Надо заполнить эту же колонку в КУС ("Варианты размещения" ни на что не влияют, нужно указать только количество доп мест)[[Файл:Travelline КУС допместа.png]]
 
* Возрастные группы детей берутся из настройки Travelline.
 
[[Файл:Travelline возр группы.png]]
 
* В КУС выполняется поиск возрастной группы по полю "Мин возраст".
 
[[Файл:Travelline КУС установка возр группы.png]]
 
* Колонка "Возраст (с)" настраивается с помощью документа [[%D0%94%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82_%22%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0_%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B9_%D1%81%D0%B2%D0%BE%D0%B9%D1%81%D1%82%D0%B2%22_(%D0%9A%D0%A3%D0%A1)#.D0.92.D0.BE.D0.B7.D1.80.D0.B0.D1.81.D1.82.D0.BD.D0.B0.D1.8F_.D0.B3.D1.80.D1.83.D0.BF.D0.BF.D0.B0|"Установка значений свойств" для свойства возрастная группа]].
 
[[Файл:Travelline КУС возр группы.png]]
 
  
==== Тарифы ====
+
Синхронизируются:
Тарифы онлайн бронирования настраиваются похожим образом как категории номеров.
+
* категории номеров;
 +
* тарифы (номенклатура пребывания);
 +
* каналы продаж (при наличии).
 +
: [[Файл:Travelline Настройка синхронизации.png|800px]]
  
Для каждого тарифа TravelLine следует создать свою номенклатуру пребывания. Ее нужно будет указать в левой колонке. Номенклатура пребывания определяет, как по тарифу TravelLine будет собираться цена проживания.
+
=== Категории номеров ===
 +
В разделе установите соответствие категорий номеров.
  
# Задайте цену проживания, учитывая все параметры пребывания, которые влияют на ценообразование. Для этого создайте новый документ [[Документ "Установка цен, надбавок, скидок" (КУС)|«Установка цен»]] с типом цены «Цена проживания». Тип цены проживания должен быть настроен так и нести в себе такую аналитику, по которой бы собиралась цена, так, как вам это требуется. Можно, например, указать «Категорию путевки», «Категорию номера» и «Вариант проживания». Для каждой комбинации этих параметров задайте свою цену. Если значение какого-то из параметров оставить пустым, это означает любое значение. Например, в строке заполнена только категория номера, допустим «Стандарт», установлена цена 1000 рублей — это означает, что бронь с любой категорией путевки и вариантом проживания в номере будет стоить 1000 рублей.
+
# Нажмите кнопу '''''Обновить''''' для загрузки данных из сервиса TravelLine.
# Создав и проведя документ установки цен вернитесь к настройке номенклатуры пребывания для тарифов TravelLine на закладку '''Настройка синхронизации''' в раздел «Тарифы». Каждому тарифу TravelLine нужно создать свою номенклатуру пребывания. Затем обратите внимание, что в [[Справочник "Номенклатура" (КУС) — Номенклатура пребывания#Карточка номенклатуры пребывания|карточке номенклатуры пребывания]] установлена категория «Номенклатура пребывания». Откройте карточку категории. Отметьте галочками атрибуты, значения которых совпадают с таковыми в типе цены «Цена проживания».
+
# В табличной части отобразятся загруженные категории номеров TravelLine — заполнятся колонки «Имя», «Код API» и «Мест» (для категорий с типом предложения «Место в номере» в колонке «Мест» передается значение 0).  
#: То есть, если в типе цены выбраны категория путевки, категория номера, вариант проживания, то у категории номенклатуры «Номенклатура пребывания» должны быть выбраны такие же атрибуты.
+
#:[[Файл:Travelline Соответствие категорий номеров.png|900px]]
# Сохраните изменения и снова откройте карточку номенклатуры пребывания. Укажите в атрибутах соответствующие значения, чтобы цена по тарифу собиралась по правильной комбинации из документа «Установка цен».
+
# В колонке «Категория номера» укажите соответствующие категории номеров, созданные в «Кинт: Управление санаторием».
 +
# Нажмите кнопку '''''Сохранить настройки''''', а затем '''''Обновить'''''.
 +
#: [[Файл:Travelline Соответствие категорий номеров установлено.png|900px]]
 +
# Проверьте и дозаполните параметры размещения в «Кинт: Управление санаторием» в соответствии с настройками в ЛК TravelLine: 
 +
#* Если в TravelLine в категории номера установлен тип предложения «Место в номере»,
 +
#*:[[Файл:Travelline тип место.png|450px]]
 +
#*: 1. В программе должен быть активирован флаг «По местам».
 +
#*: 2. Не требуется указывать варианты размещения в номере при продаже номера целиком.
 +
#*:[[Файл:Travelline 2м Стандарт.png|900px]]
 +
#* Если в TravelLine в категории номера установлен тип предложения «Номер»,
 +
#*:[[Файл:Travelline тип номер.png|450px]]
 +
#*: 1. В программе флаг «По местам» не должен быть активирован.
 +
#*: 2. Требуется отметить те же варианты размещения в номере, которые были заданы для категории номера в ЛК TravelLine.  
 +
#*: [[Файл:Travelline 3м Люкс.png|900px]]
 +
#* Если в TravelLine в категории номера указаны доп. места (помимо мест, предусмотренных вариантом размещения),
 +
#*:[[Файл:Travelline допместа.png|450px]]
 +
#*: в программе требуется заполнить значение в колонке «Доп. мест».
 +
#*:[[Файл:Travelline 2м Люкс допместо.png|900px]]
 +
#* Если в TravelLine в категории номера указана возможность размещения детей,
 +
#*:[[Файл:Travelline возр группы.png|450px]]
 +
#*: в программе выполнится поиск соответствующей возрастной группы по полю «Мин возраст».  
 +
#*:[[Файл:Travelline Возрастная группа в КУС.png|900px]]
 +
# Сохраните настройки.
 +
{{notice|Важно: TravelLine не позволяет создавать брони на конкретные номера (помещения). Бронирование осуществляется в категорию номеров. Наименования категорий в «Кинт: Управление санаторием» и TravelLine могут не совпадать. Если категория «Люкс» в TravelLine сопоставлена с категорией «Стандарт» в «Кинт: Управление санаторием», бронь из TravelLine будет передана как бронь категории «Стандарт».}}
  
=== Закладка Квота мест и цены ===
+
=== Тарифы ===
: [[Файл:Travelline Квота мест и цены.png]]
+
В разделе установите соответствие тарифов TravelLine номенклатуре пребывания, созданной в «Кинт: Управление санаторием».  
  
==== Цены ====
+
# Нажмите кнопку '''''Обновить''''', чтобы загрузить тарифы, созданные в TravelLine.
Если номенклатура настроена правильно, таблица на закладке '''Цены''' заполнится подходящими значениями, собранными по документам установки цен с типом «Цена проживания». Здесь же можно сделать отбор по периоду выгрузки. По умолчанию отбор = «Этот год».
+
# Данные по тарифам отобразятся в колонках «TravelLine»: «Имя» и «Код API».
 +
# В колонке «Номенклатура пребывания» заполните номенклатуру пребывания в соответствии с тарифами.
 +
#: [[Файл:Travelline КУС Соответствие тарифов.png|900px]]
 +
# Нажмите кнопку '''''Сохранить настройки'''''.
 +
#:[[Файл:Travelline Сохранить настройки синхронизации тарифов.png|900px]]
 +
 
 +
Допустимо сопоставлять одну номенклатуру пребывания с несколькими тарифами TravelLine, если тарифы являются однотипными и различаются только каналом продаж.
 +
 
 +
=== Каналы продаж ===
 +
Используйте раздел при наличии в TravelLine каналов продаж. 
 +
: [[Файл:Travelline КУС Соответствие каналов продаж.png|900px]]
 +
# Нажмите кнопку '''''Обновить''''', чтобы загрузить каналы бронирования (продаж) из сервиса TravelLine.  
 +
# Данные отобразятся в колонках «TravelLine»: «Имя» и «Код API».
 +
# В колонке «Каналы продаж» выберите аналогичные каналы продаж, созданные в «Кинт: Управление санаторием»
 +
# Нажмите кнопку '''''Сохранить настройки'''''.
  
Отметьте галочками те цены, которые необходимо выгрузить в личный кабинет TravelLine и нажмите '''''Выгрузить цены'''''.
+
== Выгрузка данных по квотам и ценам ==
 +
Используйте закладку '''Квота мест и цены''' для формирования данных по доступным местам и ценам, а также выгрузки данных в TravelLine.  
  
 
==== Квоты ====
 
==== Квоты ====
Здесь отображаются документы установки квот по номерам со значением параметра «Онлайн квота» = TravelLine.
+
:[[Файл:Travelline КУС Квоты.png|900px]]
 +
Для заполнения данных по доступным местам в категориях номеров по установленной квоте TravelLine и выгрузки их в TravelLine:
 +
# Установите период формирования данных.
 +
# Укажите категории номеров.
 +
# В поле «Тарифы» выберите номенклатуру пребывания.
 +
# В поле «Квота» выберите квоту, созданную для TravelLine.
 +
# Нажмите кнопку [[Файл:Кнопка синх.png]] — таблица заполнится данными по доступным местам в номерах по созданным документам установки квоты.
 +
#:[[Файл:Travelline КУС Квоты выгрузить.png|900px]]
 +
# Отметьте галочками квоты, которые необходимо выгрузить в личный кабинет TravelLine, и нажмите '''''Выгрузить квоту'''''.
 +
# Откройте личный кабинет TravelLine и проконтролируйте правильность выгруженных данных.
  
Для выгрузки квоты номеров в ЛК TravelLine создайте новый документ установки квот:
+
Расчет доступных мест выполняется на основании документов «Установка квоты» с учетом фактической занятости номеров.
# Добавьте новый период квотирования — даты и время начала и окончания квоты, время выбирается из доступных интервалов расчетных часов (заполняется обязательно).
+
==== Цены ====
# Укажите категорию номера. Укажите количество номеров категории для квотирования.
+
:[[Файл:Travelline КУС Цены до заполн.png|900px]]
# Нажмите кнопку '''''Заполнить''''' — подберутся доступные для квоты номера по введенным параметрам.
+
Для заполнения цен и их последующей выгрузки в TravelLine:  
# Установите «Онлайн квота» = TravelLine. Проведите и закройте документ.
+
# В поле «Период» выберите период выгрузки. По умолчанию отбор = «Этот год».
 
+
# Укажите категории номеров, для которых требуется рассчитать цены.
На закладке '''Установка квоты''' нажмите кнопку '''''Обновить'''''. Если документ сформирован правильно, он отобразится в таблице для той категории номеров, которая указана в квоте. Для выгрузки квот в ЛК TravelLine жмите кнопку '''''Выгрузить квоту'''''.
+
# В поле «Тарифы» укажите номенклатуру пребывания, по которой необходимо рассчитать цены.
 +
# Выберите вариант заполнения «По ценообразованию», чтобы запустить расчет цен по документам установки цен.
 +
# Нажмите кнопку [[Файл:Кнопка синх.png]] — таблица на закладке заполнится тарифами (если номенклатура настроена корректно).
 +
# Отметьте галочками цены, которые необходимо выгрузить в личный кабинет TravelLine, и нажмите '''''Выгрузить цены'''''.
 +
:[[Файл:Travelline КУС Цены выгруз.png|900px]]
 +
При выборе варианта заполнения «По настройке» появляется дополнительный раздел — '''Настройка цен'''.
 +
# Заполните тарифы в ручном режиме:
 +
#* Нажмите кнопку '''''Добавить''''' и заполните поля табличной части.
 +
#* Или нажмите кнопку '''''Заполнить по ценообразованию''''', отредактируйте табличную часть и нажмите кнопку '''''Записать'''''.
 +
#*:[[Файл:Travelline КУС Настройка цен.png|800px]]
 +
# Вернитесь в раздел '''Цены''',  выберите вариант заполнения «По настройке» и нажмите кнопку [[Файл:Кнопка синх.png]], чтобы отобразился список тарифов, подготовленных через настройку цен.
  
Откройте личный кабинет TravelLine, и проконтролируйте правильность выгруженных данных.
+
== Получение новых броней из TravelLine ==
  
=== Закладка Протокол ===
+
Новые брони можно загружать двумя способами:
: [[Файл:Travelline Протокол.png]]
+
# В ручном режиме — нажмите на кнопку '''''Получить новые брони'''''.
 +
# В автоматическом режиме — для этого на закладке '''Служебная''' включите опцию «Выполнять автоматический запрос данных каждые 5 минут».
 +
Чтобы автоматический режим работал корректно, откройте в программе раздел АДМИНИСТРИРОВАНИЕ — '''Сервис''' — '''Консоль заданий''' и убедитесь, что в задании «Получать данные TravelLine» указан пользователь, под которым выполняется фоновое задание.
  
== Работа с путевками ==
+
Загруженные заявки на бронь отображаются в журнале заявок и в интерфейсе «Администратор гостиницы» на закладке '''Прибывающие'''. Вид заявки — TravelLine.
Путевки, созданные на основании данных, полученных от сервиса TravelLine, выделяются иконкой [[Файл:ИконкаОнлайнБронирование.png]]. В шахматке гостиницы иконка выводится в левой части занятого интервала, в документе «Путевка» — в правой верхней части формы.
 
  
Можно настроить серии создаваемых путевок в справочнике [[Справочник "Серии документов" (КУС)|«Серии документов»]] в разделе АДМИНИСТРИРОВАНИЕ.
+
== Настройка интеграции с программой TL Loyalty ==
  
В журнале «Путевки» можно выбрать документы, созданные через сервис онлайн-бронирования, по переменной «Онлайн-бронирование».
+
Настройки интеграции с программой «TL Loyalty: Баллы», позволяющей объединить программу лояльности, используемую в «Кинт: Управление санаторием», с программой, используемой на платформе TravelLine, находятся на закладке '''Служебная''' в разделе «Программа TL Loyalty».
 +
: [[Файл:Адм. системы Инт серв Travelline Служ 3.png]]
 +
После активации интеграции свяжитесь со службой поддержки Travelline. Выдача карт лояльности в личном кабинете TravelLine будет заблокирована, текущий список карт лояльности можно загрузить из файла, предоставляемого службой поддержки.
  
== Настройка автоматического получения новых броней ==
+
Заполнение номера телефона в картах лояльности станет обязательным.<br>
# На закладке '''Параметры подключения''' включите опцию «Выполнять автоматический запрос данных каждые 5 минут».
+
Выдача карт и начисления бонусных баллов будет выполняться только в «Кинт: Управление Санаторием», оплата бонусными баллами будет доступна как в TravelLine, так и в «Кинт: Управление Санаторием».
# В разделе АДМИНИСТРИРОВАНИЕ в окне '''Консоль заданий''' откройте задание «Получать данные TravelLine» и убедитесь, что указан пользователь, под которым нужно выполнять это задание в фоне. Иначе укажите его, например, Администратор.
+
Баланс бонусных баллов карт будет синхронизироваться автоматически.
  
== Рабочий кабинет TravelLine ==
+
<!--== Рабочий кабинет TravelLine ==
 
Доступен по ссылке '''Рабочий кабинет TravelLine''' на закладке '''Параметры подключения'''.
 
Доступен по ссылке '''Рабочий кабинет TravelLine''' на закладке '''Параметры подключения'''.
  
Строка 146: Строка 199:
 
быть построен по-другому.
 
быть построен по-другому.
  
Подробнее о форме бронирования для санаториев вы можете прочитать на [http://blog.travelline.ru/tl/novye-vozmozhnosti-formy-bronirovaniya-dlya-sanatoriev/ странице].}}
+
Подробнее о форме бронирования для санаториев вы можете прочитать на [http://blog.travelline.ru/tl/novye-vozmozhnosti-formy-bronirovaniya-dlya-sanatoriev/ странице].}}-->

Текущая версия на 11:24, 20 февраля 2026

YouTube.png
RUTUBE.png

Интеграция c сервисом онлайн-бронирования Travelline позволяет получать новые брони и управлять доступностью номерного фонда и ценами на платформе Travelline.

Настройки для онлайн-бронирования номеров с помощью сервиса Travelline выполняются в разделе БРОНИРОВАНИЕ — Онлайн-бронированиеНастройка интеграции Travelline.

Настройка подключения

Для настройки подключения к сервису TravelLine перейдите на закладку Служебная.

Travelline Параметры.png
  1. Включите настройку «Интеграция активна».
  2. Введите параметры подключения, полученные от менеджера TravelLine:
    • Адрес сервиса: www.ХХХХ.ru
    • Логин: ХХХХ
    • Пароль: пароль
    • Код гостиницы: ХХХХ
  3. Нажмите кнопку Сохранить настройки вверху окна.
  4. Проверьте соединение, нажав кнопку Проверить подключение.
  5. Выполните настройки получения данных бронирования:
    • Укажите вариант учета периода: по ночам или по дням;
    • Включите опцию «Выполнять автоматический запрос данных каждые 5 минут», для того чтобы программа автоматически делала запросы на получение новых броней.
  6. Выполните настройки интеграции с программой «TL Loyality: Баллы», если требуется объединить программу лояльности, используемую в «Кинт: Управление санаторием», с программой, используемой на платформе TravelLine. Подробная информации о настройке интеграции с программой «TL Loyality: Баллы» — в разделе Настройка интеграции с программой TL Loyalty.

Рабочий кабинет TravelLine — ссылка позволяет перейти в Личный кабинет пользователя на сервисе TravelLine.

В разделе «Протокол» отображается протокол обмена сообщениями с сервисом. В поле «Файл протокола» укажите путь к текстовому файлу протокола.

Необходимая подготовка

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

В личном кабинете «TravelLine» должны быть добавлены:

  1. Категории номеров. При создании укажите в них:
    • Тип предложения (номер или место в номере; чтобы определить, продается ли номер целиком или по отдельным местам).
    • Количество основных мест и варианты размещения при типе предложения «Номер» (чтобы определить, для какого количества гостей номер доступен при бронировании).
    • Доп. места и условия размещения детей — при необходимости.
    ЛК Travelline Категории номеров.png
  2. Тарифы.
    ЛК Travelline Тарифы.png
  3. Возрастные группы детей (при необходимости).
    ЛК Travelline Возрастные группы.png

В программе «Кинт: Управление санаторием» должны быть созданы и корректно заполнены:

  • категории номеров;
  • номерной фонд;
  • варианты проживания;
  • варианты лечения и варианты питания;
  • возрастные группы (если требуется выделять возрастные группы детей);
  • категории путевок;
  • номенклатура пребывания;
  • документы установки цен по типам:
    • цена проживания;
    • цена лечения;
    • цена питания.
  • квота для Travelline (с документами установки квоты).

Обратите внимание:

  • При настройке номенклатуры пребывания:
  1. В карточке номенклатуры заполните ключевые атрибуты (категорию путевки, вариант питания, вариант лечения или другие), от которых будет зависеть расчет цены номенклатуры пребывания (стоимости пребывания) по документам «Установка цен».
    Travelline Номенклатура пребывани атрибуты.png
  2. Сверьте эти атрибуты с аналитикой, которая содержится в документах установки цен разных типов. В частности, параметры «Категория путевки», «Категория номера» и «Вариант проживания» должны присутствовать как в аналитике типа цены «Цена проживания», так и в перечне ключевых атрибутов номенклатуры пребывания.
    Travelline Тип цены (проживание) Аналитика.png
  3. При необходимости откройте из карточки номенклатуры пребывания карточку категории номенклатуры и активируйте в ней недостающий атрибут.
    Travelline Категория Номенклатура пребывания Атрибуты.png
  • В документах «Установка цен», участвующих в расчете стоимости пребывания, прайс должен быть либо одинаковым, либо отсутствовать. При несоблюдении этого условия стоимость пребывания может рассчитаться некорректно.
  • При создании квоты для TravelLine в документе «Квота» необходимо установить галочку «По категориям номеров» и выбрать в поле «Онлайн-квота» значение «TravelLine».
Travelline КУС Документ Квота заполнение .png

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

Перейдите на закладку Настройка синхронизации, чтобы сопоставить объекты, настроенные в личном кабинете TravelLine, с соответствующими объектами, созданными в «Кинт: Управление санаторием».

Синхронизируются:

  • категории номеров;
  • тарифы (номенклатура пребывания);
  • каналы продаж (при наличии).
Travelline Настройка синхронизации.png

Категории номеров

В разделе установите соответствие категорий номеров.

  1. Нажмите кнопу Обновить для загрузки данных из сервиса TravelLine.
  2. В табличной части отобразятся загруженные категории номеров TravelLine — заполнятся колонки «Имя», «Код API» и «Мест» (для категорий с типом предложения «Место в номере» в колонке «Мест» передается значение 0).
    Travelline Соответствие категорий номеров.png
  3. В колонке «Категория номера» укажите соответствующие категории номеров, созданные в «Кинт: Управление санаторием».
  4. Нажмите кнопку Сохранить настройки, а затем Обновить.
    Travelline Соответствие категорий номеров установлено.png
  5. Проверьте и дозаполните параметры размещения в «Кинт: Управление санаторием» в соответствии с настройками в ЛК TravelLine:
    • Если в TravelLine в категории номера установлен тип предложения «Место в номере»,
      Travelline тип место.png
      1. В программе должен быть активирован флаг «По местам».
      2. Не требуется указывать варианты размещения в номере при продаже номера целиком.
      Travelline 2м Стандарт.png
    • Если в TravelLine в категории номера установлен тип предложения «Номер»,
      Travelline тип номер.png
      1. В программе флаг «По местам» не должен быть активирован.
      2. Требуется отметить те же варианты размещения в номере, которые были заданы для категории номера в ЛК TravelLine.
      Travelline 3м Люкс.png
    • Если в TravelLine в категории номера указаны доп. места (помимо мест, предусмотренных вариантом размещения),
      Travelline допместа.png
      в программе требуется заполнить значение в колонке «Доп. мест».
      Travelline 2м Люкс допместо.png
    • Если в TravelLine в категории номера указана возможность размещения детей,
      Travelline возр группы.png
      в программе выполнится поиск соответствующей возрастной группы по полю «Мин возраст».
      Travelline Возрастная группа в КУС.png
  6. Сохраните настройки.
Важно: TravelLine не позволяет создавать брони на конкретные номера (помещения). Бронирование осуществляется в категорию номеров. Наименования категорий в «Кинт: Управление санаторием» и TravelLine могут не совпадать. Если категория «Люкс» в TravelLine сопоставлена с категорией «Стандарт» в «Кинт: Управление санаторием», бронь из TravelLine будет передана как бронь категории «Стандарт».

Тарифы

В разделе установите соответствие тарифов TravelLine номенклатуре пребывания, созданной в «Кинт: Управление санаторием».

  1. Нажмите кнопку Обновить, чтобы загрузить тарифы, созданные в TravelLine.
  2. Данные по тарифам отобразятся в колонках «TravelLine»: «Имя» и «Код API».
  3. В колонке «Номенклатура пребывания» заполните номенклатуру пребывания в соответствии с тарифами.
    Travelline КУС Соответствие тарифов.png
  4. Нажмите кнопку Сохранить настройки.
    Travelline Сохранить настройки синхронизации тарифов.png

Допустимо сопоставлять одну номенклатуру пребывания с несколькими тарифами TravelLine, если тарифы являются однотипными и различаются только каналом продаж.

Каналы продаж

Используйте раздел при наличии в TravelLine каналов продаж.

Travelline КУС Соответствие каналов продаж.png
  1. Нажмите кнопку Обновить, чтобы загрузить каналы бронирования (продаж) из сервиса TravelLine.
  2. Данные отобразятся в колонках «TravelLine»: «Имя» и «Код API».
  3. В колонке «Каналы продаж» выберите аналогичные каналы продаж, созданные в «Кинт: Управление санаторием»
  4. Нажмите кнопку Сохранить настройки.

Выгрузка данных по квотам и ценам

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

Квоты

Travelline КУС Квоты.png

Для заполнения данных по доступным местам в категориях номеров по установленной квоте TravelLine и выгрузки их в TravelLine:

  1. Установите период формирования данных.
  2. Укажите категории номеров.
  3. В поле «Тарифы» выберите номенклатуру пребывания.
  4. В поле «Квота» выберите квоту, созданную для TravelLine.
  5. Нажмите кнопку Кнопка синх.png — таблица заполнится данными по доступным местам в номерах по созданным документам установки квоты.
    Travelline КУС Квоты выгрузить.png
  6. Отметьте галочками квоты, которые необходимо выгрузить в личный кабинет TravelLine, и нажмите Выгрузить квоту.
  7. Откройте личный кабинет TravelLine и проконтролируйте правильность выгруженных данных.

Расчет доступных мест выполняется на основании документов «Установка квоты» с учетом фактической занятости номеров.

Цены

Travelline КУС Цены до заполн.png

Для заполнения цен и их последующей выгрузки в TravelLine:

  1. В поле «Период» выберите период выгрузки. По умолчанию отбор = «Этот год».
  2. Укажите категории номеров, для которых требуется рассчитать цены.
  3. В поле «Тарифы» укажите номенклатуру пребывания, по которой необходимо рассчитать цены.
  4. Выберите вариант заполнения «По ценообразованию», чтобы запустить расчет цен по документам установки цен.
  5. Нажмите кнопку Кнопка синх.png — таблица на закладке заполнится тарифами (если номенклатура настроена корректно).
  6. Отметьте галочками цены, которые необходимо выгрузить в личный кабинет TravelLine, и нажмите Выгрузить цены.
Travelline КУС Цены выгруз.png

При выборе варианта заполнения «По настройке» появляется дополнительный раздел — Настройка цен.

  1. Заполните тарифы в ручном режиме:
    • Нажмите кнопку Добавить и заполните поля табличной части.
    • Или нажмите кнопку Заполнить по ценообразованию, отредактируйте табличную часть и нажмите кнопку Записать.
      Travelline КУС Настройка цен.png
  2. Вернитесь в раздел Цены, выберите вариант заполнения «По настройке» и нажмите кнопку Кнопка синх.png, чтобы отобразился список тарифов, подготовленных через настройку цен.

Получение новых броней из TravelLine

Новые брони можно загружать двумя способами:

  1. В ручном режиме — нажмите на кнопку Получить новые брони.
  2. В автоматическом режиме — для этого на закладке Служебная включите опцию «Выполнять автоматический запрос данных каждые 5 минут».

Чтобы автоматический режим работал корректно, откройте в программе раздел АДМИНИСТРИРОВАНИЕ — СервисКонсоль заданий и убедитесь, что в задании «Получать данные TravelLine» указан пользователь, под которым выполняется фоновое задание.

Загруженные заявки на бронь отображаются в журнале заявок и в интерфейсе «Администратор гостиницы» на закладке Прибывающие. Вид заявки — TravelLine.

Настройка интеграции с программой TL Loyalty

Настройки интеграции с программой «TL Loyalty: Баллы», позволяющей объединить программу лояльности, используемую в «Кинт: Управление санаторием», с программой, используемой на платформе TravelLine, находятся на закладке Служебная в разделе «Программа TL Loyalty».

Адм. системы Инт серв Travelline Служ 3.png

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

Заполнение номера телефона в картах лояльности станет обязательным.
Выдача карт и начисления бонусных баллов будет выполняться только в «Кинт: Управление Санаторием», оплата бонусными баллами будет доступна как в TravelLine, так и в «Кинт: Управление Санаторием». Баланс бонусных баллов карт будет синхронизироваться автоматически.