Общая настройка интеграции
На начальном этапе перед настройкой интеграции необходимо:
- Обновить конфигурацию для версии 9.0.3.3.
- Включить в настройках гостиницы использование кэша цен и заполнить его по всем тарифам, а также выполнить начальные настройки в личном кабинете Travelline (создать тарифы, категории и т.д.)
Порядок настройки:
1. Для настройки перейдите в подсистему Интеграции/Взаимодействия с внешними системами.

2. Создадим новую интеграцию по кнопке Создать.

3. В настройках укажите:
- Код
- Наименование
- Гостиницу
-
Тип интеграции Travelline версия 2
- Установите флаги Действует и Режим отладки
- Макс. длину лога 9 999 999 999

Путь к логам находится на форме взаимодействия с внешними системами. Выделите строку интеграции с Travelline и перейдите на вкладку Логи интеграций со внешними системами в верхнем меню. Здесь хранятся все события связанные с выгрузкой доступности/цен/ограничений и загрузкой брони.

Запишите изменения в начальных настройках.
Переходим к настройкам подключения.

Настройки подключения
На вкладке Настройки подключения необходимо заполнить следующие параметры:

1. Указываем валюту - Руб.
2. Количество дней для обновления - параметр отвечает за глубину выгрузки цен и остатков свободных номеров. Стандартно устанавливается значение 200 дней.
3. Период обновления цен - период в минутах, который должен пройти с момент предыдущей синхронизации, чтобы перед выгрузкой цен сначала был обновлён кэш цен тарифов в 1С:Отель, а потом производилась выгрузка цен в Travelline (имеет смысл только при включенном флаге "Использовать обновление цен".
4. Обязательно установить:
Флаг Использовать загрузку броней - флаг устанавливается для загрузки броней при обмене с Travelline.
Флаг Использовать обновление доступности - включает синхронизацию свободных номеров при обмене с Travelline.
5. Рекомендуется установить:
Флаг Получать цены по брони из Travelline.
Флаг Получать цены по брони из TravelLine ставится для того, чтобы цена, по которой гость забронировал номер в объекте размещения, выгрузилась в программу в момент загрузки брони.
Использование данного флага может быть полезно в следующих случаях:
- Каналы продаж применяют свои скидки - тогда бронь будет загружена в базу уже со скидкой канала
- Управления ценами происходит непосредственно через личный кабинет Travelline. При такой настройке цены при записи брони в базу 1С:Отель будут начисляться на основного гостя в номере, остальные гости в номере будут размещаться по нулевой цене.
Применение данной настройки НЕ имеет смысла в санаториях, когда на каждого гостя выписывается путёвка и, соответственно, у каждого гостя должна быть рассчитана стоимость проживания.
Флаг Получать остатки свободных номеров\мест на полночь.
При выключенном флаге выгружается минимальный остаток свободных номеров с расчётного по расчётный час. То есть при наличии ранних заездов\поздних выездов количество свободных номеров, которое будет выгружаться, будет уменьшено на число номеров на раннем заезде\позднем выезде.
При включенном флаге остаток свободных номеров выгружается на конец дня даты. То есть наличие ранних заездов и поздних выездов НЕ учитывается при выгрузке остатка свободных номеров.
6. Опционально:
Флаг Использовать обновление цен. Флаг включает автоматическую синхронизацию цен при обмене с Travelline. В зависимости от количества тарифов, категорий, сложности ценообразования, продолжительность выполнения синхронизации при включенном флаге может значительно увеличиться. Обычно данные флаг НЕ включают и выполняют ручную выгрузку цен при их изменении в 1С:Отель.
7. В разделе Настройки подключения:

- Адрес HTTP сервера и Адрес API заполняются автоматически, менять их не требуется.
- Установите флаг Использовать SSL соединение.
- Укажите параметры подключения к Travelline - Код отеля, Логин и Пароль от API интеграции.которые предварительно необходимо получить в Travelline.
Параметры подключения предварительно запрашиваются объектом размещения в технической поддержке TravelLine.
После запиолнения основных параметров, нажмите на кнопку Тест подключения. Если данные в разделе Настройки подключения заполнены верно, то при попытке подключения должно появиться сообщение об успешности.
Далее переходим к сопоставлению данных.
Раздел Категории номеров
В разделе Категории номеров указываем сопоставление между категориями в базе 1С:Отель и категориями, которые созданы в личном кабинете Travelline.

Раздел Тарифы
В разделе Тарифы указываем сопоставление по тарифам.
для сопоставления необходимо, чтобы тарифы в Travelline:
Были созданы как самостоятельный тарифы. Зависимые тарифы будут недоступны для сопоставления.
У тарифов должен быть установлен флаг Активно.

Раздел Размещения
В разделе Размещения указываются шаблоны и виды размещений, которые в дальнейшем используются при синхронизации цен.

Раздел состоит из двух таблиц:
1. В верхней таблице Базовые по количеству гостей задаются шаблоны размещения гостей в номерах, которые в дальнейшем используются для выгрузки цен за основные места в Travelline.

Следовательно, в настройках самого шаблона следует указывать виды размещения, которые используются для размещения гостей на основных местах.
Ниже пример настройки шаблонов для одного и двух гостей в номере.


Для одноместного размещения:
1. В момент выгрузки цены в качестве основы берется шаблон для одноместного размещения, который указан в таблице Базовые по количеству гостей.
2. Виды размещения и категория, которые указаны в шаблоне, используются для получения цен из регистра Цены по тарифам по дням (кэш цен) на каждую дату из периода выгрузки (указывается на первой вкладке настройки интеграции)
3. Цены из регистра выгружаются в TravelLine.
Для двухместного размещения получаются цены для двух видов размещения, указанных в настройках шаблона, суммируются и выгружаются.
2. В нижней таблице Дополнительные гости указываются виды размещения, который будут использоваться для выгрузке цен за доп. места и цен за гостей без места.
В таблице указываются:
Вид размещения из 1С:Отель
Возрастной диапазон (задаётся только для детских доп. мест и должен полностью соответствовать настройкам возрастного диапазона, которые заданы для доп. места в Travelline)
Флаг Требуется кровать - обязателен для выгрузки цены именно как цены за доп. место.
Если соотнести настройки на данной вкладке с параметрами в личном кабинете в Travelline (см. скриншот ниже), то проще представить это в виде таблицы.


1С:Отель |
Travelline |
Базовые по количеству гостей |
Цена за каждый шаблон из 1С: Отель будет передана в раздел "Основные места в номере" (варианты размещения "Одноместное", "Двухместное" и так далее) ![]() |
Дополнительные гости |
Цена за вид размещения будет передана в раздел "Основные места в номере" в подраздел "возможно размещение детей на доп. месте" ![]() |
Дополнительные гости |
Цена за вид размещения будет передана в раздел "Дополнительные места в номере" ![]() |
Дополнительные гости |
Цена за вид размещения будет передана в раздел "Размещение детей без предоставления места" ![]() |
В этом случае на стороне личного кабинета Travelline создаются несколько вариантов размещения с указанием разных возрастов, а в 1С: Отель в таблице дополнительных гостей возраст для гостей на доп. местах указывается таким же, как он задан в личном кабинете Travelline. Порядок настройки для детей на основных местах и без места аналогичный.
Раздел Услуги

Раздел Статусы брони
В разделе Статусы брони задаём сопоставление по статусам брони между 1С:Отель и Travelline.

Разделы Агенты
В разделе Агенты указываем сопоставление между каналами продажи и агентами в 1С:Отель.
Каналы продаж добавляются в ручном формате.
Для этого нажмите Добавить в верхнем меню. Разверните список доступных каналов в поле ID.

Выберите контрагента из 1С:Отель в поле Агент.

Разделы Способы оплаты/Виды гарантий/Валюты
- В разделе Способы оплаты задаётся сопоставление между вариантами оплаты в Travelline и 1С:Отель.
Данное сопоставление используется в случаях, когда бронь от Travelline поступает вместе с оплатой (в xml брони отTravelline в поле DepositPayment передаётся статус Received).
С соответствующим способом оплаты будет записываться платёж в лицевой счёт брони при загрузке самой брони.
- В разделе Виды гарантий задаётся сопоставление по видам гарантий. В соответствии с этим сопоставлением проставляется вид гарантии в брони при её загрузке.

- В разделе Валюты задаётся сопоставление между валютами в Travelline и валютами в 1С:Отель

Данная опция полезна, когда осуществляется одновременная продажа по тарифам с разными валютами.
Важно понимать, что ID валюты на этой вкладке не загружаются автоматически, их следует добавлять вручную.
Раздел Квоты
В разделе Квоты задаётся сопоставление между квотами в Travelline и квотами в 1С:Отель.

Следует отметить тот факт, что в Travelline всегда есть как минимум одна квота, которая называется Основная он-лайн квота, в то время как в 1С:Отель справочник квот номеров может быть пустым, то есть квот нет вообще.
Учитывая этот факт, настройки на этой вкладке работают следующим образом:
Если поле Квота номеров по умолчанию и таблица квот пустая, то в Travelline в основную он-лайн квоту выгружается весь свободный остаток номеров из 1С:Отель
Если поле Квота номеров по умолчанию заполнена, то в основную он-лайн квоту в Travelline выгружается остаток из этой квоты
Если установлен флаг Не использовать выгрузку в основную квоту, то выгрузка в основную он-лайн квоту в Travelline не будет осуществляться.
В таблице ниже указывается сопоставление квот в 1С:Отель и квот в Travelline, созданных дополнительно к основной он-лайн квоте. Указывается ID квоты (api код), который указан в личном кабинете Travelline).
Раздел Скидки

