Настройка интеграции с Бронируй Онлайн (тонкий клиент, редакция 9.1)

Последние изменения: 13.08.2024

Для настройки интеграции необходимо обновить конфигурацию до версии 9.1.2.82

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

Настройка интеграции производится в подсистеме "Интеграции" в справочнике "Взаимодействия с внешними системами".

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

В настройках укажем:

  • Код

  • Наименование

  • Гостиницу

  • Тип интеграции "Бронируй Онлайн "

А также:

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

  • Укажем максимальную длину лога 9 999 999 999


После этого нажимаем кнопку "Записать" и откроем настройки интеграции.

2. В настройках интеграции на первой вкладке:

  • Указываем валюту "Руб."

  • Количество дней для обновления - 200 (параметр отвечает за глубину выгрузки цен и остатков свободных номеров).

Обязательно установить:

  • Флаг "Использовать загрузку броней" (включает загрузку броней при обмене с Бронируй Онлайн).

  • Флаг "Использовать обновление доступности" (включает синхронизацию свободных номеров при обмене с Бронируй Онлайн).

Рекомендуется установить:

  • Флаг "Получать остатки свободных номеров\мест на полночь."

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

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

Опционально:

  • Флаг "Использовать обновление цен"

Флаг включает автоматическую синхронизацию цен при обмене с Бронируй Онлайн. В зависимости от количества тарифов, категорий, сложности ценообразования, продолжительность выполнения синхронизации при включенном флаге может значительно увеличиться. Обычно данные флаг НЕ включают и выполняют ручную выгрузку цен при их изменении в 1С:Отель.

Укажем параметры подключения к Бронируй Онлайн (Адрес HTTP сервера, адрес API, логин и пароль от API интеграции), которые предварительно необходимо получить в Бронируй Онлайн.

Если всё указано корректно, то после нажатия на кнопку "Тест подключения" должно появиться сообщение об успешности подключения, а на вкладке №2, 3, 5 и 8 должны появиться данные для сопоставления.

2. На вкладке №2 "Категории номеров" задаём сопоставление между категориями в базе 1С:Отель и категориями, которые созданы в личном кабинете Бронируй Онлайн.

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

Для стыковки доступны тарифы, которые в Бронируй Онлайн:

  • Создан как самостоятельный тариф

  • У которого установлен флаг "Активно"

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

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


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

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

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

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


В упрощённом виде алгоритм при выгрузке цен за одно основное место

  • Берём шаблон, указанный для одного основного места.

  • Берём из шаблона вид размещения и категории

  • Получаем для этого вида размещения и категорий цены из регистра "Цены по тарифам по дням" (кэш цен) на каждую дату из периода выгрузки (указывается на первой вкладке настройки интеграции)

  • Выгружаем цены в Бронируй Онлайн

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

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

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

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

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

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

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

5. На вкладке № 5 "Услуги"

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

6. На вкладке № 6 "Статусы брони" задаём сопоставление по статусам брони между 1С:Отель и Бронируй Онлайн

7. На вкладке №7 "Способы оплаты" задаётся сопоставление между вариантами оплаты в Бронируй Онлайн и 1С:Отель.

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

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

9. На вкладке № 9 "Квоты" задаётся сопоставление между квотами в Бронируй Онлайн и квотами в 1С:Отель

Настройки на этой вкладке работают следующим образом:

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

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

  • Если установлен флаг "Не использовать выгрузку в основную квоту", то выгрузка из квоты номеров по умолчанию не осуществляется совсем

  • В таблице ниже указываются квоты в 1С:Отель, созданных дополнительно к основной квоте

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

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

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

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

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

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

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

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

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

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

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

  • Цену

  • Скидки

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

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

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

  • Получаем из брони Бронируй Онлайн состав гостей

  • Делим состав гостей на взрослых детей, подростков и младенцев в соответствии с переданным от Бронируй Онлайн возрастом и настройками на уровне гостиницы в 1С:Отель, которые нужно выставить в соответствии с возрастами в Бронируй Онлайн – младенцы 0-3, дети 4-5, подростки 6-12.


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


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

  • Записываем бронь

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

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

Имеется два фоновых задания для выгрузки данных:

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

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

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

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


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

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

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

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

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

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

Для ручной загрузки броней необходимо установить время последней выгрузки меньше текущего времени, а в поле «Загрузить брони по» нажать на крестик для установки текущего времени. После нажатия кнопки «Загрузить брони» будут получены все бронирования, которым Бронируй Онлайн установил дату между установленным на форме диапазоном. В случае успешной выгрузки время последней выгрузки для броней установится в текущее. Если же выгрузка будет неудачна, то время не изменится, и будет изменено только после устранения ошибок и выполнении удачной выгрузки броней на эти даты.
В фоновом задании выгрузки бронирования реализована та же логика установки даты последней выгрузки.

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