Интеграция с онлайн-витринами MGC-Loyalty

Для чего разработана интеграция

Интеграция даёт возможность для пользователей Motivity заказывать товары на онлайн-витринах MGC-Loyalty за баллы, заработанные на портале Motivity.

Как пользователь Motivity авторизуется на витрине

Пользователь может перейти к витрине только с портала по механизму бесшовной авторизации.

В боковом меню расположена кнопка MGC-Loyalty. Название кнопки может быть изменено. Для этого обратитесь в Службу Поддержки – help@start2play.ru

Если интеграция включена, поле “Телефон” должно быть обязательным для заполнения. Пользователь должен иметь возможность изменить номер телефона на портале.
Номер телефона пользователя передаётся на витрину при авторизации пользователя.
Номер телефона нельзя изменить или заполнить на витрине.

Настройка полей описана в разделе Конструктор полей.

Как пользователь использует витрину

Пользователь переходит на витрину только с портала или из приложения Motivity.

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

Если пользователю не хватает баллов для покупки – товар не будет оплачен. Пользователь увидит соответствующее сообщение.

Как узнать подробности заказа

Пользователь может узнать подробности заказа в ЛК на витрине.

Администратор – в отчёте.

Информационный поп-ап при получении доступа по баллам

Одним из инструментов для повышения мотивации сотрудников-пользователей портала и улучшения процесса обучения является ограничение доступности модулей по баллам.

Если для модуля включено данное ограничение, то по достижении установленного в поле "MGC-loyalty" в Панели управления значения пользователю показывается поп-ап с поздравлением о том, что ему стал доступен новый функционал портала.

Содержание и механика поздравительного поп-апа описана здесь.

Публичная часть

Боковое меню

После нажатия на кнопку в Боковом меню пользователь попадает на витрину. Витрина открывается в новой вкладке.

Если пользователь переходит на витрину впервые – будет создана его учётная запись.

При изменении на портале Motivity email и/или номера телефона, а также ФИО – новая учётная запись на витрине не создаётся.

Если пользовательские данные, необходимые для авторизации на витрине не заполнены, пользователь не может авторизоваться и видит заглушку с сообщением.

 

Витрина может быть не доступна текущему пользователю.

Если в ПА на странице Ограничение доступности модулей по баллам (admin/system/modules) в поле “MGC-loyalty“ установлено значение, то переход к витрине осуществляется только для тех пользователей, у которых баллов обучения не меньше, чем установленное в поле “MGC-loyalty“ значение.

Для остальных пользователей открывается окно с заглушкой.

Личный кабинет пользователя

При подключении интеграции с витриной MGC-Loyalty на портале Motivity в ЛК пользователя в блоке “Статистика” появляется вкладка “Расходуемый баланс”.
В этой вкладке записываются все зачисления и списания баллов расходуемого баланса.

Текст записей во вкладке:

При списании баллов – “Заказ #N подтверждён в интернет-магазине {ссылка на витрину/заказ}, баллы списаны и будут возвращены в случае отмены заказа.”
При отмене заказа – ““Заказ #N отменён в интернет-магазине {ссылка на витрину/заказ}. X {сумма баллов за заказ} баллов зачислено на расходуемый баланс. Баллы доступны для оплаты новых заказов.”

При подключении Каталога призов все записи об изменении расходуемого баланса отображаются в этой же вкладке.

Административная часть

Расходуемый баланс

Как настроить конфигурацию расходуемого баланса описано в соответствующем разделе.

Все баллы могут быть начислены импортом баллов.

Интеграция с MGC-Loyalty

Вкладка Настройки

Чтобы настроить интеграцию нужно заполнить поля, которые являются обязательными и сохранить значения:

  • Адрес API — указывается с указанием протокола https.

  • Домен витрины — указывается без протокола.

  • Логин — логин для авторизации в витрине.

  • Пароль — пароль для авторизации в витрине.

 

Вкладка Логи

Вкладка содержит логи обмена Motivity с MGC-Loyalty.

Состоит из:

  • Поле поиска, которое работает по дате лога.

    • Кнопка Применить — по клику список ответов ниже перестраивается в зависимости от поискового запроса.

    • Кнопка Сбросить — выводится, если был применён поиск. По клику поисковый запрос сбрасывается и список компетенций перестраивается по умолчанию.

  • Список логов в виде таблицы:

    • Столбцы / параметры лога:

      • ID лога обмена.

      • Дата лога обмена.

      • Тип (статус):

        • Подтверждение заказа

        • При успешной покупке

        • Обновление статуса ранее сделанного заказа

      • Данные запроса.

      • Данные ответа.

  • Пагинация — отображается, если во вкладке более 20 строк.

 

Подробнее про статусы:

При нажатии Купить идет финальная проверка баланса участника, путем обращения к серверу по указанному им адресу. Будет выполнен POST запрос /canorder который в ответ должен вернуть JSON с информацией о допустимости либо невозможности покупки, например при недостаточном количестве средств на счете пользователя.

После проведения транзакции, будет произведен POST запрос /finalize с передачей данных о покупке — JSON с данными заказа и товаров в нём.

POST запрос /update с передачей данных о покупке — JSON с данными заказа и товаров в нём.

 

Ограничение к витрине по баллам

В Панели управления на странице Ограничение доступности модулей по баллам (admin/system/modules) располагается поле “MGC-loyalty“.

Администратору доступна настройка ограничения к витрине путем ввода в поле количества баллов, которых необходимо набрать пользователям для получения доступа.

Интеграция в мобильном приложении

В МП Motivity пользователь переходит на витрину из бокового меню.

Витрина открывается во встроенном браузере.

Витрина может быть не доступна текущему пользователю.

Если в ПА на странице Ограничение доступности модулей по баллам (admin/system/modules) в поле “MGC-loyalty“ установлено значение, то переход к витрине осуществляется только для тех пользователей, у которых баллов обучения не меньше, чем установленное в поле “MGC-loyalty“ значение.

Для остальных пользователей открывается окно с заглушкой.

В ЛК пользователя также выводится количество баллов расходуемого баланса.

В ЛК - Статистика отображается вся информация о начислениях и списаниях баллов расходуемого баланса.

Отчётность

Отчёт по заказам сотрудников на витрине «MGC-Loyalty»

В одной строке отчёта содержится сведения по одному товару.

Фильтры отчёта:

  • Дата создания заказа

  • Пользовательские группы

  • Стандартный фильтр по всем полям из конструктора полей (выводимым в фильтры)

Столбцы отчёта:

  1. ID товара на платформе MGC

  2. Поля из конструктора полей (выводимые в отчёт). Особенность для поля Отдел: если пользователь является сотрудником нескольких отделов, все они отображаются через запятую.

  3. Дата создания - Дата оформления заказа сотрудником в формате ДД.ММ.ГГГГ

  4. Дата доставки - Дата доставки в формате ДД.ММ.ГГГГ

    1. фактическbй день, когда заказ завершён успешно или нет

  5. Статус заказа

    1. Новый заказ — для всех новых не обработанных заказов

    2. Доставка — заказ передан в доставку

    3. Выполнен — заказ выполнен

    4. Отменён — заказ отменён

  6. Артикул товара

  7. Название приза

  8. Кол-во призов в заказе

  9. Цена за единицу

  10. Общая сумма — считается как Кол-во призов в заказе х Цена за единицу