Налаштування YieldPlanet: відмінності між версіями

Матеріал з expertsolution
Перейти до навігації Перейти до пошуку
 
(Не показані 35 проміжних версій 3 користувачів)
Рядок 1: Рядок 1:
== Створення кабінету в YieldPlanet ==
‎<languages />
=== Заповнення опитувального листа ===
 
<translate>
 
== Створення кабінету в YieldPlanet == <!--T:16-->
 
<!--T:17-->
=== Заповнення опитувального листа ===  
[[Файл:YieldPlanet screenshot 1.png|800px|border]]<br>
[[Файл:YieldPlanet screenshot 1.png|800px|border]]<br>
* Також треба заповнити інформацію, яку служба підтримки внесе як базову в YieldPlanet при створені. Якщо чогось не буде внесено, то прийдеться самому все добавляти.<br>
* Також треба заповнити інформацію, яку служба підтримки внесе як базову в YieldPlanet при створені. Якщо чогось не буде внесено, то прийдеться самому все добавляти.<br>
[[Файл:YieldPlanet screenshot 2.png|800px|border]]<br>
[[Файл:YieldPlanet screenshot 2.png|800px|border]]<br>
</translate>
<translate>


=== Створення кабінету, відправлення опитувального листа ===
<!--T:18-->
=== Створення кабінету, відправлення опитувального листа ===  
Для того, щоб створити кабінет, необхідно мати заповнений опитувальний лист та надіслати його на пошту implementation@yieldplanet.com з наступним тілом листа.
Для того, щоб створити кабінет, необхідно мати заповнений опитувальний лист та надіслати його на пошту implementation@yieldplanet.com з наступним тілом листа.
Hello!<br>
Hello!<br>
This is a new hotel in the city of ''назва міста''. Please create new accounts for ''назва готелю''.<br>
This is a new hotel in the city of ''назва міста''. Please create new accounts for ''назва готелю''.<br>
Details in attachment.<br>
Details in attachment.<br>
Please connect user support@servio.com.ua to a new ''назва готелю'', ''назва міста'' (for API Servio_HMS).<br>
Please connect user support@servio.com.ua to a new ''назва готелю'', ''назва міста'' (for API Servio_HMS).<br>
Please install the Standard version або Box version.<br>
Please install the Standard version або Box version.<br>
Please add my account for ''назва готелю''.<br>
Please add my account for ''назва готелю''.<br>
''вашапошта''@servio.com.ua<br>
''вашапошта''@servio.com.ua<br>
Thanks!<br>
Thanks!<br>
=== Створення маппінгу готелю ===
</translate>
Треба вибрати готель, прописати логін і пароль від спеціального прописаного користувача через який буде відбуватись обмін даними, а також внести ID готелю, який можна дізнатися в кабінеті Yield Planet. Якщо ціна номера залежить від кількості місць, то тоді включаємо галочку “Оновлення по розміщенню”<br>
<translate>
[[Файл:YieldPlanet screenshot 3.png|800px|border]]<br>
 
 
=== Створення маппінгу готелю === <!--T:19-->
 
<!--T:5-->
Для створення маппінгу номерів, необхідно перейти за помиланнями: Налаштування→ОТА каналт→YieldPlanet.<br>
На вкладці YieldPlanet  відображено 2 блоки:
# Список готелів;
# Додаваня маппінгу готелю.<br>
[[Файл:Mapping.png|1200px|border]]<br>
Всі обов'язкові поля для заповнення позначені зірочкою. Для того, аби додати маппінг готелю необхідно в полі "Готель" з випадаючого списку обрати готельне підприємство, для якого буде додано маппінг. В поля "Логін" та "Пароль" вказати відповідні дані, за допомогою якого в подальшому буде здійснюватися обмін даними, а також в поле "Зовнішній код" внести ID готелю, який можна дізнатися в кабінеті Yield Planet.  
Якщо вартість номера буде залежити від кількості проживаючих гостей, то тоді необхідно встановити галочку “Оновлення по розміщенню” <br>
[[Файл:Mapping new.png|1000px|border]]<br>
</translate>
<translate>


