Розбіжності

Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.

--- обмін_даними_з_іншими_системами:sms_bonus [2025/10/14 11:04] – iserbin
+++ обмін_даними_з_іншими_системами:sms_bonus [2025/10/14 15:17] (поточний) – [Як це працює] iserbin
@@ Рядок 1: / Рядок 1: @@
 ====== Списання бонусів з підтвердженням по SMS/Дзвінку ======
 ===== Для чого використовується =====
-Коли в програмі активована бонусна система, то щоб зменшити можливість махінацій з боку персоналу, можна активувати списання бонусів з підтвердженням по коду з SMS або по дзвінку.
+Коли в програмі активована бонусна система, то, щоб зменшити можливість махінацій з боку персоналу, можна активувати списання бонусів з підтвердженням по коду з SMS або по дзвінку.
 ===== Як це працює =====
@@ Рядок 8: / Рядок 8: @@
 Якщо продавець ввів суму бонусів для списання - то покупцю на телефон приходить SMS з кодом, який він має продиктувати продавцю. Якщо продавець вводить правильний код - бонуси списуються.
+{{ :обмін_даними_з_іншими_системами:bonus_sms_000.png?nolink |}}
+Щоб налаштувати списання бонусів з підтвердженням по СМС, потрібно зайти в меню : "Сервіс"-"Торгове обладнання та Екран касиру", закладка "Бонуси списання", і ввести URL адресу сайта/сервісу, який буде відповідальний за надсилання СМС. Надсилати можна класичними СМС, а також можна надсилати в месенджери, або використовувати інші канали зв'язку.
+{{ :обмін_даними_з_іншими_системами:bonus_sms_001.png?nolink |}}
+:!: Звернуть увагу, що наша компанія не надає послуги з надсилання СМС, цим займаються різні СМС-провайдери, і ці послуги платні. Так само надсилати в месенджери просто так не можна, один з дозволених способів - це щоб клієнт підключив собі в месенджері "Бота", і цей Бот зможе надсилати йому СМС. Ми даємо тільки програмний інтерфейс (API) для зв'язку програми Unipro із зовнішньою системою розсилки СМС, а сам механізм розсилки (чи то БОТ, чи СМС-провайдер, чи дзвінок) реалізовується силами замовника.
+Тобто Замовник своїми силами розробляє скрипт та вирішує на якому хостингу розмістити його. Цей скрипт буде отримувати дані з Unipro, і вже він буде надсилати СМС чи то через БОТ, чи через СМС-провайдерів, чи іншим шляхом.
+Можливість допомогти в розробці скрипта та розміщенню його на хостингу уточнюйте в технічні підтримці.
+===== Опис UniproSMSProviderAPI для програмістів =====
+UniproSMSProviderAPI - API для SMS-підтвердження під час списання бонусів.
+Щоб надіслати СМС програма виконує GET запит, з наступними параметрами:
+^ Параметр      ^ Приклад        ^ Опис ^
+| tel| 0675065980 | Номер телефону клієнта  |
+| bonus| 234.45| Кількість бонусів, яку планують списати |
+| token| 12-34-45-78-90| Будь-яка стрічка, яка буде Ідентифікатором магазину, або це може бути код доступу, щоб ваш сервіс розпізнавав, який саме магазин надсилає СМС |
+| msg| Щоб використати бонуси=234.45, повідомте код: [code]. | Це повідомлення клієнту в налаштуваннях програми касира. Замість слова "[code]" - вставте код який ви надішлете клієнту. Цей параметр можна ігнорувати і надсилати інший текст |
+Приклад GET запиту:
+''https://test-json.unipro.ua/sms.php?tel=0670000000&bonus=234.45&token=12-34-56-78-90&msg=To_activate_bonuses_say_the_code.''
+У відповідь ваш сервіс має надіслати JSON:
+^ Поле ^ Тип        ^ Опис ^
+| ErrorCode| Ціле число | 0 - все ОК. Будь-який інший код - означає помилку, номер на ваш розсуд  |
+| SMSCode| Стрічка| Код, який надісланий клієнту в SMS |
+| Message| Стрічка| Повідомлення для продавця. Може бути пустим. Якщо ErrorCode=0, то повідомлення синього кольору, в іншому випадку - червоного. Наприклад "Клієнт тимчасово заблокований."|
+Успішна відповідь:
+<code>
+{
+ "ErrorCode": 0,
+ "SMSCode": "1860",
+ "Message": "Have a nice day"
+}
+</code>
+Відповідь з помилкою:
+<code>
+{
+ "ErrorCode": 209,
+ "SMSCode": "",
+ "Message": "Клієнт тимчасово заблокований"
+}
+</code>
+Наш тестовий cкрипт, може допомогти в тестуванні та розробці: \\
+Отримати JSON: [[https://test-json.unipro.ua/sms.php?tel=0670000000&bonus=789.00&token=12-34-56-78-90&msg=To_activate_bonuses_say_the_code.]] \\
+Переглянути значення, які скрипт генерував:  [[https://test-json.unipro.ua/sms.php]] \\