Настройка интеграции с Travelline (тонкий клиент, редакция 9.0 и выше)

Последние изменения: 10.10.2025
Содержание статьи:

Общая настройка интеграции

На начальном этапе перед настройкой интеграции необходимо:

  • Обновить конфигурацию для версии 9.0.3.3.
  • Включить в настройках гостиницы использование кэша цен и заполнить его по всем тарифам, а также выполнить начальные настройки в личном кабинете Travelline (создать тарифы, категории и т.д.)

Порядок настройки:

1. Для настройки перейдите в подсистему Интеграции/Взаимодействия с внешними системами.

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

3. В настройках укажите:

  • Код 
  • Наименование
  • Гостиницу
  • Тип интеграции Travelline версия 2

  • Установите флаги Действует и Режим отладки
  • Макс. длину лога 9 999 999 999

Информация

Значение длины лога 9 999 999 999 позволит в 100% случаев получить полный текст лога обмена, даже если объём выгружаемых данных большой.

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

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

Переходим к настройкам подключения.


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

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

794edc68bdff09363468fe9e6e9ccac1.png


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.

8ccc5a585f08b685619caf2091846ef3.png


Раздел Тарифы

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

для сопоставления необходимо, чтобы тарифы в Travelline:

  • Были созданы как самостоятельный тарифы. Зависимые тарифы будут недоступны для сопоставления.

  • У тарифов должен быть установлен флаг Активно.

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

20e9d41d244e4894eee4a2e150c4a088.png


Раздел Размещения

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

7e0685cf3512fa4034ac808dbd843707.png

Раздел состоит из двух таблиц:

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

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

Ниже пример настройки шаблонов для одного и двух гостей в номере.

658c04176a6e3a75e917c9c723d2936c.png
07daa2ed020d0de0d2d84ac854df7c0a.png

Как работает алгоритм при выгрузке цен?

Для одноместного размещения:

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

2. Виды размещения и категория, которые указаны в шаблоне, используются для получения цен из регистра Цены по тарифам по дням (кэш цен) на каждую дату из периода выгрузки (указывается на первой вкладке настройки интеграции)

3. Цены из регистра выгружаются в TravelLine.

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

Алгоритм повторяется для каждого указанного в таблице шаблона.

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

В таблице указываются:

  • Вид размещения из 1С:Отель

  • Возрастной диапазон (задаётся только для детских доп. мест и должен полностью соответствовать настройкам возрастного диапазона, которые заданы для доп. места в Travelline)

  • Флаг Требуется кровать - обязателен для выгрузки цены именно как цены за доп. место.

Если соотнести настройки на данной вкладке с параметрами в личном кабинете в Travelline (см. скриншот ниже), то проще представить это в виде таблицы.

1С:Отель

Travelline

Базовые по количеству гостей

Цена за каждый шаблон из 1С: Отель будет передана в раздел "Основные места в номере" (варианты размещения "Одноместное", "Двухместное" и так далее)

Дополнительные гости
(с флагом "Базовая кровать")

Цена за вид размещения будет передана в раздел "Основные места в номере" в подраздел "возможно размещение детей на доп. месте"

Дополнительные гости
(с флагом "Требуется кровать")

Цена за вид размещения будет передана в раздел "Дополнительные места в номере"

Дополнительные гости
(все флаги выключены)

Цена за вид размещения будет передана в раздел "Размещение детей без предоставления места"

Совершенно обычной ситуацией является, например, определение разной цены за доп. место в зависимости от возраста гостя. 

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

Раздел Услуги

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

87815c013212d4ccd1b86d0fc3155432.png


Раздел Статусы брони

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

ccbc34a6a00a5310cb7a380e82200a3b.png


Разделы Агенты

В разделе Агенты указываем сопоставление между каналами продажи и агентами в 1С:Отель.

Каналы продаж добавляются в ручном формате.

Для этого нажмите Добавить в верхнем меню. Разверните список доступных каналов в поле ID.

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

Разделы Способы оплаты/Виды гарантий/Валюты

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

Данное сопоставление используется в случаях, когда бронь от Travelline поступает вместе с оплатой (в xml брони отTravelline в поле DepositPayment передаётся статус Received).

С соответствующим способом оплаты будет записываться платёж в лицевой счёт брони при загрузке самой брони.

  • В разделе Виды гарантий задаётся сопоставление по видам гарантий. В соответствии с этим сопоставлением проставляется вид гарантии в брони при её загрузке.
