expertsolution - Внесок користувача [uk]

Demo Servio HMS

2026-03-24T11:59:09Z

Lashta.v:

<languages/>

<translate>
== Демо-доступ до готельної системи ==

https://hms9.servio.support/HMS_Demo/Login.aspx 
Логін: Demo1 
Пароль: 1111 

'''<big>Демо-доступ до нової готельної системи</big>'''

https://hmsqatest.servio.support/HMSDEMOCRM 
Логін: User1 
Пароль: m5?BEt 

'''<big>Демо модуля бронювання</big>'''

https://serviobooking.com/ServioQR/hms/booking/66E99440-F1EA-454E-8481-4CC4CD150D17

</translate>

ПрограмаЛояльності

2026-03-19T11:15:17Z

Lashta.v:

=Опис взаємодії=
Взаємодія системи HMS Servio і Servio Restaurant із процесинговим центром відбуватиметься через звернення цих систем до WCF служби процесингу за протоколом JSON, кодування передавання даних UTF8, методом POST.
Для цього протоколу всі типи і значення повинні передаватися в текстовому поданні. Тому необхідно використовувати такі формати для текстового представлення даних таких типів:
1. datetime - строкове подання дати у форматі "yyyy-MM-dd HH:mm:ss"
2. decimal - 18.2 - використовується округлення до 2х знаків після коми, як роздільник цілої та дробової частини виступає "." (крапка)
3. int - стандартне десяткове строкове подання цілого числа
4. string[N] - обмежений за розміром рядок, розмір рядка плаваючий від 0 до N символів.
5. string - необмежений за розміром рядок, розмір рядка плаваючий від 0 до 8000 символів.
6. bool - строкове представлення логічного типу, де "1" - істина (true), "0" - брехня (false)
Приклад запиту і відповіді у форматі JSON: запит
POST http://localhost:8000/ServioLoyaltyService/PayBonusesRequest
Content-Type: application/json; charset=utf-8
Host: localhost:8000
Content-Length: 241
Connection: Keep-Alive
{"MagneticCardID": "5", "Transactions":[{"Sum": "300.3", "ServiceGroupID": "3"}]}
результат HTTP/1.1 200 OK
Content-Length: 186
Content-Type: application/json; charset=utf-8
Сервер: Microsoft-HTTPAPI/2.0
Дата: Wed, 06 Sep 2023 11:58:56 GMT
{"Error":null,"MagneticCardID":5,"BonusBalance":0.00,"UserName":"666
666","Transactions":[{"BonusesToPay":0.00,"ServiceGroupID":3,"Sum":300.3,"TransactionDate":
"2023-09-06 14:58:56"}]}

=Функції протоколу=
Протокол обміну представлений у вигляді окремих відкритих функцій, до яких може будьякий клієнт POS системи.

==Get_eWallet_Info==
Метод за номером магнітної картки та\або ідентифікатором компанії та\або кодом бронювання та\або коротким номером картки з програмою лояльності повертає
інформацію щодо картки, учасника, якому вона належить, транзакцій і налаштувань програми лояльності.
Метод підходить для POS і HMS.

'''Вхідні параметри:'''
• string[32] POSCode - унікальний код POS системи, за яким шукається зв'язка POS системи та користувача програми лояльності. (Не впливає на виконання запиту)
• int? CompanyAccount - ідентифікатор компанії HMS Servio.
• string[20] AuthCode - код бронювання. (Не впливає на виконання запиту)
• string[20] SynkLoyaltyCode - код синхронізації програми лояльності. (Не впливає на виконання запиту)
• string[50] CardNumber - повний номер картки, за повним збігом якого шукають магнітну картку, що належить учаснику програми лояльності.
• string[30] ShortCardNumber - короткий номер картки, за повним збігом якого (за наявності) шукають магнітну картку, що належить учаснику програми лояльності.
• string[30] PhoneNumber - номер телефону, перевіряє збіг за останніми 9 цифрами з контактом або компанією програмою лояльності
• int? PersonID - ІД персони

'''Результат функції:'''
• string Error - опис помилки, що виникла
• eWallet[] eWallets - масив описів електронних гаманців eWallet. Елементи масиву структури з такими полями:
◦ int eWalletID - ID електронного гаманця o string[100] LoyaltyProgramName - назва програми лояльності
(string.Empty) o string[50] BonusStatusName - назва статусу програми лояльності o decimal BonusBalance - поточний бонусний баланс електронного гаманця o decimal AccumulatedBonuses - поточна кількість накопичених бонусів електронного гаманця
◦ string[50] DiscountStatusName - назва статусу програми лояльності o string[20] DiscountPriceListCode - код прейскуранта поточного дисконтного статусу, потрібен для синхронізації знижки за прейскурантом, якщо гаманець відноситься до дисконтної програми і для нього заведений код прейскуранта. (string.Empty)
◦ decimal DiscountTransactionsSum - сума всіх неанульованих транзакцій з урахуванням знижки, проведених для цього гаманця
◦ string[20] ServioSynkCode - код синхронізації програми лояльності o int? CompanyAccount - ідентифікатор компанії HMS Servio.
◦ string[30] MagneticCardShortNumber - короткий номер магнітної картки o string[30] MagneticCardFullNumber - довгий номер магнітної картки o decimal BonusSum - сума бонусів o decimal PaySum - сума на платіжній картці o decimal Credit - сума кредиту o decimal Accumulation - сума оборотів за карткою
◦ bool IsPayCard - прапор, що визначає налаштування лояльності "Робота з грошовими коштами"
◦ decimal ExtraMoneySum - сума екстра-грошей o bool IsSmartCard - ознака смарт карти (false)
◦ string ShortCode - короткий номер магнітної картки o decimal DayLimit - ліміт списання за день
◦ decimal WeekLimit - ліміт списання за тиждень o decimal MonthLimit - ліміт списання за місяць
◦ decimal YearLimit - ліміт списання за рік o bool UsePayLimits - ознака використання лімітів списання (false)
◦ bool UseCatLimits - ознака використання лімітів категорій (false)
◦ datetime ValidityStart - дата початку дії картки/сертифіката o datetime Validity - дата закінчення дії картки/сертифіката o bool Issue - ознака Issued (false)
◦ int Cardid - ІД картки
◦ string Comment - коментар (string.Empty)
◦ string Description - Примітка (string.Empty)
◦ decimal Discount - розмір знижки за карткою (0)
◦ string SynkLoyaltyCode - код лояльності з налаштувань програми лояльності
◦ int RoomNightBalance - кількість безкоштовних номероночей учасника o int MagneticCardID - ідентифікатор картки
◦ string UserName - ім'я власника
◦ string MobilePhone - номер телефону
◦ int DiscountGroupID - ідентифікатор дисконтної групи
◦ bool IsBonusProgram - приналежність до бонусної системи
◦ bool IsDiscountProgram - приналежність до дисконтної системи
◦ bool IsActive - ознака активності
За вхідними даними система шукає учасників, інформацію про них і налаштування програми лояльності в базі даних.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Discount_Transaction_eWallet_Request==
Метод виконує запит інформації щодо можливості надання знижки за ID магнітної картки та списком транзакцій.
Метод підходить для POS і HMS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки програми лояльності.
• string[32] POSCode - унікальний код POS системи, за яким шукається зв'язка POS системи та користувача програми лояльності. (Не впливає на виконання запиту)
• Transaction[] Transactions - масив транзакцій структур Transaction. Структура Transaction має такі поля:
◦ decimal Sum - сума транзакції. o DateTime TransactionDate - дата проведення транзакції в POS-системі. o int ServiceGroupCode - код групи послуг POS-системи.
◦ string[30] POSsystemAccount - Л/Рахунок у POS системі. (Не впливає на виконання запиту)
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Не впливає на виконання запиту)
◦ int BillitemID - ідентифікатор позиції рахунку

'''Результат функції:'''
• string Error - опис помилки, що виникла.
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту.
• int MagneticCardID - ID учасника програми лояльності, якому належить картка із запиту.
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту.
• DiscountTransaction[] DiscountTransactions - масив транзакцій для отримання знижки структур DiscountTransaction. Структура DiscountTransaction має такі поля:
◦ DateTime TransactionDate - дата проведення транзакції.
◦ decimal Sum - сума транзакції. o int ServiceGroupCode - код групи послуг POS-системи.
◦ string[30] POSsystemAccount - Л/Рахунок у POS системі.
◦ decimal Discount - величина знижки у валюті.
◦ decimal DiscountSum - сума транзакції з урахуванням знижки.
◦ string[20] DiscountPriceListCode - код прейскуранта поточного дисконтного статусу, не обов'язковий для заповнення, використовується при акцептуванні транзакцій зі знижкою за прейскурантом.
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Порожнє поле)
◦ string ErrorTransaction - опис помилки, що виникла для конкретної транзакції (Порожнє поле)
◦ int BillitemID - ідентифікатор позиції рахунку
Спочатку відбувається перевірка на дисконтний тип програми, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає карту в базі даних, якщо такої немає або вона неактивна, повертає помилку. Якщо карта є і вона активна, то система розраховує знижки для транзакцій.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Discount_Transaction_eWallet_Accept==
Метод виконує підтвердження надання знижки за ID магнітної картки та списком транзакцій. Метод підходить для POS і HMS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки програми лояльності.
• string[32] POSCode - унікальний код POS системи, за яким шукається зв'язка POS системи та користувача програми лояльності. (Не впливає на виконання запиту)
• int? BillID - ідентифікатор рахунку
• int BaseExternalID - ідентифікатор зовнішньої системи
• DiscountTransaction[] DiscountTransactions - масив транзакцій для отримання знижки структур DiscountTransaction. Структура DiscountTransaction має такі поля: o decimal Sum - сума транзакції.
◦ decimal DiscountSum - сума транзакції зі знижкою. (Не впливає на виконання запиту)
◦ DateTime TransactionDate - дата проведення транзакції.
◦ int ServiceGroupCode - код групи послуг POS системи. (Не впливає на виконання запиту)
◦ string[30] POSsystemAccount - Л/Рахунок у POS системі. (Не впливає на виконання запиту)
◦ decimal Discount - величина знижки у валюті. (Не впливає на виконання запиту)
◦ string[20] DiscountPriceListCode - код прейскуранта поточного дисконтного статусу, не обов'язковий для заповнення, використовується при акцептуванні транзакцій зі знижкою за прейскурантом. (Не впливає на виконання запиту)
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Не впливає на виконання запиту)
◦ десяткова? Quantity - кількість o string ErrorTransaction - опис виниклої помилки для конкретної транзакції. (Не впливає на виконання запиту)
◦ TransactionDetails Details - деталізація позицій рахунку. (Опціонально). Структура TransactionDetails має такі поля:
▪ int BillID - ID рахунку в POS-системі
▪ DateTime BillDate - Дата створення рахунку
▪ int CurrencyCode - Міжнародний код валюти оплати
▪ string ReceiptType - Тип чека
▪ decimal ReceiptSum - Сума чека
▪ string PaymentType - Назва типу оплати
▪ PositionInfo[] Items - Деталізація позицій чека. Структура PositionInfo має такі поля:
• int ItemID - ID нарахування
• int ServiceCode - Код послуги
• string Name - Назва послуги
• string ClassName - Назва класу послуги
• string ClassCode - Код класу послуги
• string SubClassName - Назва підкласу послуги
• string SubClassCode - Код підкласу послуги
• decimal Price - Ціна позиції
• decimal Quantity - Кількість - Кількість
• decimal Total - Підсумкова вартість

'''Результат функції:'''
• string Error - опис помилки, що виникла.
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• decimal PayBonuses - загальна сума знижки за транзакціями із запиту

Спочатку відбувається перевірка на дисконтний тип програми, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає картку в базі даних, якщо такої немає, повертає помилку про відсутність такої картки. Якщо картка є, то система бере учасника за даними з картки, розраховує знижки для транзакцій, додає транзакції в базу даних і оновлює інформацію про учасника в базі даних.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Return_Discount_Transaction_eWallet_Request==
Метод виконує запит інформації щодо можливості повернення транзакцій зі знижкою за ID магнітної картки та списком транзакцій.
Метод підходить для HMS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки програми лояльності.
• string[32] POSCode - унікальний код POS системи, за яким шукається зв'язка POS системи та користувача програми лояльності. (Не впливає на виконання запиту)
• Transaction[] Transactions - масив транзакцій структур Transaction. Структура Transaction має такі поля:
◦ decimal Sum - сума транзакції.
◦ DateTime TransactionDate - дата проведення транзакції в POS системі. (Не впливає на виконання запиту)
◦ int ServiceGroupCode - код групи послуг POS-системи.
◦ string[30] POSsystemAccount - Л/Рахунок у POS системі. (Не впливає на виконання запиту)
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Не впливає на виконання запиту)
◦ decimal DiscountSum - сума транзакції зі знижкою. (Не впливає на виконання запиту)
◦ decimal Discount - величина знижки у валюті. (Не впливає на виконання запиту)
◦ string[20] DiscountPriceListCode - код прейскуранта поточного дисконтного статусу, не обов'язковий для заповнення, використовується при акцептуванні транзакцій зі знижкою за прейскурантом. (Не впливає на виконання запиту) o десяткова? Quantity - кількість
string ErrorTransaction - опис виниклої помилки для конкретної транзакції. (Не впливає на виконання запиту)
◦ TransactionDetails Details - деталізація позицій рахунку. (Опціонально). Структура TransactionDetails має такі поля:
▪ int BillID - ID рахунку в POS-системі
▪ DateTime BillDate - Дата створення рахунку
▪ int CurrencyCode - Міжнародний код валюти оплати
▪ string ReceiptType - Тип чека
▪ decimal ReceiptSum - Сума чека
▪ string PaymentType - Назва типу оплати
▪ PositionInfo[] Items - Деталізація позицій чека. Структура PositionInfo має такі поля:
• int ItemID - ID нарахування
• int ServiceCode - Код послуги
• string Name - Назва послуги
• string ClassName - Назва класу послуги
• string ClassCode - Код класу послуги
• string SubClassName - Назва підкласу послуги
• string SubClassCode - Код підкласу послуги
• decimal Price - Ціна позиції
• decimal Quantity - Кількість - Кількість
• decimal Total - Підсумкова вартість

'''Результат функції:'''
• string Error - опис помилки, що виникла.
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту.
• int MagneticCardID - ID учасника програми лояльності, якому належить картка із запиту.
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту.
• bool IsOTPNeed - ознака необхідності підтвердження операції паролем/пін-кодом (Завжди false)
• DiscountTransaction[] DiscountTransactions - масив транзакцій для отримання знижки структур DiscountTransaction. Структура DiscountTransaction має такі поля:
• DateTime TransactionDate - дата проведення транзакції.
• decimal Sum - сума транзакції. o int ServiceGroupCode - код групи послуг POS-системи. o string[30] POSsystemAccount - Л/Рахунок у POS системі. o decimal Discount - величина знижки у валюті. o decimal DiscountSum - сума транзакції з урахуванням знижки.
• string[20] DiscountPriceListCode - код прейскуранта поточного дисконтного статусу, не обов'язковий для заповнення, використовується при акцептуванні транзакцій зі знижкою за прейскурантом.
string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Порожнє поле)
• string ErrorTransaction - опис помилки, що виникла для конкретної транзакції (Порожнє поле)
• TransactionDetails Details - деталізація позицій рахунку. Структура TransactionDetails має такі поля:
▪ int BillID - ID рахунку в POS-системі
▪ DateTime BillDate - Дата створення рахунку
▪ int CurrencyCode - Міжнародний код валюти оплати
▪ string ReceiptType - Тип чека
▪ decimal ReceiptSum - Сума чека
▪ string PaymentType - Назва типу оплати
▪ PositionInfo[] Items - Деталізація позицій чека. Структура PositionInfo має такі поля:
◦ int ItemID - ID нарахування
◦ int ServiceCode - Код послуги
◦ string Name - Назва послуги
◦ string ClassName - Назва класу послуги
◦ string ClassCode - Код класу послуги
◦ string SubClassName - Назва підкласу послуги
◦ string SubClassCode - Код підкласу послуги
◦ decimal Price - Ціна позиції
◦ decimal Quantity - Кількість - Кількість
◦ decimal Total - Підсумкова вартість
Спочатку відбувається перевірка на дисконтний тип програми, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає карту в базі даних, якщо такої немає або вона неактивна, повертає помилку. Якщо карта є і вона активна, то система розраховує знижку для транзакцій.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Return_Discount_Transaction_eWallet_Accept==
Метод виконує підтвердження повернення зі знижкою за ID магнітної картки та списком транзакцій.
Метод підходить для HMS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки програми лояльності.
• string[32] POSCode - унікальний код POS системи, за яким шукається зв'язка POS системи та користувача програми лояльності. (Не впливає на виконання запиту)
• string CodeOTP - пароль/пін-код підтвердження операції. (Не впливає на виконання запиту)
• DiscountTransaction[] DiscountTransactions - масив транзакцій для отримання знижки структур DiscountTransaction. Структура DiscountTransaction має такі поля:
decimal Sum - сума транзакції.
◦ decimal DiscountSum - сума транзакції зі знижкою. (Не впливає на виконання запиту)
◦ DateTime TransactionDate - дата проведення транзакції. o int ServiceGroupCode - код групи послуг POS-системи.
◦ string[30] POSsystemAccount - Л/Рахунок у POS системі. (Не впливає на виконання запиту)
◦ decimal Discount - величина знижки у валюті. (Не впливає на виконання запиту)
◦ string[20] DiscountPriceListCode - код прейскуранта поточного дисконтного статусу, не обов'язковий для заповнення, використовується при акцептуванні транзакцій зі знижкою за прейскурантом. (Не впливає на виконання запиту)
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Не впливає на виконання запиту)
◦ string ErrorTransaction - опис виниклої помилки для конкретної транзакції. (Не впливає на виконання запиту)
◦ TransactionDetails Details - деталізація позицій рахунку. Структура TransactionDetails має такі поля:
▪ int BillID - ID рахунку в POS-системі
▪ DateTime BillDate - Дата створення рахунку
▪ int CurrencyCode - Міжнародний код валюти оплати
▪ string ReceiptType - Тип чека
▪ decimal ReceiptSum - Сума чека
▪ string PaymentType - Назва типу оплати
▪ PositionInfo[] Items - Деталізація позицій чека. Структура PositionInfo має такі поля:
• int ItemID - ID нарахування
• int ServiceCode - Код послуги
• string Name - Назва послуги
• string ClassName - Назва класу послуги
• string ClassCode - Код класу послуги
• string SubClassName - Назва підкласу послуги
• string SubClassCode - Код підкласу послуги
• decimal Price - Ціна позиції
• decimal Quantity - Кількість - Кількість
• decimal Total - Підсумкова вартість

'''Результат функції:'''
• string Error - опис помилки, що виникла.
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• decimal Discount - загальна сума знижки за транзакціями із запиту

Спочатку відбувається перевірка на дисконтний тип програми, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає картку в базі даних, якщо такої немає, повертає помилку про відсутність такої картки. Якщо картка є, то система бере учасника за даними з картки, додає транзакції повернення з дисконтним типом і оновлює інформацію про учасника в базі даних.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Add_eWallet_Bonuses_Request==
Метод виконує запит інформації щодо можливості нарахування бонусів за ID магнітної картки та списком транзакцій.
Метод підходить для HMS.

'''Вхідні параметри:'''
• string[32] POSCode - унікальний код POS системи, за яким шукається зв'язка POS системи та користувача програми лояльності. (Не впливає на виконання запиту)
• int MagneticCardID - ID магнітної картки
• int CustomerType - тип замовника в POS системі (Не впливає на виконання запиту)
• int CustomerID - ID замовника в POS системі (Не впливає на виконання запиту)
• Transaction[] Transactions - масив транзакцій структур Transaction. Структура Transaction має такі поля:
◦ DateTime TransactionDate - дата проведення транзакції в POS системі (Не впливає на виконання запиту)
◦ int ServiceGroupCode - код групи послуг POS системи o decimal Quantity - кількість послуг за транзакцією o decimal Sum - сума транзакції o string[30] POSsystemAccount - Л/Рахунок у POS системі (Не впливає на виконання запиту)
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Не впливає на виконання запиту)
◦ string ServiceProviderName - Найменування постачальника послуг (Не впливає на виконання запиту)
◦ string ServiceProviderID - ID постачальника послуг у POS системі (Не впливає на виконання запиту)
◦ TransactionDetails Details - деталізація позицій рахунку. (Опціонально). Структура TransactionDetails має такі поля:
▪ int BillID - ID рахунку в POS-системі
▪ DateTime BillDate - Дата створення рахунку
▪ int CurrencyCode - Міжнародний код валюти оплати
▪ string ReceiptType - Тип чека
decimal ReceiptSum - Сума чека
▪ string PaymentType - Назва типу оплати
▪ PositionInfo[] Items - Деталізація позицій чека. Структура PositionInfo має такі поля:
• int ItemID - ID нарахування
• int ServiceCode - Код послуги
• string Name - Назва послуги
• string ClassName - Назва класу послуги
• string ClassCode - Код класу послуги
• string SubClassName - Назва підкласу послуги
• string SubClassCode - Код підкласу послуги
• decimal Price - Ціна позиції
• decimal Quantity - Кількість - Кількість
• decimal Total - Підсумкова вартість

