Налаштування OTA Bronui.com: відмінності між версіями

Матеріал з expertsolution
Перейти до навігації Перейти до пошуку
(Створена сторінка: =Загальна інформація про Bronui= Для початку треба щоби було що з’єднувати. Отже у вас мають бути створені та налаштовані категорії номерів та тариф в Bronui.com (посилання https://extranet.dev.bronui.com/). = Налаштування номерів = Для створення категорії номеру потрібно п...)
 
Немає опису редагування
 
(Не показано одну проміжну версію цього користувача)
Рядок 1: Рядок 1:
=Загальна інформація про Bronui=
= Налаштування інтеграції =
Для початку треба щоби було що з’єднувати. Отже у вас мають бути створені та налаштовані категорії номерів та тариф в Bronui.com (посилання https://extranet.dev.bronui.com/). 
 
= Налаштування номерів =
== Загальна інформація про Bronui ==
Для створення категорії номеру потрібно перейти на сторінку '''Налаштування номерів''' та натиснути '''Додати тип номеру'''<br>
Для початку необхідно, щоб у 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.bronui.com/external-provider/
'''Уважно перевірити щоб не була встановленна тестова адреса сервісу 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.
= Типові помилки та рішення =

Поточна версія на 14:19, 9 березня 2026

Налаштування інтеграції

Загальна інформація про Bronui

Для початку необхідно, щоб у Bronui.com були створені та налаштовані категорії номерів і тарифи. Інтеграція працює коректно лише за умови, що всі об’єкти розміщення активні та доступні для продажу.

Вхід до екстранету Bronui.com: https://extranet.dev.bronui.com/

---

Налаштування номерів

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


Add.png

Після створення категорії номеру необхідно:

  • вказати назву категорії;
  • задати максимальну кількість гостей;
  • зберегти зміни.

---

Налаштування тарифів

Для створення тарифу необхідно перейти до розділу Тарифів та натиснути кнопку Додати тариф.
Addter.png
Під час створення тарифу необхідно:

  • вказати назву тарифу;
  • обрати типи харчування.

Створений тариф необхідно активувати, щоб він був доступний для синхронізації.

Умови підключення

Крок 1. Параметри системи

Перейдіть до розділу Налаштування → Параметри системи → Інсталяції (default) та встановіть параметри, як зазначено нижче.


Parametrs.png

Уважно перевірити щоб не була встановленна тестова адреса сервісу https://api.dev.bronui.com/external-provider/  
  • Доступність використання OTA Bronui — увімкнути чекбокс.
  • Інтервал запиту бронювань з OTA Bronui, с — 60
  • Інтервал синхронізації даних з OTA Bronui, с — 60
 Значення за замовчуванням, змінювати не рекомендується.
 

Крок 2. Створення маппінгу готелю

Для коректної роботи інтеграції необхідно виконати маппінг готелю між сервісом та Bronui.com.

Перейдіть за шляхом: Налаштування → OTA канали → Bronui

На вкладці Bronui відображено два блоки:

  • список готелів;
  • додавання маппінгу готелю.


Ota11.png
Для створення маппінгу:

  • оберіть свій готель з випадаючого списку;
  • логін та пароль для API використовуйте ті, які ви отримали від служби підтримки Bronui;
  • у полі Зовнішній код внесіть код вашого готелю, який ви отримали від служби підтримки;
  • Збережіть зміни.

Після створення маппінгу готель стає доступним для подальшого зіставлення номерів і тарифів.

Крок 3. Синхронізація Servio HMS з Bronui

Після налаштування маппінгу готелю необхідно виконати співставлення даних між Servio HMS та Bronui.com.

Співставлення категорій номерів

Для налаштування синхронізації категорій номерів необхідно співставити категорії, які передаються по API Bronui, з категоріями HMS. Див. приклад на скріні:
Mappingroom.png
Покрокові дії:

  1. Увімкніть чекбокс напроти категорії номеру (пункт 1).
  2. Натисніть на випадаючий список (пункт 2).
  3. Оберіть відповідну категорію номеру (пункт 3).
  4. Натисніть Зберегти.

Співставлення тарифів

Для налаштування синхронізації тарифів необхідно співставити тарифи, які передаються по API Bronui, з тарифами HMS. Див. приклад на скріні:
Screenshot Rates.png
Покрокові дії:

  1. Натисніть Редагувати поруч із тарифом.
  2. Увімкніть чекбокс напроти тарифу.
  3. Відкрийте випадаючий список.
  4. Оберіть тариф відповідно наданому коду тарифу з Bronui.
  5. Натисніть Зберегти.

Співставлення умов розміщення

Для налаштування синхронізації умов розміщення необхідно співставити умови, які передаються по API Bronui, з умовами HMS. Див. приклад на скріні:
Roz.png

Покрокові дії:

  1. Оберіть тариф у маппінгу умов розміщення.
  2. Активуйте чекбокс умови розміщення.
  3. Натисніть на випадаючий список.
  4. У дропдауні оберіть відповідний код умови розміщення з Bronui.
  5. Натисніть Зберегти.

Створення умов розміщення

Для коректної роботи синхронізації необхідно, щоб умови розміщення в HMS та Bronui відповідали одна одній.

  • Перейдіть за посиланням: Налаштування → OTA канали → Умови розміщення.
  • На вкладці розташовано два блоки:
  1. Довідник умов розміщення;
  2. Додавання (Редагування) умов розміщення.

Параметри для налаштування умови розміщення

  • Назва — вказуємо назву умови розміщення.
  • Скорочення — скорочена назва умови.
  • Тип розміщення — кількість людей,відповідна до основних місць в номері.
  • Категорія номеру — з випадаючого списку обираємо категорію номеру, для якої ця умова буде застосована.
  • Дорослих — кількість дорослих, що розташовуються в номері за цією умовою.
  • Дітей — кількість дітей.
  • Дітей з оплатою — кількість дітей, для яких нараховується повноцінний пакет проживання (не може перевищувати кількість у полі "Дітей").
  • Місця — загальна кількість основних місць у номері.
  • Дод. місця — кількість додаткових місць у номері (якщо передбачено).
  • По місцях — встановлюється чекбокс, якщо вартість передаватиметься за місце, а не за номер цілком.
  • Додаткове місце — встановлюється чекбокс, якщо в номері передбачені додаткові місця.
  • Підкласи послуг — послуги, які передаватимуться до OTA каналу для нарахування вартості для даної умови розміщення.

Налаштування розміщення на 2 основних місця


Placement conditions 1.png

Налаштування розміщення на 2 основних місця з урахуванням дітей з оплатою


Placement conditions 2.png

Налаштування розміщення на 2 основних місця з урахуванням дітей з оплатою та додаткового місця


Placement conditions 3.png

Інші типи умов розміщення необхідно налаштовувати за аналогією.

> Примітка! Умови розміщення в OTA тарифах повинні на 100% відповідати тим, що вказані в цьому розділі. Якщо в тарифі умова відрізнятиметься від зазначеної, вартість нараховуватиметься некоректно.

Створення ОТА-каналу в Servio HMS

Щоб налаштувати канал OTA, виконайте наступне:

  • Оберіть потрібний канал.
  • Додайте канал у систему.
  • Увімкніть галочки/параметри, які відмічені на скріншотах нижче.

Screenshot 2.png
Screenshot 31.png

Налаштування ExternalConnectionService

В екстерналі вмикаємо все, як на прикладі нижче і перезапускаємо службу
External.png

Особливості роботи


Тимчасові бронювання автоматично не анулюються в Servio HMS.
Якщо гість не завершив бронювання, інформацію про ануляцію надсилатиме OTA-канал.
Тому вручну втручатися не потрібно — система обробляє зміни, отримані від OTA.

Типові помилки та рішення