=== Створення послуг ===
Створюємо потрібну кількість послуг, які треба синхронізувати з Yield Planet, це стосується додаткових послуг<br>
[[Файл:YieldPlanet screenshot 4.png|800px|border]]<br>


=== Створення умов розміщення ===
<!--T:20-->
=== Створення умов розміщення ===  
Налаштування умов розміщення впливає на синхронізацію даних між HMS та YieldPlannet. В залежності від вказаних умов розміщення, буде передаватися вартість на проживання за номер.<br>
Для сказування умов переходимо за посиланнями Налаштування→ОТА каанли→Умови розміщення. На вкладці розташовано 2 блоки:
* Довідник умов розміщення;
* Додавання (Редагуванян) умов розиміщення.
[[Файл:Placement conditions.png |1200px|border]]<br>
Додаємо кількість умов, яка потрібна для синхронізації з YieldPlanet, якщо окремо пакетні і не пакетні умови, то треба створювати умови з різними підкласами послуг.<br>
Додаємо кількість умов, яка потрібна для синхронізації з YieldPlanet, якщо окремо пакетні і не пакетні умови, то треба створювати умови з різними підкласами послуг.<br>
'''''Примітка!''''' У випадку якщо помлуга пакетна, то в полі "Підкласи послуг" вказуємо лише цю послугу. Якщо послуги індивідуальні, не пакетні то необхідно додавати декілька підкласів, за умови, якщо вони мають враховуватися у вартість.<br>
Параметри для налаштування умови розміщення:
* Назва - вказуємо назву умови розміщення;
* Скорочення - скорочена назва умови;
* Тип розміщення - кількість людей, що можуть розташовуватися в номері;
* Категорія номеру - з випадаючого списку, обираємо категорію номеру, для якого ця умова буде застосована;
* Дорослих - необхідно вказати скільки дорослих буде розташовано в номері за даною умовою;
* Дітей - кількість дітей.
* Дітей з оплатою - кількість дітей, для яких буде нараховано повноцінний пакет проживання (показник в полі "Дітей з оплатою" не може бути більше ніж показник в полі "Дітей");
* Місця - загальна кількість основних місць в номері;
* Дод. місця - кількість додаткових місць в номері (якщо це передбачено);
* По місцях - встановлюється чекбокс у випадку, якщо вартість передаватиметься за місце, а не за номер в цілому;
* Додаткове місце - встановлюється чекбокс, якщо в номері передбачені додаткові місця;
* Підкласи послуг - Послуги, які передаватимуться до ОТА каналу для нарахування вартості для даної умови проживання.<br>
[[Файл:YieldPlanet screenshot 5.png|800px|border]]<br>
[[Файл:YieldPlanet screenshot 5.png|800px|border]]<br>
Розглянемо декілька варіантів для налаштування розміщення.<br>
</translate>
<translate>
<!--T:21-->
==== Налаштування розміщення на 2 основних місця: ====
<br>
[[Файл:Placement conditions 1.png|800px|border]]
<br>
</translate>
<translate>
<!--T:22-->
==== Налаштування розміщення на 2 основних місця враховуючи дітей з оплатою: ====
<br>
[[Файл:Placement conditions 2.png|800px|border]]
<br>
</translate>
<translate>
<!--T:23-->
==== Налаштування розміщення на 2 основних місця враховуючи дітей з оплатою та додаткове місце: ====
<br>
[[Файл:Placement conditions 3.png|800px|border]]
<br>
Інші типи умови розміщення необхідно налаштовувати за аналогією.
<!--T:24-->
'''''Примітка!''''' Умови розміщення в ОТА тарифах мають на 100% відповідати, тим що вказані в даному розділі. Якщо в тарифі умова відрізнятиметься від умови вказаної в "Умови розміщення" вартість нараховуватиметься не коректно.
</translate>
<translate>