222c92ded203df634520261f3c3e755a.png

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

Данная опция полезна, когда осуществляется одновременная продажа по тарифам с разными валютами.

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


Раздел Квоты

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

ea1c3e55d3a01f4442c3af09ddc9cdb1.png

Технические детали

Следует отметить тот факт, что в Travelline всегда есть как минимум одна квота, которая называется Основная он-лайн квота, в то время как в 1С:Отель справочник квот номеров может быть пустым, то есть квот нет вообще.

Учитывая этот факт, настройки на этой вкладке работают следующим образом:

  • Если поле Квота номеров по умолчанию и таблица квот пустая, то в Travelline в основную он-лайн квоту выгружается весь свободный остаток номеров из 1С:Отель

  • Если поле Квота номеров по умолчанию заполнена, то в основную он-лайн квоту в Travelline выгружается остаток из этой квоты

  • Если установлен флаг Не использовать выгрузку в основную квоту, то выгрузка в основную он-лайн квоту в Travelline не будет осуществляться.

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

Раздел Скидки

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

f3cf0ce76fe9929839974ace4ea1c23e.png

Для настройки необходимо:    

  • Добавить скидки в личном кабинете Travelline. Наименование скидки задать аналогично Типу скидки в 1С:Отель.

  • В сопоставлениях в интеграции с TravelLine на стороне 1Св поле ID прописать название типа скидки из Travelline и указать тип скидки из 1С:Отель.

На этом этап настройки сопоставления следует считать завершённым.

Запуск интеграции

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

  • Тестовую выгрузку квоты (остатков номеров)

  • Тестовую выгрузку цен

  • Проверить результаты выгрузки квоты и цен и сравнить их с 1С:Отель с формой Что свободно? в режиме Цены и наличие.

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

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

dbe3429f7aecb979ced21e9b16952e3f.png

Так же на вкладке Ручная синхронизация существует возможность провести выборочную синхронизацию по определённым тарифам, категориям и периоду.

Это бывает полезно при необходимости частичной выгрузки данных

После успешной проверки квоты и цен следует настроить обмен с Travelline в автоматическом режиме.

Настройка Фонового задания

Перейдите на вкладку Фоновое задание, установите флаг Использовать фоновое задание, укажите пользователя с полными правами для выполнения фонового задания (имеет смысл создать для этой задачи отдельного пользователя) и настроить расписание.

1632c739d7a409b3a62ab8595adb8635.png

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


Создание тестовой брони в TravelLine

Следующиq этап - создание тестовой брони в TravelLine. Если всё настроено успешно, бронь выгрузится при выполнении фонового задания. После загрузки броней следует проверить её корректность, а именно:

  • Состав гостей

  • Цену

  • Скидки

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

Следует отметить, что бронь будет успешно доставлена в 1С:Отель только в случае корректно заполненного справочника Шаблоны размещения, т.е. если будет найден подходящий шаблон в справочнике.

Поиск шаблона осуществляется по следующему алгоритму:

  • Получаем из брони Travelline состав гостей
  • Делим состав гостей на взрослых, детей, подростков и младенцев в соответствии с переданным от Travelline возрастом и настройками на уровне гостиницы в 1С:Отель

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

  • Проставляем шаблон и виды размещения из него в бронь
  • Записываем бронь

Если бронь выгрузилась успешно, протестируйте загрузку отмены брони и после этого переводить интеграцию в боевой режим.

Особенности настройки интеграции с TravelLine в редакции 9.1. и выше

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

В релизах редакции 9.0 фоновое задание работало на загрузку броней и выгрузку изменений (доступности и цен) с той периодичностью, которая указана в «Расписании выполнения фонового задания» (стандартно - 180-300 сек), либо полную синхронизацию цен при включенном флаге Использовать обновление цен (обычно этот флаг не ставится, цены выгружаются вручную для сокращения времени выполнения фонового задания).

В релизах редакции 9.1 с появлением двух фоновых заданий упрощается работа с выгрузкой данных:

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

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

Для запуска двух фоновых заданий перейдите на вкладку Фоновые задания.

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

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

    Поставьте флаг «Использовать фоновое задание для выгрузки изменений и загрузки броней»

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

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

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


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



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


Помогла ли вам статья?