Для настройки необходимо:
Добавить скидки в личном кабинете Travelline. Наименование скидки задать аналогично Типу скидки в 1С:Отель.
- В сопоставлениях в интеграции с TravelLine на стороне 1Св поле ID прописать название типа скидки из Travelline и указать тип скидки из 1С:Отель.
На этом этап настройки сопоставления следует считать завершённым.
Запуск интеграции
Далее для запуска интеграции необходимо провести:
Тестовую выгрузку квоты (остатков номеров)
Тестовую выгрузку цен
Проверить результаты выгрузки квоты и цен и сравнить их с 1С:Отель с формой Что свободно? в режиме Цены и наличие.

Результат выгрузки сравниваем с формой Что свободно? в режиме Цены и наличие, меняя состав взрослых.

Так же на вкладке Ручная синхронизация существует возможность провести выборочную синхронизацию по определённым тарифам, категориям и периоду.
Это бывает полезно при необходимости частичной выгрузки данных
После успешной проверки квоты и цен следует настроить обмен с Travelline в автоматическом режиме.
Настройка Фонового задания
Перейдите на вкладку Фоновое задание, установите флаг Использовать фоновое задание, укажите пользователя с полными правами для выполнения фонового задания (имеет смысл создать для этой задачи отдельного пользователя) и настроить расписание.