=== Створення ОТА-тарифів ===
Робите по прикладу нижче, в умовах, яких потрібно включаєте синхронізацію<br>
[[Файл:YieldPlanet screenshot 6.png|800px|border]]<br>


== Створення ОТА-каналу в Servio HMS ==
<!--T:25-->
== Створення ОТА-каналу в Servio HMS ==  
 
Вибираєте потрібний канал, додаєте його, а потім включаєте галочки, які відмічені нижче.<br>
Вибираєте потрібний канал, додаєте його, а потім включаєте галочки, які відмічені нижче.<br>
[[Файл:YieldPlanet screenshot 7.png|800px|border]]<br>
[[Файл:YieldPlanet screenshot 7.png|800px|border]]<br>
[[Файл:YieldPlanet screenshot 8.png|800px|border]]<br>
[[Файл:YieldPlanet screenshot 8.png|800px|border]]<br>
</translate>
<translate>


== Синхронізація Servio HMS з Yield Planet ==
== Синхронізація Servio HMS з Yield Planet ==  
Вносимо відповідні ID із YieldPlanet в Servio HMS, після внесення перепровірте і збережіть зміни.<br>
Вносимо відповідні ID із YieldPlanet в Servio HMS, після внесення перепровірте і збережіть зміни.<br>
[[Файл:YieldPlanet screenshot 9.png|800px|border]]<br>
[[Файл:YieldPlanet screenshot 9.png|800px|border]]<br>
</translate>
<translate>


== Відключення тригерів в БД Servio HMS ==
<!--T:27-->
== Відключення тригерів в БД Servio HMS ==  
Відкриваємо через БД два тригери і змінюємо в них статус з 0 на 1, для того, щоб вони почали автоматично передавати ціну
Відкриваємо через БД два тригери і змінюємо в них статус з 0 на 1, для того, щоб вони почали автоматично передавати ціну
і доступність, нижче скріншот з прикладом.<br>
і доступність, нижче скріншот з прикладом.<br>
[[Файл:YieldPlanet screenshot 10.png|800px|border]]<br>
[[Файл:YieldPlanet screenshot 10.png|800px|border]]<br>
</translate>
<translate>


== Налаштування ExternalConnectionService та CM_Settings ==
<!--T:28-->
== Налаштування ExternalConnectionService та CM_Settings ==  
В екстерналі включаємо все, як на прикладі нижче і перезапускаємо службу<br>
В екстерналі включаємо все, як на прикладі нижче і перезапускаємо службу<br>
[[Файл:YP external.png|800px|border]]<br>
[[Файл:YieldPlanet screenshot 11.png|800px|border]]<br>
В CM_Settings налаштовуємо, підставляючи свої значення по прикладу нижче і перезапускаємо службу.<br>
В CM_Settings налаштовуємо, підставляючи свої значення по прикладу нижче і перезапускаємо службу.<br>
[[Файл:YP CM Settings.png|800px|border]]<br>
[[Файл:YieldPlanet screenshot 12.png|800px|border]]<br>
== Передача цін і доступності за допомогою ChannelMappingTestApp ==
</translate>
Спочатку шукаємо програму на WebDav, 1-ому хостингу або в папці Services у готелів на хостингах. Включаємо програму і змінюємо на правильний порт, вибираємо канал і тиснемо “Завантажити список готелів”:<br>
<translate>
[[Файл:YP TestForm.png|800px|border]]<br>
Переходимо в YieldPlanet для ручного заповнення даних(1-ий раз, далі автоматично буде завантажувати):<br>
[[Файл:YP заповнення цін.png|800px|border]]<br>
[[Файл:YP заповнення цін 2.png|800px|border]]<br>
Перевіряємо, що ціни і доступність заповнились в YP:<br>
[[Файл:YP перевірка цін.png|800px|border]]<br>
Далі переходимо в ChannelManagerTestApp:<br>
[[Файл:Channel mapping test form.png|800px|border]]<br>
- Якщо ціна залежить від кількості основних місць, то необхідно написати листа на implementation@yieldplanet.com з наступним змістом:<br>
Hello!<br>