'''Результат функції:'''
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• int MagneticCardID - ID магнітної картки
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• decimal BonusBalance - поточний бонусний баланс електронного гаманця
• Transaction[] Transactions - масив транзакцій Transaction, за якими можливо виконати нарахування бонусів. Структура Transaction має такі поля:
• DateTime TransactionDate - дата проведення транзакції в POS-системі
(Порожнє поле) o int ServiceGroupCode - код групи послуг POS системи o decimal Quantity - кількість послуг за транзакцією o decimal Sum - сума транзакції o string[30] POSsystemAccount - Л/Рахунок у POS системі o string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Порожнє поле)
• string ServiceProviderName - Найменування постачальника послуг o string ServiceProviderID - ID постачальника послуг у POS-системі o TransactionDetails Details - деталізація позицій рахунку. (Опціонально). Структура TransactionDetails має такі поля:
▪ int BillID - ID рахунку в POS-системі
▪ DateTime BillDate - Дата створення рахунку
▪ int CurrencyCode - Міжнародний код валюти оплати
▪ string ReceiptType - Тип чека
▪ decimal ReceiptSum - Сума чека
▪ string PaymentType - Назва типу оплати
▪ PositionInfo[] Items - Деталізація позицій чека. Структура PositionInfo має такі поля:
◦ int ItemID - ID нарахування
◦ int ServiceCode - Код послуги
◦ string Name - Назва послуги
◦ string ClassName - Назва класу послуги
◦ string ClassCode - Код класу послуги
◦ string SubClassName - Назва підкласу послуги
◦ string SubClassCode - Код підкласу послуги
◦ decimal Price - Ціна позиції
◦ decimal Quantity - Кількість - Кількість
◦ decimal Total - Підсумкова вартість
◦ string Error - опис помилки, що виникла
◦ bool IsOTPNeed - ознака необхідності підтвердження операції паролем/пін-кодом

Спочатку відбувається перевірка на бонусний тип програми, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає карту в базі даних, якщо такої немає або вона неактивна, повертає помилку. Якщо картка є і вона активна, то система розраховує кількість бонусів для транзакцій.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Add_eWallet_Bonuses==
Метод здійснює нарахування бонусів учаснику програми лояльності за ID магнітної картки та списком транзакцій.
Метод підходить для POS і HMS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки.
• string[32] POSCode - унікальний код POS системи, за яким шукається зв'язка POS системи та користувача програми лояльності. (Не впливає на виконання запиту)
• POSServiceProvider[] POSServiceProviders - Список сервіс провайдерів, які беруть участь в операції. (Опціонально). Структура POSServiceProvider має такі поля:
◦ string POSSProviderID - ID постачальника послуг у POS системі
◦ string CompanyName - Назва компанії
◦ bool IsCompany - Компанія чи фізособа
◦ рядок AddressLegal - Юридична адреса
◦ рядок ITN - ІПН
◦ string TaxIDCode - ЄДРПОУ(У)
◦ string JobPosition - Посада для підпису (наприклад: Директор)
◦ string Employee - Прізвище та ініціали для підпису (наприклад Пупкін В.П.)
◦ string AffilateCode - Код філії, якщо є
◦ string Bank_MFO - МФО банку з реквізитів рахунку
◦ string Bank_Name - Назва банку з реквізитів рахунку
◦ string Bank_Account - Рахунок у банку з реквізитів рахунку
◦ string IBAN - IBAN з реквізитів рахунку, якщо є
◦ string NDSNumber - Номер свідоцтва платника ПДВ, якщо є
• Transaction[] Transactions - масив транзакцій для нарахування бонусів Transaction.
Структура Transaction має такі поля: o decimal Sum - сума транзакції. o DateTime TransactionDate - дата проведення транзакції в POS-системі.
◦ int ServiceGroupCode - код групи послуг POS-системи.
◦ string[30] POSsystemAccount - Л/Рахунок у POS системі. (Не впливає на виконання запиту)
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Не впливає на виконання запиту)
◦ десяткова? Quantity - кількість o TransactionDetails Details - деталізація позицій рахунку. (Опціонально). Структура TransactionDetails має такі поля:
▪ int BillID - ID рахунку в POS-системі
▪ DateTime BillDate - Дата створення рахунку
▪ int CurrencyCode - Міжнародний код валюти оплати
▪ string ReceiptType - Тип чека
▪ decimal ReceiptSum - Сума чека
▪ string PaymentType - Назва типу оплати
▪ PositionInfo[] Items - Деталізація позицій чека. Структура PositionInfo має такі поля:
• int ItemID - ID нарахування
• int ServiceCode - Код послуги
• string Name - Назва послуги
• string ClassName - Назва класу послуги
• string ClassCode - Код класу послуги
• string SubClassName - Назва підкласу послуги
• string SubClassCode - Код підкласу послуги
• decimal Price - Ціна позиції
• decimal Quantity - Кількість - Кількість
• decimal Total - Підсумкова вартість

'''Результат функції:'''
• int MagneticCardID - ID магнітної картки програми лояльності із запиту.
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту.
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• decimal AddedBonuses - кількість нарахованих бонусів за транзакції
• decimal BonusBalance - поточний бонусний баланс електронного гаманця
• string Error - опис помилки, що виникла
Спочатку відбувається перевірка на бонусний тип програми, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає картку в базі даних, якщо такої немає, повертає помилку про відсутність такої картки. Якщо картка є, то система бере учасника за даними з картки, розраховує кількість бонусів для транзакцій, додає транзакції в базу даних і оновлює інформацію про учасника в базі даних.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Return_Add_eWallet_Bonuses_Request==
Метод виконує запит інформації щодо можливості повернення транзакцій з нарахуванням бонусів за ID магнітної картки та списком транзакцій.
Метод підходить для HMS.

'''Вхідні параметри:'''
• string[32] POSCode - унікальний код POS системи, за яким шукається зв'язка POS системи та користувача програми лояльності. (Не впливає на виконання запиту)
• int MagneticCardID - ID магнітної картки
• int CustomerType - тип замовника в POS системі (Не впливає на виконання запиту)
• int CustomerID - ID замовника в POS системі (Не впливає на виконання запиту)
• Transaction[] Transactions - масив транзакцій структур Transaction. Структура Transaction має такі поля:
◦ DateTime TransactionDate - дата проведення транзакції в POS системі
◦ int ServiceGroupCode - код групи послуг POS системи o decimal Quantity - кількість послуг за транзакцією
◦ decimal Sum - сума транзакції
◦ string[30] POSsystemAccount - Л/Рахунок у POS системі (Не впливає на виконання запиту)
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Не впливає на виконання запиту)
◦ string ServiceProviderName - Найменування постачальника послуг (Не впливає на виконання запиту)
◦ string ServiceProviderID - ID постачальника послуг у POS системі (Не впливає на виконання запиту)
◦ TransactionDetails Details - деталізація позицій рахунку. (Опціонально). Структура TransactionDetails має такі поля:
▪ int BillID - ID рахунку в POS-системі
▪ DateTime BillDate - Дата створення рахунку
▪ int CurrencyCode - Міжнародний код валюти оплати
▪ string ReceiptType - Тип чека
▪ decimal ReceiptSum - Сума чека
▪ string PaymentType - Назва типу оплати
▪ PositionInfo[] Items - Деталізація позицій чека. Структура PositionInfo має такі поля:
• int ItemID - ID нарахування
• int ServiceCode - Код послуги
• string Name - Назва послуги
• string ClassName - Назва класу послуги
• string ClassCode - Код класу послуги
• string SubClassName - Назва підкласу послуги
• string SubClassCode - Код підкласу послуги
• decimal Price - Ціна позиції
• decimal Quantity - Кількість - Кількість

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• decimal BonusBalance - баланс бонусів учасника програми лояльності, якому належить картка із запиту
• bool IsOTPNeed - ознака необхідності підтвердження операції паролем/пін-кодом (Завжди false)
• Transaction[] Transactions - масив транзакцій Transaction, за якими можливо виконати скасування нарахування бонусів. Структура Transaction має такі поля:
◦ DateTime TransactionDate - дата проведення транзакції в POS системі
◦ int ServiceGroupCode - код групи послуг POS системи
◦ decimal Quantity - кількість послуг за транзакцією
◦ decimal Sum - сума транзакції
◦ string[30] POSsystemAccount - Л/Рахунок в POS системі
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Даний код повинен бути унікальним в межах POS системи серед не віддалених точок.
◦ string string ServiceProviderName - Найменування постачальника послуг
◦ string ServiceProviderID - ID постачальника послуг в POS системі
◦ TransactionDetails Details - деталізація позицій рахунку. (Опціонально). Структура TransactionDetails має такі поля:
▪ int BillID - ID рахунку в POS системі
▪ DateTime BillDate - Дата створення рахунку
▪ int CurrencyCode - Міжнародний код валюти оплати
▪ string ReceiptType - Тип чека
▪ decimal ReceiptSum - Сума чека
▪ string PaymentType - Назва типу оплати
▪ PositionInfo[] Items - Деталізація позицій чека. Структура PositionInfo має такі поля:
• int ItemID - ID нарахування
• int ServiceCode - Код послуги
• string Name - Назва послуги
• string ClassName - Назва класу послуги
• string ClassCode - Код класу послуги
• string SubClassName - Назва підкласу послуги
• string SubClassCode - Код підкласу послуги
• decimal Price - Ціна позиції
• decimal Quantity - Кількість
• decimal Total - Підсумкова вартість
Спочатку відбувається перевірка на бонусний тип програми, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає картку в базі даних, якщо такої немає або вона неактивна, повертає помилку. Якщо картка є і вона активна, то система бере учасника за даними з картки, розраховує кількість бонусів для повернення і якщо їхня кількість недостатня на балансі учасника, повертає помилку.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Return_Add_eWallet_Bonuses_Accept==

Метод виконує підтвердження повернення транзакцій з нарахуванням бонусів за ID магнітної картки та списком транзакцій.
Метод підходить для HMS.

'''Вхідні параметри:'''
• string[32] POSCode - унікальний код POS системи, за яким шукається зв'язка POS системи та користувача програми лояльності. (Не впливає на виконання запиту)
• int MagneticCardID - ID магнітної картки
• int CustomerType - тип замовника в POS системі (Не впливає на виконання запиту)
• int CustomerID - ID замовника в POS системі (Не впливає на виконання запиту)
• Transaction[] Transactions - масив транзакцій структур Transaction. Структура Transaction має такі поля:
◦ DateTime TransactionDate - дата проведення транзакції в POS системі
◦ int ServiceGroupCode - код групи послуг POS системи (Не впливає на виконання запиту)
◦ decimal Quantity - кількість послуг за транзакцією
◦ decimal Sum - сума транзакції o string[30] POSsystemAccount - Л/Рахунок у POS системі (Не впливає на виконання запиту)
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Не впливає на виконання запиту)
◦ string ServiceProviderName - Найменування постачальника послуг (Не впливає на виконання запиту)
◦ string ServiceProviderID - ID постачальника послуг у POS системі (Не впливає на виконання запиту)
◦ TransactionDetails Details - деталізація позицій рахунку (Опціонально). Структура TransactionDetails має такі поля:
▪ int BillID - ID рахунку в POS-системі
▪ DateTime BillDate - Дата створення рахунку
▪ int CurrencyCode - Міжнародний код валюти оплати
▪ string ReceiptType - Тип чека
▪ decimal ReceiptSum - Сума чека
▪ string PaymentType - Назва типу оплати
▪ PositionInfo[] Items - Деталізація позицій чека. Структура PositionInfo має такі поля:
• int ItemID - ID нарахування
• int ServiceCode - Код послуги
• string Name - Назва послуги
• string ClassName - Назва класу послуги
• string ClassCode - Код класу послуги
• string SubClassName - Назва підкласу послуги
• string SubClassCode - Код підкласу послуги
• decimal Price - Ціна позиції
• decimal Quantity - Кількість - Кількість
• decimal Total - Підсумкова вартість
• POSServiceProvider[] POSServiceProviders - Список сервіс провайдерів, які беруть участь в операції. (Не впливає на виконання запиту). Структура POSServiceProvider має такі поля:
◦ string POSSProviderID - ID постачальника послуг у POS системі
◦ string CompanyName - Назва компанії
◦ bool IsCompany - Компанія чи фізособа
◦ рядок AddressLegal - Юридична адреса
◦ рядок ITN - ІПН
◦ string TaxIDCode - ЄДРПОУ(У)
◦ string JobPosition - Посада для підпису (наприклад: Директор)
◦ string Employee - Прізвище та ініціали для підпису (наприклад Пупкін В.П.)
◦ string AffilateCode - Код філії, якщо є
◦ string Bank_MFO - МФО банку з реквізитів рахунку
◦ string Bank_Name - Назва банку з реквізитів рахунку
◦ string Bank_Account - Рахунок у банку з реквізитів рахунку
◦ string IBAN - IBAN з реквізитів рахунку, якщо є
◦ string NDSNumber - Номер свідоцтва платника ПДВ, якщо є

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• decimal BonusBalance - баланс бонусів учасника програми лояльності, якому належить картка із запиту
• decimal AddedBonuses - кількість нарахованих бонусів за транзакції Спочатку відбувається перевірка на бонусний тип програми, якщо ні - повертаємо
помилку.
Далі за MagneticCardID система шукає картку в базі даних, якщо такої немає, повертає помилку про відсутність такої картки. Якщо картка є, то система бере учасника за даними з картки, додає в бд транзакції повернення з типом транзакції нарахування бонусів і оновлює інформацію про учасника в базі даних.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Pay_Transaction_eWallet_Bonuses_Request==
Метод виконує запит інформації щодо можливості часткової оплати бонусами за ID магнітної картки та списком транзакцій.
Метод підходить для POS і HMS.

Вхідні параметри:
• int MagneticCardID - ID магнітної картки.
• string[32] POSCode - унікальний код POS системи, за яким шукається зв'язка POS системи та користувача програми лояльності. (Не впливає на виконання запиту)
• Transaction[] Transactions - масив транзакцій структур Transaction. Структура Transaction має такі поля:
◦ DateTime? TransactionDate - дата проведення транзакції в POS системі. (Не впливає на виконання запиту)
◦ int ServiceGroupCode - код групи послуг POS-системи. o decimal Sum - сума транзакції.
◦ string[30] POSsystemAccount - Л/Рахунок у POS системі. (Не впливає на виконання запиту)
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Не впливає на виконання запиту)

'''Результат функції:'''
• string Error - опис помилки, що виникла.
• int MagneticCardID - ID магнітної картки програми лояльності із запиту.
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту.
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту.
• decimal BonusBalance - баланс бонусів учасника програми лояльності, якому належить картка із запиту.
• PayTransaction[] PayTransactions - масив транзакцій для оплати бонусами PayTransaction. Структура PayTransaction має такі поля: o DateTime TransactionDate - дата проведення транзакції в POS-системі. o int ServiceGroupCode - код групи послуг POS-системи. o decimal Sum - сума транзакції.
◦ string[30] POSsystemAccount - Л/Рахунок у POS системі. (Порожнє поле) o decimal BonusesToPay - кількість бонусів, необхідних для оплати транзакції
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Даний код повинен бути унікальним в межах POS системи серед не віддалених точок. (Порожнє поле). o string ErrorTransaction - опис виниклої помилки для конкретної транзакції. (Порожнє поле)
Спочатку відбувається перевірка на бонусний тип програми, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає карту в базі даних, якщо такої немає або вона неактивна, повертає помилку. Якщо картка є і вона активна, то система розраховує кількість бонусів для транзакцій.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Pay_Transaction_eWallet_Bonuses_Accept==
Метод виконує підтвердження транзакцій з частковою оплатою бонусами за ID магнітної картки та списком транзакцій.
Метод підходить для POS і HMS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки.
• string[32] POSCode - унікальний код POS системи, за яким шукається зв'язка POS системи та користувача програми лояльності. (Не впливає на виконання запиту)
• PayTransaction[] Transactions - масив транзакцій для оплати бонусами PayTransaction. Структура PayTransaction має такі поля:
◦ decimal Sum - сума транзакції. o DateTime TransactionDate - дата проведення транзакції в POS-системі. o int ServiceGroupCode - код групи послуг POS-системи.
◦ decimal BonusesToPay - кількість бонусів, необхідних для оплати транзакції.
◦ десяткова? Quantity - кількість o string[30] POSsystemAccount - Л/Рахунок у POS системі. (Не впливає на виконання запиту)
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Не впливає на виконання запиту)
◦ TransactionDetails Details - деталізація позицій рахунку. (Опціонально) Структура TransactionDetails має такі поля:
• int BillID - ID рахунку в POS-системі
• DateTime BillDate - Дата створення рахунку
• int CurrencyCode - Міжнародний код валюти оплати
• string ReceiptType - Тип чека
• decimal ReceiptSum - Сума чека
• string PaymentType - Назва типу оплати
• PositionInfo[] Items - Деталізація позицій чека. Структура PositionInfo має такі поля:
◦ int ItemID - ID нарахування
◦ int ServiceCode - Код послуги
◦ string Name - Назва послуги
◦ string ClassName - Назва класу послуги
◦ string ClassCode - Код класу послуги
◦ string SubClassName - Назва підкласу послуги
◦ string SubClassCode - Код підкласу послуги
◦ decimal Price - Ціна позиції
◦ decimal Quantity - Кількість - Кількість
◦ decimal Total - Підсумкова вартість

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• decimal PayBonuses - загальна сума списаних бонусів
• decimal BonusBalance - баланс бонусів учасника програми лояльності, якому належить картка із запиту
Спочатку відбувається перевірка на бонусний тип програми, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає картку в базі даних, якщо такої немає, повертає помилку про відсутність такої картки. Якщо картка є, то система бере учасника за даними з картки, розраховує кількість бонусів для транзакцій, додає транзакції в базу даних і оновлює інформацію про учасника в базі даних.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Return_Pay_Transaction_eWallet_Bonuses_Request==
Метод виконує запит інформації щодо можливості повернення транзакції з частковою оплатою бонусами за ID магнітної картки та списком транзакцій.
Метод підходить для HMS.

'''Вхідні параметри:'''
• string[32] POSCode - унікальний код POS системи, за яким шукається зв'язка POS системи та користувача програми лояльності. (Не впливає на виконання запиту)
• int MagneticCardID - ID магнітної картки
• int CustomerType - тип замовника в POS системі (Не впливає на виконання запиту)
• int CustomerID - ID замовника в POS системі (Не впливає на виконання запиту)
• Transaction[] Transactions - масив транзакцій структур Transaction. Структура Transaction має такі поля:
o DateTime TransactionDate - дата проведення транзакції в POS системі
o int ServiceGroupCode - код групи послуг POS системи
o decimal Quantity - кількість послуг за транзакцією
o decimal Sum - сума транзакції
o string[30] POSsystemAccount - Л/Рахунок у POS системі (Не впливає на виконання запиту)
o string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Не впливає на виконання запиту)
o string ServiceProviderName - найменування постачальника послуг
o string ServiceProviderID - ідентифікатор постачальника послуг TransactionDetails[] Details - деталізація позицій рахунку. Структура TransactionDetails має такі поля:
▪ int BillID - ID рахунку в POS-системі
▪ DateTime BillDate - Дата створення рахунку
▪ int CurrencyCode - Міжнародний код валюти оплати
▪ string ReceiptType - Тип чека
▪ decimal ReceiptSum - Сума чека
▪ string PaymentType - Назва типу оплати
▪ PositionInfo[] Items - Деталізація позицій чека. Структура PositionInfo має такі поля:
• int ItemID - ID нарахування
• int ServiceCode - Код послуги
• string Name - Назва послуги
• string ClassName - Назва класу послуги
• string ClassCode - Код класу послуги
• string SubClassName - Назва підкласу послуги
• string SubClassCode - Код підкласу послуги
• decimal Price - Ціна позиції
• decimal Quantity - Кількість - Кількість
• decimal Total - Підсумкова вартість

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• decimal BonusBalance - баланс бонусів учасника програми лояльності, якому належить картка із запиту
• bool IsOTPNeed - ознака необхідності підтвердження операції паролем/пін-кодом (Завжди false)
• PayTransaction[] PayTransactions - масив транзакцій для оплати бонусами PayTransaction. Структура PayTransaction має такі поля:
o DateTime TransactionDate - дата проведення транзакції в POS системі
o int ServiceGroupCode - код групи послуг POS системи (Порожнє поле)
o decimal Sum - сума транзакції
o decimal Quantity - кількість послуг за транзакцією
o string[30] POSsystemAccount - Л/Рахунок у POS-системі (Порожнє поле)
o decimal BonusesToPay - кількість бонусів, необхідних для оплати транзакції
o string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Порожнє поле)
o string ErrorTransaction - опис помилки, що виникла для конкретної транзакції (Порожнє поле)
o string ServiceProviderName - найменування постачальника послуг
o string ServiceProviderID - ідентифікатор постачальника послуг
o TransactionDetails[] Details - деталізація позицій рахунку. Структура TransactionDetails має такі поля:
▪ int BillID - ID рахунку в POS-системі
▪ DateTime BillDate - Дата створення рахунку
▪ int CurrencyCode - Міжнародний код валюти оплати
▪ string ReceiptType - Тип чека
▪ decimal ReceiptSum - Сума чека
▪ string PaymentType - Назва типу оплати
▪ PositionInfo[] Items - Деталізація позицій чека. Структура PositionInfo має такі поля:
◦ int ItemID - ID нарахування
◦ int ServiceCode - Код послуги
◦ string Name - Назва послуги
◦ string ClassName - Назва класу послуги
◦ string ClassCode - Код класу послуги
◦ string SubClassName - Назва підкласу послуги
◦ string SubClassCode - Код підкласу послуги
◦ decimal Price - Ціна позиції
◦ decimal Quantity - Кількість - Кількість
◦ decimal Total - Підсумкова вартість
Спочатку відбувається перевірка на бонусний тип програми, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає карту в базі даних, якщо такої немає або вона неактивна, повертає помилку.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Return_Pay_Transaction_eWallet_Bonuses_Accept==
Метод виконує підтвердження повернення транзакцій з частковою оплатою бонусами за ID магнітної картки та списком транзакцій.
Метод підходить для HMS.

