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

Материал из КинтВики
Перейти к: навигация, поиск
 
(не показаны 2 промежуточные версии 1 участника)
Строка 3: Строка 3:
 
| __TOC__
 
| __TOC__
 
|}
 
|}
Интеграция с системой онлайн-бронирования [http://ru.wubook.net/ WuBook]
+
Интеграция с системой онлайн-бронирования [http://ru.wubook.net/ WuBook].
  
=== Общая характеристика ===
 
 
Онлайн-бронирование позволяет получать брони от внешних источников — сайт гостиницы (санатория), booking.com и другие.
 
Онлайн-бронирование позволяет получать брони от внешних источников — сайт гостиницы (санатория), booking.com и другие.
Бронирование выполняется по категориям номеров.
+
 
 +
Бронирование выполняется в категории номеров.
 +
 
 
На каждую полученную бронь создается один документ «Путевка», в который будет добавлен первый найденный свободный номер гостиницы.
 
На каждую полученную бронь создается один документ «Путевка», в который будет добавлен первый найденный свободный номер гостиницы.
  
 
Если бронь содержит данные по нескольким категориям номеров или физлицам, то в путевку будет добавлено соответствующее количество строк.
 
Если бронь содержит данные по нескольким категориям номеров или физлицам, то в путевку будет добавлено соответствующее количество строк.
  
=== Пример работы онлайн-бронирования ===
+
Примеры интеграции модуля на сайтах гостиниц http://ru.wubook.net/rivendell
* Примеры интеграции модуля на сайтах гостиниц: http://ru.wubook.net/rivendell
 
  
 
=== Настройка взаимодействия ===
 
=== Настройка взаимодействия ===
Настройка взаимодействия программного продукта '''«Кинт: Управление санаторием»''' и сервиса '''WuBook''' выполняется в разделе «Гостиница», команда '''«Онлайн-бронирование WuBook»'''.
+
Настройка взаимодействия программы «Кинт: Управление санаторием» и сервиса WuBook открывается из раздела ГОСТИНИЦА командой '''Онлайн-бронирование WuBook'''.
  
 
Настройка выполняется в три этапа:
 
Настройка выполняется в три этапа:
* Получение лицензии — ввод ключа активации и параметров авторизации в [https://wubook.net/wauth личном кабинете];
+
* Получение лицензии — ввод ключа активации и параметров авторизации в [https://wubook.net/wauth личном кабинете].
* Настройка синхронизации — согласование объектов в базе данных «Кинт: Управление санаторием» и WuBook;
+
* Настройка синхронизации — согласование объектов в базе данных «Кинт: Управление санаторием» и WuBook.
* Настройка квот и цен — отправка данных о ценах и доступной квоте мест в WuBook;
+
* Настройка квот и цен — отправка данных о ценах и доступной квоте мест в WuBook.
  
[[Файл:Параметры подключения WuBook.png]]
+
: [[Файл:Параметры подключения WuBook.png]]
{{-}}
 
  
 
==== Получение лицензии ====
 
==== Получение лицензии ====
 
Для возможности настройки и работы с онлайн-бронированием необходимо получить лицензионный ключ. Ключ выдается клиентским отделом компании «Кинт».
 
Для возможности настройки и работы с онлайн-бронированием необходимо получить лицензионный ключ. Ключ выдается клиентским отделом компании «Кинт».
  
Для подключения к сервису онлайн-бронирования WuBook необходимо ввести '''«Логин»''', '''«Пароль»''' и '''«Код гостиницы»'''. Логин и пароль используются те же, что и для доступа в личный кабинет, «Код гостиницы» ('''«Lcode»''') можно узнать в разделе «ВАШИ ОБЪЕКТЫ» на [https://wubook.net/wauth/wauth/avatar странице администрирования] в личном кабинете.
+
Для подключения к сервису онлайн-бронирования WuBook нужно ввести «Логин», «Пароль» и «Код гостиницы». Логин и пароль используются те же, что и для доступа в личный кабинет, «Код гостиницы» («Lcode») можно узнать в разделе «ВАШИ ОБЪЕКТЫ» на [https://wubook.net/wauth/wauth/avatar странице администрирования] в личном кабинете.
После ввода регистрационных данных можно проверить корректность введенных данных командой '''«Проверить подключение»'''. В случае успешного соединения выводится сообщение '''«Подключение установлено! Сервис доступен»'''.
+
 
 +
После ввода регистрационных данных можно проверить корректность введенных данных командой '''Проверить подключение'''. В случае успешного соединения выводится сообщение «Подключение установлено! Сервис доступен».
  
 
==== Получение данных онлайн-бронирования ====
 
==== Получение данных онлайн-бронирования ====
Получение данных о бронированиях (новые брони или модификация/отмена существующих) возможна тремя способами:
+
Получение данных о бронированиях (новые брони или модификация / отмена существующих) возможна тремя способами:
* вручную (в форме настройки интеграции Wubook): команда '''«Получить новые брони»''' позволяет выполнить принудительный запрос недоставленных броней;
+
* Вручную (в форме настройки интеграции Wubook): команда '''Получить новые брони''' позволяет выполнить принудительный запрос недоставленных броней.
* в автоматическом режиме при получении Push-уведомления от сервиса WuBook;
+
* В автоматическом режиме при получении Push-уведомления от сервиса WuBook.
* в автоматическом режиме с использованием фонового задания (получение новых данных выполняется каждые 4 часа, изменять расписание работы '''не рекомендуется''')
+
* В автоматическом режиме с использованием фонового задания (получение новых данных выполняется каждые 4 часа, изменять расписание работы не рекомендуется).
  
Настройка Push-уведомлений
+
==== Настройка Push-уведомлений ====
 
Используются для получения уведомлений о создании новой брони в сервисе WuBook.
 
Используются для получения уведомлений о создании новой брони в сервисе WuBook.
 +
 
Для активации уведомлений необходимо:
 
Для активации уведомлений необходимо:
* наличие установленного веб-сервера (например, Apache) на компьютере, на котором расположена база данных «Кинт: Управление санаторием»;
+
* Наличие установленного веб-сервера (например, Apache) на компьютере, на котором расположена база данных «Кинт: Управление санаторием».
* выполнить публикацию http-сервиса '''WubookPushNotification''' средствами 1С из конфигуратора (Администрирование -> Публикация на веб-сервере… -> HTTP сервисы);
+
* Выполнить публикацию http-сервиса WubookPushNotification средствами 1С из конфигуратора (АДМИНИСТРИРОВАНИЕ — '''Публикация на веб-сервере''' — '''HTTP сервисы''').
* выполнить стоп-старт веб-сервера для корректного применения настроек;
+
* Выполнить стоп-старт веб-сервера для корректного применения настроек.
* в настройках WuBook необходимо указать адрес опубликованной базы и нажать кнопку «Активировать push уведомления». Если активация успешна — будет установлен флаг «Используется».
+
* В настройках WuBook необходимо указать адрес опубликованной базы и нажать кнопку «Активировать push уведомления». Если активация успешна — будет установлен флаг «Используется».
Для проверки отправки уведомлений нужно нажать кнопку «Проверить состояние push», если тестовое уведомление пришло — будет выдано соответствующее сообщение.
+
 
 +
Для проверки отправки уведомлений нужно нажать кнопку '''''Проверить состояние push''''', если тестовое уведомление пришло — будет выдано соответствующее сообщение.
 +
 
 +
=== Настройка синхронизации ===
 +
Настройки соответствия объектов необходимы для определения связи между «Категориями номеров» и «Номенклатурой путевки» в базе «Кинт: Управление санаторием» и «Категориями номеров» и «Тарифными планами» в базе WuBook.
  
==== Настройка синхронизации ====
+
Состав доступных для онлайн-бронирования «Категорий номеров» и «тарифов» выполняется в личном кабинете.
Настройки соответствия объектов необходимы для определения связи между '''«Категориями номеров»''' и '''«Номенклатурой путевки»''' в базе «Кинт: Управление санаторием» и '''«Категориями номеров»''' и '''«Тарифными планами»''' в базе WuBook.
 
Состав доступных для онлайн-бронирования «Категорий номеров» и «тарифов» выполняется в личном кабинете
 
  
После заполнения соответствий объектов необходимо нажать кнопку '''«Сохранить настройки»''' для записи настроек в базу данных.
+
После заполнения соответствий объектов необходимо нажать кнопку '''''Сохранить настройки''''' для записи настроек в базу данных.
  
[[Файл:Настройки синхронизации WuBook.png]]
+
: [[Файл:Настройки синхронизации WuBook.png]]
{{-}}
 
  
==== Квота мест и цены ====
+
=== Квота мест и цены ===
В таблице '''«Цены»''' выводятся настройки '''«Цены путевки»''' по периодам действия с разворотом по «Тарифу» и «Категории номера». Цены выводятся только для варианта проживания «Основное место».
+
В таблице «Цены» выводятся настройки «Цены путевки» по периодам действия с разворотом по «Тарифу» и «Категории номера». Цены выводятся только для варианта проживания «Основное место».
  
По команде '''«Выгрузить цены»''' производится отправка данных в сервис WuBook для указанного тарифа по периодам.
+
По команде '''''Выгрузить цены''''' производится отправка данных в сервис WuBook для указанного тарифа по периодам.
  
==== Протокол ====
+
=== Протокол ===
 
Содержит настройки протокола выполнения запросов к сервису.
 
Содержит настройки протокола выполнения запросов к сервису.
 +
 
Таблица выводит расшифровку файла протокола.
 
Таблица выводит расшифровку файла протокола.
Кнопка '''«Очистить»''' удаляет все записи из файла протокола.
+
 
 +
Кнопка '''''Очистить''''' удаляет все записи из файла протокола.

Текущая версия на 16:42, 30 апреля 2021

Интеграция с системой онлайн-бронирования WuBook.

Онлайн-бронирование позволяет получать брони от внешних источников — сайт гостиницы (санатория), booking.com и другие.

Бронирование выполняется в категории номеров.

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

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

Примеры интеграции модуля на сайтах гостиниц http://ru.wubook.net/rivendell

Настройка взаимодействия

Настройка взаимодействия программы «Кинт: Управление санаторием» и сервиса WuBook открывается из раздела ГОСТИНИЦА командой Онлайн-бронирование WuBook.

Настройка выполняется в три этапа:

  • Получение лицензии — ввод ключа активации и параметров авторизации в личном кабинете.
  • Настройка синхронизации — согласование объектов в базе данных «Кинт: Управление санаторием» и WuBook.
  • Настройка квот и цен — отправка данных о ценах и доступной квоте мест в WuBook.
Параметры подключения WuBook.png

Получение лицензии

Для возможности настройки и работы с онлайн-бронированием необходимо получить лицензионный ключ. Ключ выдается клиентским отделом компании «Кинт».

Для подключения к сервису онлайн-бронирования WuBook нужно ввести «Логин», «Пароль» и «Код гостиницы». Логин и пароль используются те же, что и для доступа в личный кабинет, «Код гостиницы» («Lcode») можно узнать в разделе «ВАШИ ОБЪЕКТЫ» на странице администрирования в личном кабинете.

После ввода регистрационных данных можно проверить корректность введенных данных командой Проверить подключение. В случае успешного соединения выводится сообщение «Подключение установлено! Сервис доступен».

Получение данных онлайн-бронирования

Получение данных о бронированиях (новые брони или модификация / отмена существующих) возможна тремя способами:

  • Вручную (в форме настройки интеграции Wubook): команда Получить новые брони позволяет выполнить принудительный запрос недоставленных броней.
  • В автоматическом режиме при получении Push-уведомления от сервиса WuBook.
  • В автоматическом режиме с использованием фонового задания (получение новых данных выполняется каждые 4 часа, изменять расписание работы не рекомендуется).

Настройка Push-уведомлений

Используются для получения уведомлений о создании новой брони в сервисе WuBook.

Для активации уведомлений необходимо:

  • Наличие установленного веб-сервера (например, Apache) на компьютере, на котором расположена база данных «Кинт: Управление санаторием».
  • Выполнить публикацию http-сервиса WubookPushNotification средствами 1С из конфигуратора (АДМИНИСТРИРОВАНИЕ — Публикация на веб-сервереHTTP сервисы).
  • Выполнить стоп-старт веб-сервера для корректного применения настроек.
  • В настройках WuBook необходимо указать адрес опубликованной базы и нажать кнопку «Активировать push уведомления». Если активация успешна — будет установлен флаг «Используется».

Для проверки отправки уведомлений нужно нажать кнопку Проверить состояние push, если тестовое уведомление пришло — будет выдано соответствующее сообщение.

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

Настройки соответствия объектов необходимы для определения связи между «Категориями номеров» и «Номенклатурой путевки» в базе «Кинт: Управление санаторием» и «Категориями номеров» и «Тарифными планами» в базе WuBook.

Состав доступных для онлайн-бронирования «Категорий номеров» и «тарифов» выполняется в личном кабинете.

После заполнения соответствий объектов необходимо нажать кнопку Сохранить настройки для записи настроек в базу данных.

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

Квота мест и цены

В таблице «Цены» выводятся настройки «Цены путевки» по периодам действия с разворотом по «Тарифу» и «Категории номера». Цены выводятся только для варианта проживания «Основное место».

По команде Выгрузить цены производится отправка данных в сервис WuBook для указанного тарифа по периодам.

Протокол

Содержит настройки протокола выполнения запросов к сервису.

Таблица выводит расшифровку файла протокола.

Кнопка Очистить удаляет все записи из файла протокола.