Please turn on employment based pricing mode (no formula)<br>
<!--T:29-->
''ID готелю'', ''назва готелю'' <br>
== Передача цін і доступності ==
Починаючи з версії 06.01.145 реалізовано можливість робити перерахунок та синхронізацію цін, доступності для ОТА-каналів інтерфейсно в HMS.<br>
Для цього переходимо на сторінку Налаштування\OTA-канали.<br>
Обираємо зі списку необхідний OTA-канал та відкриваємо його на редагування.<br>
[[Файл:Список OTA.png|1200 px|]]<br>
Скролимо в низ сторінки до блоку "Завдання синхронізації".<br>
[[Файл:Блок Завдання синхронізації.png|1200px|]]<br>
В цьому блоці доступні параметри:<br>
Випадаючий список "Тип завдання", що має три завдання:<br>
1. "Синхронізувати категорії кімнат" - відповідає за перерахунок статистики доступності кімнат у готелі та створює завдання для синхронізації доступності з OTA-каналом.<br>
2. "Перерахувати ціни" - відповідає за перерахунок цін у готелі.<br>
3. "Синхронізувати OTA-тариф" - відповідає за створення завдання синхронізації цін готелю з OTA-каналом.<br>
[[Файл:Тип завдання.png|800 px|]]<br>
'''ВАЖЛИВО!!!''' ''Для синхронізації цін, спершу їх потрібно перерахувати. Тому спершу необхідно виконати завдання "Перерахувати ціни", а після перерахунок синхронізувати ОТА-тарифи''<br>


Thanks!<br>
Наступний параметр селектор календаря, в якому обиарється період для перерахунку і синхронізації.<br>


- Далі включити параметр в Servio HMS:<br>
Наступний параметр "OTA-тариф" (якщо обрано тип завдання "Перерахувати ціни" або "Синхронізувати ОТА-тарифи") або "Категорія кімнати"(Якщо обрано тип завдання "Синхронізувати категорії кімнат")<br>
[[Файл:YP оновлення по розміщенню.png|800px|border]]<br>
Якщо обрано тип завдання "Перерахувати ціни" або "Синхронізувати ОТА-тарифи" - підтьгуються доступні для синхронзації ОТА-тарифи.<br>
- Переходимо в YieldPlanet і пробуємо витягнути категорії і тарифні плани каналів, якщо не виходить, то причин може бути декілька:
</translate>
<translate>


# Невірні дані були в опитувальному листі(login, password, hotelid), можна змінити вручну в налаштуваннях каналу, або через службу підтримки YieldPlanet, перевірити дані можна через вхід в екстранет конкретного каналу;
== Мапінг категорій і цін між каналами продажу та Yield Planet ==  
# Клієнт не подав запит на інтеграцію каналу із менеджером каналів продажів YieldPlanet, це мають робити вони, окрім каналу Servio Reservation наприклад, там ми пишемо представникам RoomsWizard.<br>
[[Файл:YieldPlanet screenshot 23.png|800px|border]]<br>
[[Файл:YP channel.png|800px|border]]<br>
- Якщо категорії вдалось витягнути, а треба по основних місцях ділити ціну, то треба вручну створити пусті категорії в каналі і підтягнути туди ID і назву існуючої, тільки через кому після ID - вказати кількість основних місць:<br>
[[Файл:YP кількість місць.png|800px|border]]<br>
- Після додавання нових категорій в каналі продажу, також треба відредагувати категорію в YieldPlanet(після листа на підтримку для включення ціни по основних місцях - категорії в YP змінять властивості, треба їх активувати):<br>
[[Файл:YP основні місця.png|800px|border]]<br>
- Після перероблення категорій на ціну по к-кстю основних місць, повторно вивантажуємо ціну, бо до цього вона була тільки за номер, а тепер треба передати за кожне місце окремо:<br>
[[Файл:Channel mapping test form.png|800px|border]]<br>
== Мапінг категорій і цін між каналами продажу та Yield Planet ==
[[Файл:YP таблиця відповідності.png|800px|border]]<br>
- Уважно створюємо мапінг по прикладу, перед цим обов’язково передивіться ціни і доступність в YieldPlanet(після створення мапінгу - дані відразу автоматично відправляться на канал):<br>
- Уважно створюємо мапінг по прикладу, перед цим обов’язково передивіться ціни і доступність в YieldPlanet(після створення мапінгу - дані відразу автоматично відправляться на канал):<br>
[[Файл:YP редагування відповідності.png|800px|border]]<br>
[[Файл:YieldPlanet screenshot 24.png|800px|border]]<br>
- Якщо канал не активований, то пишемо листа на активацію каналу на пошту implementation@yieldplanet.com з наступним змістом:<br>
- Якщо канал не активований, то пишемо листа на активацію каналу на пошту implementation@yieldplanet.com з наступним змістом:<br>
Hello!
Hello!
Please activate the channel
Please activate the channel
ID каналу, назва каналу
ID каналу, назва каналу
for ID готелю, назва готелю.
for ID готелю, назва готелю.
Thanks!<br>
Thanks!<br>
- Після активації в YieldPlanet - значки каналів будуть синього кольору і в канали буде надсилатись інформація:<br>
- Після активації в YieldPlanet - значки каналів будуть синього кольору і в канали буде надсилатись інформація:<br>
[[Файл:YP панель моніторинга.png|800px|border]]<br>
[[Файл:YieldPlanet screenshot 25.png|800px|border]]<br>
</translate>