'''Вхідні параметри:'''
• string[32] POSCode - унікальний код POS системи, за яким шукається зв'язка POS системи та користувача програми лояльності. (Не впливає на виконання запиту)
• int MagneticCardID - ID магнітної картки
• int CustomerType - тип замовника в POS системі (Не впливає на виконання запиту)
• int CustomerID - ID замовника в POS системі (Не впливає на виконання запиту)
• PayTransaction[] Transactions - масив транзакцій для оплати бонусами PayTransaction. Структура PayTransaction має такі поля::
◦ DateTime TransactionDate - дата проведення транзакції в POS системі
◦ int ServiceGroupCode - код групи послуг POS системи
◦ decimal Quantity - кількість послуг за транзакцією
◦ decimal Sum - сума транзакції o string[30] POSsystemAccount - Л/Рахунок у POS системі (Не впливає на виконання запиту)
◦ decimal BonusesToPay - кількість бонусів, необхідних для оплати транзакції (Не впливає на виконання запиту)
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Не впливає на виконання запиту)
◦ рядок ErrorTransaction - f o string ServiceProviderName - найменування постачальника послуг
◦ string ServiceProviderName - ідентифікатор постачальника послуг
◦ TransactionDetails Details - деталізація позицій рахунку. (Опціонально). Структура TransactionDetails має такі поля:
▪ int BillID - ID рахунку в POS-системі
▪ DateTime BillDate - Дата створення рахунку
▪ int CurrencyCode - Міжнародний код валюти оплати
▪ string ReceiptType - Тип чека
▪ decimal ReceiptSum - Сума чека
▪ string PaymentType - Назва типу оплати
▪ PositionInfo[] Items - Деталізація позицій чека. Структура PositionInfo має такі поля:
• int ItemID - ID нарахування
• int ServiceCode - Код послуги
• string Name - Назва послуги
• string ClassName - Назва класу послуги
• string ClassCode - Код класу послуги
• string SubClassName - Назва підкласу послуги
• string SubClassCode - Код підкласу послуги
• decimal Price - Ціна позиції
• decimal Quantity - Кількість
• decimal Total - Підсумкова вартість
• POSServiceProvider[] POSServiceProviders - Список сервіс провайдерів, які беруть участь в операції. (Не впливає на виконання запиту). Структура POSServiceProvider має такі поля:
o string POSSProviderID - ID постачальника послуг у POS системі
o string CompanyName - Назва компанії
o bool IsCompany - Компанія чи фізособа
o рядок AddressLegal - Юридична адреса
o рядок ITN - ІПН
o string TaxIDCode - ЄДРПОУ(У)
o string JobPosition - Посада для підпису (наприклад: Директор)
o string Employee - Прізвище та ініціали для підпису (наприклад Пупкін В.П.)
o string AffilateCode - Код філії, якщо є
o string Bank_MFO - МФО банку з реквізитів рахунку
o string Bank_Name - Назва банку з реквізитів рахунку
o string Bank_Account - Рахунок у банку з реквізитів рахунку
o string IBAN - IBAN з реквізитів рахунку, якщо є
o string NDSNumber - Номер свідоцтва платника ПДВ, якщо є
• string CodeOTP - пароль/пін-код підтвердження операції

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• decimal BonusBalance - баланс бонусів учасника програми лояльності, якому належить картка із запиту
• decimal PayBonuses - загальна кількість витрачених бонусів за транзакції
Спочатку відбувається перевірка на бонусний тип програми, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає картку в базі даних, якщо такої немає, повертає помилку про відсутність такої картки. Якщо картка є, то система бере учасника за даними з картки, додає в бд транзакції повернення з типом оплати бонусами і оновлює інформацію про учасника в базі даних. Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Get_Certificates_Info==
Метод за ID і номером сертифікатів повертає інформацію за знайденими сертифікатами.
Метод підходить для HMS.

'''Вхідні параметри:'''
• string[32] POSCode - унікальний код POS системи, за яким шукається зв'язка POS системи та користувача програми лояльності. (Не впливає на виконання запиту)
• int? СertificateID - ID сертифіката
• string[100] CertificateNumber - Номер сертифіката
• string[20] CertificateCode - код оплати сертифіката (Не впливає на виконання запиту)

'''Результат функції:'''
• string Error - опис помилки, що виникла
• Certificates[] - масив описів сертифікатів Certificate . Елементи масиву структури з такими полями:
◦ int CertificateID - ID сертифіката
◦ string CertificateNumber - Номер сертифіката
◦ string CertificateCode - код оплати сертифіката (Порожнє поле)
◦ string CertificateTypeName - тип сертифіката
◦ bool IsCertificateTypeActive - тип сертифіката активний?
◦ bool IsCertificateTypeDeleted - тип сертифіката видалено?
◦ DateTime? CertificateTypeActionStartDate - дата початку проведення акції типу сертифіката (Порожнє поле)
◦ DateTime? CertificateTypeActionEndDate - дата закінчення проведення акції типу сертифіката (Порожнє поле)
◦ decimal CertificateAmount - сума сертифіката o bool IsCertificateActive - статус сертифіката активний?
◦ string CertificateStatusName - назва статусу сертифіката
◦ DateTime? CertificateActivationDate - дата активації CertificateActivationDate
◦ DateTime? CertificateDeactivationDate - дата деактивації.
◦ int? AccountID - ідентифікатор власника o string[100] LoyaltyProgramName - назва програми лояльності гаманця
(Порожнє поле)
◦ string UserName - ПІБ учасника з анкети електронного гаманця (якщо є гаманець і анкета учасника, інакше null).

==Certificate_Transactions_Request==
Метод виконує запит інформації щодо можливості оплати сертифікатом за ID сертифіката і списком транзакцій.
Метод підходить для HMS.

Вхідні параметри:
• string[32] POSCode - унікальний код POS системи, за яким шукається зв'язка POS системи та користувача програми лояльності. (Не впливає на виконання запиту)
• int CertificateID - ID сертифіката
• CertificateTransaction[] CertificateTransactions - масив транзакцій структур Transaction. Структура Transaction має такі поля:
◦ DateTime TransactionDate - дата проведення транзакції в POS системі (Не впливає на виконання запиту)
◦ int ServiceGroupCode - код групи послуг POS системи (Не впливає на виконання запиту)
◦ decimal Sum - сума транзакції o string[30] POSsystemAccount - Л/Рахунок у POS системі (Не впливає на виконання запиту)
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Не впливає на виконання запиту)
◦ string ServiceProviderName - Найменування постачальника послуг (Не впливає на виконання запиту)
◦ int? PaymentID - ID нарахування. Необхідно для пошуку учасника програми лояльності.
◦ string TransactionError - опис виниклої помилки для конкретної транзакції (Не впливає на виконання запиту)
◦ DateTime PaymentConsumptionDate - дата споживання послуги (з нарахування) (Не впливає на виконання запиту)

'''Результат функції:'''
• int CertificateID - ID сертифіката
• string CertificateStatusName - статус сертифіката
• decimal CertificateAmount - ціна сертифіката
• DateTime? CertificateDeactivationDate - дата деактивації. Найменша з цих двох: розрахована дата деактивації сертифіката і дата припинення дії типу сертифіката. (CertificateDeactivationDate буде null, якщо дата активації сертифіката == null) У цей день сертифікат ВЖЕ не діє.
• int? AccountID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, який оплатив нарахування, якщо такий є.
• CertificateTransaction[] CertificateTransactions - масив транзакцій для оплати сертифікатом CertificateTransaction. Структура CertificateTransaction має такі поля:
◦ DateTime TransactionDate - дата проведення транзакції в POS системі
◦ int ServiceGroupCode - код групи послуг POS системи
◦ decimal Sum - сума транзакції
◦ string[30] POSsystemAccount - Л/Рахунок у POS системі
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок.
◦ string ServiceProviderName - Найменування постачальника послуг
◦ int? PaymentID - ID нарахування. Необхідно для пошуку учасника програми лояльності.
◦ string TransactionError - опис виниклої помилки для конкретної транзакції
◦ DateTime PaymentConsumptionDate - дата споживання послуги (з нарахування)
• string Error - опис помилки, що виникла
• bool IsOTPNeed - ознака необхідності підтвердження операції паролем/пін-кодом
Спочатку відбуваються перевірки на валідність сертифіката за CertificateID і суми транзакцій, якщо не проходимо якусь перевірку - повертаємо відповідну помилку.
Далі намагаємося отримати дату оплати й учасника програми лояльності за PaymentID першої транзакції.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Certificate_Transactions_Accept==
Метод виконує підтвердження оплати сертифіката за ID сертифіката і списком транзакцій.
Метод підходить для HMS.

'''Вхідні параметри:'''
• string[32] POSCode - унікальний код POS-системи, за яким шукається зв'язка POSсистеми та користувача програми лояльності.
• int CertificateID - ID сертифіката
• int MagneticCardID - ідентифікатор карти
• string CodeOTP - пароль/пін-код підтвердження операції
• CertificateTransaction[] CertificateTransactions - масив транзакцій для оплати сертифікатом CertificateTransaction. Структура CertificateTransaction має такі поля:
◦ DateTime TransactionDate - дата проведення транзакції в POS системі o int ServiceGroupCode - код групи послуг POS системи (Не впливає на виконання запиту)
◦ decimal Sum - сума транзакції o int? PaymentID - ID нарахування. Необхідно для пошуку учасника програми лояльності.
◦ string[30] POSsystemAccount - Л/Рахунок у POS системі (Не впливає на виконання запиту)
◦ string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Не впливає на виконання запиту)
◦ DateTime PaymentConsumptionDate - дата споживання послуги (з нарахування)
(Не впливає на виконання запиту)
◦ string ServiceProviderName - найменування постачальника послуг
◦ string TransactionError - опис виниклої помилки для конкретної транзакції
• TransactionDetails Details - деталізація позицій рахунку. (Опціонально). Структура TransactionDetails має такі поля:
◦ int BillID - ID рахунку в POS-системі
◦ DateTime BillDate - Дата створення рахунку
◦ int CurrencyCode - Міжнародний код валюти оплати
◦ string ReceiptType - Тип чека
◦ decimal ReceiptSum - Сума чека
◦ string PaymentType - Назва типу оплати
◦ PositionInfo[] Items - Деталізація позицій чека. Структура PositionInfo має такі поля:
▪ int ItemID - ID нарахування
▪ int ServiceCode - Код послуги
▪ string Name - Назва послуги
▪ string ClassName - Назва класу послуги
▪ string ClassCode - Код класу послуги
▪ string SubClassName - Назва підкласу послуги
▪ string SubClassCode - Код підкласу послуги
▪ decimal Price - Ціна позиції
▪ decimal Quantity - Кількість - Кількість
▪ decimal Total - Підсумкова вартість

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int CertificateID - ID сертифіката
• string CertificateStatusName - статус сертифіката
• decimal CertificateStartBalance - вартість сетрифіката
• decimal AllTransactionsSum - сума всіх проведених транзакцій
• decimal CertificateFinishBalance - залишок сертифіката
• int? AccountID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, який оплатив нарахування, якщо такий є.
Спочатку відбуваються перевірки на валідність сертифіката за CertificateID і суми транзакцій, якщо не проходимо якусь перевірку - повертаємо відповідну помилку.
Далі намагаємося отримати дату оплати й учасника програми лояльності за PaymentID першої транзакції, якщо знайшли учасника - підвищуємо йому оборот грошей у бд. Додаємо транзакцію, змінюємо статус сертифіката на "Погашений" у бд.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Money_Input_Request==
Метод виконує запит інформації щодо можливості покласти гроші на картку за ID магнітної картки.
Метод підходить для HMS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки програми лояльності

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• decimal MoneyBalance - баланс лояльних грошей учасника програми лояльності, якому належить картка із запиту
Спочатку відбувається перевірка на використання лояльних грошей, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає картку в базі даних, якщо такої немає або вона неактивна, повертає помилку. Якщо картка є і вона активна, то система бере учасника програми лояльності за карткою.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Money_Input==
Метод виконує підтвердження поповнення лояльного балансу за ID магнітної картки та сумою поповнення.
Метод підходить для HMS і для POS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки програми лояльності (для HMS)
• int CardNumber - короткий або довгий номер магнітної картки програми лояльності (для POS)
• decimal Summ - сума поповнення
• DateTime? PaymentTime - час оплати (необов'язкове поле, якщо не вказувати, братиметься час готелю із запиту або час інсталяції)

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• decimal MoneyBalance - баланс лояльних грошей учасника програми лояльності, якому належить картка із запиту
• eWallet[] eWallets - результат аналогічний функції Get_eWallet_Info.
Спочатку відбувається перевірка на використання лояльних грошей, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає картку в базі даних, якщо такої немає, повертає помилку про відсутність такої картки. Якщо карта є, то система бере учасника за даними з карти, додає транзакції в базу даних і оновлює інформацію про учасника в базі даних. Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Return_Money_Input_Request==
Метод виконує запит інформації щодо можливості повернути покладені гроші на картку за ID магнітної картки.
Метод підходить для HMS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки програми лояльності
• decimal Sum - сума поповнення

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• decimal MoneyBalance - баланс лояльних грошей учасника програми лояльності, якому належить картка із запиту
Спочатку відбувається перевірка на використання лояльних грошей, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає картку в базі даних, якщо такої немає або вона неактивна, повертає помилку. Якщо картка є і вона активна, то система бере учасника програми лояльності за карткою, перевіряє, чи достатньо коштів на балансі учасника, якщо ні, повертає помилку.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Return_Money_Input_Accept==
Метод виконує підтвердження повернення грошей з лояльного балансу за ID магнітної картки та сумою поповнення.
Метод підходить для HMS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки програми лояльності
• decimal Sum - сума поповнення

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• decimal MoneyBalance - баланс лояльних грошей учасника програми лояльності, якому належить картка із запиту
Спочатку відбувається перевірка на використання лояльних грошей, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає картку в базі даних, якщо такої немає, повертає помилку про відсутність такої картки. Якщо картка є, то система бере учасника програми лояльності за карткою, перевіряє, чи достатньо коштів на балансі учасника, якщо ні, повертає помилку, інакше додає транзакцію зняття з рахунку до бази даних і оновлює інформацію про учасника в базі даних.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Pay_Transaction_eWallet_PayCard_Request==
Метод виконує запит інформації щодо можливості оплати коштами з лояльного балансу за ID магнітної картки та списком транзакцій.
Метод підходить для HMS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки програми лояльності
• Transactions [] - масив транзакцій структур Transaction. Структура Transaction має такі поля:
◦ decimal Sum - сума транзакції
◦ int ServiceGroupID - ID групи послуг транзакції
◦ decimal? Quantity - кількість
◦ datetime? TransactionDate - дата транзакції

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• decimal MoneyBalance - баланс лояльних грошей учасника програми лояльності, якому належить картка із запиту
• EC_ResponseTransaction[] Transactions - масив транзакцій для отримання знижки структур EC_ResponseTransaction. Структура EC_ResponseTransaction має такі поля:
◦ decimal Sum - сума транзакції
◦ int ServiceGroupID - ID групи послуг транзакції
◦ DateTime TransactionDate - час проведення транзакції
◦ decimal? Quantity - кількість
Спочатку відбувається перевірка на використання лояльних грошей, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає картку в базі даних, якщо такої немає або вона неактивна, повертає помилку. Якщо картка є і вона активна, то система бере учасника програми лояльності та розраховує, чи вистачить лояльних грошей в учасника для транзакцій, якщо ні - повертаємо помилку.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Pay_Transaction_eWallet_PayCard_Accept==
Метод виконує підтвердження оплати коштами з лояльного балансу за ID магнітної картки та списком транзакцій.
Метод підходить для POS і HMS.

'''Вхідні параметри:'''
• string[32] POSCode - унікальний код POS системи, за яким шукається зв'язка POS системи та користувача програми лояльності. (Не впливає на виконання запиту)
• string[20] CardCode - короткий або повний код картки лояльності.
• int BillID - ідентифікатор чека.
• decimal? PaySum - сума до оплати лояльними грошима.
• int? MagneticCardID - ID магнітної картки програми лояльності.
• PayTransaction[] Transactions - масив транзакцій для оплати лояльними грошима PayTransaction. Структура PayTransaction має такі поля:
o DateTime TransactionDate - дата проведення транзакції в POS системі
o int ServiceGroupCode - код групи послуг POS системи o decimal Quantity - кількість послуг за транзакцією
o decimal Sum - сума транзакції
o string[30] POSsystemAccount - Л/Рахунок у POS системі (Не впливає на виконання запиту)
o string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Не впливає на виконання запиту)
o TransactionDetails Details - деталізація позицій рахунку. (Опціонально). Структура TransactionDetails має такі поля:
▪ int BillID - ID рахунку в POS-системі
▪ DateTime BillDate - Дата створення рахунку
▪ int CurrencyCode - Міжнародний код валюти оплати
▪ string ReceiptType - Тип чека
▪ decimal ReceiptSum - Сума чека
▪ string PaymentType - Назва типу оплати
▪ PositionInfo[] Items - Деталізація позицій чекаю Структура PositionInfo має такі поля:
• int ItemID - ID нарахування
• int ServiceCode - Код послуги
• string Name - Назва послуги
• string ClassName - Назва класу послуги
• string ClassCode - Код класу послуги
• string SubClassName - Назва підкласу послуги
• string SubClassCode - Код підкласу послуги
• decimal Price - Ціна позиції
• decimal Quantity - Кількість - Кількість
• decimal Total - Підсумкова вартість

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
Спочатку відбувається перевірка на використання лояльних грошей, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає карту в базі даних, якщо такої немає або вона неактивна, повертає помилку. Якщо картка є і вона активна, то система бере учасника програми лояльності та розраховує, чи вистачить лояльних грошей в учасника для транзакцій, якщо ні - повертаємо помилку, інакше додає транзакції в базу даних і оновлює інформацію про учасника в базі даних.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Return_Pay_Money_Request==
Метод виконує запит інформації щодо можливості повернення транзакцій оплачених коштами з лояльного балансу за ID магнітної картки та списком транзакцій.
Метод підходить для HMS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки програми лояльності
• Transactions [] - масив транзакцій структур Transaction. Структура Transaction має такі поля:
◦ decimal Sum - сума транзакції
◦ DateTime TransactionDate - час проведення транзакції

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• decimal MoneyBalance - баланс лояльних грошей учасника програми лояльності, якому належить картка із запиту
• EC_ResponseTransaction[] Transactions - масив транзакцій для отримання знижки структур EC_ResponseTransaction. Структура EC_ResponseTransaction має такі поля:
◦ decimal Sum - сума транзакції
◦ DateTime TransactionDate - час проведення транзакції
Спочатку відбувається перевірка на використання лояльних грошей, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає карту в базі даних, якщо такої немає або вона неактивна, повертає помилку.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Return_Pay_Money_Accept==
Метод виконує підтвердження повернення транзакцій оплати коштами з лояльного балансу за ID магнітної картки та списком транзакцій.
Метод підходить для HMS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки програми лояльності
• Transactions [] - масив транзакцій структур Transaction. Структура Transaction має такі поля:
◦ decimal Sum - сума транзакції
◦ DateTime TransactionDate - час проведення транзакції

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
Спочатку відбувається перевірка на використання лояльних грошей, якщо ні - повертаємо помилку.
Далі за MagneticCardID система шукає картку в базі даних, якщо такої немає або вона неактивна, повертає помилку. Якщо картка є і вона активна, то система бере учасника програми лояльності, додає в бд транзакцію повернення з типом зняття з рахунку і оновлює інформацію про учасника в базі даних.
Після чого повертаємо результат функції, заповнюючи відповідні поля.

