====== Списання бонусів з підтвердженням по SMS/Дзвінку ======
===== Для чого використовується =====
Коли в програмі активована бонусна система, то, щоб зменшити можливість махінацій з боку персоналу, можна активувати списання бонусів з підтвердженням по коду з SMS або по дзвінку.

===== Як це працює =====
Під час покупки, якщо продавець вибрав клієнта, відображається допустима сума бонусів, яку можна використати як знижку на весь чек. Кількість бонусів до списання можна ввести будь-яку, щоб було зручніше давати решту. 

Якщо продавець ввів суму бонусів для списання - то покупцю на телефон приходить 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]] \\