Поточна версія на 15:00, 3 березня 2026

Інші мови:


Створення кабінету в YieldPlanet

Заповнення опитувального листа

YieldPlanet screenshot 1.png

  • Також треба заповнити інформацію, яку служба підтримки внесе як базову в YieldPlanet при створені. Якщо чогось не буде внесено, то прийдеться самому все добавляти.

YieldPlanet screenshot 2.png


Створення кабінету, відправлення опитувального листа

Для того, щоб створити кабінет, необхідно мати заповнений опитувальний лист та надіслати його на пошту implementation@yieldplanet.com з наступним тілом листа. Hello!
This is a new hotel in the city of назва міста. Please create new accounts for назва готелю.
Details in attachment.
Please connect user support@servio.com.ua to a new назва готелю, назва міста (for API Servio_HMS).
Please install the Standard version або Box version.
Please add my account for назва готелю.
вашапошта@servio.com.ua
Thanks!


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

Для створення маппінгу номерів, необхідно перейти за помиланнями: Налаштування→ОТА каналт→YieldPlanet.
На вкладці YieldPlanet відображено 2 блоки:

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

Mapping.png
Всі обов'язкові поля для заповнення позначені зірочкою. Для того, аби додати маппінг готелю необхідно в полі "Готель" з випадаючого списку обрати готельне підприємство, для якого буде додано маппінг. В поля "Логін" та "Пароль" вказати відповідні дані, за допомогою якого в подальшому буде здійснюватися обмін даними, а також в поле "Зовнішній код" внести ID готелю, який можна дізнатися в кабінеті Yield Planet. Якщо вартість номера буде залежити від кількості проживаючих гостей, то тоді необхідно встановити галочку “Оновлення по розміщенню”
Mapping new.png


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

Налаштування умов розміщення впливає на синхронізацію даних між HMS та YieldPlannet. В залежності від вказаних умов розміщення, буде передаватися вартість на проживання за номер.
Для сказування умов переходимо за посиланнями Налаштування→ОТА каанли→Умови розміщення. На вкладці розташовано 2 блоки:

  • Довідник умов розміщення;
  • Додавання (Редагуванян) умов розиміщення.

Placement conditions.png
Додаємо кількість умов, яка потрібна для синхронізації з YieldPlanet, якщо окремо пакетні і не пакетні умови, то треба створювати умови з різними підкласами послуг.
Примітка! У випадку якщо помлуга пакетна, то в полі "Підкласи послуг" вказуємо лише цю послугу. Якщо послуги індивідуальні, не пакетні то необхідно додавати декілька підкласів, за умови, якщо вони мають враховуватися у вартість.
Параметри для налаштування умови розміщення:

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