==Departure_Transaction_Accept==
Метод виконує підтвердження транзакції виселення і додає накопичені номероночі учаснику за потреби.
Метод підходить для HMS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки програми лояльності.
• decimal Duration - тривалість проживання гостя.
• DateTime TransactionDate - дата проведення транзакції.

'''Результат функції:'''
• string Error - опис помилки, що виникла
Спочатку перевіряємо картку на валідність, потім додаємо транзакцію, потім за потреби додаємо накопичені номероночі учаснику програми лояльності.

==Add_RoomNights_Accept==
Метод виконує нарахування номероночей на баланс користувача за його карткою. Метод підходить для HMS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки програми лояльності.
• int RoomNights - кількість номероночей.

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• int RoomNightBalance - баланс номероночей учасника програми лояльності
Спочатку беремо картку за айді та перевіряємо її валідність, потім додаємо номероночі учаснику, якому належить карта.

==WriteOff_RoomNights_Accept==
Метод виконує списання номероночей з балансу користувача за його карткою. Метод підходить для HMS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки програми лояльності.
• int MaxRoomNights - максимальна кількість номероночей для оплати.
• int GuestID - ідентифікатор гостя

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• int RoomNightBalance - баланс номероночей учасника програми лояльності
• int RoomNightsApplied - кількість застосованих номероночей
Спочатку беремо картку за ID і перевіряємо її валідність, потім перевіряємо баланс учасника, якому належить картка, і якщо вистачає - списуємо номероночі.

==Return_WriteOff_RoomNights_Accept==
Метод виконує повернення списання номероночей з балансу користувача за його карткою. Метод підходить для HMS.

'''Вхідні параметри:'''
• int MagneticCardID - ID магнітної картки програми лояльності.
• int RoomNights - кількість номероночей.

'''Результат функції:'''
• string Error - опис помилки, що виникла
• int MagneticCardID - ID магнітної картки програми лояльності із запиту
• int eWalletID - ID учасника програми лояльності, якому належить картка із запиту
• string UserName - ім'я (ПІБ контакту або назва компанії) учасника програми лояльності, якому належить картка із запиту
• int RoomNightBalance - баланс номероночей учасника програми лояльності Спочатку беремо картку за айді та перевіряємо її валідність, потім нараховуємо номероночі
учаснику, якому належить карта.

==Get_eWallet_Secure_Info==
Метод за номером телефону або електронною поштою, а також паролем, шукає учасників, інформацію про них і налаштування програми лояльності в базі даних.

Вхідні параметри:
• string PhoneNumber - номер телефону
• string Mail - електронна пошта
• string[50] Password - пароль учасника лояльності Результат функції:
• string Error - опис помилки, що виникла
• eWallet[] eWallets - масив описів електронних гаманців eWallet. Елементи масиву структури з такими полями:
o int eWalletID - ID електронного гаманця
o string[100] LoyaltyProgramName - назва програми лояльності
(string.Empty)
o string[50] BonusStatusName - назва статусу програми лояльності
o decimal BonusBalance - поточний бонусний баланс електронного гаманця
o decimal AccumulatedBonuses - поточна кількість накопичених бонусів електронного гаманця
o string[50] DiscountStatusName - назва статусу програми лояльності
o string[20] DiscountPriceListCode - код прейскуранта поточного дисконтного статусу, потрібен для синхронізації знижки за прейскурантом, якщо гаманець
o decimal DiscountTransactionsSum - сума всіх неанульованих транзакцій з урахуванням знижки, проведених для даного гаманця
o string[20] ServioSynkCode - код синхронізації програми лояльності
o int? CompanyAccount - ідентифікатор компанії HMS Servio.
o string[30] MagneticCardShortNumber - короткий номер магнітної картки
o string[30] MagneticCardFullNumber - довгий номер магнітної картки
o decimal BonusSum - сума бонусів
o decimal PaySum - сума на платіжній картці
o decimal Credit - сума кредиту
o decimal Accumulation - сума оборотів по карті
o bool IsPayCard - прапор, що визначає налаштування лояльності «Робота з грошовими коштами»
o decimal ExtraMoneySum - сума екстра-грошей
o bool IsSmartCard - ознака смарт карти (false)
o string ShortCode - короткий номер магнітної картки
o decimal DayLimit - ліміт списання за день
o decimal WeekLimit - ліміт списання за тиждень
o decimal MonthLimit - ліміт списання за місяць
o decimal YearLimit - ліміт списання за рік
o bool UsePayLimits - ознака використання лімітів списання (false)
o bool UseCatLimits - ознака використання лімітів категорій (false)
o datetime ValidityStart - дата початку дії картки/сертифіката
o datetime Validity - дата закінчення дії картки/сертифіката
o bool Issue - ознака Issued (false)
o int Cardid - ІД картки
o string Comment - коментар (string.Empty)
o string Description - Примітка (string.Empty)
o decimal Discount - розмір знижки за карткою (0)
o string SynkLoyaltyCode - код лояльності з налаштувань програми лояльності
o int RoomNightBalance - кількість безкоштовних номероночей учасника
o int MagneticCardID - ідентифікатор картки
o string UserName - ім'я власника
o string MobilePhone - номер телефону
o int DiscountGroupID - ідентифікатор дисконтної групи
o bool IsBonusProgram - приналежність до бонусної системи
o bool IsDiscountProgram - приналежність до дисконтної системи
o bool IsActive - ознака активності
o Files[] Files - структура інформації про пов'язані файли
▪ string ID - ідентифікатор файлу
▪ string Name - назва файлу
▪ DateTime DocumentDate - дата додавання документа (може змінюватися вручну)

==Get_File==
Метод повертає інформацію про файл за його ідентифікатором.
'''Вхідні параметри:'''
• string FileID - ідентифікатор файл

'''Результат функції:'''
• string Error - опис помилки, що виникла
• string Name - назва файлу
• string Data - вміст файлу в Base64

==Get_eWallet_Guests==
Метод витягує всі бронювання (сутності Guest) за учасником лояльності (який визначається за ідентифікатором гаманця.)
Якщо учасник лояльності:
• анкета (Client) - видає всіх гостей, де вказана ця анкета.
• компанія - видає всіх гостей, закріплених за цією компанією.

'''Вхідні параметри:'''
• string eWalletID - ідентифікатор гаманця;

'''Результат функції:'''
• string Error - опис виниклої помилки;
• eWalletGuests[] Guests - масив бронювань. Опис елементів:
◦ int GuestID - ідентифікатор гостя;
◦ string GuestName - ім'я гостя;
◦ int Status - ідентифікатор статусу;
◦ string StatusName - назва статусу;
◦ DateTime FirstDate - дата, з якої починається бронювання;
◦ DateTime LastDate - дата, з якої закінчується бронювання;
◦ string RoomNumber - номер кімнати;
◦ string RoomType - тип кімнати;
◦ string PriceName - назва прайс-листа;

==Get_eWallet_Bills==
Метод витягує всі рахунки (закриті або відкриті), які безпосередньо або побічно стосуються цього учасника лояльності.
Якщо учасник лояльності:
- анкета (Client) - витягує рахунки:
◦ гостей, де закріплена ця анкета і гість є платником;
◦ особистих рахунків (PersonalAccount), де закріплена ця анкета і ЛС є платником;
◦ компаній, які закріплені за цією анкетою через таблицю інвесторів, і компанія є платником;
- компанія - витягує всі рахунки компанії, де вона є платником.

'''Вхідні параметри:'''
• string eWalletID - ідентифікатор гаманця;

'''Результат функції:'''
• string Error - опис помилки, що виникла;
• eWalletBill[] Bills - масив рахунків. Опис елементів:
◦ int BillID - ІД рахунку
◦ string Comment - коментар з приводу рахунку
◦ int ServiceProviderID - ІД провайдера сервісу
◦ decimal BillPaymentSum - Сума за всіма платежами
◦ decimal BillReceiptSum - Сума за всіма чеками
◦ decimal BillBalance - Баланс рахунку
◦ int BillCurrencyISO - Валюта чека в ISO форматі. 980 - гривня
◦ int BillStatus - ІД статусу
◦ string BillStatusName - ім'я статусу
◦ DateTime BillCreationDate - дата створення рахунку
◦ int HotelID - ІД готелю

==Change_LoyaltyAccount_Password==
Метод змінює пароль учасника лояльності, а також номер телефону та електронну пошту (за наявності).

'''Вхідні параметри:'''
- int eWalletID - ідентифікатор учасника
- string OldPassword - старий пароль (для підтвердження)
- string NewPassword - новий пароль
- string NewPhoneNumber - номер телефону для заміни
- string NewMail - електронна пошта для заміни

'''Результат функції:'''
- string Error - опис помилки

==GetLastBonusTransactionsInfo==
Метод витягує всі транзакції за учасником лояльності (який визначається за ідентифікатором гаманця) або за карткою лояльності.

'''Вхідні параметри:'''
• int eWalletID - ідентифікатор гаманця;
• string CardNumber - номер картки лояльності
• int CountRecords - кількість записів, які потрібно вивести
• int CountSkipRecords - кількість записів, які потрібно пропустити від початку

'''Результат функції:'''
• string Error - опис помилки, що виникла;
• TransactionInfo[] Transactions - масив транзакцій. Опис елементів:
◦ decimal Bonuses - кількість нарахованих бонусів;
◦ decimal Sum - сума транзакції;
◦ string TransactionDate - дата проведення транзакції;

==Upload_eWallet_Documents==
Метод завантажує файли за наданими адресами в межах учасників програми лояльності
'''Вхідні параметри:'''
• EWalletDocuments[] EWalletDocuments - масив учасників програми лояльності. Опис елементів:
◦ int EwalletID – ІД учасника;
◦ Documents[] Documents – Масив документів учасника програми лояльності. Опис елементів:
– string FileName - назва файлу, яка буде використана в БД для учасників лояльності;
– string DocumentDate - дата файлу, яка буде використана в БД;
– string Url - адреса файлу з прямим розміщенням, який буде завантажуватися.

'''Результат функції:'''
• string Error - опис помилки, що виникла;
• • EWalletDocuments[] EWalletDocuments - масив учасників програми лояльності. Опис елементів:
◦ int EwalletID – ІД учасника;
◦ Documents[] Documents – Масив документів учасника програми лояльності. Опис елементів:
– int FileID - дідентифікатор файлу в БД;
– string FileName - назва файлу;
– string Status - успішність збереження файлу.

Підготовка до роботи

2026-02-06T14:57:41Z

Lashta.v: Позначено цю версію для перекладу

‎<languages/>
<translate>


У цьому розділі наводиться опис дій, які слід виконати перед початком роботи із Системою.
== Запуск та завершення сеансу роботи ==


Для переходу до роботи з Системою наберіть в адресному рядку: http://<адреса хоста>/<адреса сайту>/Login.aspx.
Відкриється вікно авторизації, в якому потрібно виконати такі дії:
 
[[Файл:Вікно входу.png|thumb]]
 
# З першого списку виберіть мову інтерфейсу користувача.
# З другого списку, що випадає, виберіть готель.
# З наступного списку виберіть робоче місце користувача.
# В полі «Логін» введіть реєстраційне ім'я користувача.
# У полі "Пароль" вкажіть пароль для вибраного реєстраційного імені.
# Натисніть кнопку Увійти.
 
В результаті відкриється головне вікно програми. Якщо реєстраційне ім'я або пароль вказано неправильно, у нижній частині вікна авторизації з'явиться повідомлення з текстом, виділеним червоним кольором шрифту: «Ви ввели неправильний логін або пароль». Виконайте процедуру авторизації повторно, вказавши правильно ім'я та пароль.
Якщо введене реєстраційне ім'я користувача відсутнє у списку, зверніться до адміністратора Системи, з проханням про його додавання.
Під час запуску Системи здійснюється перевірка сумісності версії сайту із версією БД. Якщо версії розрізняються, на екрані з'явиться попередження: «Версія сайту не сумісна з версією бази даних» і не входить до системи.
Сеанс роботи з Системою можна завершити одним із наступних способів:
* за допомогою кнопки Вихід із системи;
* за допомогою стандартної кнопки Windows закриття вікна.
</translate>
‎<languages/>
<translate>
== Оновлення / продовження ліцензії == 


Авторське право на Систему захищене від несанкціонованого розповсюдження ліцензуванням робочих станцій. Ліцензія видається на певний термін на кожну робочу станцію. Прив'язка ліцензії до робочої станції здійснюється за параметрами комп'ютера.
У разі зміни параметрів робочої станції (наприклад, заміна процесора, материнської плати, перевстановлення операційної системи тощо) потрібне оновлення ліцензії.
Подовження ліцензії необхідно у разі закінчення періоду її дії.
І в тому, і в іншому випадку процедура заміни ліцензії однакова.
Якщо Системі потрібна зміна ліцензії, у вікні авторизації користувача з'являється напис «До закінчення терміну ліцензії залишилася кількість днів».
Щоб змінити ліцензію, виконайте такі дії:
# Натисніть на посилання «ліцензії». Відкриється вікно «Оновлення ліцензії». [[Файл:Ліцензія.png|thumb]]
# Натисніть кнопку Сгенерувати. Система згенерує ключ, що містить основні параметри робочої станції, і відобразить його у вигляді зашифрованого тексту в полі Код запиту ліцензії.
# Скопіюйте вміст поля «Код запиту ліцензії» та надішліть його електронною поштою на адресу «helpdesk@servio.support». У листі вкажіть назву робочої станції та дані контактної особи.
# Лист буде отримано службою підтримки, яка згенерує ключ ліцензії та надішле його на адресу відправника запиту.
# Скопіюйте зашифрований текст із отриманого листа, вставте його в поле «Файл ліцензії» та натисніть кнопку Зберегти ліцензію.
На цьому процедуру оновлення ліцензії закінчено.
</translate>
‎<languages/>
<translate>
== Вибір робочого місця == 


Під робочим місцем розуміється сукупність доступного користувачеві устаткування (каси, зчитувачі паспортів та інших.). Адміністратору Системи надається можливість створювати робочі місця, прив'язувати до них необхідне обладнання, а також редагувати та видаляти робочі місця.
Вибір робочого місця виконується у вікні авторизації користувача до реєстрації.
</translate>
‎<languages/>
<translate>
== Вибір установки == 


Під установкою розуміється область роботи устаткування (каси, зчитувачі паспортів та інших.). Єдиним критерієм розподілу обладнання по областях є його фізичне розташування. Формування списку установок виконується співробітником служби підтримки в процесі установки Системи, а розподіл обладнання по областях - адміністратором Системи.
</translate>
‎<languages/>
<translate>
== Вибір валюти розрахунку за послуги == 


У Системі надано можливість розраховувати вартість послуг у різних валютах. Перелік валют поставляється із конфігурацією Системи і після її встановлення не може бути вилучений із Системи. Також користувачеві надається можливість самому додавати необхідні валюти, які можуть бути видалені. Кількість валют, яку можна додати, залежить від установок, заданих у конфігурації.
Вибір валюти розрахунку виконується у рядку стану після реєстрації користувача. В інтерфейсі Системи відображатиметься вартість послуг, перерахована відповідно до вибраної валюти.
</translate>

FAQ

2026-02-06T10:25:05Z

Lashta.v:

<languages/>
<translate>

