ПрограмаЛояльності - Історія редагувань

Ohorodnik.danylo: /* Upload_eWallet_Documents */

2026-04-06T10:24:49Z

Upload_eWallet_Documents

← Попередня версія		Версія за 10:24, 6 квітня 2026
Рядок 1250:		Рядок 1250:
	'''Вхідні параметри:'''		'''Вхідні параметри:'''
	• EWalletDocuments[] EWalletDocuments - масив учасників програми лояльності. Опис елементів:		• EWalletDocuments[] EWalletDocuments - масив учасників програми лояльності. Опис елементів:
	◦ int ~~EwalletID~~ – ІД учасника;		◦ int EWalletID – ІД учасника;
	◦ Documents[] Documents – Масив документів учасника програми лояльності. Опис елементів:		◦ Documents[] Documents – Масив документів учасника програми лояльності. Опис елементів:
	– string FileName - назва файлу, яка буде використана в БД для учасників лояльності;		– string FileName - назва файлу, яка буде використана в БД для учасників лояльності;

Lashta.v в 11:15, 19 березня 2026

2026-03-19T11:15:17Z

← Попередня версія		Версія за 11:15, 19 березня 2026
Рядок 1245:		Рядок 1245:
	◦ decimal Sum - сума транзакції;		◦ decimal Sum - сума транзакції;
	◦ string TransactionDate - дата проведення транзакції;		◦ 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 - успішність збереження файлу.

Andriy.Kolch: /* Get_eWallet_Bills */

2025-05-19T15:05:51Z

Get_eWallet_Bills

← Попередня версія		Версія за 15:05, 19 травня 2025
Рядок 1216:		Рядок 1216:
	◦ DateTime BillCreationDate - дата створення рахунку		◦ DateTime BillCreationDate - дата створення рахунку
	◦ int HotelID - ІД готелю		◦ 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 - дата проведення транзакції;

Andriy.Kolch: /* Pay_Transaction_eWallet_PayCard_Request */

2025-05-19T14:59:05Z

Pay_Transaction_eWallet_PayCard_Request

Показати зміни

Andriy.Kolch: /* Money_Input */

2025-05-19T11:24:56Z

Money_Input

← Попередня версія		Версія за 11:24, 19 травня 2025
Рядок 891:		Рядок 891:
	Спочатку відбувається перевірка на використання лояльних грошей, якщо ні - повертаємо помилку.		Спочатку відбувається перевірка на використання лояльних грошей, якщо ні - повертаємо помилку.
	Далі за MagneticCardID система шукає картку в базі даних, якщо такої немає, повертає помилку про відсутність такої картки. Якщо карта є, то система бере учасника за даними з карти, додає транзакції в базу даних і оновлює інформацію про учасника в базі даних. Після чого повертаємо результат функції, заповнюючи відповідні поля.		Далі за 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 система шукає картку в базі даних, якщо такої немає або вона неактивна, повертає помилку. Якщо картка є і вона активна, то система бере учасника програми лояльності та розраховує, чи вистачить лояльних грошей в учасника для транзакцій, якщо ні - повертаємо помилку.
			Після чого повертаємо результат функції, заповнюючи відповідні поля.

Andriy.Kolch: /* Return_Pay_Transaction_eWallet_Bonuses_Accept */

2025-05-19T11:18:05Z

Return_Pay_Transaction_eWallet_Bonuses_Accept

Показати зміни

Andriy.Kolch: /* Return_Pay_Transaction_eWallet_Bonuses_Request */

2025-05-19T09:18:56Z

Return_Pay_Transaction_eWallet_Bonuses_Request

@@ Рядок 641: / Рядок 641: @@
      • bool IsOTPNeed - ознака необхідності підтвердження операції паролем/пін-кодом (Завжди false)
      • PayTransaction[] PayTransactions - масив транзакцій для оплати бонусами PayTransaction. Структура PayTransaction має такі поля:
-    • DateTime TransactionDate - дата проведення транзакції в POS системі
+        o DateTime TransactionDate - дата проведення транзакції в POS системі
          o int ServiceGroupCode - код групи послуг POS системи (Порожнє поле)
          o decimal Sum - сума транзакції
          o decimal Quantity - кількість послуг за транзакцією
-         o string[30] POSsystemAccount - Л/Рахунок у POS-системі
+         o string[30] POSsystemAccount - Л/Рахунок у POS-системі (Порожнє поле)
-    • (Порожнє поле) o decimal BonusesToPay - кількість бонусів, необхідних для оплати транзакції
+        o decimal BonusesToPay - кількість бонусів, необхідних для оплати транзакції
-     • string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Порожнє поле)
+        o string[30] PointOfSalePOScode - код точки продажу в POS системі. Цей код має бути унікальним у межах POS системи серед не віддалених точок. (Порожнє поле)

Andriy.Kolch: /* Return_Add_eWallet_Bonuses_Accept */

2025-05-19T08:59:33Z

Return_Add_eWallet_Bonuses_Accept

Показати зміни

Andriy.Kolch: /* Return_Add_eWallet_Bonuses_Request */

2025-05-19T08:50:17Z

Return_Add_eWallet_Bonuses_Request

Показати зміни

Andriy.Kolch в 08:32, 19 травня 2025

2025-05-19T08:32:58Z

← Попередня версія		Версія за 08:32, 19 травня 2025
Рядок 1:		Рядок 1:
	~~=API ServioLoyaltyService=~~
	=Опис взаємодії=		=Опис взаємодії=
	Взаємодія системи HMS Servio і Servio Restaurant із процесинговим центром відбуватиметься через звернення цих систем до WCF служби процесингу за протоколом JSON, кодування передавання даних UTF8, методом POST.		Взаємодія системи HMS Servio і Servio Restaurant із процесинговим центром відбуватиметься через звернення цих систем до WCF служби процесингу за протоколом JSON, кодування передавання даних UTF8, методом POST.