Для настройки интеграции необходимо обновить конфигурацию до версии 9.1.2.82.
Перед настройкой интеграции необходимо включить в настройках гостиницы использование кэша цен и заполнить его по всем тарифам, а также выполнить начальные настройки в личном кабинете Бронируй Онлайн (создать тарифы, категории и т.д.)
Для настройки интеграции необходимо:
1. Открыть подсистему Интеграции/Взаимодействия с внешними системами.
2. Создадим новую интеграцию нажатием на кнопку Создать.
В настройках указать:
Код
Наименование
Гостиницу
Тип интеграции Бронируй Онлайн
Установим флаги Действует и Режим отладки
Укажем максимальную длину лога 9 999 999 999
После этого нажимаем кнопку Записать и откроем настройки интеграции.
3. В открывшемся окне в разделе Настройки необходимо заполнить основные параметры для корректной работы интеграции.
1) Вкладка Настройки подключения
Поле Гостиница указывается по умолчанию. В случае мультигостиничной базы для каждой гостиницы создается своя интеграция с сервисом Бронируй Онлайн.
Поле Тип клиента - при заполненном поле во всех бронированиях, выгруженных в программу из Бронируй Онлайн, будет установлен данный тип клиента.
Поля Источник информации и Направление маркетинга заполняются в том случае, когда необходимо во всех бронированиях, загруженных из Бронируй Онлайн, установить значения источника и маркета.
Обязательно установить валюту - RUB
Количество дней для обновления - 200 (параметр отвечает за глубину выгрузки цен и остатков свободных номеров).
Флаг Использовать загрузку броней - устанавливается обязательно, флаг используется для загрузки бронирований при обмене с Бронируй Онлайн.
Флаг Использовать обновление доступности - устанавливается обязательно, флаг используется для синхронизации остатков свободных номеров при обмене с Бронируй Онлайн.
Флаг Получать остатки свободных номеров\мест на полночь. При выключенном флаге выгружается минимальный остаток свободных номеров с расчётного по расчётный час (состояние на 12:00). То есть при наличии ранних заездов\поздних выездов количество свободных номеров, которое будет выгружаться, будет уменьшено на число номеров на раннем заезде\позднем выезде. При включенном флаге остаток свободных номеров выгружается на конец дня даты (23:59:59). То есть наличие ранних заездов и поздних выездов НЕ учитывается при выгрузке остатка свободных номеров.
Флаг Использовать обновление цен - флаг включает автоматическую синхронизацию цен при обмене с Бронируй Онлайн. В зависимости от количества тарифов, категорий, сложности ценообразования, продолжительность выполнения синхронизации при включенном флаге может значительно увеличиться. Обычно данные флаг НЕ включают и выполняют ручную выгрузку цен при их изменении в 1С:Отель.
Укажем параметры подключения к Бронируй Онлайн:
HTTP сервер: lk.bronirui-online.ru
Адрес API на сервере: /extranet/v1
Пароль: используйте ключ API, указанный в личном кабинете Бронируй Онлайн.
Если всё указано корректно, то после нажатия на кнопку Тест подключения должно появиться сообщение об успешности подключения, а на вкладке №2, 3, 5 и 8 должны появиться данные для сопоставления.
2) На вкладке Категории номеров задаём сопоставление между категориями в базе 1С:Отель и категориями, которые созданы в личном кабинете Бронируй Онлайн.
3) На вкладке Тарифы указываем сопоставление по тарифам.
Для тарифов, по которым в дальнейшем будет выполняться выгрузка цен, как вручную, так и автоматически, следует установить флаг Выгружать цены.
4) На вкладке Размещения указываются шаблоны и виды размещений, которые в дальнейшем используются при синхронизации цен.
Раздел состоит из двух таблиц.
В верхней таблице Базовые по количеству гостей задаются базовые шаблоны размещения гостей в номерах для выгрузки стоимости размещения гостей на основных местах, указанных в тарифах. Например, указываем шаблоны для размещения одного, двух, трех гостей в номере.
Ниже пример настройки шаблонов для одного и двух гостей в номере.
В нижней таблице Дополнительные гости указываются виды размещения, который будут использоваться для выгрузки цен за доп. места и цен за гостей без места.
В таблице указываются: вид размещения в 1С:Отель, возрастной диапазон (задаётся только для детских доп. мест и должен полностью соответствовать настройкам возрастного диапазона, которые заданы для доп. места в Бронируй Онлайн), флаг Требуется кровать - устанавливается обязательно для выгрузки цены за доп. место.
5) На вкладке Услуги задаётся настройка соответствий по доп. услугам, которые могут загружаться вместе с бронью из Бронируй Онлайн
6) На вкладке Статусы брони задаём сопоставление по статусам брони между 1С:Отель и Бронируй Онлайн
7) На вкладке Способы оплаты задаётся сопоставление между вариантами оплаты в Бронируй Онлайн и 1С:Отель.
С соответствующим способом оплаты будет записываться платёж в лицевой счёт брони при загрузке самой брони.
8) На вкладке Агенты указываем сопоставление между каналами продажи и агентами в 1С:Отель.
9) На вкладке Квоты задаётся сопоставление между квотами в Бронируй Онлайн и квотами в 1С:Отель
Настройки на этой вкладке работают следующим образом:
Если поле Квота номеров по умолчанию и таблица квот пустая, то в Бронируй Онлайн выгружается весь свободный остаток номеров из 1С:Отель
Если поле Квота номеров по умолчанию заполнена, то в Бронируй Онлайн выгружается остаток из этой квоты
Если установлен флаг Не использовать выгрузку в основную квоту, то выгрузка из квоты номеров по умолчанию не осуществляется совсем
В таблице ниже указываются квоты в 1С:Отель, созданных дополнительно к основной квоте
На этом этап настройки сопоставления следует считать завершённым.
4. Следующий этап - запуск интеграции, для этого необходимо провести:
Тестовую выгрузку квоты (остатков номеров)
Тестовую выгрузку цен
Проверить результаты выгрузки квоты и цен в Бронируй Онлайн и сравнить их с формой Что свободно? в 1С:Отель в режиме Цены и наличие.
Для этого переходим в настройках интеграции на вкладку Ручная синхронизация и последовательно нажимаем кнопки Доступность и Цены.
Результат выгрузки сравниваем с формой Что свободно? (подсистема Фронт-Офис/Что свободно) в режиме Цены и наличие меняя количество взрослых гостей.
Также на вкладке Ручная синхронизация существует возможность провести выборочную синхронизацию по определённым тарифам, категориям и периоду.
Это бывает полезно при необходимости частичной выгрузки данных.
5. Заключительный этап - настройка фонового задания. Перейдем на вкладку Фоновый задания.
Имеется два фоновых задания для выгрузки данных:
1) Первое фоновое задание также выгружает только изменения и загружает бронирования с той периодичность, которая указана в «Расписании».
2) Второе фоновое задание раз в день синхронизирует весь объем данных, включая цены по тарифам, доступность и ограничения. Одновременная работа двух фоновых заданий позволит избежать тех ситуаций, когда по ряду причин не были выгружены изменения за более ранние периоды и отразит актуальную информацию в Бронируй Онлайн.
В первом фоновом задании укажите пользователя, под которым будет происходить выгрузка изменений и загрузка броней.
Установите переключатель Использовать фоновое задание для выгрузки изменений и загрузки брони.
Укажите Расписание выполнения фонового задания. Рекомендуется установить периодичность в 180-300 сек ежедневно.
Для работы второго фонового задания укажите пользователя, под которым будет происходить полная синхронизация данных. Это может быть тот же пользователь, который указан в первом фоновом задании, или новый, но с тем же набором прав.
Установите переключатель Использовать фоновое задание для полной синхронизации.
Укажите Расписание выполнения фонового задания. Рекомендуется установить ежедневное выполнение в ночное время.
После внесения изменений Сохраните и обновите данные.
Для удобства отслеживания времени последней выгрузки данных на вкладке Ручная синхронизация существует раздел, в котором можно увидеть, в какое время выгружались изменения в «Доступности», «Ценах» и «Ограничениях».
Для ручной загрузки броней необходимо установить время последней выгрузки меньше текущего времени, а в поле «Загрузить брони по» нажать на крестик для установки текущего времени. После нажатия кнопки «Загрузить брони» будут получены все бронирования, которым Бронируй Онлайн установил дату между установленным на форме диапазоном. В случае успешной выгрузки время последней выгрузки для броней установится в текущее. Если же выгрузка будет неудачна, то время не изменится, и будет изменено только после устранения ошибок и выполнении удачной выгрузки броней на эти даты.
В фоновом задании выгрузки бронирования реализована та же логика установки даты последней выгрузки.