Интегрировать систему бонусов Sagi с R-Keeper 7

Нужно разработать ПО для интеграции сервиса бонусов Sagiс кассовым R-Keeper 7, за основу можно взять уже реализованные конкурентами решения docs.loona.ai/guides/integration.html#iiko store.uds.app/integrations/r-keeper-inform

Интегрировать систему бонусов Sagi с R-Keeper 7

Необходимо произвести интеграцию системы бонусов SAGI с R-Keeper 7 посредством разработки ПО. Для примера можно взять один из аналогов подобной системы:

• docs.loona.ai/guides/integration.html#iiko
• store.uds.app/integrations/r-keeper-inform (сами экзешники можем дать после отклика)

По поводу данных, насколько я понимаю, в примерах работ функционал направлен на редактирование и создание новых скидок и бонусов на рабочем месте, через веб, тогда как наше решение должно брать уже готовую информацию по айдишнику клиента из базы стороннего приложения.

• docs.rkeeper.ru (документация RK7)
• sagi.kz (Сайт приложения)

Краткое описание:

Интеграцию должен настраивать специалист R-Keeper. После настройки интеграции списание и начисление бонусов осуществляется через рабочее место кассира.

Функционал: оплата по коду, оплата по номеру телефону, информация о кассире.

В R-Keeper перед печатью пречека нажать на кнопку "SAGI" и ввести код клиента из приложения SAGI App. В появившемся окне отобразится имя клиента и количество накопленных баллов. После отображения информации о клиенте будет предложено списать бонусы. Если бонусы списывать не нужно, то нажать на кнопку "Нет" и провести обычный расчет заказа. В случае списания бонусов отобразится окно с вводом количества списываемых баллов, далее необходимо распечатать пречек. Сумма чека будет уменьшена на сумму списываемых баллов SAGI. Оставшуюся сумму оплатить наличными или банковской картой. После закрытия заказа клиенту начисляются/спишутся баллы.

Кратко Техническое Задание:

Подключение/Админка.

1. Запрашиваем логин и пароль, получаем токен. (Business: Login using Password)

Тут же получаем ID филиала и подтягиваем его данные (Business: Get Branch). Сохраняем для заведения ID и GROUP_ID филиала.

2. Для каждого заведения постера предлагаем выбрать товар-подарок (отдельный товар с нулевой ценой), его также сохраняем.

3. Дополнительно будет cron-скрипт для продления токенов (метод Business: Refresh token).

Работа на терминале.

1. При запуске кассы, и наличии токена и привязки к филиалу, подтягиваем данные филиала для получения настройки наград.

Если награды отключены, все связанное с ними пропускаем/убираем.

* при переходе к оплате чека *

2. Когда закончили наполнять заказ и переходят к оплате запрашиваем телефон клиента.

3. Подтягиваем информацию о клиенте, его бонусах, кешбэку и штампиках (Get User info, Get Private Balance For Branch, Get Cashback for User, Get User Stamp Info). Показываем информацию кассиру.

4. Если есть возможность выдать подарок за штампики, показываем кнопку "Выдать награду".

Иначе чекбокс "начислить штампики", который активирует поле ввода кол-ва начисляемых штампиков. Максимальное начисление = требуемому кол-ву для подарка. Если в сумме (есть + начисляем) у клиента будет хватать на подарок - показываем кнопку "Выдать награду".

По кнопке автоматически добавляем в чек товар-подарок. Если подарок не настроен, блокируем кнопку и пишем уведомление что нужно донастроить.

5. Для списания бонусов показываем поле для ввода суммы с ограничением вводимой суммы балансом клиента.

* после завершения (когда оплатили и распечатали чек) *

6. Создаем транзакцию для начисления бонусов (Create Order For Send Cashback)

- при выдаче награды поле give_award = true

- при наличии начисления штампиков поле add_stamp = true и в поле stamp_count передаем кол-во

7. Начисляем бонусы (Send Money To User)

- при списании { use_balance: true, amount: сума бонусами }

- без списания { use_balance: false }

Дополнительно на терминале будет функционал для обработки случаев сбоев связи при завершении заказа.

Т.е. если на этапах 6 - 7 происходит сбой, в фоновом режиме будут происходить попытки закончить последовательность запросов.

В чек добавляем информацию о:

- количестве начисленных штампиков

- факте выдачи награды и сколько штампиков за это списали

Порядок вызова методов:

Начисление бонусов (без использования)

1.Business: Get User info - метод для поиска пользователя

2.Business: Get Private Balance For Branch - метод для вывода доступных бонусов в данном заведении

3.Business: Get Cashback for User - метод который вытаскивает процент кэшбека, который может получить пользователь

4.Business: Get User Stamp Info - метод для вывода информации о накопленных штампиков. Вызывать в том случае когда у филиала включена опция configuration.award.enabled=true и отображать кнопки наградить в этом случае.

5.Business: Create Order For Send Cashback - метод для создания транзакции для начисления бонуса

6.Business: Send Money To User - метод, который после успешного создания вышеупомянутой транзакции начисляет бонусы клиенты

Начисление бонусов (с использованием)

Вызываются все вышеупомянутые методы, различия только в методе Business: Send Money To User. Отправлять значения для этих полей: use_balance и amount.

Начисление бонусов и награды

Вызываются все вышеупомянутые методы, различия только в методе Business: Create Order For Send Cashback. Отправлять нужные значения для этого поля: add_stamp

Выдача подарка(когда все награды уже накоплены)

Используется данный метод - Business: Give Award To User

Все необходимые методы прикреплены в ТЗ - файле.