Установите частоту выполнения фонового задания. Стандартно устанавливается частота в диапазоне от 180 до 300 сек.
Создание тестовой брони в TravelLine
Следующиq этап - создание тестовой брони в TravelLine. Если всё настроено успешно, бронь выгрузится при выполнении фонового задания. После загрузки броней следует проверить её корректность, а именно:
Состав гостей
Цену
Скидки
Поиск шаблона осуществляется по следующему алгоритму:
- Получаем из брони Travelline состав гостей
- Делим состав гостей на взрослых, детей, подростков и младенцев в соответствии с переданным от Travelline возрастом и настройками на уровне гостиницы в 1С:Отель

- Далее по определённому составу гостей в справочнике шаблоном ищем шаблон, который в заголовке будет содержать аналогичный состав гостей

- Проставляем шаблон и виды размещения из него в бронь
- Записываем бронь
Особенности настройки интеграции с TravelLine в редакции 9.1. и выше
Начиная с релиза 9.1.1.4, появилась логика, которая подразумевает работу двух фоновых заданий в рамках одной интеграции для корректной выгрузки данных в TravelLine.
В релизах редакции 9.0 фоновое задание работало на загрузку броней и выгрузку изменений (доступности и цен) с той периодичностью, которая указана в «Расписании выполнения фонового задания» (стандартно - 180-300 сек), либо полную синхронизацию цен при включенном флаге Использовать обновление цен (обычно этот флаг не ставится, цены выгружаются вручную для сокращения времени выполнения фонового задания).
В релизах редакции 9.1 с появлением двух фоновых заданий упрощается работа с выгрузкой данных:
Первое фоновое задание также выгружает только изменения и загружает бронирования с той периодичность, которая указана в Расписании.
Второе фоновое раз в день синхронизирует весь объем данных, включая цены по тарифам, доступность и ограничения. Одновременная работа двух фоновых заданий позволит избежать тех ситуаций, когда по ряду причин не были выгружены изменения за более ранние периоды и отразит актуальную информацию в TravelLine.
Для запуска двух фоновых заданий перейдите на вкладку Фоновые задания.

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

Укажите расписание выполнения фонового задания. Рекомендуется установить периодичность в 180-300 сек ежедневно.

Поставьте флаг «Использовать фоновое задание для выгрузки изменений и загрузки броней»
- Для работы второго фонового задания укажите пользователя, под которым будет происходить полная синхронизация данных. Это может быть тот же пользователь, который указан в первом фоновом задании, или новый, но с тем же набором прав.
Укажите расписание выполнения фонового задания. Рекомендуется установить ежедневное выполнение в ночное время.

После внесения изменений «Сохраните и обновите данные».

Для удобства отслеживания времени последней выгрузки данных на вкладке «Ручная синхронизация» добавился раздел, в котором можно увидеть, в какое время выгружались изменения в «Доступности», «Ценах» и «Ограничениях».

Нужна помощь? Напишите нам ([email protected]) или обратитесь к базе знаний.