Налаштування OTA Bronui.com: відмінності між версіями
(Створена сторінка: =Загальна інформація про Bronui= Для початку треба щоби було що з’єднувати. Отже у вас мають бути створені та налаштовані категорії номерів та тариф в Bronui.com (посилання https://extranet.dev.bronui.com/). = Налаштування номерів = Для створення категорії номеру потрібно п...) |
Немає опису редагування |
||
| Рядок 1: | Рядок 1: | ||
=Загальна інформація про Bronui= | = Налаштування інтеграції = | ||
Для початку | |||
= Налаштування номерів = | == Загальна інформація про Bronui == | ||
Для створення категорії номеру | Для початку необхідно, щоб у Bronui.com були створені та налаштовані категорії номерів і тарифи. | ||
Інтеграція працює коректно лише за умови, що всі об’єкти розміщення активні та доступні для продажу. | |||
Вхід до екстранету Bronui.com: | |||
https://extranet.dev.bronui.com/ | |||
--- | |||
== Налаштування номерів == | |||
Для створення категорії номеру необхідно перейти до розділу '''Налаштування номерів''' та натиснути кнопку '''Додати тип номеру'''. | |||
<br> | |||
[[Файл:Add.png|1200px|]] | [[Файл:Add.png|1200px|]] | ||
<br> | <br> | ||
Після створення категорії номеру необхідно: | |||
* вказати назву категорії; | |||
* задати максимальну кількість гостей; | |||
* зберегти зміни. | |||
--- | |||
== Налаштування тарифів == | |||
Для створення тарифу необхідно перейти до розділу '''Тарифів''' та натиснути кнопку '''Додати тариф'''. | |||
<br> | |||
[[Файл:Addter.png|1200px|]] | |||
<br> | |||
Під час створення тарифу необхідно: | |||
* вказати назву тарифу; | |||
* обрати типи харчування. | |||
Створений тариф необхідно активувати, щоб він був доступний для синхронізації. | |||
= Умови підключення = | |||
== Крок 1. Параметри системи== | |||
Перейдіть до розділу '''Налаштування → Параметри системи → Інсталяції (default)''' та встановіть параметри, як зазначено нижче. | |||
<br> | |||
[[Файл:parametrs.png|1200px|]] | |||
<br> | |||
* '''Адреса сервісу OTA Bronui''' — https://api.dev.bronui.com/external-provider/ | |||
* '''Доступність використання OTA Bronui''' — увімкнути чекбокс. | |||
* '''Інтервал запиту бронювань з OTA Bronui, с''' — 60 | |||
* '''Інтервал синхронізації даних з OTA Bronui, с''' — 60 | |||
Значення за замовчуванням, змінювати не рекомендується. | |||
== Крок 2. Створення маппінгу готелю == | |||
Для коректної роботи інтеграції необхідно виконати маппінг готелю між сервісом та Bronui.com. | |||
Перейдіть за шляхом: | |||
'''Налаштування → OTA канали → Bronui''' | |||
На вкладці '''Bronui''' відображено два блоки: | |||
* список готелів; | |||
* додавання маппінгу готелю. | |||
<br> | |||
[[Файл:Ota11.png|1200px|]] | |||
<br> | |||
Для створення маппінгу: | |||
* оберіть свій готель з випадаючого списку; | |||
* логін та пароль для API використовуйте ті, які ви отримали від служби підтримки Bronui; | |||
* у полі '''Зовнішній код''' внесіть код вашого готелю, який ви отримали від служби підтримки; | |||
* Збережіть зміни. | |||
Після створення маппінгу готель стає доступним для подальшого зіставлення номерів і тарифів. | |||
== Крок 3. Синхронізація Servio HMS з Bronui == | |||
Після налаштування маппінгу готелю необхідно виконати співставлення даних між Servio HMS та Bronui.com. | |||
=== Співставлення категорій номерів === | |||
Для налаштування синхронізації категорій номерів необхідно співставити категорії, які передаються по API Bronui, з категоріями HMS. | |||
Див. приклад на скріні: | |||
<br> | |||
[[Файл:Mappingroom.png|1200px]] | |||
<br> | |||
Покрокові дії: | |||
# Увімкніть чекбокс напроти категорії номеру (пункт 1). | |||
# Натисніть на випадаючий список (пункт 2). | |||
# Оберіть відповідну категорію номеру (пункт 3). | |||
# Натисніть '''Зберегти'''. | |||
=== Співставлення тарифів === | |||
Для налаштування синхронізації тарифів необхідно співставити тарифи, які передаються по API Bronui, з тарифами HMS. | |||
Див. приклад на скріні: | |||
<br> | |||
[[Файл:Screenshot Rates.png|1200px]] | |||
<br> | |||
Покрокові дії: | |||
# Натисніть '''Редагувати''' поруч із тарифом. | |||
# Увімкніть чекбокс напроти тарифу. | |||
# Відкрийте випадаючий список. | |||
# Оберіть тариф відповідно наданому коду тарифу з Bronui. | |||
# Натисніть '''Зберегти'''. | |||
=== Співставлення умов розміщення === | |||
Для налаштування синхронізації умов розміщення необхідно співставити умови, які передаються по API Bronui, з умовами HMS. | |||
Див. приклад на скріні: <br>[[Файл:Roz.png|1200px|]]<br> | |||
Покрокові дії: | |||
# Оберіть тариф у маппінгу умов розміщення. | |||
# Активуйте чекбокс умови розміщення. | |||
# Натисніть на випадаючий список. | |||
# У дропдауні оберіть відповідний код умови розміщення з Bronui. | |||
# Натисніть '''Зберегти'''. | |||
== Створення умов розміщення == | |||
Для коректної роботи синхронізації необхідно, щоб умови розміщення в HMS та Bronui відповідали одна одній. | |||
* Перейдіть за посиланням: '''Налаштування → OTA канали → Умови розміщення'''. | |||
* На вкладці розташовано два блоки: | |||
# Довідник умов розміщення; | |||
# Додавання (Редагування) умов розміщення. | |||
=== Параметри для налаштування умови розміщення === | |||
* '''Назва''' — вказуємо назву умови розміщення. | |||
* '''Скорочення''' — скорочена назва умови. | |||
* '''Тип розміщення''' — кількість людей,відповідна до основних місць в номері. | |||
* '''Категорія номеру''' — з випадаючого списку обираємо категорію номеру, для якої ця умова буде застосована. | |||
* '''Дорослих''' — кількість дорослих, що розташовуються в номері за цією умовою. | |||
* '''Дітей''' — кількість дітей. | |||
* '''Дітей з оплатою''' — кількість дітей, для яких нараховується повноцінний пакет проживання (не може перевищувати кількість у полі "Дітей"). | |||
* '''Місця''' — загальна кількість основних місць у номері. | |||
* '''Дод. місця''' — кількість додаткових місць у номері (якщо передбачено). | |||
* '''По місцях''' — встановлюється чекбокс, якщо вартість передаватиметься за місце, а не за номер цілком. | |||
* '''Додаткове місце''' — встановлюється чекбокс, якщо в номері передбачені додаткові місця. | |||
* '''Підкласи послуг''' — послуги, які передаватимуться до OTA каналу для нарахування вартості для даної умови розміщення. | |||
=== Налаштування розміщення на 2 основних місця === | |||
<br> | |||
[[Файл:Placement conditions 1.png|800px|border]] | |||
<br> | |||
=== Налаштування розміщення на 2 основних місця з урахуванням дітей з оплатою === | |||
<br> | |||
[[Файл:Placement conditions 2.png|800px|border]] | |||
<br> | |||
=== Налаштування розміщення на 2 основних місця з урахуванням дітей з оплатою та додаткового місця === | |||
<br> | |||
[[Файл:Placement conditions 3.png|800px|border]] | |||
<br> | |||
Інші типи умов розміщення необхідно налаштовувати за аналогією. | |||
> '''Примітка!''' Умови розміщення в OTA тарифах повинні на 100% відповідати тим, що вказані в цьому розділі. Якщо в тарифі умова відрізнятиметься від зазначеної, вартість нараховуватиметься некоректно. | |||
= Створення ОТА-каналу в Servio HMS = | |||
Щоб налаштувати канал OTA, виконайте наступне: | |||
* Оберіть потрібний канал. | |||
* Додайте канал у систему. | |||
* Увімкніть галочки/параметри, які відмічені на скріншотах нижче. | |||
[[Файл:Screenshot 2.png|1200px]] | |||
<br> | |||
[[Файл:Screenshot 31.png|1200px]] | |||
<br> | |||
=Налаштування ExternalConnectionService= | |||
В екстерналі вмикаємо все, як на прикладі нижче і перезапускаємо службу<br> | |||
[[Файл:External.png|1200px]]<br> | |||
= Особливості роботи = | |||
<br> Тимчасові бронювання автоматично не анулюються в Servio HMS. | |||
<br> Якщо гість не завершив бронювання, інформацію про ануляцію надсилатиме OTA-канал. | |||
<br> Тому вручну втручатися не потрібно — система обробляє зміни, отримані від OTA. | |||
= Типові помилки та рішення = | |||
Поточна версія на 10:52, 10 лютого 2026
Налаштування інтеграції
Загальна інформація про Bronui
Для початку необхідно, щоб у Bronui.com були створені та налаштовані категорії номерів і тарифи. Інтеграція працює коректно лише за умови, що всі об’єкти розміщення активні та доступні для продажу.
Вхід до екстранету Bronui.com: https://extranet.dev.bronui.com/
---
Налаштування номерів
Для створення категорії номеру необхідно перейти до розділу Налаштування номерів та натиснути кнопку Додати тип номеру.
Після створення категорії номеру необхідно:
- вказати назву категорії;
- задати максимальну кількість гостей;
- зберегти зміни.
---
Налаштування тарифів
Для створення тарифу необхідно перейти до розділу Тарифів та натиснути кнопку Додати тариф.
Під час створення тарифу необхідно:
- вказати назву тарифу;
- обрати типи харчування.
Створений тариф необхідно активувати, щоб він був доступний для синхронізації.
Умови підключення
Крок 1. Параметри системи
Перейдіть до розділу Налаштування → Параметри системи → Інсталяції (default) та встановіть параметри, як зазначено нижче.
- Адреса сервісу OTA Bronui — https://api.dev.bronui.com/external-provider/
- Доступність використання OTA Bronui — увімкнути чекбокс.
- Інтервал запиту бронювань з OTA Bronui, с — 60
- Інтервал синхронізації даних з OTA Bronui, с — 60
Значення за замовчуванням, змінювати не рекомендується.
Крок 2. Створення маппінгу готелю
Для коректної роботи інтеграції необхідно виконати маппінг готелю між сервісом та Bronui.com.
Перейдіть за шляхом: Налаштування → OTA канали → Bronui
На вкладці Bronui відображено два блоки:
- список готелів;
- додавання маппінгу готелю.
- оберіть свій готель з випадаючого списку;
- логін та пароль для API використовуйте ті, які ви отримали від служби підтримки Bronui;
- у полі Зовнішній код внесіть код вашого готелю, який ви отримали від служби підтримки;
- Збережіть зміни.
Після створення маппінгу готель стає доступним для подальшого зіставлення номерів і тарифів.
Крок 3. Синхронізація Servio HMS з Bronui
Після налаштування маппінгу готелю необхідно виконати співставлення даних між Servio HMS та Bronui.com.
Співставлення категорій номерів
Для налаштування синхронізації категорій номерів необхідно співставити категорії, які передаються по API Bronui, з категоріями HMS.
Див. приклад на скріні:
Покрокові дії:
- Увімкніть чекбокс напроти категорії номеру (пункт 1).
- Натисніть на випадаючий список (пункт 2).
- Оберіть відповідну категорію номеру (пункт 3).
- Натисніть Зберегти.
Співставлення тарифів
Для налаштування синхронізації тарифів необхідно співставити тарифи, які передаються по API Bronui, з тарифами HMS.
Див. приклад на скріні:
Покрокові дії:
- Натисніть Редагувати поруч із тарифом.
- Увімкніть чекбокс напроти тарифу.
- Відкрийте випадаючий список.
- Оберіть тариф відповідно наданому коду тарифу з Bronui.
- Натисніть Зберегти.
Співставлення умов розміщення
Для налаштування синхронізації умов розміщення необхідно співставити умови, які передаються по API Bronui, з умовами HMS.
Див. приклад на скріні: ![]()
Покрокові дії:
- Оберіть тариф у маппінгу умов розміщення.
- Активуйте чекбокс умови розміщення.
- Натисніть на випадаючий список.
- У дропдауні оберіть відповідний код умови розміщення з Bronui.
- Натисніть Зберегти.
Створення умов розміщення
Для коректної роботи синхронізації необхідно, щоб умови розміщення в HMS та Bronui відповідали одна одній.
- Перейдіть за посиланням: Налаштування → OTA канали → Умови розміщення.
- На вкладці розташовано два блоки:
- Довідник умов розміщення;
- Додавання (Редагування) умов розміщення.
Параметри для налаштування умови розміщення
- Назва — вказуємо назву умови розміщення.
- Скорочення — скорочена назва умови.
- Тип розміщення — кількість людей,відповідна до основних місць в номері.
- Категорія номеру — з випадаючого списку обираємо категорію номеру, для якої ця умова буде застосована.
- Дорослих — кількість дорослих, що розташовуються в номері за цією умовою.
- Дітей — кількість дітей.
- Дітей з оплатою — кількість дітей, для яких нараховується повноцінний пакет проживання (не може перевищувати кількість у полі "Дітей").
- Місця — загальна кількість основних місць у номері.
- Дод. місця — кількість додаткових місць у номері (якщо передбачено).
- По місцях — встановлюється чекбокс, якщо вартість передаватиметься за місце, а не за номер цілком.
- Додаткове місце — встановлюється чекбокс, якщо в номері передбачені додаткові місця.
- Підкласи послуг — послуги, які передаватимуться до OTA каналу для нарахування вартості для даної умови розміщення.
Налаштування розміщення на 2 основних місця
Налаштування розміщення на 2 основних місця з урахуванням дітей з оплатою
Налаштування розміщення на 2 основних місця з урахуванням дітей з оплатою та додаткового місця
Інші типи умов розміщення необхідно налаштовувати за аналогією.
> Примітка! Умови розміщення в OTA тарифах повинні на 100% відповідати тим, що вказані в цьому розділі. Якщо в тарифі умова відрізнятиметься від зазначеної, вартість нараховуватиметься некоректно.
Створення ОТА-каналу в Servio HMS
Щоб налаштувати канал OTA, виконайте наступне:
- Оберіть потрібний канал.
- Додайте канал у систему.
- Увімкніть галочки/параметри, які відмічені на скріншотах нижче.
Налаштування ExternalConnectionService
В екстерналі вмикаємо все, як на прикладі нижче і перезапускаємо службу
![]()
Особливості роботи
Тимчасові бронювання автоматично не анулюються в Servio HMS.
Якщо гість не завершив бронювання, інформацію про ануляцію надсилатиме OTA-канал.
Тому вручну втручатися не потрібно — система обробляє зміни, отримані від OTA.