YieldPlanet screenshot 5.png
Розглянемо декілька варіантів для налаштування розміщення.


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


Placement conditions 1.png

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


Placement conditions 2.png


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


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

Примітка! Умови розміщення в ОТА тарифах мають на 100% відповідати, тим що вказані в даному розділі. Якщо в тарифі умова відрізнятиметься від умови вказаної в "Умови розміщення" вартість нараховуватиметься не коректно.


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

Вибираєте потрібний канал, додаєте його, а потім включаєте галочки, які відмічені нижче.
YieldPlanet screenshot 7.png
YieldPlanet screenshot 8.png

Синхронізація Servio HMS з Yield Planet

Вносимо відповідні ID із YieldPlanet в Servio HMS, після внесення перепровірте і збережіть зміни.
YieldPlanet screenshot 9.png


Відключення тригерів в БД Servio HMS

Відкриваємо через БД два тригери і змінюємо в них статус з 0 на 1, для того, щоб вони почали автоматично передавати ціну і доступність, нижче скріншот з прикладом.
YieldPlanet screenshot 10.png

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

В екстерналі включаємо все, як на прикладі нижче і перезапускаємо службу
YieldPlanet screenshot 11.png
В CM_Settings налаштовуємо, підставляючи свої значення по прикладу нижче і перезапускаємо службу.
YieldPlanet screenshot 12.png

Передача цін і доступності

Починаючи з версії 06.01.145 реалізовано можливість робити перерахунок та синхронізацію цін, доступності для ОТА-каналів інтерфейсно в HMS.
Для цього переходимо на сторінку Налаштування\OTA-канали.
Обираємо зі списку необхідний OTA-канал та відкриваємо його на редагування.
Список OTA.png
Скролимо в низ сторінки до блоку "Завдання синхронізації".
Блок Завдання синхронізації.png
В цьому блоці доступні параметри:
Випадаючий список "Тип завдання", що має три завдання:
1. "Синхронізувати категорії кімнат" - відповідає за перерахунок статистики доступності кімнат у готелі та створює завдання для синхронізації доступності з OTA-каналом.
2. "Перерахувати ціни" - відповідає за перерахунок цін у готелі.
3. "Синхронізувати OTA-тариф" - відповідає за створення завдання синхронізації цін готелю з OTA-каналом.
Тип завдання.png
ВАЖЛИВО!!! Для синхронізації цін, спершу їх потрібно перерахувати. Тому спершу необхідно виконати завдання "Перерахувати ціни", а після перерахунок синхронізувати ОТА-тарифи

Наступний параметр селектор календаря, в якому обиарється період для перерахунку і синхронізації.

Наступний параметр "OTA-тариф" (якщо обрано тип завдання "Перерахувати ціни" або "Синхронізувати ОТА-тарифи") або "Категорія кімнати"(Якщо обрано тип завдання "Синхронізувати категорії кімнат")
Якщо обрано тип завдання "Перерахувати ціни" або "Синхронізувати ОТА-тарифи" - підтьгуються доступні для синхронзації ОТА-тарифи.

Мапінг категорій і цін між каналами продажу та Yield Planet

YieldPlanet screenshot 23.png
- Уважно створюємо мапінг по прикладу, перед цим обов’язково передивіться ціни і доступність в YieldPlanet(після створення мапінгу - дані відразу автоматично відправляться на канал):
YieldPlanet screenshot 24.png
- Якщо канал не активований, то пишемо листа на активацію каналу на пошту implementation@yieldplanet.com з наступним змістом:
Hello! Please activate the channel ID каналу, назва каналу for ID готелю, назва готелю. Thanks!
- Після активації в YieldPlanet - значки каналів будуть синього кольору і в канали буде надсилатись інформація:
YieldPlanet screenshot 25.png