FAQ, F.A.Q. (Frequently Asked Question(s) — підбірка часто задаваних питань на певну тему та відповідей на них, яка створюється переважно для того, щоб не треба було постійно відповідати на одні й ті ж запитання

</translate>

<translate>
'''Servio POS''' 
* [[Навчальні_матеріали_по_Servio_POS|Навчальні матеріали по Servio POS (ресторанній програмі)]] 
* [[Servio_Demo_доступ|Демо-доступ до ресторанної системи]]
* [[Додаткові операції над закритими рахунками в POS-модулі]]
* [[Закриття проблемного рахунку, де є проблема з банк-терміналом чи ФР/ПРРО]]
* [[Операції з закритим рахунком. Зміна видів оплат, повернення, відновлення, друк фіскального чеку та копії рахунку]]
* [[Де подивитися чеки та як зробити копію чеку по ПРРО]]
* [[Що перевірити, якщо не відображаються місця надання послуг]]
</translate>

<translate>
'''Servio HMS'''
* [[Навчальні_матеріали_Servio_HMS|Навчальні матеріали по Servio HMS (готельній програмі)]] 
* [[Demo_Servio_HMS|Демо-доступ до готельної системи]] 
* [[FAQ_Restriction_OTA|Як налаштувати обмеження продажів для ОТА каналів]] 
* [[FAQ_HMS_NoSlipFiscalOrder|Якщо фіскальний чек чи сліп банківського терміналу роздрукувався, а рахунок не оплачно в готельній програмі]] 
* [[FAQ_HMS_Оплати|Оплата рахунку без друку чеку, або без сліпу, або без чеку та без сліпу для стандартних типів оплат]] 
* [[Додавання нового постачальника на основі існуючого в HMS]]
* [[Призначення завдань покоївкам]]
</translate>

<translate>
'''Загальне | Інтеграції'''
* [[Банківські_термінали|Список інтеграваних банківських терміналів]] 
* [[Інструкція з друку на принтері GP-C80250 Series при підключенні по USB]]
</translate>

FAQ

2026-02-06T10:24:32Z

Lashta.v:

<languages/>
<translate>

FAQ, F.A.Q. (Frequently Asked Question(s) — підбірка часто задаваних питань на певну тему та відповідей на них, яка створюється переважно для того, щоб не треба було постійно відповідати на одні й ті ж запитання

</translate>

<translate>
'''Servio POS''' 
* [[Навчальні_матеріали_по_Servio_POS|Навчальні матеріали по Servio POS (ресторанній програмі)]] 
* [[Servio_Demo_доступ|Демо-доступ до ресторанної системи]]
* [[Додаткові операції над закритими рахунками в POS-модулі]]
* [[Закриття проблемного рахунку, де є проблема з банк-терміналом чи ФР/ПРРО]]
* [[Операції з закритим рахунком. Зміна видів оплат, повернення, відновлення, друк фіскального чеку та копії рахунку]]
* [[Де подивитися чеки та як зробити копію чеку по ПРРО]]
* [[Що перевірити, якщо не відображаються місця надання послуг]]
</translate>

<translate>
'''Servio HMS'''
* [[Навчальні_матеріали_Servio_HMS|Навчальні матеріали по Servio HMS (готельній програмі)]] 
* [[Demo_Servio_HMS|Демо-доступ до готельної системи]] 
* [[FAQ_Restriction_OTA|Як налаштувати обмеження продажів для ОТА каналів]] 
* [[FAQ_HMS_NoSlipFiscalOrder|Якщо фіскальний чек чи сліп банківського терміналу роздрукувався, а рахунок не оплачно в готельній програмі]] 
* [[FAQ_HMS_Оплати|Оплата рахунку без друку чеку, або без сліпу, або без чеку та без сліпу для стандартних типів оплат]] 
* [[Додавання нового постачальника на основі існуючого в HMS]]
* [[Призначення завдань покоївкам]]
</translate>

<translate>
'''Загальне | Інтеграції'''
* [[Банківські_термінали та фіскальні реєстратори|Список інтеграваних банківських терміналів]] 
* [[Інструкція з друку на принтері GP-C80250 Series при підключенні по USB]]
</translate>

Банківські термінали

2026-02-06T10:22:24Z

Lashta.v:

==Налаштування бібліотек фіскальних реєстраторів==

{| class="wikitable"
|-
! '''Назва бібліотеки''' !! '''COM-port''' !! '''TCP/IP''' !! '''Опис'''
|-
| '''FR_Atol_30F''' || + || - || Бібліотека для роботи з РРО Атол 30Ф. Потребує встановлення драйвера. Зібрана під драйвер версії 8.
|-
| '''FR_Checkbox''' || - || + || Бібліотека для роботи з ПРРО Checkbox по API.
|-
| '''FR_Connect''' || - || + || Бібліотека виступає проксі для іншої служби.
|-
| '''FR_ConnectDuplicator''' || - || + || Бібліотека виступає проксі для декількох інших служб.
|-
| '''FR_Cork''' || - || - || Пустотіла бібліотека для випадків відсутності інтеграції з фіскальним реєстратором (лише з банківським терміналом).
|-
| '''FR_DaisyPerfect_S''' || + || - || Бібліотека для роботи з РРО Daisy Prefect S.
|-
| '''FR_DATECS_FP_3141T''' || + || - || Бібліотека для роботи з РРО Datecs FP-3141T. Реалізація універсального протоколу Dateks v2.
|-
| '''FR_DATECS_FP_3530T''' || + || - || Бібліотека для роботи з РРО Datecs FP 3530T. Реалізація універсального протоколу Dateks v5.
|-
| '''FR_DATECS_FP_3530T_OLE''' || + || - || Бібліотека для роботи з РРО Datecs FP 3530T. Потребує встановлення DatecsECR OLE.
|-
| '''FR_DATECS_FP_700''' || + || - || Бібліотека для роботи з РРО Datecs FP 700.
|-
| '''FR_DATECS_KRYPTON''' || + || - || Бібліотека для роботи з РРО Datecs. Реалізація протоколу Dateks Krypton K6.
|-
| '''FR_Exelio''' || + || + || Бібліотека для роботи з РРО Exelio. Використовується драйвер Exellio FP. Потребує реєстрації бібліотеки (ExellioFP.dll).
|-
| '''FR_Fiskaltrust_AT''' || - || + || Бібліотека для роботи з ПРРО fiskaltrust.at.
|-
| '''FR_IKC_810T''' || + || - || Бібліотека для роботи з РРО IKC Е810T. Потребує реєстрації бібліотеки (NeoFiscalPrinterDriver.dll).
|-
| '''FR_IKC_E260T''' || + || - || Бібліотека для роботи з РРО IKC E260T.
|-
| '''FR_IntelectSoft''' || - || + || Бібліотека для роботи з ПРРО IntelectSoft через ISFiscalService.
|-
| '''FR_LeoCAS''' || + || + || Бібліотека для роботи з РРО LeoCAS. Використовується бібліотека EKKA2.
|-
| '''FR_Maria_301MTM''' || + || + || Бібліотека для роботи з РРО Марія. Реалізація протоколу Резонанс Торгівля.
|-
| '''FR_MG_N707TS''' || - || + || Бібліотека для роботи з РРО MG N707TS.
|-
| '''FR_MINI_FP54''' || + || + || Бібліотека для роботи з РРО MINI FP54. Потребує реєстрації бібліотеки (ecrT400.dll).
|-
| '''FR_Novitus''' || + || - || Бібліотека для роботи з РРО Novitus.
|-
| '''FR_NURKASSA''' || - || + || Бібліотека для роботи з ПРРО Nurkassa.
|-
| '''FR_PORT_FPG_1000''' || + || - || Бібліотека для роботи з РРО ПОРТ FPG-1000.
|-
| '''FR_REGOS_VCR''' || - || + || Бібліотека для роботи з ПРРО Regos.
|-
| '''FR_Star_SCP700''' || + || - || Бібліотека для роботи з РРО Star SCP700. Використовується бібліотека StarIO.
|-
| '''FR_TFP115''' || + || - || Бібліотека для роботи з РРО TFP-115. Потребує реєстрації бібліотеки (UniFiscalOcx.dll).
|-
| '''FR_TIS''' || - || + || Бібліотека для роботи з ПРРО Wipon Kassa.
|-
| '''FR_Touch_Belarus''' || + || - || Бібліотека для роботи з РРО Штрих-М для Білорусі. Потребує встановлення драйвера. Зібрана під драйвер ККТ 4.13.0.582.
|-
| '''FR_Touch-M_FR-K''' || + || - || Бібліотека для роботи з РРО Штрих-М. Потребує встановлення драйвера. Зібрана під драйвер ККТ 4.9.0.197.
|-
| '''FR_Touch-M_FR-K_415''' || + || - || Бібліотека для роботи з РРО Штрих-М. Потребує встановлення драйвера. Зібрана під драйвер ККТ 4.15.0.823.
|-
| '''FR_Touch-M_FR-K_415_FN''' || + || - || Бібліотека для роботи з РРО Штрих-М. Потребує встановлення драйвера. Зібрана під драйвер ККТ 4.15.0.823. Використовуються методи FN (методи роботи з фіскальним накопичувачем).
|-
| '''FR_TREMOL_FP15''' || + || + || Бібліотека для роботи з РРО Tremol FP15. Використовується бібліотека FPcore.
|-
| '''FR_Vchasno_Kasa''' || - || + || Бібліотека для роботи з ПРРО Вчасно.Каса.
|-
| '''FR_Webkassa_KZ''' || - || + || Бібліотека для роботи з ПРРО Webkassa.kz.
|}

==Налаштування бібліотек банківських терміналів==

{| class="wikitable"
|-
! '''Назва бібліотеки''' !! '''COM-port''' !! '''TCP/IP''' !! '''Опис'''
|-
| '''POS_Connect''' || - || + || Бібліотека виступає проксі для іншої служби.
|-
| '''POS_Cork''' || - || - || Пустотіла бібліотека для випадків відсутності інтеграції з банківським терміналом (лише з фіскальним реєстратором).
|-
| '''POS_Ingenico_Acrus''' || + || - || Бібліотека для роботи з БТ Ingenico через ПЗ Arcus. Потребує встановлення компонентів Arcus2.
|-
| '''POS_Ingenico_BPOS''' || + || + || Бібліотека для роботи з БТ Ingenico по протоколу B-POS1. Потребує реєстрації бібліотеки (ECRcommX.dll). Зібрана для версії 1.10.5.8.
|-
| '''POS_Ingenico_ECR''' || + || - || Бібліотека для роботи з БТ Ingenico по протоколу ECR (старіший за B-POS1). Потребує реєстрації бібліотеки (ECRcommX.dll). Зібрана для версії 1.7.8.0.
|-
| '''POS_Ingenico_ECR_A-BANK''' || - || + || Бібліотека для роботи з БТ по протоколу Акцент-Банк (JSON).
|-
| '''POS_Ingenico_ipp350''' || + || + || Бібліотека для роботи з БТ Ingenico по протоколу B-POS1. Потребує реєстрації бібліотеки (ECRcommX.dll). Зібрана для версії 1.9.3.5.
|-
| '''POS_Printec_POSAPI''' || + || + || Бібліотека для роботи з БТ Verifone, Castles по протоколу Printec POSAPI. Використовується бібліотека posnet. Потребує встановлення Visual C++ 2015 Redistributable (x86).
|-
| '''POS_PrivatBank_ECR''' || + || + || Бібліотека для роботи з БТ по протоколу PrivatBank ECR (JSON).
|-
| '''POS_Tactilion_ASAP''' || + || + || Бібліотека для роботи з БТ Tactilion по протоколу ASAP (Aria Service Application Protocol). Використовується бібліотека posnet. Потребує встановлення Visual C++ 2012 Redistributable (x86).
|-
| '''POS_VerifoneSberbank''' || + || - || Бібліотека для роботи з БТ через ПЗ Сбербанк. Використовується бібліотека LibraryGate.
|-
| '''POS_VerifoneSberbankEcr''' || + || - || Бібліотека для роботи з БТ через ПЗ Сбербанк. Потребує реєстрації бібліотеки (sbrf.dll).
|-
| '''POS_VerifoneVx675Dubai''' || + || - || Бібліотека для роботи з БТ по інтерфейсу NBAD (National Bank of Abu Dhabi). Використовується бібліотека ECR.
|-
| '''POS_VerifoneVxInpasEcr''' || + || + || Бібліотека для роботи з БТ Verifone по протоколу InpasEcr. Потребує реєстрації компонента InpasEcrCom.
|-
| '''POS_YARUS_PC2100''' || - || + || Бібліотека для роботи з БТ Yarus PC2100.
|-
| '''POS_Ingenico_ECR_A-BANK''' || - || + || Бібліотека для роботи з БТ ECR_A-BANK.
|-
| '''POS_SmartOne_PEK''' || + || + || Бібліотека для роботи з БТ по протоколу SmartOne PEK ECR (JSON)..
|-
| '''POS_Servus Systems Integration ECR''' ||- || + ||Бібліотека для роботи з БТ Verifone X990 по протоколу SSI ECR JSON.
|}

Відповідність версій HMS/БД

2026-01-16T10:57:26Z

Lashta.v:

{| class="wikitable"
|-
! Версія HMS !! Версія БД !! Скрипти
|-
| 01.01.001 || Unknown|| -
|-
| 01.01.002 || Unknown|| -
|-
| 01.01.003 || 06.01.009|| -
|-
| 01.01.004 || 06.01.021 || -
|-
| 01.01.005 || 06.01.035 || -
|-
| 01.01.006 || 06.01.035 || -
|-
| 01.01.007 || 06.01.051 || +
|-
| 01.01.008 || 06.01.051 || -
|-
| 01.01.009 || 06.01.051 || -
|-
| 01.01.010 || 06.01.051 || +
|-
| 01.01.011 || 06.01.060 || -
|-
| 01.01.012 || 06.01.060 || -
|-
| 01.01.013 || 06.01.060 || -
|-
| 01.01.014 || 06.01.065 || -
|-
| 01.01.015 || 06.01.065 || -
|-
| 01.01.016 || 06.01.069 || -
|-
| 01.01.017 || 06.01.069|| -
|-
| 01.01.018 || 06.01.070 || -
|-
| 01.01.019 || 06.01.070 || -
|-
| 01.01.020 || 06.01.070 || -
|-
| 01.01.021 || 06.01.071 || -
|-
| 01.01.022 || 06.01.071 || -
|-
| 01.01.023 || 06.01.071 || -
|-
| 01.01.024 || 06.01.074 || -
|-
| 01.01.025 || 06.01.078 || -
|-
| 01.01.026 || 06.01.083 || -
|-
| 01.01.027 || 06.01.085 || -
|-
| 01.01.028 || 06.01.085 || -
|-
| 01.01.029 || 06.01.085 || -
|-
| 01.01.030 || 06.01.089 || -
|-
| 01.01.031 || 06.01.112 || -
|-
| 01.01.032 || 06.01.116 || -
|-
| 01.01.033 || 06.01.118 || +
|-
| 01.01.034 || 06.01.125 || -
|-
| 01.01.035 || 06.01.157 || -
|-
| 01.01.036 || 06.01.162 || +
|-
| 01.01.037 || 06.01.163 || -
|-
| 01.01.038 || 06.01.165 || -
|-
| 01.01.039 || 06.01.166 || -
|-
| 01.01.040 || 06.01.170|| -
|-
| 01.01.041 || 06.01.170|| -
|-
| 01.01.042 || 06.01.173 || -
|-
| 01.01.043 || 06.01.174 || -
|-
| 01.01.044 || 06.01.176 || -
|-
| 01.01.045 || 06.01.179 || -
|-
| 01.01.046 || 06.01.181|| -
|-
| 01.01.047 || 06.01.182 || -
|-
| 01.01.048 || 06.01.183 || -
|-
| 01.01.049 || 06.01.185 || -
|}

Відповідність версій HMS/БД

2025-11-20T08:12:08Z

Lashta.v:

{| class="wikitable"
|-
! Версія HMS !! Версія БД !! Скрипти
|-
| 01.01.001 || Unknown|| -
|-
| 01.01.002 || Unknown|| -
|-
| 01.01.003 || 06.01.009|| -
|-
| 01.01.004 || 06.01.021 || -
|-
| 01.01.005 || 06.01.035 || -
|-
| 01.01.006 || 06.01.035 || -
|-
| 01.01.007 || 06.01.051 || +
|-
| 01.01.008 || 06.01.051 || -
|-
| 01.01.009 || 06.01.051 || -
|-
| 01.01.010 || 06.01.051 || +
|-
| 01.01.011 || 06.01.060 || -
|-
| 01.01.012 || 06.01.060 || -
|-
| 01.01.013 || 06.01.060 || -
|-
| 01.01.014 || 06.01.065 || -
|-
| 01.01.015 || 06.01.065 || -
|-
| 01.01.016 || 06.01.069 || -
|-
| 01.01.017 || 06.01.069|| -
|-
| 01.01.018 || 06.01.070 || -
|-
| 01.01.019 || 06.01.070 || -
|-
| 01.01.020 || 06.01.070 || -
|-
| 01.01.021 || 06.01.071 || -
|-
| 01.01.022 || 06.01.071 || -
|-
| 01.01.023 || 06.01.071 || -
|-
| 01.01.024 || 06.01.074 || -
|-
| 01.01.025 || 06.01.078 || -
|-
| 01.01.026 || 06.01.083 || -
|-
| 01.01.027 || 06.01.085 || -
|-
| 01.01.028 || 06.01.085 || -
|-
| 01.01.029 || 06.01.085 || -
|-
| 01.01.030 || 06.01.089 || -
|-
| 01.01.031 || 06.01.112 || -
|-
| 01.01.032 || 06.01.116 || -
|-
| 01.01.033 || 06.01.118 || +
|-
| 01.01.034 || 06.01.125 || -
|-
| 01.01.035 || 06.01.157 || +
|-
| 01.01.036 || 06.01.162 || +
|-
| 01.01.037 || 06.01.163 || -
|-
| 01.01.038 || 06.01.165 || -
|-
| 01.01.039 || 06.01.166 || -
|-
| 01.01.040 || 06.01.170|| -
|-
| 01.01.041 || 06.01.170|| -
|}

Відповідність версій HMS/БД

2025-11-11T08:29:03Z

Lashta.v:

{| class="wikitable"
|-
! Версія HMS !! Версія БД !! Скрипти
|-
| 01.01.001 || Unknown|| -
|-
| 01.01.002 || Unknown|| -
|-
| 01.01.003 || 06.01.009|| -
|-
| 01.01.004 || 06.01.021 || -
|-
| 01.01.005 || 06.01.035 || -
|-
| 01.01.006 || 06.01.035 || -
|-
| 01.01.007 || 06.01.051 || +
|-
| 01.01.008 || 06.01.051 || -
|-
| 01.01.009 || 06.01.051 || -
|-
| 01.01.010 || 06.01.051 || +
|-
| 01.01.011 || 06.01.060 || -
|-
| 01.01.012 || 06.01.060 || -
|-
| 01.01.013 || 06.01.060 || -
|-
| 01.01.014 || 06.01.065 || -
|-
| 01.01.015 || 06.01.065 || -
|-
| 01.01.016 || 06.01.069 || -
|-
| 01.01.017 || 06.01.069|| -
|-
| 01.01.018 || 06.01.070 || -
|-
| 01.01.019 || 06.01.070 || -
|-
| 01.01.020 || 06.01.070 || -
|-
| 01.01.021 || 06.01.071 || -
|-
| 01.01.022 || 06.01.071 || -
|-
| 01.01.023 || 06.01.071 || -
|-
| 01.01.024 || 06.01.074 || -
|-
| 01.01.025 || 06.01.078 || -
|-
| 01.01.026 || 06.01.083 || -
|-
| 01.01.027 || 06.01.085 || -
|-
| 01.01.028 || 06.01.085 || -
|-
| 01.01.029 || 06.01.085 || -
|-
| 01.01.030 || 06.01.089 || -
|-
| 01.01.031 || 06.01.112 || -
|-
| 01.01.032 || 06.01.116 || -
|-
| 01.01.033 || 06.01.118 || +
|-
| 01.01.034 || 06.01.125 || -
|-
| 01.01.035 || 06.01.157 || +
|-
| 01.01.036 || 06.01.162 || +
|-
| 01.01.037 || 06.01.163 || -
|-
| 01.01.038 || 06.01.165 || -
|-
| 01.01.039 || 06.01.166 || -
|}

Файл:New user.png

2025-10-28T08:42:39Z

Lashta.v:

Файл:New role.png

2025-10-28T08:42:25Z

Lashta.v:

Файл:Permissions.png

2025-10-28T08:42:15Z

Lashta.v:

Файл:Permissions SSL.png

2025-10-28T08:42:06Z

Lashta.v:

Файл:New user role.png

2025-10-28T08:41:56Z

Lashta.v:

Файл:New user hms.png

2025-10-28T08:41:45Z

Lashta.v:

Файл:Contract cond.png

2025-10-28T08:41:36Z

Lashta.v:

Файл:Password company.png

2025-10-28T08:41:24Z

Lashta.v:

Файл:Company contract.png

2025-10-28T08:41:10Z

Lashta.v:

Файл:Company contract cond.png

2025-10-28T08:40:54Z

Lashta.v:

Налаштування ТСО

2025-10-28T08:36:00Z

Lashta.v:

==Налаштування користувачів==
Налаштування роботи ТСО необхідно почати виконувати з додавання ролі та користувача які використовуватимуться тільки для ТСО.
===Створення ролі в HMS_MVC===
1. Створюємо в новому HMS_MVC роль, для цього необхідно авторизуватися під адміністратором (користувачем який має дозвіл на створення нових ролей та додавання користувачів), перейти в розділ "Administration" → "Identity management" → "Roles". Натиснути на кнопку "New role"
 
[[Файл:New role.png|1200px]]
 
У вікні "New Role" необхідно заповнити поле "Role name" та встановити галку в полі "Public", після цього зберегти дані. Для доданої нової ролі натиснути на кнопку "Actions" обрати "Permissions"
 
[[Файл:Permissions.png|1200px]]
 

для ролі додати доступ тільки до розділу "Permission:SelfServiceTerminal" та натискаємо на кнопку "Save"

 
[[Файл:Permissions SSL.png|700px]]
 
=== Створення нового користувача HMS_MVC===
Після цього необхідно створити нового користувача, для цього переходимо "Administration" → "Identity management" →"Users", настиснути на кнопку "New User" заповнити обов'язкові поля такі як:
* User name - на даному етапі, ім'я користувача з нового HMS_MVC має відповідати імені користувача, створеному в старому HMS
* Password - обов'язково має містити 1 велику, 1 маленьку літери, цифру та спецсимвол.
* Email address - необхідно вказувати реальну адресу електронної пошти, так як в майбутньому буде додано функціонал відновлення паролю, відповідно яку адресу буде вказано, за такою адресою і виконуватиметься відновлення.
 
[[Файл:New user.png|700px]]
 
Далі натискаємо на вкладку "Roles" та обираємо роль яку попередньо створювали для цього користувача та натиснути на кнопку "Save"
 
[[Файл:New user role.png|700px]]
 
===Створення нового користувача в HMS===
Далі в старому HMS створюємо користувача з таким самим ПІБ користувача як було вказано в User name при створенні користувача в HMS_MVC.
 
[[Файл:New user hms.png|700px]]
 
===Об'єднання користувачів в БД===
Далі необхідно зробити об'єднання користувача в таблицю "[AbpUserLoginTable]". 
Для цього беремо "LoginID" користувача TCO з таблиці "[Login_table]" БД старого HMS. 
в БД HMS_Audit необхідно взяти "Id" користувача ТСО з таблиці "AbpUsers". 

Скрипт об'єднання: 
'''''INSERT INTO [bd_name].[db_pms].[AbpUserLoginTable] (AbpUserID, LoginTableID)''''' 
'''''VALUES ('409B50F9-D8C6-0D2B-6A5C-3A177C715659',408)''''' 

==Налаштування шляху для контенту==

Для того, щоб в ТСО підтягувалися всі фото, які налаштовуються в рекламному редакторі, а також був доступ до зісканованих документів гостей, необхідно виконати налаштування до спільної теки Content для двох сайтів HMS та HMS_MVC. 
Відкриваємо в старому HMS ''"Налаштування → Параметри системи → Інсталяції → (обрати "Default" інсталяцію) →Різне"'' в параметрі "Шлях до папки для зберігання файлів" необхідно вказати шлях до папки сайту, де знаходиться тека Content з якої тягнутиме всі дані, тобто, якщо налаштовуємо через рекламний редактор старого HMS, то і відповідно шлях має йти до сайту старого HMS, наприклад: ''D:\Servio_HMS\HMS_QA_MixTest\HMS'' в саму папку Content не заводимо.

==Налаштування компанії для роботи з ТСО==
В старому HMS необхідно створи компанію, через яку виконуватимуться продажі через ТСО. Принцип налаштування так і для модуля бронювання. 
===Створення умов договорів===
Необхідно створити умови договорів (У випадку якщо вже не додано необхідних), за якими працюватиме ТСО, для цього необхідно перейти за посиланнями "Бухгалтерія → Договори →Умови договорів". Заповнити всі обов'язкові поля та натиснути на кнопку "Додати"
 
[[Файл:Contract cond.png|700px]]
 
===Налаштування карти компанії ===
В створеній карті компанії необхідно перейти на вкладку "Паролі" 
В полі "Код" необхідно згенерувати пароль компанії, після цього, в блоці "Умови" необхідно обрати умови договору які будуть доступні цій компанії. Після додавання всіх параметрів натиснути кнопку "Додати", дані будуть збережені.
 
[[Файл:Password company.png|1200px]]
 
Далі необхідно перейти на вкладку "Договори" та створити договір для компанії. Для цього: 
* Заповнюємо всі обов'язкові поля - Номер договору, Дата підписання, Дата початку
* Натиснути на кнопку "Додати пропозицію"
 
[[Файл:Company contract.png|1200px]]
 
Відкрити пропозицію на редагування та додати умови договору які створювали раніше обрати потрібний прейскурант для цієї умови (в разі відсутності створити новий прейскурант) та встановити тип оплати "К/К" та натиснути на кнопку "Додати".
 
[[Файл:Company contract cond.png|1200px]]
 
===Надання доступу компанії до роботи з ТСО===
Скопіювати згенерований "Код" в карті компанії на вкладці "Паролі". Перейти за посиланням ''"Налаштування → Параметри системи → Інсталяції → (обрати "Default" інсталяцію) →Різне"'' в параметр "Пароль компанії для терміналу самообслуговування:" вставити скопійований код та зберегти налаштування.

==Налаштування логотипів та категорій кімнат==
Логотип готелю, назву готелю, фото категорії та опис ТСО забирає з розділу "Рекламний редактор". Для можливості перемикання між мовами та отримання інформації відповідною мовою, варто додавати описи всіма мовами якими готель хоче бачити інформацію.

Перейти за посиланням ''"Продаж → Рекламний редактор → Готелі"'', у випадаючому списку "Готель" для якого виконуватимуться налаштування. 
В полі "Додаванян логотипу" натиснути кнопку "Вибрати файл" та обрати фото лого готелю, після цього натиснути на кнопку "Додати".
 
[[Файл:Logo SST.png |1200px]]
 
Для відображення якісного фото, рекомендовано в папці "Content" замінити завантажене фото з рекламного редактору на оригінальне (через завантаження фото стискається і при переході на ТСО відображуватиметься розмитим), назву необхідно зберегти такою, яка створилася при завантаженні фото через редактор - '''"HotelID1_1_LOGO"''' 

Перейти на вкладку ''"Типи номерів"'', в полі "Готель" обрати потрібний готель, в полі "Тип номеру" обрати з випадабчого списку категорію номеру для якої буде додано фото та опис категорії. 
В полі "Додаванян фотографії" натиснути кнопку "Вибрати файл" та обрати фото відповідної категорії, після цього натиснути на кнопку "Додати". Праворуч над полем для введення тексту обрати в полі "Мова" мову якою буде додано опис.

'''Важливо!!!''' Які мови буде обрано та додано опис, тільки тими мовами буде відображуватися даний опис в ТСО, якщо доступні до вибору будуть інші мови, то опис категорії не буде відображуватися при виборі мови, для якої не було додано опису в рекламному редакторі.
 
[[Файл:Room type.png |1200px]]
 

[[Файл:Room type EN.png |1200px]]
 

==Налаштування оплати==
Для роботи ТСО рекомендовано створити окрему касу, каса має бути фіскалізована, так як оплати приймаються тільки банківськими картками. При створенні каси обов'язково додати в касу постачальника по якому виконуватимуться оплати. В типах оплати додати "Кредитна карта" з налаштуванням ідентифікатора мерчанта.
 
[[Файл:Checkout.png |1200px]]
 
В постачальника обов'язково має бути додано тип оплати "Кредитна карта" в каналі продажу "SERVIO HMS"
 
[[Файл:Payment type.png |700px]]
 
Створену касу необхідно додати до робочого місця та до користувача ТСО, в користувача ТСО має бути доступна лише одна каса.
Робоче місце має бути прив'язано до готелю для якого налаштовується ТСО.
 
[[Файл:Working place.png |700px]]
 

==Налаштування сканування документів==
Для сканування документів необхідно встановити службу паспортів. Можна використовувати як Регула так і зчитувач через ДІЯ сервіс. Для цього необхідно в розділі "Налаштування → Обладнання → Зчитувачі паспортів" додати адресу служби паспортів. Доданий зчитувач також необхідно додати до робочого місця.

==Налаштування кодування ключ-карти==
Для кодування ключ-карток необхідно встановити службу замків LockService. Для цього необхідно в розділі ''"Налаштування → Обладнання → Замки"'' додати адресу служби замків. Доданий замок також необхідно додати до робочого місця. 

Перейти за посиланням ''"Налаштування → Керування номерним фондом → Електронні замки"'' додати номери замків, при додаванні можна одразу зв'язати з номером кімнати або після цього перейти на вкладку "Номери" та для відповідного номеру кімнати додати номер замка. для цього відкриваємо запис номера на редагування, в полі "Замки" з випадабчого списку обрати відповідний замок до цього номеру, після цього зберегти зміни.

Після внесення всіх налаштувань необхідно перезапустити пул HMS_MVS

Файл:Logo SST.png

2025-10-28T08:35:28Z

Lashta.v:

Файл:Room type.png

2025-10-28T08:34:44Z

Lashta.v:

Файл:Room type EN.png

2025-10-28T08:34:33Z

Lashta.v:

Файл:Checkout.png

2025-10-28T08:34:23Z

Lashta.v:

Файл:Payment type.png

2025-10-28T08:34:13Z

Lashta.v:

Файл:Working place.png

2025-10-28T08:33:55Z

Lashta.v:

Налаштування ТСО

2025-10-28T08:30:49Z

Lashta.v: Створена сторінка: ==Налаштування користувачів== Налаштування роботи ТСО необхідно почати виконувати з додавання ролі та користувача які використовуватимуться тільки для ТСО. ===Створення ролі в HMS_MVC=== 1. Створюємо в новому HMS_MVC роль, для цього необхідно авторизуватися пі...

==Налаштування користувачів==
Налаштування роботи ТСО необхідно почати виконувати з додавання ролі та користувача які використовуватимуться тільки для ТСО.
===Створення ролі в HMS_MVC===
1. Створюємо в новому HMS_MVC роль, для цього необхідно авторизуватися під адміністратором (користувачем який має дозвіл на створення нових ролей та додавання користувачів), перейти в розділ "Administration" → "Identity management" → "Roles". Натиснути на кнопку "New role"
 
[[Файл:New role.png|1200px]]
 
У вікні "New Role" необхідно заповнити поле "Role name" та встановити галку в полі "Public", після цього зберегти дані. Для доданої нової ролі натиснути на кнопку "Actions" обрати "Permissions"
 
[[Файл:Permissions.png|1200px]]
 

для ролі додати доступ тільки до розділу "Permission:SelfServiceTerminal" та натискаємо на кнопку "Save"

 
[[Файл:Permissions SSL.png|700px]]
 
=== Створення нового користувача HMS_MVC===
Після цього необхідно створити нового користувача, для цього переходимо "Administration" → "Identity management" →"Users", настиснути на кнопку "New User" заповнити обов'язкові поля такі як:
* User name - на даному етапі, ім'я користувача з нового HMS_MVC має відповідати імені користувача, створеному в старому HMS
* Password - обов'язково має містити 1 велику, 1 маленьку літери, цифру та спецсимвол.
* Email address - необхідно вказувати реальну адресу електронної пошти, так як в майбутньому буде додано функціонал відновлення паролю, відповідно яку адресу буде вказано, за такою адресою і виконуватиметься відновлення.
 
[[Файл:New user.png|700px]]
 
Далі натискаємо на вкладку "Roles" та обираємо роль яку попередньо створювали для цього користувача та натиснути на кнопку "Save"
 
[[Файл:New user role.png|700px]]
 
===Створення нового користувача в HMS===
Далі в старому HMS створюємо користувача з таким самим ПІБ користувача як було вказано в User name при створенні користувача в HMS_MVC.
 
[[Файл:New user hms.png|700px]]
 
===Об'єднання користувачів в БД===
Далі необхідно зробити об'єднання користувача в таблицю "[AbpUserLoginTable]". 
Для цього беремо "LoginID" користувача TCO з таблиці "[Login_table]" БД старого HMS. 
в БД HMS_Audit необхідно взяти "Id" користувача ТСО з таблиці "AbpUsers". 

Скрипт об'єднання: 
'''''INSERT INTO [bd_name].[db_pms].[AbpUserLoginTable] (AbpUserID, LoginTableID)''''' 
'''''VALUES ('409B50F9-D8C6-0D2B-6A5C-3A177C715659',408)''''' 

==Налаштування шляху для контенту==

Для того, щоб в ТСО підтягувалися всі фото, які налаштовуються в рекламному редакторі, а також був доступ до зісканованих документів гостей, необхідно виконати налаштування до спільної теки Content для двох сайтів HMS та HMS_MVC. 
Відкриваємо в старому HMS ''"Налаштування → Параметри системи → Інсталяції → (обрати "Default" інсталяцію) →Різне"'' в параметрі "Шлях до папки для зберігання файлів" необхідно вказати шлях до папки сайту, де знаходиться тека Content з якої тягнутиме всі дані, тобто, якщо налаштовуємо через рекламний редактор старого HMS, то і відповідно шлях має йти до сайту старого HMS, наприклад: ''D:\Servio_HMS\HMS_QA_MixTest\HMS'' в саму папку Content не заводимо.

==Налаштування компанії для роботи з ТСО==
В старому HMS необхідно створи компанію, через яку виконуватимуться продажі через ТСО. Принцип налаштування так і для модуля бронювання. 
===Створення умов договорів===
Необхідно створити умови договорів (У випадку якщо вже не додано необхідних), за якими працюватиме ТСО, для цього необхідно перейти за посиланнями "Бухгалтерія → Договори →Умови договорів". Заповнити всі обов'язкові поля та натиснути на кнопку "Додати"
 
[[Файл:Contract cond.png|700px]]
 
===Налаштування карти компанії ===
В створеній карті компанії необхідно перейти на вкладку "Паролі" 
В полі "Код" необхідно згенерувати пароль компанії, після цього, в блоці "Умови" необхідно обрати умови договору які будуть доступні цій компанії. Після додавання всіх параметрів натиснути кнопку "Додати", дані будуть збережені.
 
[[Файл:Password company.png|1200px]]
 
Далі необхідно перейти на вкладку "Договори" та створити договір для компанії. Для цього: 
* Заповнюємо всі обов'язкові поля - Номер договору, Дата підписання, Дата початку
* Натиснути на кнопку "Додати пропозицію"
 
[[Файл:Company contract.png|1200px]]
 
Відкрити пропозицію на редагування та додати умови договору які створювали раніше обрати потрібний прейскурант для цієї умови (в разі відсутності створити новий прейскурант) та встановити тип оплати "К/К" та натиснути на кнопку "Додати".
 
[[Файл:Company contract cond.png|1200px]]
 
===Надання доступу компанії до роботи з ТСО===
Скопіювати згенерований "Код" в карті компанії на вкладці "Паролі". Перейти за посиланням ''"Налаштування → Параметри системи → Інсталяції → (обрати "Default" інсталяцію) →Різне"'' в параметр "Пароль компанії для терміналу самообслуговування:" вставити скопійований код та зберегти налаштування.

==Налаштування логотипів та категорій кімнат==
Логотип готелю, назву готелю, фото категорії та опис ТСО забирає з розділу "Рекламний редактор". Для можливості перемикання між мовами та отримання інформації відповідною мовою, варто додавати описи всіма мовами якими готель хоче бачити інформацію.

Перейти за посиланням ''"Продаж → Рекламний редактор → Готелі"'', у випадаючому списку "Готель" для якого виконуватимуться налаштування. 
В полі "Додаванян логотипу" натиснути кнопку "Вибрати файл" та обрати фото лого готелю, після цього натиснути на кнопку "Додати".
 
[[Файл:Logo.png |1200px]]
 
Для відображення якісного фото, рекомендовано в папці "Content" замінити завантажене фото з рекламного редактору на оригінальне (через завантаження фото стискається і при переході на ТСО відображуватиметься розмитим), назву необхідно зберегти такою, яка створилася при завантаженні фото через редактор - '''"HotelID1_1_LOGO"''' 

Перейти на вкладку ''"Типи номерів"'', в полі "Готель" обрати потрібний готель, в полі "Тип номеру" обрати з випадабчого списку категорію номеру для якої буде додано фото та опис категорії. 
В полі "Додаванян фотографії" натиснути кнопку "Вибрати файл" та обрати фото відповідної категорії, після цього натиснути на кнопку "Додати". Праворуч над полем для введення тексту обрати в полі "Мова" мову якою буде додано опис.

'''Важливо!!!''' Які мови буде обрано та додано опис, тільки тими мовами буде відображуватися даний опис в ТСО, якщо доступні до вибору будуть інші мови, то опис категорії не буде відображуватися при виборі мови, для якої не було додано опису в рекламному редакторі.
 
[[Файл:Room type.png |1200px]]
 

[[Файл:Room type EN.png |1200px]]
 

==Налаштування оплати==
Для роботи ТСО рекомендовано створити окрему касу, каса має бути фіскалізована, так як оплати приймаються тільки банківськими картками. При створенні каси обов'язково додати в касу постачальника по якому виконуватимуться оплати. В типах оплати додати "Кредитна карта" з налаштуванням ідентифікатора мерчанта.
 
[[Файл:Checkout.png |1200px]]
 
В постачальника обов'язково має бути додано тип оплати "Кредитна карта" в каналі продажу "SERVIO HMS"
 
[[Файл:Payment type.png |700px]]
 
Створену касу необхідно додати до робочого місця та до користувача ТСО, в користувача ТСО має бути доступна лише одна каса.
Робоче місце має бути прив'язано до готелю для якого налаштовується ТСО.
 
[[Файл:Working place.png |700px]]
 

==Налаштування сканування документів==
Для сканування документів необхідно встановити службу паспортів. Можна використовувати як Регула так і зчитувач через ДІЯ сервіс. Для цього необхідно в розділі "Налаштування → Обладнання → Зчитувачі паспортів" додати адресу служби паспортів. Доданий зчитувач також необхідно додати до робочого місця.

==Налаштування кодування ключ-карти==
Для кодування ключ-карток необхідно встановити службу замків LockService. Для цього необхідно в розділі ''"Налаштування → Обладнання → Замки"'' додати адресу служби замків. Доданий замок також необхідно додати до робочого місця. 

Перейти за посиланням ''"Налаштування → Керування номерним фондом → Електронні замки"'' додати номери замків, при додаванні можна одразу зв'язати з номером кімнати або після цього перейти на вкладку "Номери" та для відповідного номеру кімнати додати номер замка. для цього відкриваємо запис номера на редагування, в полі "Замки" з випадабчого списку обрати відповідний замок до цього номеру, після цього зберегти зміни.

Після внесення всіх налаштувань необхідно перезапустити пул HMS_MVS

Інструкція "Servio HMS MVC"

2025-10-28T08:30:15Z

Lashta.v:

* [[Відповідність версій HMS/БД]]
* [[Налаштування телеграм-боту по покоївкам у новому HMS]]
* [[Додавання телеграм-ботів у новому HMS]]
* [[Налаштування Inline-кнопок для розсилок]]
* [[Integration with Facebook(META)]]
* [[Налаштування ТСО]]

Відповідність версій HMS/БД

2025-10-27T08:37:55Z

Lashta.v:

Відповідність версій HMS/БД

2025-10-16T10:37:59Z

Lashta.v:

Відповідність версій HMS/БД

2025-10-16T10:37:42Z

Lashta.v: Створена сторінка: {| class="wikitable" |+ Текст опису |- ! Версія HMS !! Версія БД !! Скрипти |- | 01.01.001 || Unknown|| - |- | 01.01.002 || Unknown|| - |- | 01.01.003 || 06.01.009|| - |- | 01.01.004 || 06.01.021 || - |- | 01.01.005 || 06.01.035 || - |- | 01.01.006 || 06.01.035 || - |- | 01.01.007 || 06.01.051 || + |- | 01.01.008 || 06.01.051 || - |- | 01.01.009 || 06.01.051 || - |- | 01.01.010 || 06.01.051 || + |- | 01.01.011 || 06.01.060 ||...

{| class="wikitable"
|+ Текст опису
|-
! Версія HMS !! Версія БД !! Скрипти
|-
| 01.01.001 || Unknown|| -
|-
| 01.01.002 || Unknown|| -
|-
| 01.01.003 || 06.01.009|| -
|-
| 01.01.004 || 06.01.021 || -
|-
| 01.01.005 || 06.01.035 || -
|-
| 01.01.006 || 06.01.035 || -
|-
| 01.01.007 || 06.01.051 || +
|-
| 01.01.008 || 06.01.051 || -
|-
| 01.01.009 || 06.01.051 || -
|-
| 01.01.010 || 06.01.051 || +
|-
| 01.01.011 || 06.01.060 || -
|-
| 01.01.012 || 06.01.060 || -
|-
| 01.01.013 || 06.01.060 || -
|-
| 01.01.014 || 06.01.065 || -
|-
| 01.01.015 || 06.01.065 || -
|-
| 01.01.016 || 06.01.069 || -
|-
| 01.01.017 || 06.01.069|| -
|-
| 01.01.018 || 06.01.070 || -
|-
| 01.01.019 || 06.01.070 || -
|-
| 01.01.020 || 06.01.070 || -
|-
| 01.01.021 || 06.01.071 || -
|-
| 01.01.022 || 06.01.071 || -
|-
| 01.01.023 || 06.01.071 || -
|-
| 01.01.024 || 06.01.074 || -
|-
| 01.01.025 || 06.01.078 || -
|-
| 01.01.026 || 06.01.083 || -
|-
| 01.01.027 || 06.01.085 || -
|-
| 01.01.028 || 06.01.085 || -
|-
| 01.01.029 || 06.01.085 || -
|-
| 01.01.030 || 06.01.089 || -
|-
| 01.01.031 || 06.01.112 || -
|-
| 01.01.032 || 06.01.116 || -
|-
| 01.01.033 || 06.01.118 || +
|-
| 01.01.034 || 06.01.125 || -
|-
| 01.01.035 || 06.01.157 || +
|}

Інструкція "Servio HMS MVC"

2025-10-16T10:29:11Z

Lashta.v:

* [[Налаштування телеграм-боту по покоївкам у новому HMS]]
* [[Додавання телеграм-ботів у новому HMS]]
* [[Налаштування Inline-кнопок для розсилок]]
* [[Integration with Facebook(META)]]
* [[Відповідність версій HMS/БД]]

Налаштування Inline-кнопок для розсилок

2025-06-26T10:01:25Z

Lashta.v: /* Додавання Inline-кнопок до правил розсилки */

==Додавання Inline-кнопок для масової розсилки повідомлень==
Для масової розсилки повідомлень користувачам необхідно перейти по сторінкам: CRM → Контакти. Обрати одного або декількох користувачів для відправки повідомлення, встановивши галки навпроти кожної анкети яким необхідно виконати розсилку.
 
[[Файл:Guest select send.png|1000px]]
 
Для відбору користувачів для розсилки також можна використовувати користувацькі фільтри, що значно спрощує пошук необхідних користувачів. Для цього необхідно натиснути на кнопку "Користувацькі фільтри" в переліку раніше створених фільтрів обрати потрібний, після цього натиснути наполе для встановлення чекбоксу в шапці таблиці, таким чином галки застосуються для всіх записів відібраних за фільтром.
 
[[Файл:Guest filter select.png|1000px]]
 
Після того як обрали анкети для надсилання, необхідно натиснути на кнопку "Надіслати повідомлення", відкривається форма заповнення даних для розсилки
 
[[Файл:Guest send message.png|1000px]]
 
Inline-кнопки реалізовані тільки для телеграм повідомлень, тому при заповненні форми необхідно обрати:
* Тип - Telegram (гостьовий)
* Бот - телеграм бот який створений для гостьових розсилок (обов'язкове поле до заповнення)
* Повідомлення - необхідно додати текст повідомлення (обов'язкове поле до заповнення)
* Inline-кнопки - відображується кнопка з назвою "Додати новий рядок".
 
[[Файл:Message inline button.png|1000px]]
 
Після натискання на дану кнопку відкриється форма для заповнення назви Inline-кнопки та поле для введення посилання за яким перейде користувач після натискання на таку кнопку.
* Назва - обов'язкове поле, пропускає на введення від 1 до 20 символів враховуючи прогалини
* Посилання - обов'язкове поле, допускається введення саме посилання на сайт/картинку і т.д. Наприклад: https://hmsdemo.servioreservation.com/
* Додати - натискання на кнопку, додає її до повідомлення
* Скасувати - скасовує додавання Inline-кнопки до форми повідомлення
 
[[Файл:Message add inline button.png|1000px]]
 
Після того як натиснути на кнопку "Додати", Inline-кнопка відображується в формі повідомлення
 
[[Файл:Message inline button1.png|1000px]]
 
Якщо необхідно додати декілька кнопок, їм можна додавати як в один рядок так і кожну кнопку окремим рядком. 
Для додавання нової кнопки окремим рядком потрібно повторно натиснути на кнопку "Додати новий рядок", заповнити всі необхідні поля і натиснути на кнопку "Додати". Тоді в повідомленні кнопки розташовуватимуться одна під одною
 
[[Файл:Message add some inline button.png|1000px]]
 
Також можна додати декілька кнопок в один ряд, для цього використовується кнопка у вигляді "'''+'''" навпроти першої доданої кнопки. Максимально в один рядок можна додати 3 кнопки.
 
[[Файл:Message add some inline button2.png|1000px]]
 
Для редагування або видалення кнопки, необхідно натиснути на вже додану кнопку, відкривається вікно з інформацією про цю inline-кнопку з можливістю змінити назву та посилання і відповідно кнопками "Зберегти" та "Видалити".
 
За необхідності також можна додати файл натиснувши на поле "завантажити файл". Після заверешення формування повідомлення натиснути на кнопку "Відправити", і повідомлення буде надіслано всім обраним користувачам.
 
[[Файл:Guest telegram inline.png|300px]]
 

==Додавання Inline-кнопок до правил розсилки ==

Для масової розсилки повідомлень користувачам необхідно перейти по сторінкам: '''CRM → Розсилки'''. Натиснути на кнопку "Додати правило", після цього відкриється форма для додавання правила розсилки.
 
[[Файл:Create rule message .png|1000px]]
 
Inline-кнопки реалізовані тільки для телеграм розсилок, тому при створенні правила розсилки необхідно обрати:
* Тип - Контакти або Компанії (обов'язкове поле до заповнення)
* Фільтр пошуку - в залежності від обраного типу відображуються фільтри, якщо Тип вказано - Контакти, то в переліку будуть доступні користувацькі фільтри, які додавалися на сторінці ''CRM → Контакти'', необхідно обрати один з фільтрів за яким буде виконано відбір анкет для здійснення розсилки
* Надіслати на - '''Telegram (гостьовий)'''
* Бот для відправки - телеграм бот який створений для гостьових розсилок (обов'язкове поле до заповнення)
* Час для відправки - вказується в форматі гг:хх (обов'язкове поле до заповнення), наприклад: 21:37
* Повторювати - необхідно обрати один з варіантів повторення, в залежності від обраної повторюваності стільки разів буде надіслано дана розсилка:
# Одноразово - буде виконано відправку повідомлення один раз у встановлений час в період зазначений в полях Дата початку/Дата завершення
# Кожен день - буде виконано відправку повідомлення кожного дня у встановлений час в період зазначений в полях Дата початку/Дата завершення, і таку кількість разів яка вказана в полі Повторювати з відповідним інтервалом зазначеним в полі Інтервал
# Щотижня - буде виконано відправку повідомлення кожного тижня у встановлений час та день в період зазначений в полях Дата початку/Дата завершення, і таку кількість разів яка вказана в полі Повторювати з відповідним інтервалом зазначеним в полі Інтервал
# Кожен місяць - буде виконано відправку повідомлення кожного місяця у встановлений час та дату в період зазначений в полях Дата початку/Дата завершення, і таку кількість разів яка вказана в полі Повторювати з відповідним інтервалом зазначеним в полі Інтервал
* Тема - вказати тему розсилки (обов'язкове поле до заповнення)
* Шаблон листа - необхідно додати текст повідомлення (обов'язкове поле до заповнення)
* Inline-кнопки - відображується кнопка з назвою "Додати новий рядок".
 
[[Файл:Create rule message inline .png|1000px]]
 
Після натискання на дану кнопку відкриється форма для заповнення назви Inline-кнопки та поле для введення посилання за яким перейде користувач після натискання на таку кнопку.
* Назва - обов'язкове поле, пропускає на введення від 1 до 20 символів враховуючи прогалини
* Посилання - обов'язкове поле, допускається введення саме посилання на сайт/картинку і т.д. Наприклад: https://hmsdemo.servioreservation.com/
* Додати - натискання на кнопку, додає її до повідомлення
* Скасувати - скасовує додавання Inline-кнопки до форми повідомлення
 
[[Файл:Create rule message inline2 .png|1000px]]
 
Після того як натиснути на кнопку "Додати", Inline-кнопка відображується в формі повідомлення
 
[[Файл:Create rule message inline3 .png|1000px]]
 
Якщо необхідно додати декілька кнопок, їм можна додавати як в один рядок так і кожну кнопку окремим рядком. 
Для додавання нової кнопки окремим рядком потрібно повторно натиснути на кнопку "Додати новий рядок", заповнити всі необхідні поля і натиснути на кнопку "Додати". Тоді в повідомленні кнопки розташовуватимуться одна під одною
 
[[Файл:Create rule message inline4.png|1000px]]
 
Також можна додати декілька кнопок в один ряд, для цього використовується кнопка у вигляді "'''+'''" навпроти першої доданої кнопки. Максимально в один рядок можна додати 3 кнопки.
 
[[Файл:Create rule message inline5.png|1000px]]
 

Для редагування або видалення кнопки, необхідно натиснути на вже додану кнопку, відкривається вікно з інформацією про цю inline-кнопку з можливістю змінити назву та посилання і відповідно кнопками "Зберегти" та "Видалити".
 
За необхідності також можна додати файл натиснувши на кнопку "Додати файл". Після заверешення формування правила розсилки натиснути на кнопку "Додати", і повідомлення буде надіслано всім адресатам по застосованому фільтру у встановлений час та з відповідним інтервалом та кількістю відправок.
 
[[Файл:Guest telegram inline.png|300px]]

Файл:Create rule message inline5.png

2025-06-26T09:53:50Z

Lashta.v:

Файл:Create rule message inline4.png

2025-06-26T09:52:30Z

Lashta.v:

Файл:Create rule message inline3 .png

2025-06-26T09:50:39Z

Lashta.v:

Налаштування Inline-кнопок для розсилок

2025-06-26T09:21:14Z

Lashta.v: /* Додавання Inline-кнопок до правил розсилки */

==Додавання Inline-кнопок для масової розсилки повідомлень==
Для масової розсилки повідомлень користувачам необхідно перейти по сторінкам: CRM → Контакти. Обрати одного або декількох користувачів для відправки повідомлення, встановивши галки навпроти кожної анкети яким необхідно виконати розсилку.
 
[[Файл:Guest select send.png|1000px]]
 
Для відбору користувачів для розсилки також можна використовувати користувацькі фільтри, що значно спрощує пошук необхідних користувачів. Для цього необхідно натиснути на кнопку "Користувацькі фільтри" в переліку раніше створених фільтрів обрати потрібний, після цього натиснути наполе для встановлення чекбоксу в шапці таблиці, таким чином галки застосуються для всіх записів відібраних за фільтром.
 
[[Файл:Guest filter select.png|1000px]]
 
Після того як обрали анкети для надсилання, необхідно натиснути на кнопку "Надіслати повідомлення", відкривається форма заповнення даних для розсилки
 
[[Файл:Guest send message.png|1000px]]
 
Inline-кнопки реалізовані тільки для телеграм повідомлень, тому при заповненні форми необхідно обрати:
* Тип - Telegram (гостьовий)
* Бот - телеграм бот який створений для гостьових розсилок (обов'язкове поле до заповнення)
* Повідомлення - необхідно додати текст повідомлення (обов'язкове поле до заповнення)
* Inline-кнопки - відображується кнопка з назвою "Додати новий рядок".
 
[[Файл:Message inline button.png|1000px]]
 
Після натискання на дану кнопку відкриється форма для заповнення назви Inline-кнопки та поле для введення посилання за яким перейде користувач після натискання на таку кнопку.
* Назва - обов'язкове поле, пропускає на введення від 1 до 20 символів враховуючи прогалини
* Посилання - обов'язкове поле, допускається введення саме посилання на сайт/картинку і т.д. Наприклад: https://hmsdemo.servioreservation.com/
* Додати - натискання на кнопку, додає її до повідомлення
* Скасувати - скасовує додавання Inline-кнопки до форми повідомлення
 
[[Файл:Message add inline button.png|1000px]]
 
Після того як натиснути на кнопку "Додати", Inline-кнопка відображується в формі повідомлення
 
[[Файл:Message inline button1.png|1000px]]
 
Якщо необхідно додати декілька кнопок, їм можна додавати як в один рядок так і кожну кнопку окремим рядком. 
Для додавання нової кнопки окремим рядком потрібно повторно натиснути на кнопку "Додати новий рядок", заповнити всі необхідні поля і натиснути на кнопку "Додати". Тоді в повідомленні кнопки розташовуватимуться одна під одною
 
[[Файл:Message add some inline button.png|1000px]]
 
Також можна додати декілька кнопок в один ряд, для цього використовується кнопка у вигляді "'''+'''" навпроти першої доданої кнопки. Максимально в один рядок можна додати 3 кнопки.
 
[[Файл:Message add some inline button2.png|1000px]]
 
Для редагування або видалення кнопки, необхідно натиснути на вже додану кнопку, відкривається вікно з інформацією про цю inline-кнопку з можливістю змінити назву та посилання і відповідно кнопками "Зберегти" та "Видалити".
 
За необхідності також можна додати файл натиснувши на поле "завантажити файл". Після заверешення формування повідомлення натиснути на кнопку "Відправити", і повідомлення буде надіслано всім обраним користувачам.
 
[[Файл:Guest telegram inline.png|300px]]
 

==Додавання Inline-кнопок до правил розсилки ==

Для масової розсилки повідомлень користувачам необхідно перейти по сторінкам: '''CRM → Розсилки'''. Натиснути на кнопку "Додати правило", після цього відкриється форма для додавання правила розсилки.
 
[[Файл:Create rule message .png|1000px]]
 
Inline-кнопки реалізовані тільки для телеграм розсилок, тому при створенні правила розсилки необхідно обрати:
* Тип - Контакти або Компанії (обов'язкове поле до заповнення)
* Фільтр пошуку - в залежності від обраного типу відображуються фільтри, якщо Тип вказано - Контакти, то в переліку будуть доступні користувацькі фільтри, які додавалися на сторінці ''CRM → Контакти'', необхідно обрати один з фільтрів за яким буде виконано відбір анкет для здійснення розсилки
* Надіслати на - '''Telegram (гостьовий)'''
* Бот для відправки - телеграм бот який створений для гостьових розсилок (обов'язкове поле до заповнення)
* Час для відправки - вказується в форматі гг:хх (обов'язкове поле до заповнення), наприклад: 21:37
* Повторювати - необхідно обрати один з варіантів повторення, в залежності від обраної повторюваності стільки разів буде надіслано дана розсилка:
# Одноразово - буде виконано відправку повідомлення один раз у встановлений час в період зазначений в полях Дата початку/Дата завершення
# Кожен день - буде виконано відправку повідомлення кожного дня у встановлений час в період зазначений в полях Дата початку/Дата завершення, і таку кількість разів яка вказана в полі Повторювати з відповідним інтервалом зазначеним в полі Інтервал
# Щотижня - буде виконано відправку повідомлення кожного тижня у встановлений час та день в період зазначений в полях Дата початку/Дата завершення, і таку кількість разів яка вказана в полі Повторювати з відповідним інтервалом зазначеним в полі Інтервал
# Кожен місяць - буде виконано відправку повідомлення кожного місяця у встановлений час та дату в період зазначений в полях Дата початку/Дата завершення, і таку кількість разів яка вказана в полі Повторювати з відповідним інтервалом зазначеним в полі Інтервал
* Тема - вказати тему розсилки (обов'язкове поле до заповнення)
* Шаблон листа - необхідно додати текст повідомлення (обов'язкове поле до заповнення)
* Inline-кнопки - відображується кнопка з назвою "Додати новий рядок".
 
[[Файл:Create rule message inline .png|1000px]]
 
Після натискання на дану кнопку відкриється форма для заповнення назви Inline-кнопки та поле для введення посилання за яким перейде користувач після натискання на таку кнопку.
* Назва - обов'язкове поле, пропускає на введення від 1 до 20 символів враховуючи прогалини
* Посилання - обов'язкове поле, допускається введення саме посилання на сайт/картинку і т.д. Наприклад: https://hmsdemo.servioreservation.com/
* Додати - натискання на кнопку, додає її до повідомлення
* Скасувати - скасовує додавання Inline-кнопки до форми повідомлення
 
[[Файл:Create rule message inline2 .png|1000px]]
 

Після того як натиснути на кнопку "Додати", Inline-кнопка відображується в формі повідомлення
 
[[Файл:Message inline button1.png|1000px]]
 
Якщо необхідно додати декілька кнопок, їм можна додавати як в один рядок так і кожну кнопку окремим рядком. 
Для додавання нової кнопки окремим рядком потрібно повторно натиснути на кнопку "Додати новий рядок", заповнити всі необхідні поля і натиснути на кнопку "Додати". Тоді в повідомленні кнопки розташовуватимуться одна під одною
 
[[Файл:Message add some inline button.png|1000px]]
 
Також можна додати декілька кнопок в один ряд, для цього використовується кнопка у вигляді "'''+'''" навпроти першої доданої кнопки. Максимально в один рядок можна додати 3 кнопки.
 
[[Файл:Message add some inline button2.png|1000px]]
 

Для редагування або видалення кнопки, необхідно натиснути на вже додану кнопку, відкривається вікно з інформацією про цю inline-кнопку з можливістю змінити назву та посилання і відповідно кнопками "Зберегти" та "Видалити".
 
За необхідності також можна додати файл натиснувши на поле "завантажити файл". Після заверешення формування повідомлення натиснути на кнопку "Відправити", і повідомлення буде надіслано всім обраним користувачам.
 
[[Файл:Guest telegram inline.png|300px]]

Налаштування Inline-кнопок для розсилок

2025-06-26T09:11:55Z

Lashta.v: /* Додавання Inline-кнопок до правил розсилки */

==Додавання Inline-кнопок для масової розсилки повідомлень==
Для масової розсилки повідомлень користувачам необхідно перейти по сторінкам: CRM → Контакти. Обрати одного або декількох користувачів для відправки повідомлення, встановивши галки навпроти кожної анкети яким необхідно виконати розсилку.
 
[[Файл:Guest select send.png|1000px]]
 
Для відбору користувачів для розсилки також можна використовувати користувацькі фільтри, що значно спрощує пошук необхідних користувачів. Для цього необхідно натиснути на кнопку "Користувацькі фільтри" в переліку раніше створених фільтрів обрати потрібний, після цього натиснути наполе для встановлення чекбоксу в шапці таблиці, таким чином галки застосуються для всіх записів відібраних за фільтром.
 
[[Файл:Guest filter select.png|1000px]]
 
Після того як обрали анкети для надсилання, необхідно натиснути на кнопку "Надіслати повідомлення", відкривається форма заповнення даних для розсилки
 
[[Файл:Guest send message.png|1000px]]
 
Inline-кнопки реалізовані тільки для телеграм повідомлень, тому при заповненні форми необхідно обрати:
* Тип - Telegram (гостьовий)
* Бот - телеграм бот який створений для гостьових розсилок (обов'язкове поле до заповнення)
* Повідомлення - необхідно додати текст повідомлення (обов'язкове поле до заповнення)
* Inline-кнопки - відображується кнопка з назвою "Додати новий рядок".
 
[[Файл:Message inline button.png|1000px]]
 
Після натискання на дану кнопку відкриється форма для заповнення назви Inline-кнопки та поле для введення посилання за яким перейде користувач після натискання на таку кнопку.
* Назва - обов'язкове поле, пропускає на введення від 1 до 20 символів враховуючи прогалини
* Посилання - обов'язкове поле, допускається введення саме посилання на сайт/картинку і т.д. Наприклад: https://hmsdemo.servioreservation.com/
* Додати - натискання на кнопку, додає її до повідомлення
* Скасувати - скасовує додавання Inline-кнопки до форми повідомлення
 
[[Файл:Message add inline button.png|1000px]]
 
Після того як натиснути на кнопку "Додати", Inline-кнопка відображується в формі повідомлення
 
[[Файл:Message inline button1.png|1000px]]
 
Якщо необхідно додати декілька кнопок, їм можна додавати як в один рядок так і кожну кнопку окремим рядком. 
Для додавання нової кнопки окремим рядком потрібно повторно натиснути на кнопку "Додати новий рядок", заповнити всі необхідні поля і натиснути на кнопку "Додати". Тоді в повідомленні кнопки розташовуватимуться одна під одною
 
[[Файл:Message add some inline button.png|1000px]]
 
Також можна додати декілька кнопок в один ряд, для цього використовується кнопка у вигляді "'''+'''" навпроти першої доданої кнопки. Максимально в один рядок можна додати 3 кнопки.
 
[[Файл:Message add some inline button2.png|1000px]]
 
Для редагування або видалення кнопки, необхідно натиснути на вже додану кнопку, відкривається вікно з інформацією про цю inline-кнопку з можливістю змінити назву та посилання і відповідно кнопками "Зберегти" та "Видалити".
 
За необхідності також можна додати файл натиснувши на поле "завантажити файл". Після заверешення формування повідомлення натиснути на кнопку "Відправити", і повідомлення буде надіслано всім обраним користувачам.
 
[[Файл:Guest telegram inline.png|300px]]
 

==Додавання Inline-кнопок до правил розсилки ==

Для масової розсилки повідомлень користувачам необхідно перейти по сторінкам: '''CRM → Розсилки'''. Натиснути на кнопку "Додати правило", після цього відкриється форма для додавання правила розсилки.
 
[[Файл:Create rule message .png|1000px]]
 
Inline-кнопки реалізовані тільки для телеграм розсилок, тому при створенні правила розсилки необхідно обрати:
* Тип - Контакти або Компанії (обов'язкове поле до заповнення)
* Фільтр пошуку - в залежності від обраного типу відображуються фільтри, якщо Тип вказано - Контакти, то в переліку будуть доступні користувацькі фільтри, які додавалися на сторінці ''CRM → Контакти'', необхідно обрати один з фільтрів за яким буде виконано відбір анкет для здійснення розсилки
* Надіслати на - '''Telegram (гостьовий)'''
* Бот для відправки - телеграм бот який створений для гостьових розсилок (обов'язкове поле до заповнення)
* Час для відправки - вказується в форматі гг:хх (обов'язкове поле до заповнення), наприклад: 21:37
* Повторювати - необхідно обрати один з варіантів повторення, в залежності від обраної повторюваності стільки разів буде надіслано дана розсилка:
# Одноразово - буде виконано відправку повідомлення один раз у встановлений час в період зазначений в полях Дата початку/Дата завершення
# Кожен день - буде виконано відправку повідомлення кожного дня у встановлений час в період зазначений в полях Дата початку/Дата завершення, і таку кількість разів яка вказана в полі Повторювати з відповідним інтервалом зазначеним в полі Інтервал
# Щотижня - буде виконано відправку повідомлення кожного тижня у встановлений час та день в період зазначений в полях Дата початку/Дата завершення, і таку кількість разів яка вказана в полі Повторювати з відповідним інтервалом зазначеним в полі Інтервал
# Кожен місяць - буде виконано відправку повідомлення кожного місяця у встановлений час та дату в період зазначений в полях Дата початку/Дата завершення, і таку кількість разів яка вказана в полі Повторювати з відповідним інтервалом зазначеним в полі Інтервал
* Тема - вказати тему розсилки (обов'язкове поле до заповнення)
* Шаблон листа - необхідно додати текст повідомлення (обов'язкове поле до заповнення)
* Inline-кнопки - відображується кнопка з назвою "Додати новий рядок".
 
[[Файл:Create rule message inline .png|1000px]]
 
Після натискання на дану кнопку відкриється форма для заповнення назви Inline-кнопки та поле для введення посилання за яким перейде користувач після натискання на таку кнопку.
* Назва - обов'язкове поле, пропускає на введення від 1 до 20 символів враховуючи прогалини
* Посилання - обов'язкове поле, допускається введення саме посилання на сайт/картинку і т.д. Наприклад: https://hmsdemo.servioreservation.com/
* Додати - натискання на кнопку, додає її до повідомлення
* Скасувати - скасовує додавання Inline-кнопки до форми повідомлення
 
[[Файл:Create rule message inline2 .png|1000px]]
 

Після того як натиснути на кнопку "Додати", Inline-кнопка відображується в формі повідомлення
 
[[Файл:Message inline button1.png|1000px]]
 
Якщо необхідно додати декілька кнопок, їм можна додавати як в один рядок так і кожну кнопку окремим рядком. 
Для додавання нової кнопки окремим рядком потрібно повторно натиснути на кнопку "Додати новий рядок", заповнити всі необхідні поля і натиснути на кнопку "Додати". Тоді в повідомленні кнопки розташовуватимуться одна під одною
 
[[Файл:Message add some inline button.png|1000px]]
 
Також можна додати декілька кнопок в один ряд, для цього використовується кнопка у вигляді "'''+'''" навпроти першої доданої кнопки. Максимально в один рядок можна додати 3 кнопки.
 
[[Файл:Message add some inline button2.png|1000px]]
 

Для редагування або видалення кнопки, необхідно натиснути на вже додану кнопку, відкривається вікно з інформацією про цю inline-кнопку з можливістю змінити назву та посилання і відповідно кнопками "Зберегти" та "Видалити".
 
За необхідності також можна додати файл натиснувши на поле "завантажити файл". Після заверешення формування повідомлення натиснути на кнопку "Відправити", і повідомлення буде надіслано всім обраним користувачам.
 
[[Файл:Guest telegram inline.png|300px]]

Налаштування Inline-кнопок для розсилок

2025-06-26T09:11:29Z

Lashta.v: /* Додавання Inline-кнопок для масової розсилки повідомлень */

==Додавання Inline-кнопок для масової розсилки повідомлень==
Для масової розсилки повідомлень користувачам необхідно перейти по сторінкам: CRM → Контакти. Обрати одного або декількох користувачів для відправки повідомлення, встановивши галки навпроти кожної анкети яким необхідно виконати розсилку.
 
[[Файл:Guest select send.png|1000px]]
 
Для відбору користувачів для розсилки також можна використовувати користувацькі фільтри, що значно спрощує пошук необхідних користувачів. Для цього необхідно натиснути на кнопку "Користувацькі фільтри" в переліку раніше створених фільтрів обрати потрібний, після цього натиснути наполе для встановлення чекбоксу в шапці таблиці, таким чином галки застосуються для всіх записів відібраних за фільтром.
 
[[Файл:Guest filter select.png|1000px]]
 
Після того як обрали анкети для надсилання, необхідно натиснути на кнопку "Надіслати повідомлення", відкривається форма заповнення даних для розсилки
 
[[Файл:Guest send message.png|1000px]]
 
Inline-кнопки реалізовані тільки для телеграм повідомлень, тому при заповненні форми необхідно обрати:
* Тип - Telegram (гостьовий)
* Бот - телеграм бот який створений для гостьових розсилок (обов'язкове поле до заповнення)
* Повідомлення - необхідно додати текст повідомлення (обов'язкове поле до заповнення)
* Inline-кнопки - відображується кнопка з назвою "Додати новий рядок".
 
[[Файл:Message inline button.png|1000px]]
 
Після натискання на дану кнопку відкриється форма для заповнення назви Inline-кнопки та поле для введення посилання за яким перейде користувач після натискання на таку кнопку.
* Назва - обов'язкове поле, пропускає на введення від 1 до 20 символів враховуючи прогалини
* Посилання - обов'язкове поле, допускається введення саме посилання на сайт/картинку і т.д. Наприклад: https://hmsdemo.servioreservation.com/
* Додати - натискання на кнопку, додає її до повідомлення
* Скасувати - скасовує додавання Inline-кнопки до форми повідомлення
 
[[Файл:Message add inline button.png|1000px]]
 
Після того як натиснути на кнопку "Додати", Inline-кнопка відображується в формі повідомлення
 
[[Файл:Message inline button1.png|1000px]]
 
Якщо необхідно додати декілька кнопок, їм можна додавати як в один рядок так і кожну кнопку окремим рядком. 
Для додавання нової кнопки окремим рядком потрібно повторно натиснути на кнопку "Додати новий рядок", заповнити всі необхідні поля і натиснути на кнопку "Додати". Тоді в повідомленні кнопки розташовуватимуться одна під одною
 
[[Файл:Message add some inline button.png|1000px]]
 
Також можна додати декілька кнопок в один ряд, для цього використовується кнопка у вигляді "'''+'''" навпроти першої доданої кнопки. Максимально в один рядок можна додати 3 кнопки.
 
[[Файл:Message add some inline button2.png|1000px]]
 
Для редагування або видалення кнопки, необхідно натиснути на вже додану кнопку, відкривається вікно з інформацією про цю inline-кнопку з можливістю змінити назву та посилання і відповідно кнопками "Зберегти" та "Видалити".
 
За необхідності також можна додати файл натиснувши на поле "завантажити файл". Після заверешення формування повідомлення натиснути на кнопку "Відправити", і повідомлення буде надіслано всім обраним користувачам.
 
[[Файл:Guest telegram inline.png|300px]]
 

==Додавання Inline-кнопок до правил розсилки ==

Для масової розсилки повідомлень користувачам необхідно перейти по сторінкам: '''CRM → Розсилки'''. Натиснути на кнопку "Додати правило", після цього відкриється форма для додавання правила розсилки.
 
[[Файл:Create rule message .png|1000px]]
 
Inline-кнопки реалізовані тільки для телеграм розсилок, тому при створенні правила розсилки необхідно обрати:
* Тип - Контакти або Компанії (обов'язкове поле до заповнення)
* Фільтр пошуку - в залежності від обраного типу відображуються фільтри, якщо Тип вказано - Контакти, то в переліку будуть доступні користувацькі фільтри, які додавалися на сторінці ''CRM → Контакти'', необхідно обрати один з фільтрів за яким буде виконано відбір анкет для здійснення розсилки
* Надіслати на - '''Telegram (гостьовий)'''
* Бот для відправки - телеграм бот який створений для гостьових розсилок (обов'язкове поле до заповнення)
* Час для відправки - вказується в форматі гг:хх (обов'язкове поле до заповнення), наприклад: 21:37
* Повторювати - необхідно обрати один з варіантів повторення, в залежності від обраної повторюваності стільки разів буде надіслано дана розсилка:
# Одноразово - буде виконано відправку повідомлення один раз у встановлений час в період зазначений в полях Дата початку/Дата завершення
# Кожен день - буде виконано відправку повідомлення кожного дня у встановлений час в період зазначений в полях Дата початку/Дата завершення, і таку кількість разів яка вказана в полі Повторювати з відповідним інтервалом зазначеним в полі Інтервал
# Щотижня - буде виконано відправку повідомлення кожного тижня у встановлений час та день в період зазначений в полях Дата початку/Дата завершення, і таку кількість разів яка вказана в полі Повторювати з відповідним інтервалом зазначеним в полі Інтервал
# Кожен місяць - буде виконано відправку повідомлення кожного місяця у встановлений час та дату в період зазначений в полях Дата початку/Дата завершення, і таку кількість разів яка вказана в полі Повторювати з відповідним інтервалом зазначеним в полі Інтервал
* Тема - вказати тему розсилки (обов'язкове поле до заповнення)
* Шаблон листа - необхідно додати текст повідомлення (обов'язкове поле до заповнення)
* Inline-кнопки - відображується кнопка з назвою "Додати новий рядок".
 
[[Файл:Create rule message inline .png|1000px]]
 
Після натискання на дану кнопку відкриється форма для заповнення назви Inline-кнопки та поле для введення посилання за яким перейде користувач після натискання на таку кнопку.
* Назва - обов'язкове поле, пропускає на введення від 1 до 20 символів враховуючи прогалини
* Посилання - обов'язкове поле, допускається введення саме посилання на сайт/картинку і т.д. Наприклад: https://hmsdemo.servioreservation.com/
* Додати - натискання на кнопку, додає її до повідомлення
* Скасувати - скасовує додавання Inline-кнопки до форми повідомлення
 
[[Файл:Create rule message inline2 .png|1000px]]
 

Після того як натиснути на кнопку "Додати", Inline-кнопка відображується в формі повідомлення
 
[[Файл:Message inline button1.png|1000px]]
 
Якщо необхідно додати декілька кнопок, їм можна додавати як в один рядок так і кожну кнопку окремим рядком. 
Для додавання нової кнопки окремим рядком потрібно повторно натиснути на кнопку "Додати новий рядок", заповнити всі необхідні поля і натиснути на кнопку "Додати". Тоді в повідомленні кнопки розташовуватимуться одна під одною
 
[[Файл:Message add some inline button.png|1000px]]
 
Також можна додати декілька кнопок в один ряд, для цього використовується кнопка у вигляді "'''+'''" навпроти першої доданої кнопки. Максимально в один рядок можна додати 3 кнопки.
 
[[Файл:Message add some inline button2.png|1000px]]
 

За необхідності також можна додати файл натиснувши на поле "завантажити файл". Після заверешення формування повідомлення натиснути на кнопку "Відправити", і повідомлення буде надіслано всім обраним користувачам.
 
[[Файл:Guest telegram inline.png|300px]]

Налаштування Inline-кнопок для розсилок

2025-06-26T08:52:43Z

Lashta.v: /* Додавання Inline-кнопок до правил розсилки */

==Додавання Inline-кнопок для масової розсилки повідомлень==
Для масової розсилки повідомлень користувачам необхідно перейти по сторінкам: CRM → Контакти. Обрати одного або декількох користувачів для відправки повідомлення, встановивши галки навпроти кожної анкети яким необхідно виконати розсилку.
 
[[Файл:Guest select send.png|1000px]]
 
Для відбору користувачів для розсилки також можна використовувати користувацькі фільтри, що значно спрощує пошук необхідних користувачів. Для цього необхідно натиснути на кнопку "Користувацькі фільтри" в переліку раніше створених фільтрів обрати потрібний, після цього натиснути наполе для встановлення чекбоксу в шапці таблиці, таким чином галки застосуються для всіх записів відібраних за фільтром.
 
[[Файл:Guest filter select.png|1000px]]
 
Після того як обрали анкети для надсилання, необхідно натиснути на кнопку "Надіслати повідомлення", відкривається форма заповнення даних для розсилки
 
[[Файл:Guest send message.png|1000px]]
 
Inline-кнопки реалізовані тільки для телеграм повідомлень, тому при заповненні форми необхідно обрати:
* Тип - Telegram (гостьовий)
* Бот - телеграм бот який створений для гостьових розсилок (обов'язкове поле до заповнення)
* Повідомлення - необхідно додати текст повідомлення (обов'язкове поле до заповнення)
* Inline-кнопки - відображується кнопка з назвою "Додати новий рядок".
 
[[Файл:Message inline button.png|1000px]]
 
Після натискання на дану кнопку відкриється форма для заповнення назви Inline-кнопки та поле для введення посилання за яким перейде користувач після натискання на таку кнопку.
* Назва - обов'язкове поле, пропускає на введення від 1 до 20 символів враховуючи прогалини
* Посилання - обов'язкове поле, допускається введення саме посилання на сайт/картинку і т.д. Наприклад: https://hmsdemo.servioreservation.com/
* Додати - натискання на кнопку, додає її до повідомлення
* Скасувати - скасовує додавання Inline-кнопки до форми повідомлення
 
[[Файл:Message add inline button.png|1000px]]
 
Після того як натиснути на кнопку "Додати", Inline-кнопка відображується в формі повідомлення
 
[[Файл:Message inline button1.png|1000px]]
 
Якщо необхідно додати декілька кнопок, їм можна додавати як в один рядок так і кожну кнопку окремим рядком. 
Для додавання нової кнопки окремим рядком потрібно повторно натиснути на кнопку "Додати новий рядок", заповнити всі необхідні поля і натиснути на кнопку "Додати". Тоді в повідомленні кнопки розташовуватимуться одна під одною
 
[[Файл:Message add some inline button.png|1000px]]
 
Також можна додати декілька кнопок в один ряд, для цього використовується кнопка у вигляді "'''+'''" навпроти першої доданої кнопки. Максимально в один рядок можна додати 3 кнопки.
 
[[Файл:Message add some inline button2.png|1000px]]
 

За необхідності також можна додати файл натиснувши на поле "завантажити файл". Після заверешення формування повідомлення натиснути на кнопку "Відправити", і повідомлення буде надіслано всім обраним користувачам.
 
[[Файл:Guest telegram inline.png|300px]]
 

==Додавання Inline-кнопок до правил розсилки ==

Для масової розсилки повідомлень користувачам необхідно перейти по сторінкам: '''CRM → Розсилки'''. Натиснути на кнопку "Додати правило", після цього відкриється форма для додавання правила розсилки.
 
[[Файл:Create rule message .png|1000px]]
 
Inline-кнопки реалізовані тільки для телеграм розсилок, тому при створенні правила розсилки необхідно обрати:
* Тип - Контакти або Компанії (обов'язкове поле до заповнення)
* Фільтр пошуку - в залежності від обраного типу відображуються фільтри, якщо Тип вказано - Контакти, то в переліку будуть доступні користувацькі фільтри, які додавалися на сторінці ''CRM → Контакти'', необхідно обрати один з фільтрів за яким буде виконано відбір анкет для здійснення розсилки
* Надіслати на - '''Telegram (гостьовий)'''
* Бот для відправки - телеграм бот який створений для гостьових розсилок (обов'язкове поле до заповнення)
* Час для відправки - вказується в форматі гг:хх (обов'язкове поле до заповнення), наприклад: 21:37
* Повторювати - необхідно обрати один з варіантів повторення, в залежності від обраної повторюваності стільки разів буде надіслано дана розсилка:
# Одноразово - буде виконано відправку повідомлення один раз у встановлений час в період зазначений в полях Дата початку/Дата завершення
# Кожен день - буде виконано відправку повідомлення кожного дня у встановлений час в період зазначений в полях Дата початку/Дата завершення, і таку кількість разів яка вказана в полі Повторювати з відповідним інтервалом зазначеним в полі Інтервал
# Щотижня - буде виконано відправку повідомлення кожного тижня у встановлений час та день в період зазначений в полях Дата початку/Дата завершення, і таку кількість разів яка вказана в полі Повторювати з відповідним інтервалом зазначеним в полі Інтервал
# Кожен місяць - буде виконано відправку повідомлення кожного місяця у встановлений час та дату в період зазначений в полях Дата початку/Дата завершення, і таку кількість разів яка вказана в полі Повторювати з відповідним інтервалом зазначеним в полі Інтервал
* Тема - вказати тему розсилки (обов'язкове поле до заповнення)
* Шаблон листа - необхідно додати текст повідомлення (обов'язкове поле до заповнення)
* Inline-кнопки - відображується кнопка з назвою "Додати новий рядок".
 
[[Файл:Create rule message inline .png|1000px]]
 
Після натискання на дану кнопку відкриється форма для заповнення назви Inline-кнопки та поле для введення посилання за яким перейде користувач після натискання на таку кнопку.
* Назва - обов'язкове поле, пропускає на введення від 1 до 20 символів враховуючи прогалини
* Посилання - обов'язкове поле, допускається введення саме посилання на сайт/картинку і т.д. Наприклад: https://hmsdemo.servioreservation.com/
* Додати - натискання на кнопку, додає її до повідомлення
* Скасувати - скасовує додавання Inline-кнопки до форми повідомлення
 
[[Файл:Create rule message inline2 .png|1000px]]
 

Після того як натиснути на кнопку "Додати", Inline-кнопка відображується в формі повідомлення
 
[[Файл:Message inline button1.png|1000px]]
 
Якщо необхідно додати декілька кнопок, їм можна додавати як в один рядок так і кожну кнопку окремим рядком. 
Для додавання нової кнопки окремим рядком потрібно повторно натиснути на кнопку "Додати новий рядок", заповнити всі необхідні поля і натиснути на кнопку "Додати". Тоді в повідомленні кнопки розташовуватимуться одна під одною
 
[[Файл:Message add some inline button.png|1000px]]
 
Також можна додати декілька кнопок в один ряд, для цього використовується кнопка у вигляді "'''+'''" навпроти першої доданої кнопки. Максимально в один рядок можна додати 3 кнопки.
 
[[Файл:Message add some inline button2.png|1000px]]
 

За необхідності також можна додати файл натиснувши на поле "завантажити файл". Після заверешення формування повідомлення натиснути на кнопку "Відправити", і повідомлення буде надіслано всім обраним користувачам.
 
[[Файл:Guest telegram inline.png|300px]]

Файл:Create rule message inline2 .png

2025-06-26T08:52:22Z

Lashta.v:

Файл:Create rule message inline .png

2025-06-26T08:49:34Z

Lashta.v:

Файл:Create rule message .png

2025-06-26T08:37:10Z

Lashta.v:

Налаштування Inline-кнопок для розсилок

2025-06-26T08:34:32Z

Lashta.v:

==Додавання Inline-кнопок для масової розсилки повідомлень==
Для масової розсилки повідомлень користувачам необхідно перейти по сторінкам: CRM → Контакти. Обрати одного або декількох користувачів для відправки повідомлення, встановивши галки навпроти кожної анкети яким необхідно виконати розсилку.
 
[[Файл:Guest select send.png|1000px]]
 
Для відбору користувачів для розсилки також можна використовувати користувацькі фільтри, що значно спрощує пошук необхідних користувачів. Для цього необхідно натиснути на кнопку "Користувацькі фільтри" в переліку раніше створених фільтрів обрати потрібний, після цього натиснути наполе для встановлення чекбоксу в шапці таблиці, таким чином галки застосуються для всіх записів відібраних за фільтром.
 
[[Файл:Guest filter select.png|1000px]]
 
Після того як обрали анкети для надсилання, необхідно натиснути на кнопку "Надіслати повідомлення", відкривається форма заповнення даних для розсилки
 
[[Файл:Guest send message.png|1000px]]
 
Inline-кнопки реалізовані тільки для телеграм повідомлень, тому при заповненні форми необхідно обрати:
* Тип - Telegram (гостьовий)
* Бот - телеграм бот який створений для гостьових розсилок (обов'язкове поле до заповнення)
* Повідомлення - необхідно додати текст повідомлення (обов'язкове поле до заповнення)
* Inline-кнопки - відображується кнопка з назвою "Додати новий рядок".
 
[[Файл:Message inline button.png|1000px]]
 
Після натискання на дану кнопку відкриється форма для заповнення назви Inline-кнопки та поле для введення посилання за яким перейде користувач після натискання на таку кнопку.
* Назва - обов'язкове поле, пропускає на введення від 1 до 20 символів враховуючи прогалини
* Посилання - обов'язкове поле, допускається введення саме посилання на сайт/картинку і т.д. Наприклад: https://hmsdemo.servioreservation.com/
* Додати - натискання на кнопку, додає її до повідомлення
* Скасувати - скасовує додавання Inline-кнопки до форми повідомлення
 
[[Файл:Message add inline button.png|1000px]]
 
Після того як натиснути на кнопку "Додати", Inline-кнопка відображується в формі повідомлення
 
[[Файл:Message inline button1.png|1000px]]
 
Якщо необхідно додати декілька кнопок, їм можна додавати як в один рядок так і кожну кнопку окремим рядком. 
Для додавання нової кнопки окремим рядком потрібно повторно натиснути на кнопку "Додати новий рядок", заповнити всі необхідні поля і натиснути на кнопку "Додати". Тоді в повідомленні кнопки розташовуватимуться одна під одною
 
[[Файл:Message add some inline button.png|1000px]]
 
Також можна додати декілька кнопок в один ряд, для цього використовується кнопка у вигляді "'''+'''" навпроти першої доданої кнопки. Максимально в один рядок можна додати 3 кнопки.
 
[[Файл:Message add some inline button2.png|1000px]]
 

За необхідності також можна додати файл натиснувши на поле "завантажити файл". Після заверешення формування повідомлення натиснути на кнопку "Відправити", і повідомлення буде надіслано всім обраним користувачам.
 
[[Файл:Guest telegram inline.png|300px]]
 

==Додавання Inline-кнопок до правил розсилки ==

Для масової розсилки повідомлень користувачам необхідно перейти по сторінкам: CRM → Контакти. Обрати одного або декількох користувачів для відправки повідомлення, встановивши галки навпроти кожної анкети яким необхідно виконати розсилку.
 
[[Файл:Guest select send.png|1000px]]
 
Для відбору користувачів для розсилки також можна використовувати користувацькі фільтри, що значно спрощує пошук необхідних користувачів. Для цього необхідно натиснути на кнопку "Користувацькі фільтри" в переліку раніше створених фільтрів обрати потрібний, після цього натиснути наполе для встановлення чекбоксу в шапці таблиці, таким чином галки застосуються для всіх записів відібраних за фільтром.
 
[[Файл:Guest filter select.png|1000px]]
 
Після того як обрали анкети для надсилання, необхідно натиснути на кнопку "Надіслати повідомлення", відкривається форма заповнення даних для розсилки
 
[[Файл:Guest send message.png|1000px]]
 
Inline-кнопки реалізовані тільки для телеграм повідомлень, тому при заповненні форми необхідно обрати:
* Тип - Telegram (гостьовий)
* Бот - телеграм бот який створений для гостьових розсилок (обов'язкове поле до заповнення)
* Повідомлення - необхідно додати текст повідомлення (обов'язкове поле до заповнення)
* Inline-кнопки - відображується кнопка з назвою "Додати новий рядок".
 
[[Файл:Message inline button.png|1000px]]
 
Після натискання на дану кнопку відкриється форма для заповнення назви Inline-кнопки та поле для введення посилання за яким перейде користувач після натискання на таку кнопку.
* Назва - обов'язкове поле, пропускає на введення від 1 до 20 символів враховуючи прогалини
* Посилання - обов'язкове поле, допускається введення саме посилання на сайт/картинку і т.д. Наприклад: https://hmsdemo.servioreservation.com/
* Додати - натискання на кнопку, додає її до повідомлення
* Скасувати - скасовує додавання Inline-кнопки до форми повідомлення
 
[[Файл:Message add inline button.png|1000px]]
 
Після того як натиснути на кнопку "Додати", Inline-кнопка відображується в формі повідомлення
 
[[Файл:Message inline button1.png|1000px]]
 
Якщо необхідно додати декілька кнопок, їм можна додавати як в один рядок так і кожну кнопку окремим рядком. 
Для додавання нової кнопки окремим рядком потрібно повторно натиснути на кнопку "Додати новий рядок", заповнити всі необхідні поля і натиснути на кнопку "Додати". Тоді в повідомленні кнопки розташовуватимуться одна під одною
 
[[Файл:Message add some inline button.png|1000px]]
 
Також можна додати декілька кнопок в один ряд, для цього використовується кнопка у вигляді "'''+'''" навпроти першої доданої кнопки. Максимально в один рядок можна додати 3 кнопки.
 
[[Файл:Message add some inline button2.png|1000px]]
 

За необхідності також можна додати файл натиснувши на поле "завантажити файл". Після заверешення формування повідомлення натиснути на кнопку "Відправити", і повідомлення буде надіслано всім обраним користувачам.
 
[[Файл:Guest telegram inline.png|300px]]

Налаштування Inline-кнопок для розсилок

2025-06-26T07:56:12Z

Lashta.v:

Налаштування Inline-кнопок для розсилок

2025-06-26T07:55:52Z

Lashta.v: /* Додавання Inline-кнопок для масової розсилки повідомлень */

Налаштування Inline-кнопок для розсилок

2025-06-26T07:55:31Z

Lashta.v: /* Додавання Inline-кнопок для масової розсилки повідомлень */

Файл:Guest telegram inline.png

2025-06-26T07:55:04Z

Lashta.v:

Налаштування Inline-кнопок для розсилок

2025-06-26T07:52:37Z

Lashta.v: /* Додавання Inline-кнопок для масової розсилки повідомлень */

Файл:Message add some inline button2.png

2025-06-26T07:46:17Z

Lashta.v: