/
SetRetail10 ◾️ Mindbox

Публичное пространство

SetRetail10 ◾️ Mindbox

июл. 28, 2025

Список работ

10.2.95.0

CR-4702 - Получение подробных данных проблемы… СТАТУС

SR-4232 - Получение подробных данных проблемы… СТАТУС

SR-4233 - Получение подробных данных проблемы… СТАТУС

SR-4235 - Получение подробных данных проблемы… СТАТУС

SR-4244 - Получение подробных данных проблемы… СТАТУС

SR-4247 - Получение подробных данных проблемы… СТАТУС

SR-4254 - Получение подробных данных проблемы… СТАТУС

SR-4256 - Получение подробных данных проблемы… СТАТУС

SR-4262 - Получение подробных данных проблемы… СТАТУС

SR-4267 - Получение подробных данных проблемы… СТАТУС

SR-4279 - Получение подробных данных проблемы… СТАТУС

SR-4289 - Получение подробных данных проблемы… СТАТУС

SR-4289 - Получение подробных данных проблемы… СТАТУС

SR-4290 - Получение подробных данных проблемы… СТАТУС

SR-4307 - Получение подробных данных проблемы… СТАТУС

SR-4344 - Получение подробных данных проблемы… СТАТУС

10.3.2.0

SR-4876 - Получение подробных данных проблемы… СТАТУС

CR-5791 - Получение подробных данных проблемы… СТАТУС

10.3.11.0

SR-5446 - Получение подробных данных проблемы… СТАТУС

10.3.12.0

SR-5445 - Получение подробных данных проблемы… СТАТУС

SR-5442 - Получение подробных данных проблемы… СТАТУС

SR-5443 - Получение подробных данных проблемы… СТАТУС

10.3.13.0

SR-5513 - Получение подробных данных проблемы… СТАТУС

Описание

Mindbox - это облачное решение для автоматизации розничного маркетинга. Сервис предоставляет рекламные акции и лояльность, больше каналов для рассылок. Клиентам отправляются рекомендации, также предоставляются автоматические маркетинговые алгоритмы на основе машинного обучения. 

Зоны ответственности

  • Команда разработки А.
  • Все ошибки создаются стандартно в Jira по регламенту.
  • Все обработки ошибок на стороне Mindbox осуществлять через менеджера проекта или продукт-оунера.
  • Запросы на доработку только через менеджера.

Настройка

Настройка плагина на сервере

1. На сервере SetRetail/SetCentrum перейдите в Интеграция → Внешние процессинги → кликните .

2. Введите в строке поиска майндбокс → кликните Внешние процессинги лояльности → установите флажок Лояльность Майндбокс → кликните .

3. Кликните по процессингу Лояльность Майндбокс.

4. На вкладке ОБЩИЕ установите следующие настройки:

НастройкиОписание
URL-адрес процессинга *

Адрес к продуктивному контуру процессинга Mindbox.

Указывается в полном формате с протоколом https.

Endpoint процессингаЛогин для доступа к процессингу
Секретный ключ

Ключ для доступа к процессингу.

Указывается в формате:

Mindbox secretKey="XXXXXXXXXXXXXX"

Идентификатор программы товаров (канал продаж) *

Идентификатор программы лояльности в Mindbox.

По умолчанию: default

Идентификатор основного бонусного счета

Основной бонусный счет для списания или начисления баллов.

Предоставляется Mindbox.

Идентификатор дополнительного бонусного счета

Дополнительный бонусный счет для списания или начисления баллов.

Предоставляется Mindbox.

SR-5445 - Получение подробных данных проблемы… СТАТУС

CR-7243 - Получение подробных данных проблемы… СТАТУС

10.3.12.0

Время соединения (миллисекунды)

Время, которое требуется для запроса к процессингу MindBox

  • По умолчанию: 3000
  • Рекомендуется: 10000
Время ответа (миллисекунды)

Время, которое требуется на ожидание ответа от процессинга Mindbox

  • По умолчанию: 5000
  • Рекомендуется: 15000

 Печатать слип вне чека

Устанавливается печать информации о баллах в отдельном документе от основного чека

 Не отправлять в Mindbox чеки из SetKit, содержащие признаки запрета расчета скидок


Отключение отправки чековых позиций, полученных из SetKit, в CRM MindBox.

При активированном флажке запрещена отправка чеков, полученных из SetKit в Mindbox, при следующих условиях:

  • Если в заказе покупателя присутствует хотя бы одна позиция с признаком isFixedPrice = true - касса не отправляет мягкий чек в Mindbox.

  • Если в заказе покупателя присутствует хотя бы одна позиция с признаком isFixedDiscounts = true - касса не отправляет мягкий чек в Mindbox.

  • Если в заказе покупателя все позиции без запретов расчета скидок (isFixedPrice = false и isFixedDiscounts = false), то касса отправляет мягкий чек в Mindbox для расчета скидок.

SR-5568 - Получение подробных данных проблемы… СТАТУС

CR-7537 - Получение подробных данных проблемы… СТАТУС

10.3.14.0

 Выводить информацию о клиенте при добавлении карты в чек

При добавлении карты лояльности в чек на экране кассира отображается детальная информация о клиенте

SR-5442 - Получение подробных данных проблемы… СТАТУС

CR-7041 - Получение подробных данных проблемы… СТАТУС

10.3.12.0

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


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

SR-5443 - Получение подробных данных проблемы… СТАТУС

CR-7057 - Получение подробных данных проблемы… СТАТУС

10.3.12.0

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

Настраивать вывод текстовых сообщений на экран. Будет отображена только та информация, которая будет настроена пользователем в поле [Выводимая информация при добавлении карты в чек]

CR-9866 - Получение подробных данных проблемы… СТАТУС

SR-6412 - Получение подробных данных проблемы… СТАТУС

10.3.27.0

Выводимая информация при добавлении карты в чек

Настройка полей для вывода сообщения на экран о карте покупателя

CR-9866 - Получение подробных данных проблемы… СТАТУС

SR-6412 - Получение подробных данных проблемы… СТАТУС

10.3.27.0

Список ключей для подстановок

  • mainBalanceSystemName - systemName основного баланса;
  • mainBalanceName - название основного баланса для отображения (balance->balanceType->name);
  • mainBalanceTotal - общее количество баллов на счете основного баланса;
  • mainBalanceAvailable - доступное количество баллов на счете основного баланса;
  • mainBalanceExpirationTotal - ближайшее количество сгораемых баллов основного баланса;
  • mainBalanceExpirationDate - дата ближайшего сгорания баллов основного баланса;
  • additionalBalanceName - systemName дополнительного баланса;
  • additionalBalanceName - название дополнительного баланса для отображения (balance->balanceType->name);
  • additionalBalanceTotal - общее количество баллов на счете дополнительного баланса;
  • additionalBalanceAvailable - доступное количество баллов на счете дополнительного баланса;
  • additionalBalanceExpirationTotal - ближайшее количество сгораемых баллов дополнительного баланса;
  • additionalBalanceExpirationDate - дата ближайшего сгорания баллов дополнительного баланса;
  • totalPaidAmount - общая сумма покупок (retailOrderStatistics->totalPaidAmount)
  • present - подарок (customer->customFields->present);
  • nextLevel - осталось для следующего уровня (customer->customFields->nextlevel);


Пример шаблона (копируется в строчку в настройках):

  • Счет: {mainBalanceSystemName} \n
  • Баланс: {mainBalanceTotal} баллов Активных: {mainBalanceAvailable} баллов \n;
    {mainBalanceExpirationTotal} баллов с датой сгорания {mainBalanceExpirationDate} \n\n;

Примеры на кассе:

Клавиатурная касса


SetTouch

Верифицировать покупателей из сегментовУстанавливается код сегмента (или коды через точку с запятой) в процессинге Mindbox, к которому принадлежат карты, требующие верификации с помощью СМС-кода
Максимальное время ожидания ввода смс-кода подтверждения (секунды)Время ожидания ввода СМС-кода подтверждения в секундах
Учитывать тег отказа от печати чека

Если флажок установлен, то при использовании плагина, чек не печатается.

SR-6389 - Получение подробных данных проблемы… СТАТУС

CR-9782 - Получение подробных данных проблемы… СТАТУС

10.3.25.0

Отправка чека по номеру телефона имеет приоритет над отправкой через e-mail

Если настройка включена, значит если у клиента заполнен и номер телефона и e-mail, чек будет отправлен по номеру телефона. Если отключена, отправка чека на e-mail в приоритете.

SR-6389 - Получение подробных данных проблемы… СТАТУС

CR-9782 - Получение подробных данных проблемы… СТАТУС

10.3.25.0

Печатать чек, если у клиента отсутствует e-mail

Если в карточке клиента отсутствует e-mail, то при включенной настройке будет распечатан бумажный чек вместо отправки чека по номеру телефона.

SR-6817 - Получение подробных данных проблемы… СТАТУС

CR-10405 - Получение подробных данных проблемы… СТАТУС

10.3.30.0

Тег для печати купонов

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

Значение по умолчанию: VyvodReklamynacheck

CR-11240 - Получение подробных данных проблемы… СТАТУС

SR-7469 - Получение подробных данных проблемы… СТАТУС

10.4.7.0

Печать купона отдельным слипом

Если настройка включена, то купон печатается отдельным слипом. Если выключена, то купон печатается в составе чека.

CR-11240 - Получение подробных данных проблемы… СТАТУС

SR-7469 - Получение подробных данных проблемы… СТАТУС

10.4.7.0

Печать купона в любом случае

При включении данной настройки слип с купоном печатается всегда.

CR-11240 - Получение подробных данных проблемы… СТАТУС

SR-7469 - Получение подробных данных проблемы… СТАТУС

10.4.7.0

5. Перейдите на вкладку ПЛАГИН КАРТ МАЙНДБОКС и установите настройки карт:

НастройкиОписание
Перечень комбинаций карт (через точку с запятой): длина номера карты лояльности - допустимые префиксы для неё (через запятую). Например: 16-222,999;18-66664,66665,66667

Настраиваются префиксы категорий карт, которые будут запрашиваться с кассы из процессинга Mindbox. Заведение категорий карт в SetRetail10 не требуется.

Пример:

  • Номер карты 112233, где 11 префикс, тогда значение настройки будет = 6-11, где 6 - количество символов карты, 11 префикс.
  • Использовать все карты с префиксом 23, тогда настройка будет = 23.
  • Номер карты 1234567, где 12 префикс, тогда значение настройки будет = 7-12, где 7 - количество символов карты, 12 префикс. 
  • 13-22,70&.[А-Я0-9].*&.*[A-Z0-9].*&.*[A-Z].*&.*[А-Я].
Перечень комбинаций купонов (через точку с запятой): длина номера купона - допустимые префиксы для него (через запятую). Перечень регулярных выражений через &.

Настраиваются префиксы внешних купонов, которые будут запрашиваться с кассы из процессинга Mindbox. Заведение серийных или несерийных купонов в SetRetail10 не требуется.

Заполнение значений такое же как и в случае с картами (см. пример из настройки выше по заполнению длины карт).

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

Пример:

.*[0-9].*&.*[А-Я].* - регулярное выражение для русскобуквенных промокодов

SR-6688 - Получение подробных данных проблемы… СТАТУС

CR-10001 - Получение подробных данных проблемы… СТАТУС

10.3.29.0

Перечень комбинаций позиционных купонов (через точку с запятой): длина номера купона - допустимые префиксы для него (через запятую)

Настраиваются префиксы внешних позиционных купонов, которые будут запрашиваться с кассы из процессинга Mindbox. Заведение позиционных купонов в SetRetail10 не требуется.

Пример

  • Код купона 2212568999888, в поле настройки указано значение 13-22, где 13 - количество символов карты, 22 - префикс.

SR-7215 - Получение подробных данных проблемы… СТАТУС

CR-11351 - Получение подробных данных проблемы… СТАТУС

10.4.5.0

Перечень полей при регистрации клиента (через точку с запятой): Фамилия, Имя, Отчество, Дата Рождения, Email. Например: lastname;firstname;middlename;birthdate;email

При регистрации нового клиента заполнять анкету с данными клиента. Требуемые поля указываются через разделитель "точка с запятой".

Указанные поля анкеты будут необязательными к заполнению на кассе. Начиная с версии 10.4.9.0 можно также устанавливать обязательные поля анкеты, для этого реализована отдельная настройка (описано ниже).

Доступные поля:

  • lastname - фамилия;
  • firstname - имя;
  • middlename - отчество;
  • birthdate - дата рождения;
  • email - электронная почта.

SR-6630 - Получение подробных данных проблемы… СТАТУС

CR-9764 - Получение подробных данных проблемы… СТАТУС

10.3.29.0

Перечень обязательных полей при регистрации клиента (через точку с запятой): Фамилия, Имя, Отчество, Дата Рождения, Email. Например: lastname;firstname;middlename;birthdate;email

Перечень обязательных полей при регистрации клиента. Указанные в данной настройке поля запрещено пропускать при выдаче карты покупателя (будет возможно только отменить процесс регистрации). Поля будут выведены к заполнению на кассе в том порядке, в котором они перечислены в настройках плагина. Сначала будут выведены обязательные поля, затем - все необязательные.

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

Доступные поля:

  • lastname - фамилия;
  • firstname - имя;
  • middlename - отчество;
  • birthdate - дата рождения;
  • email - электронная почта.

SR-7714 - Получение подробных данных проблемы… СТАТУС

CR-12701 - Получение подробных данных проблемы… СТАТУС

10.4.9.0

Разделитель кода верификации (регулярное выражение)

SR-7963 - Получение подробных данных проблемы… СТАТУС

CR-13168 - Получение подробных данных проблемы… СТАТУС

10.4.12.0

Регулярное выражение для определения QR-кода на кассе.

Пример

Регулярное выражение:

(\d{13}),(\d{0,4})

Значение, "зашитое" в QR-код:

1120200786809,0000

где 1120200786809 - номер карты покупателя, а 0000 - код верификации.

 Дополнительная защита операции списания бонусов при авторизации покупателей по штрихкоду карты

Для подтверждения операции списания бонусов касса запрашивает ввод СМС-кода подтверждения, если карта была добавлена в чек по штрихкоду.

Если в карточке клиента отсутствует номер телефона, операция списания бонусов недоступна.

  • SR-5513 - Получение подробных данных проблемы… СТАТУС
  • CR-7608 - Получение подробных данных проблемы… СТАТУС
  • 10.3.13.0

 Дополнительная защита операции списания бонусов при авторизации покупателей при вводе номера вручную

Для подтверждения операции списания бонусов касса запрашивает ввод СМС-кода подтверждения, если карта была добавлена в чек вручную.

Если в карточке клиента отсутствует номер телефона, операция списания бонусов недоступна.

  • SR-5513 - Получение подробных данных проблемы… СТАТУС
  • CR-7608 - Получение подробных данных проблемы… СТАТУС
  • 10.3.13.0

 Дополнительная защита операции списания бонусов при авторизации покупателей по магнитной полосе карты

Для подтверждения операции списания бонусов касса запрашивает ввод СМС-кода подтверждения, если карта была добавлена в чек прокатыванием магнитной полосы.

Если в карточке клиента отсутствует номер телефона, операция списания бонусов недоступна.

  • SR-5513 - Получение подробных данных проблемы… СТАТУС
  • CR-7608 - Получение подробных данных проблемы… СТАТУС
  • 10.3.13.0
Дополнительная защита операции списания бонусов при авторизации покупателей по номеру телефона

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

Если одновременно активирован флаг Отключение защиты операции списания бонусов при авторизации по номеру телефона, то настройка Дополнительная защита операции списания бонусов при авторизации покупателей по номеру телефона будет считаться более приоритетной.

SR-7141 - Получение подробных данных проблемы… СТАТУС

CR-11215 - Получение подробных данных проблемы… СТАТУС

10.4.5.0

 Запрет на добавление другой карты

Нельзя добавить карту в чек, который уже содержит другую карту.

SR-6275 - Получение подробных данных проблемы… СТАТУС

10.3.25.0

 Отключение защиты операции списания бонусов при авторизации по номеру телефона

Для подтверждения операции списания бонусов касса не запрашивает ввод СМС-кода подтверждения, если карта была добавлена в чек через поиск по номеру телефона.

  • SR-6986 - Получение подробных данных проблемы… СТАТУС
  • CR-10467 - Получение подробных данных проблемы… СТАТУС
  • 10.4.0.0
Регистрировать номер телефона покупателя, если он отсутствует в данных по карте

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

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

SR-7575 - Получение подробных данных проблемы… СТАТУС

CR-12375 - Получение подробных данных проблемы… СТАТУС

10.4.8.0

Длина ПИН-кода верификации

Длина кода подтверждения, отправляемого в SMS-сообщении при списании бонусов и аутентификации владельца карты лояльности.

По умолчанию: 4; минимально допустимое значение: 4.

SR-8216 - Получение подробных данных проблемы… СТАТУС

CR-13856 - Получение подробных данных проблемы… СТАТУС

10.4.17.0

Количество sms-запросов для одного номера телефона

Максимальное количество SMS-сообщений с кодом подтверждения для одного номера телефона в рамках одного чека.

По умолчанию: 3.

SR-8216 - Получение подробных данных проблемы… СТАТУС

CR-13856 - Получение подробных данных проблемы… СТАТУС

10.4.17.0

Количество попыток сверки ПИН-кода

Максимальное количество попыток ввода кода подтверждения для одного SMS-сообщения.

По умолчанию: 3.

SR-8216 - Получение подробных данных проблемы… СТАТУС

CR-13856 - Получение подробных данных проблемы… СТАТУС

10.4.17.0

Таймаут отправки sms при выдаче/замене карты с ПИН-кодом верификации (сек)

Время (в секундах), в течение которого будет запрещено повторно отправлять код подтверждения при выдаче/замене карты.

По умолчанию: 60.

SR-8216 - Получение подробных данных проблемы… СТАТУС

CR-13856 - Получение подробных данных проблемы… СТАТУС

10.4.17.0

6. Кликните .

Шаблон кассы

1. Перейдите в Кассовый модуль → Шаблоны касс → кликните  → выберите из контекстного меню Редактировать.

2. Для любого типа кассы (Клавиатурная/SetTouch), если требуется сообщать кассиру о доступной сумме списываемых бонусов, тогда установите флажок Информирование кассира о возможности списать бонусы.

3. Для клавиатурной кассы.

Перейдите на вкладку НАСТРОЙКА МЕНЮ → кликните .

Добавьте действие Списание бонусов.

Для просмотра информации по карте добавьте функцию меню:

Для кассы SetTouch кнопка Инфо по карте есть по умолчанию.

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

4. Для кассы SetTouch.

Для кассы SetTouch кнопка СПИСАТЬ БОНУСЫ появится, если связь плагина с внешней системой есть и доступно списание баллов. Отдельных настроек в шаблоне кассы SetTouch производить не требуется.

5. Кликните .

Настройка привилегий кассира

1. Если кассиру будет предоставлено право редактирования суммы списания бонусов, тогда перейдите в Персонал → Роли кассиров → кликните .

2. Добавьте к кассовой роли привилегию Редактирование суммы списания бонусов.

После выполненных настроек перезагрузите кассовый модуль.

Рекламная акция для работы с бонусами Mindbox

1. Перейдите в Лояльность → кликните Рекламные акции → кликните .

2. Введите название рекламной акции → установите условие Безусловно (также можно установить списание бонусов по условиям) → установите результат Скидка → Внешняя система лояльности → выберите Плагин лояльности Майндбокс → кликните .

3. Запустите рекламную акцию.

 

Данные о продажах

Чек

Операционный день

Данные о продажах в чеке из раздела операционного дня будут отражены на вкладке ТОВАРНЫЕ ПОЗИЦИИ.

Также начисление и списание бонусов через процессинг Mindbox будут отражены на вкладке КАРТЫ.

Интеграционная документация

SR-4608 - Получение подробных данных проблемы… СТАТУС

CR-5383 - Получение подробных данных проблемы… СТАТУС

10.2.96.0

Данные о продаже формируются в XML-пакет согласно интеграционной документации по экспорту чеков. Экспорт производится с помощью веб-сервисов и файлов.

Начиная с версии 10.2.96.0 добавилось плагинное свойство EXTERNAL_COUPON.

Также относительно процессинга используются следующие поля плагинных свойств:

ПолеОписание
bonusesToWriteOffКоличество бонусов к списанию.
preorderMode

Статус предзаказа в процессинге:

  • Online - на связи.
  • Offline - связь отсутствовала, расчет был произведен при отключенном процессинге Mindbox.
externalSystemIdИдентификатор транзакции во внешнем процессинге.
accruedBonusesКоличество начисленных бонусов.
appliedPromotionsПримененные рекламные акции Mindbox.
beginMode

Статус расчета в начале совершения операции с чеком:

  • Online - на связи.
  • Offline - связь отсутствует, расчет будет произведен при отключенном процессинге Mindbox.
BonusChangeСообщение об изменении размера бонусного счета исходя из списанных/начисленных баллов.
UID_PURCHASEИдентификатор транзакции чека.
lines

Подробное сообщение от процессинга Mindbox о срабатывании рекламных акций и работы с бонусным балансом.

SR-4803 - Получение подробных данных проблемы… СТАТУС

10.2.98.0

С версии 10.2.98.0 генерируются уникальные идентификаторы LineId для каждой позиции чека.

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

chargedBonusesКоличество списанных бонусов.
mindboxCardSource

Способ добавления карты покупателя в чек:

  • QR_AUTHENTICATION - QR с кодом верификации (успешная валидация кода).

  • QR_WITHOUT_AUTHENTICATION - QR без кода верификации (код верификации отсутствует или не прошел валидацию).

  • BARCODE - добавление карты путем сканированием штрихкода с номером карты.

  • MOBILE_PHONE - добавление карты по номеру телефона.

  • CARD_NUMBER - вручную по номеру карты.

  • UNKNOWN - способ добавления не известен.

SR-7963 - Получение подробных данных проблемы… СТАТУС

CR-13168 - Получение подробных данных проблемы… СТАТУС

10.4.12.0

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="1" userName="Администраторов Администратор Администраторович" operationType="true" cashOperation="INCOME" operDay="2021-04-02+03:00" shop="1872"
              cash="61" shift="2" number="5" saletime="2021-04-02T18:25:03.590+03:00" begintime="2021-04-02T16:59:28.073+03:00" amount="33.14" discountAmount="35.04"
              inn="7802781104" fiscalDocNum="3;5">
        <plugin-property key="bonusesToWriteOff" value="33.00"/>
        <plugin-property key="preorderMode" value="Online"/>
		<plugin-property key="mindboxCardSource" value="QR_WITHOUT_AUTHENTICATION"/>
        <plugin-property key="externalSystemId" value="18720611617377099583"/>
        <plugin-property key="accruedBonuses" value="3.0"/>
        <plugin-property key="appliedPromotions" value="[]"/>
        <plugin-property key="beginMode" value="Online"/>
        <plugin-property key="BonusChange"
                         value="{"balanceType":{"name":"MainBalance","ids":{"systemName":"MainBalance"}},"earnedAmount":3.0,"spentAmount":33.0}"/>
        <plugin-property key="UID_PURCHASE" value="405dfb08-2fe3-492d-864c-0ed205f45ce8"/>
        <plugin-property key="lines"
                         value="[{"minPricePerItem":"0.00","basePricePerItem":"68.18","discountedPriceOfLine":"33.14000","quantity":"1.000","quantityType":"int","lineId":"Пряник яблочный сочный (Россия)_4600515000005","lineNumber":"1","product":{"ids":{"default":"00515"}},"status":{"ids":{"externalId":"Sr10Paid"}},"appliedPromotions":[{"type":"discount","amount":2.04,"promotion":{"ids":{"mindboxId":"133","externalId":"clone-clone-promotion-112-2"},"name":"Set10-3%","type":"mindbox"}},{"type":"spentBonusPoints","amount":33.0,"promotion":{"ids":{"mindboxId":"102","externalId":"promotion-102"},"name":"Списание баллов SR10","type":"mindbox"},"balanceType":{"name":"MainBalance","ids":{"systemName":"MainBalance"}}},{"type":"earnedBonusPoints","amount":3.0,"promotion":{"ids":{"mindboxId":"45","externalId":"clone-clone-promo-action-2"},"name":"Базовое начисление баллов 10% на счет","type":"mindbox"},"balanceType":{"name":"MainBalance","ids":{"systemName":"MainBalance"}}}]}]"/>
        <plugin-property key="offlineTransactionId" value="20210402_165928_1872_61_2_5_1617377097550"/>
        <plugin-property key="BonusBalance"
                         value="{"total":"834.00","available":"576.00","blocked":"258.00","systemName":"MainBalance","balanceType":{"name":"MainBalance","ids":{"systemName":"MainBalance"}}}"/>
        <plugin-property key="chargedBonuses" value="33.0"/>
        <positions>
            <position order="1" departNumber="1" goodsCode="00515" barCode="4600515000005" count="1.000" cost="68.18" nds="20.0" ndsSum="5.52" discountValue="35.04"
                      costWithDiscount="33.14" amount="33.14" dateCommit="2021-04-02T18:06:11.602+03:00" insertType="1">
                <plugin-property key="countryName" value="Бельгия"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="CashChangePaymentEntity" amount="0.86" description=""/>
            <payment typeClass="CashPaymentEntity" amount="34.0" description="Оплата наличными"/>
        </payments>
        <discountCards>
            <discountCard>112233</discountCard>
            <discountCard>41359</discountCard>
            <discountCard>40059</discountCard>
        </discountCards>
        <card type="EXTERNAL" number="112233" guid="112233"/>
        <card type="EXTERNAL_COUPON" number="41359"/>
        <card type="EXTERNAL_COUPON" number="40059"/>
    </purchase>
</purchases>

Обычный чек

SR-6690 - Получение подробных данных проблемы… СТАТУС

CR-10289 - Получение подробных данных проблемы… СТАТУС

10.3.29.0

Начиная с версии 10.3.29.0 в бонусном слипе не печатается информация о заблокированных бонусных баллах.

Пример работы

Списание бонусных баллов

Начиная с версии SetRetail 10.3.23.0 изменилась логика работы плагина Mindbox по распределению бонусных баллов:

  • убрано кассовое перераспределение баллов по позициям с округлением;

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

SR-6210 - Получение подробных данных проблемы… СТАТУС

CR-9539 - Получение подробных данных проблемы… СТАТУС

10.3.23.0

Сценарий списания бонусов, приведённый ниже, реализуется при установленных следующим образом настройках:

  •  Дополнительная защита операции списания бонусов при авторизации покупателей по штрихкоду карты
  •  Дополнительная защита операции списания бонусов при авторизации покупателей при вводе номера вручную
  •  Дополнительная защита операции списания бонусов при авторизации покупателей по магнитной полосе карты
  •  Отключение защиты операции списания бонусов при авторизации по номеру телефона

При таких настройках касса не требует ввод СМС-кода для подтверждения операции списания бонусов.

Для включения защиты данной операции в зависимости от способа авторизации покупателя, измените настройки в разделе Внешние процессинги → Лояльность Майндбокс → на вкладке ПЛАГИН КАРТ МАЙНДБОКС. 

Клавиатурная касса

1. Кассир добавляет на кассе карту из процессинга Mindbox.

2. При включенной настройке  Выводить информацию о клиенте при добавлении карты в чек на экране кассира отображается подробная информация по клиенту. Кассир нажимает ВВОД или ОТМЕНА.

3. При включенной настройке  Выводить детализацию по бонусным счетам клиента при добавлении карты в чек на экране кассира отображается информация о размере доступных бонусов для списания и информация о ближайших сгораниях. Кассир нажимает ВВОД или ОТМЕНА.

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

5. Кассир добавляет товары.

6. Кассир нажимает кнопку РАСЧЕТ → в случае установленного флажка Информирование кассира о возможности списать бонусы появляется сообщение → кассир выбирает Списать и нажимает клавишу ВВОД.

Также кассир может перейти в меню кассы и выбрать пункт Списание бонусов.

7. Кассир редактирует сумму бонусов, если разрешено → нажимает клавишу ВВОД для подтверждения списания.

Списывается сумма баллов.

8. Кассир вводит оставшуюся сумму и нажимает клавишу ВВОД для подтверждения.

Печатается чек.

SetTouch

1. Кассир нажимает на кассе функцию для добавления карты покупателя.

2. Кассир вводит номер карты покупателя Mindbox → нажимает .

3. Кассир нажимает .

4. При включенной настройке  Выводить информацию о клиенте при добавлении карты в чек на экране кассира отображается подробная информация по клиенту. Кассир нажимает .

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

6. После авторизации карты отображается её номер и суммарный баланс бонусных баллов по счетам, указанным в настройках плагина.

7. Кассир добавляет товары в чек и выбирает тип оплаты, например, наличными.

8. Производится расчет скидок → в случае установленного флажка Информирование кассира о возможности списать бонусы появляется сообщение → кассир нажимает .

Также может нажать .

9. Кассир редактирует сумму бонусов, если разрешено → нажимает .

Списывается сумма баллов.

10. Кассир вводит оставшуюся сумму к оплате и нажимает .

Печатается чек.

Валидация операции списания бонусов, если карта добавлена в чек по номеру телефона

SR-7141 - Получение подробных данных проблемы… СТАТУС

CR-11215 - Получение подробных данных проблемы… СТАТУС

10.4.5.0

Функциональность доступна для клавиатурных касс, SetTouch и SCO.

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

Для включения валидации необходимо установить флаг Дополнительная защита операции списания бонусов при авторизации покупателей по номеру телефона в настройках плагина на вкладке ПЛАГИН КАРТ МАЙНДБОКС.

Основной сценарий работы

1. Кассир добавляет товар в чек.

2. Кассир переходит в окно поиска карты лояльности.


3. Кассир нажимает НОМЕР ТЕЛЕФОНА.


4. Далее кассир вводит продиктованный покупателем номер телефона и нажимает ПОДТВЕРДИТЬ. Карта добавляется в чек.


5. Кассир переходит к расчёту. 


6. Касса выводит окно о доступных для списания бонусах. Кассир нажимает СПИСАТЬ.


7. Кассир уточняет у покупателя, сколько бонусов необходимо потратить, при необходимости редактирует сумму к списанию и нажимает СПИСАТЬ.

8. Касса выводит окно с сообщением "Отсканируйте ШК карты или проведите магнитную полосу карты через считыватель". Ручной ввод номера карты запрещён.

Далее происходит валидация карты одним из следующих способов:

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

9. Карта проходит валидацию, и касса отображает применённые к товару скидки.

10. Кассир рассчитывает покупателя.

Сообщение кассы "Добавленная карта не прошла проверку. Списание бонусов запрещено"

1-8. Повторяются шаги из предыдущего сценария.

9. Карта не проходит проверку, и касса выводит сообщение: "Добавленная карта не прошла проверку. Списание бонусов запрещено".

10. Кассир закрывает окно. Касса не применяет скидки по бонусам.

Идентификация владельца карты лояльности с помощью СМС-кода

10.3.2.0

1. Кассир добавляет в чек карту лояльности и товары.

На экране отображается бонусный баланс. Кассир нажимает РАСЧЕТ.

2. Карта принадлежит сегменту карт, требующих ввода кода подтверждения.

На телефон покупателя отправляется код в СМС-сообщении.

3. Кассир вводит код из СМС-сообщения и нажимает ВВОД.

4. После успешной авторизации производится расчет скидок, к товарам применяется дополнительная акция для данного типа карт.

5. Далее кассир производит стандартные операции по фискализации чека.

Выдача карты лояльности на кассе

SR-7575 - Получение подробных данных проблемы… СТАТУС

CR-12375 - Получение подробных данных проблемы… СТАТУС

10.4.8.0

Начиная с версии 10.4.8.0 при выдаче карты лояльности и списании бонусов в рамках одного чека (например, при работе акции по начислению приветственных бонусов за регистрацию), бонусы будут списаны без дополнительного подтверждения по СМС даже если установлен флаг Дополнительная защита операции списания бонусов при авторизации покупателей по штрихкоду карты. Так как при выдаче карты пользователю приходит проверочный код на номер телефона, отсутствует необходимость в дополнительной отправке проверочного кода при списании бонусов в том же чеке. Такая логика работы кассы позволяет сократить время обслуживания покупателей и расходы на отправку СМС-сообщений.

SR-5446 - Получение подробных данных проблемы… СТАТУС

CR-7056 - Получение подробных данных проблемы… СТАТУС

10.3.11.0

В версии 10.3.11.0 реализован процесс выдачи или замены карты на кассе с подтверждением номера телефона.

1. Кассир добавляет товары в чек.

2. Кассир выбирает пункт меню Выдача/замена карты.

3. Кассир запрашивает номер телефона покупателя и вводит его.

4. Процессинг отправляет код подтверждения на телефон покупателя.

5. Кассир вводит код из СМС-сообщения.

6. Касса запрашивает выбор типа карты.

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

При выборе физической карты касса запрашивает номер карты. Кассир сканирует карту или прокатывает ее через карт-ридер или вводит номер карты вручную.

В случае неудачной проверки номера карты касса выведет сообщение:

8. Кассир завершает чек доступными типами оплат.

Отказ от печати чека

SR-6175 - Получение подробных данных проблемы… СТАТУС

CR-8422 - Получение подробных данных проблемы… СТАТУС

10.3.23.0

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

Настройка

В шаблоне касс перейдите на вкладку ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → раздел Работа с чеком → установите настройки → кликните .

 Использовать анкетные данные покупателя для отправки электронной копии чека

 Не печатать бумажный чек 

         всегда, если чек отправлен в электронной форме

 Информировать кассира об отказе от печати чека

Пример работы

1. Кассир добавляет карту лояльности в чек. Касса отправляет запрос в процессинг. При наличии в ответе от процессинга информации о email клиента на экране кассы отображается сообщение о том, что бумажный чек не будет распечатан.

2. Кассир добавляет товары и закрывает чек доступными типами оплат.

3. Чек не распечатывается, на экране отображается сообщение об отправке электронного чека.

4. В операционном дне в чеке отображается информация об отправке.

Арбитраж скидок (более выгодная скидка в MindBox)

SR-6177 - Получение подробных данных проблемы… СТАТУС

CR-8826 - Получение подробных данных проблемы… СТАТУС

10.3.25.0

Описание

Начиная с версии 10.3.25 на кассе есть возможность отмены скидок SetRetail10 в пользу скидок MindBox в случае, когда скидrа MindBox более выгодна для покупателя.

В тех торговых сетях, где используется внутренняя лояльность SetRetail10 и внешний плагин интеграции с Mindbox раньше скидки, заведенные в SetRetail10 (фиксированная, процентная, купоны, товарные наборы, скидка на чек) суммировались с внешними скидками MindBox. Начиная с версии 10.3.25.0 реализована возможность арбитража скидок между SetRetail10 и MindBox, чтобы скидки SetRetail10 могли отменяться внешней системой MindBox в случае, когда скида в MindBox более выгодна для покупателя.

Акции SetRetail10 загружаются в Mindbox посредством импорта.

Настройка

  • Для корректной работы необходимо корректно настроить арбитраж на стороне MindBox:
    • Группа со скидками Mindbox должна быть выше группы с внешними скидками(сет); 
    • Cистема применяет акции сверху вниз, поэтому необходимо помещать в начало более приоритетную группу
    • Аналогично и с самими акциями в группе: должен быть корректный id внешних акций из сет, если настроены исключения не "все акции сет".
    • Должны быть установлены Приоритеты («Максимальная выгода» в промоакциях).

Чтобы арбитраж для суммирующихся акций работал корректно, в БД catalog в таблице sales_management_properties измените порядок провайдеров лояльности, чтобы суммирующиеся акции сработали до расчета скидок MindBox. Подробнее /wiki/spaces/SR10DEV/pages/1032880180.

Отображение названий акций из Mindbox на экране кассы SetTouch и в чековых данных

SR-6919 - Получение подробных данных проблемы… СТАТУС

CR-9661 - Получение подробных данных проблемы… СТАТУС

10.3.31.0

С версии 10.3.31.0 при срабатывании акции из Mindbox её название отображается:

  • при просмотре скидок на кассе SetTouch;
  • на сервере SetRetail/SetCentrum в чековых данных.

Пример

При расчёте скидок на кассе SetTouch отображается название акции из Mindbox:


На сервере SetRetail/SetCentrum в разделе Операционный день → Чеки при открытии чека на вкладке СКИДКИ ПО ЧЕКУ отображается название акции из Mindbox.

Отправка товаров, добавленных вне мягкого чека, в Mindbox для расчета скидок

Описание

SR-7051 - Получение подробных данных проблемы… СТАТУС

CR-10955 - Получение подробных данных проблемы… СТАТУС

10.4.1.0

При активированной настройке Не отправлять в Mindbox чеки из SetKit, содержащие признаки запрета расчета скидок:

  • Если в заказе покупателя присутствует хотя бы одна позиция с признаком isFixedPrice = true или isFixedDiscounts = true, то касса не отправляет мягкий чек в Mindbox.
  • При этом товары, добавленные в чек помимо заказа из SetKit, отправляются в Mindbox для расчета скидок и начисления бонусов (с нумерацией позиций без учета мягкого чека).

Если в мягком чеке присутствуют типы товаров с запретом расчета скидок (например, "Табачные изделия", "Дисконтная карта", "Подарочная карта"), то этот чек при восстановлении на кассе не будет отправлен в Mindbox вне зависимости от выставленных флагов у позиций, для расчета скидок будут отправлены только добавленные к чеку товары.

Пример работы

Исходные условия

  • В SetCentrum настроена внешняя интеграция с Mindbox посредством плагина.
  • В сети магазина используется сервис SetKit.
  • На кассе настроено взаимодействие с SetKit для получения данных о мягком чеке, т.е. для клавиши назначена функция "Поиск мягкого чека".
  • В результате оформления заказа формируется мягкий чек, который затем поступает в SetKit и хранится там до запроса его с кассы Set10.
  • В SetCentrum в настройках карт плагина активирован флаг "Не отправлять в Mindbox чеки из SetKit, содержащие признаки запрета расчета скидок".

Сценарий отправки в Mindbox запроса с добавленными на кассе товарами без позиций из мягкого чека

  1. Внешняя система присылает в SetKit созданный заказ:

    1. Товар А - 1 шт. (isFixedPrice = true и isFixedDiscounts = false);

    2. Товар Б - 2 шт. (isFixedPrice = false и isFixedDiscounts = false);

    3. Товар В - 1 шт. (isFixedPrice = false и isFixedDiscounts = true).

  2. Кассир добавляет в чек товар "Пакет".

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

  4. Кассир производит поиск мягкого чека (сканирует ШК мягкого чека/вводит номер вручную в окне поиска/ищет по номеру телефона покупателя).

  5. Мягкий чек найден, и товары добавляются в чек.

  6. Кассир добавляет в чек товар "Блокнот".

  7. Кассир переходит к расчету.

  8. Касса передает две позиции ("Пакет" и "Блокнот") в запросе в процессинг Mindbox для расчета скидок.

  9. Касса применяет скидки к двум позициям.

  10. Покупатель оплачивает чек.

Выдача карты лояльности покупателю, если карта не найдена по номеру телефона

SR-7125 - Получение подробных данных проблемы… СТАТУС

CR-11130 - Получение подробных данных проблемы… СТАТУС

10.4.4.0

Описание

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

Функциональность реализована для касс SetTouch.

Пример работы на SetTouch

Исходное условие: на SetTouch настроена кнопка c функцией кассы Плагин поиска карты по номеру телефона (Лояльность Майндбокс).

1. Кассир добавляет товар в чек.

2. Кассир переходит к поиску карты лояльности по номеру телефона.


3. Кассир вводит номер телефона, продиктованный покупателем, и нажимает ПОДТВЕРДИТЬ. 


4. Карты, привязанной к указанному номеру телефона, не найдено. Кассир сообщает об этом покупателю и предлагает завести карту лояльности.

Покупатель соглашается, и кассир нажимает ПОДТВЕРДИТЬ.


5. Касса автоматически подставляет ранее введенный номер телефона в поле для ввода в окне выдачи карты лояльности. Кассир нажимает ПОДТВЕРДИТЬ.


6. На указанный номер телефона покупателю приходит SMS с кодом для подтверждения.

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


7. Кассир уточняет у покупателя, какую карту выдать - виртуальную или физическую. Кассир нажимает ВИРТУАЛЬНАЯ.


8. Касса выдает сообщение об успешной выдаче карты. Кассир нажимает ПОДТВЕРДИТЬ.


9. Выданная карта лояльности добавлена в чек.

10. Кассир переходит к расчету.

Дополнение анкеты покупателя номером телефона на кассе

SR-7575 - Получение подробных данных проблемы… СТАТУС

CR-12375 - Получение подробных данных проблемы… СТАТУС

10.4.8.0

Описание

В ситуации, когда на кассе включена защита операции списания бонусов, а у покупателя в анкете нет номера телефона, становится невозможным списание бонусов - так как невозможно идентифицировать покупателя проверкой по СМС-коду.

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

Пример работы на кассе

Исходные условия

В настройках плагина установлены флажки:

  • Дополнительная защита операции списания бонусов при авторизации покупателей по штрихкоду карты;
  • Регистрировать номер телефона покупателя, если он отсутствует в данных по карте.

Сценарий 1. Успешное дополнение анкеты покупателя номером телефона

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

2. Кассир вводит продиктованный покупателем номер телефона и нажимает ПОДТВЕРДИТЬ.


3. На номер телефона покупателя отправляется СМС-сообщение с кодом подтверждения. 

4. Кассир вводит код, продиктованный покупателем, и нажимает ПОДТВЕРДИТЬ.


5. Касса выводит сообщение об успешном добавлении номера телефона. Кассир нажимает ПОДТВЕРДИТЬ.


6. Карта успешно добавлена в чек. 

7. Кассир добавляет товары и завершает чек.

Сценарий 2. Отмена дополнения анкеты покупателя номером телефона и запрет на списание бонусов

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

2. Покупатель не предоставляет информацию о своем номере телефона. Кассир нажимает ОТМЕНИТЬ.


3. Касса выводит сообщение об отмене операции внесения данных о покупателе. Карта успешно добавляется в чек.


4. Кассир добавляет товар в чек. Если кассир нажимает на кнопку СПИСАТЬ БОНУСЫ.


5. Касса выводит окно с количеством доступных бонусов на карте покупателя. Кассир нажимает СПИСАТЬ.


6. Касса выводит сообщение о запрете списания бонусов (так как невозможно выполнить проверку по СМС согласно настройке Дополнительная защита операции списания бонусов при авторизации покупателей по штрихкоду карты). 

7. Кассир закрывает чек без применения бонусов.

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

SR-7714 - Получение подробных данных проблемы… СТАТУС

CR-12701 - Получение подробных данных проблемы… СТАТУС

10.4.9.0

Описание

Начиная с версии 10.4.9.0. появилась возможность задать в настройках плагина обязательные для регистрации покупателя поля анкеты. Заполнение указанных полей будет запрещено пропускать кассиру в процессе выдачи на кассе новой карты лояльности. 

Пример работы

Исходные условия

В настройках плагина заданы:

  • в качестве обязательных полей анкеты: фамилия, имя;
  • в качестве необязательных полей анкеты: отчество, дата рождения, email.

Сценарий 1. Отмена регистрации покупателя

1. Кассир вызывает функцию выдачи карты.


2. Кассир вводит номер телефона, продиктованный покупателем.


3. Касса выводит окно для заполнения фамилии покупателя (обязательное поле при регистрации). Кассир нажимает ОТМЕНИТЬ.


5. Касса выводит сообщение "Процесс выдачи/замены карты отменен".

Сценарий 2. Успешная регистрация покупателя

1. Кассир вызывает функцию выдачи карты.


2. Кассир вводит номер телефона, продиктованный покупателем.

3. Касса выводит окно для заполнения фамилии покупателя (обязательное поле при регистрации).

4. Кассир вводит фамилию покупателя и нажимает ПОДТВЕРДИТЬ.

5. Касса выводит окно для заполнения имени покупателя (обязательное поле при регистрации).

6. Кассир вводит имя покупателя и нажимает ПОДТВЕРДИТЬ.

7. Касса выводит окно для заполнения отчества покупателя (необязательное поле при регистрации).

8. Кассир нажимает ОТМЕНИТЬ.

9. Касса выводит окно для заполнения даты рождения покупателя (необязательное поле при регистрации).

10. Кассир нажимает ОТМЕНИТЬ.

11. Касса выводит окно для заполнения email покупателя (необязательное поле при регистрации).

12. Кассир нажимает ОТМЕНИТЬ.

13. Касса выводит окно для ввода кода подтверждения из СМС-сообщения.

14. Кассир вводит код, продиктованный покупателем, и нажимает ПОДТВЕРДИТЬ.

15. Касса выводит запрос "Выдать виртуальную или физическую карту лояльности?"

16. Кассир наживает кнопку ВИРТУАЛЬНАЯ.

17. Касса выводит сообщение "Новая карта успешно выдана и применена в чеке". 

18. Кассир нажимает ПОДТВЕРДИТЬ. Карта добавлена в чек.

Применение позиционного купона на кассе

SR-7215 - Получение подробных данных проблемы… СТАТУС

CR-11351 - Получение подробных данных проблемы… СТАТУС

10.4.5.0

Функциональность доступна для клавиатурных касс, SetTouch и SCO.

Описание

Начиная с версии 10.4.5.0 реализована возможность применять на кассе позиционные купоны внешней системы лояльности Mindbox.

Пример работы

Основной сценарий

Исходные условия

  • Во внешней системе Mindbox заведен позиционный купон со скидкой 50%.
  • В настройках плагина в SetCentrum на вкладке ПЛАГИН КАРТ МАЙНДБОКС указаны соответствующие префиксы купонов.

Сценарий работы на кассе

1. Кассир добавляет товар в чек.

2. Кассир открывает окно редактирования товара → нажимает на иконку → сканирует штрихкод купона или вводит номер вручную и нажимает ПРИМЕНИТЬ.

3. Напротив соответствующего товара и в подвале чека появляется индикация применения позиционного купона.

4. Кассир переходит к расчёту. На товар применилась скидка по купону 50%.

Сообщение кассы "Нет свободного товара для применения купона"

К одному товару нельзя применить несколько купонов. При сканировании сначала одного, а затем другого купона, касса выведет ошибку "Нет свободного товара для применения купона".

При этом скидка по первому из отсканированных купонов предоставлена будет.

Печать купонов на чеке

SR-7469 - Получение подробных данных проблемы… СТАТУС

CR-11240 - Получение подробных данных проблемы… СТАТУС

10.4.7.0

Описание

Начиная с версии 10.4.7.0 реализована возможность печати купонов, передаваемых из Mindbox, на чеке (в составе чека или в отдельном слипе).

Номер купона может быть представлен в виде:

  • QR-кода;
  • штрихкода в формате CODE39.

Пример

Исходные настройки в SetCentrum:

  • В настройках шаблона кассы (в разделе Кассовый модуль → Шаблоны касс → [Шаблон кассы] → ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → Работа с чеком) установлены флажки:

    • Использовать анкетные данные покупателя для отправки электронной копии чека; 

    • Не печатать бумажный чек, если чек отправлен в электронной форме.

  • В настройках плагина Mindbox на вкладке ОБЩИЕ:

    • в поле Тег для печати купонов задано значение VyvodReklamynacheck;

    • установлен флаг Печать купона отдельным слипом;

    • установлен флаг Печать купона в любом случае.

Сценарий работы:

  1. Кассир добавляет в чек товары и карту покупателя по номеру телефона.
  2. Кассир рассчитывает покупателя.
  3. Касса распечатает купон вне зависимости от наличия отказа от печати чека.


confluence.macros.advanced.include.unable-to-render Включенная страница не может быть найдена.

Авторизация покупателя на кассе по QR-коду из мобильного приложения

SR-7963 - Получение подробных данных проблемы… СТАТУС

CR-13168 - Получение подробных данных проблемы… СТАТУС

10.4.12.0

Описание

Начиная с версии 10.4.12.0 реализована возможность авторизации покупателя на кассе по QR-коду с "зашитым" кодом верификации. При успешной авторизации данным способом, касса не потребует подтверждения по СМС при списании бонусов. Такая логика работы позволяет ритейлеру сократить расходы на услуги связи.

Пример работы

Исходное условие

В настройках плагина на вкладке ПЛАГИН КАРТ МАЙНДБОКС заполнено поле Разделитель кода верификации (регулярное выражение).

Сценарий 1. Списание бонусов без подтверждения по СМС, если карта добавлена по QR-коду с валидным кодом верификации

  1. Кассир сканирует QR-код из мобильного приложения покупателя.

    1. плагин отправляет запрос Offline.GetCustomerInfo с номером карты и получает успешный ответ;

    2. плагин отправляет запрос Offline.CheckMobilePhoneAuthorizationCode и получает успешный ответ.

  2. Карта покупателя добавляется в чек.

  3. Кассир добавляет в чек товары.

  4. Кассир переходит к расчету.

    1. касса рассчитывает скидки Set10;

    2. плагин успешно выполняет запрос Offline.AuthorizedPreorder.

  5. Касса отображает информацию о доступных к списанию бонусов.

  6. Кассир нажимает “Списать” и в форме ввода указывает количество списываемых бонусов без валидации по СМС.

  7. Касса отображает примененные к товарам скидки.

  8. Кассир рассчитывает покупателя. В данных чека присутствует признак авторизации покупателя посредством QR-кода.

Сценарий 2. Списание бонусов с подтверждением по СМС, если карта добавлена по QR-коду с невалидным кодом верификации

  1. Кассир сканирует QR-код из мобильного приложения покупателя.

    1. плагин отправляет запрос Offline.GetCustomerInfo с номером карты и получает успешный ответ;

    2. плагин отправляет запрос Offline.CheckMobilePhoneAuthorizationCode и получает неуспешный ответ.

  2. Касса выводит кассиру сообщение о том, что QR-код недействителен.

  3. Кассир нажимает кнопку “Отменить”.

  4. Карта покупателя добавляется в чек (так как сам номер карты считан успешно, но без подтверждения по коду верификации).

  5. Кассир добавляет в чек товары.

  6. Кассир переходит к расчету:

    1. касса рассчитывает скидки Set10;

    2. плагин успешно выполняет запрос Offline.AuthorizedPreorder.

  7. Касса отображает информацию о доступных к списанию бонусов.

  8. Кассир нажимает “Списать” и в форме ввода указывает количество списываемых бонусов.

  9. Касса запрашивает валидацию списания бонусов посредством СМС.

  10. Кассир вводит продиктованный код, и касса успешно сверяет введенный код из СМС.

  11. Касса отображает примененные к товарам скидки.

  12. Кассир рассчитывает покупателя. В данных чека присутствует признак авторизации покупателя посредством QR-кода.

Сценарий 3. Списание бонусов без подтверждением по СМС, если карта добавлена по QR-коду с повторной успешной проверкой кода верификации

  1. Кассир сканирует QR-код из мобильного приложения покупателя.

    1. плагин отправляет запрос Offline.GetCustomerInfo с номером карты и получает успешный ответ;

    2. плагин отправляет запрос Offline.CheckMobilePhoneAuthorizationCode и получает неуспешный ответ.

  2. Касса выводит кассиру сообщение о том, что QR-код недействителен.

  3. Кассир нажимает кнопку “Повторить”.

  4. Касса открывает окно для повторного сканирования кода.

  5. Кассир сканирует обновленный QR-код с приложения покупателя:

    1. плагин отправляет запрос Offline.CheckMobilePhoneAuthorizationCode и получает успешный ответ.

  6. Карта покупателя добавляется в чек.

  7. Кассир добавляет в чек товары.

  8. Кассир переходит к расчету:

    1. касса рассчитывает скидки Set10;

    2. плагин успешно выполняет запрос Offline.AuthorizedPreorder.

  9. Касса отображает информацию о доступных к списанию бонусов.

  10. Кассир нажимает “Списать” и в форме ввода указывает количество списываемых бонусов без валидации по СМС.

  11. Касса отображает примененные к товарам скидки.

  12. Кассир рассчитывает покупателя. В данных чека присутствует признак авторизации покупателя посредством QR-кода.

Дополнительная информация

Логирование и диагностика

Лог-файл операций

Логирование всех операций с процессингом (начисления, списания) Mindbox производится в файле:

/home/tc/storage/crystal-cash/logs/plugins.log

Список сообщений и ситуаций

Успешный расчет скидки из Mindbox в лог-файле

Если скидка успешно рассчиталась и есть применение бонусов, после нажатия на РАСЧЕТ, или при списании бонусов. Тогда в лог-файле ниже будет следующий ответ с содержанием рекламной акции.

Response from Mindbox processing, status=200

Сообщение на кассе "Access denied"

Если появилось такое сообщение, то это обозначает, что неправильно указаны параметры доступа к процессингу. Проверьте в подключениях к процессингу Интеграции → Внешние процессинги → Лояльность Майндбокс корректность данных в полях: Endpoint процессинга и Секретный ключ.

Сообщение в лог-файле:

Сообщение на кассе "Нет связи с процессингом"

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

Сообщение в лог-файле:

Проверка доступности процессинга Mindbox с кассы

Для проверки доступности ответов от процессинга наберите команду ниже. Должен вернуться ответ с кодом 405

https://api.mindbox.ru/v3/operations/sync?endpointId=

Если вернулся любой другой ответ, значит процессинг не отвечает.

Изменения интеграции заказов с процессингом лояльности

SR-7561 - Получение подробных данных проблемы… СТАТУС

CR-11734 - Получение подробных данных проблемы… СТАТУС

10.4.8.0

Начиная с версии 10.4.8.0 была изменена логика создания и редактирования заказов в связи с переходом Mindbox на новую схему интеграции. Подробнее

Ранее для создания заказа необходимо было сделать два последовательных вызова: начало создания заказа (begin) в момент старта проведения заказа и коммит создания заказа (commit) в момент успешного проведения заказа. Теперь, чтобы создать заказ, требуется один вызов операции с шагом создать или обновить заказ (createorder) и идентификатором заказа. Этот шаг сразу же спишет баллы, счетчик лимитов в акции, применит промокоды и начислит бонусы за заказ (если статус заказа соответствует условиям в акции).

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

Передача в Mindbox примененных в чеке типов оплаты 

SR-7759 - Получение подробных данных проблемы… СТАТУС

CR-12793 - Получение подробных данных проблемы… СТАТУС

10.4.10.0

Начиная с версии 10.4.10.0 реализована передача примененных в чеке типов оплат для последующего начисления кешбэка во внешнем процессинге. Таким образом, при настройке промоакций в Mindbox появляется выбирать типы оплат для дополнительных бонусных начислений покупателям, чтобы мотивировать их к использованию конкретных видов оплаты.

В зависимости от сохраненных в свойствах чека типов оплат при вызове метода createOrder в секции payments передаются следующие типы оплаты:

Сохраненный в свойствах чека тип оплаты

Передаваемый параметр во внешний процессингОписание 
CashPaymentEntityCashPaymentEntityОплата наличными
BankCardPaymentEntityBankCardPaymentEntityОплата банковской картой любым терминалом
BankQRPaymentEntityBankQRPaymentEntityОплата по QR-коду любого банка кроме Сбербанка 
readcity.gift.card.payment.pluginReadcityGiftCardPaymentОплата подарочной картой "Читай-Город"
split.payment.pluginSplitPaymentОплата Яндекс Сплит
yandex.pay.payment.pluginYandexPayPaymentОплата Яндекс Пэй
BankBiometricsPaymentEntityBankBiometricsPaymentEntityОплата по биометрии (отдельно настроенный тип оплаты)

BankCardPaymentEntity

(плагинные свойства:

<plugin-property key="sberbank.payment.type" value="Q"/>

<plugin-property key="sberbank.payment.type" value="B"/>)

BankCardPaymentEntityQRОплата терминалом Сбербанка по QR-коду

BankCardPaymentEntity

(плагинное свойство:

<plugin-property key="sberbank.payment.type" value="P"/>)

BankCardPaymentEntityBIOОплата терминалом Сбербанка по биометрии

Пример запроса в Mindbox:

{
	"pointOfContact" : "973",
	"order" : {
		"totalPrice" : 227.0,
		"lines" : [ {
			"minPricePerItem" : "0.00",
			"basePricePerItem" : "227.04",
			"quantity" : "1.000",
			"lineId" : "Сок апельсиновый ароматный (Израиль)_7201737000001_1",
			"lineNumber" : "1",
		"product" : {
			"ids" : {
				"website" : "01737"
			}
		},
		"status" : {
			"ids" : {
				"externalId" : "Sr10Paid"
			}
		},
			"customFields" : { }
		} ],
		"ids" : {
			"offlineTransactionId" : "20250130_110528_973_2_8_3_1738224340902"
		},
		"payments" : [ {
			"type" : "BankCardPaymentEntity",
			"amount" : "227.00"
		} ]
	},
 	"customer" : {
		"ids" : {
			"mindboxId" : "45865257"
		},
			"customFields" : { }
	}
}

Пример работы на кассе

  1. Кассир добавляет в чек товары и применяет карту покупателя.

  2. Кассир переходит к расчету и выбирает оплату банковской картой.

  3. Касса рассчитывает скидки и показывает сумму к оплате.

  4. Покупатель оплачивает покупку банковской картой (любой терминал):

    1. плагин получает из чека примененный тип оплаты, отправляет запрос в процессинг с передачей соответствующего типа оплаты BankCardPaymentEntity и указанием суммы оплаты данным способом и получает успешный ответ.

  5. Касса печатает чек и слип с указанием бонусов к начислению, полученных от процессинга.

Оптимизация процесса верификации клиентов через СМС

Описание

SR-8216 - Получение подробных данных проблемы… СТАТУС

CR-13856 - Получение подробных данных проблемы… СТАТУС

10.4.17.0

Начиная с версии 10.4.17.0 оптимизирован процесс верификации списания бонусов и аутентификации владельцев карт лояльности посредством отправки СМС с кодом подтверждения. Риск отправки избыточных сообщений снижается благодаря ограничениям, устанавливаемым в настройках плагина:

  • Длина ПИН-кода верификации

    • Возможность задать длину проверочного кода (минимум – 4 символа).

    • Защита от ввода кода некорректной длины (например, 2-3 символа или пустое поле). 

  • Количество sms-запросов для одного номера телефона

    • Ограничение на число СМС, которые можно отправить на один номер в рамках одного чека.

    • При достижении лимита отправка новых кодов недоступна.

  • Количество попыток сверки ПИН-кода

    • Задает допустимое количество попыток ввода неправильного кода из одной СМС.

    • В качестве попыток учитываются только валидные (соответствующие заданной длине) коды.

  • Таймаут отправки sms при выдаче/замене карты с ПИН-кодом верификации (сек)

    • Ограничение по времени между повторными отправками СМС.

    • Условия сброса тайм-аута:
      - если СМС была отправлена в открытом чеке (в чек были добавлены товары), то тайм-аут обнуляется после закрытия чека;
      - если в чек не были добавлены товары, то тайм-аут обнуляется автоматически по истечению времени, заданного в настройках.

Бизнес-ценность: сокращение денежных затрат на СМС за счет уменьшения количества отправляемых сообщений.

Поддерживаемые типы касс: клавиатурные, SetTouch и SetSCOv3.

Пример работы

Исходные условия

  1. В SetCentrum в настройках плагина на вкладке ПЛАГИН КАРТ МАЙНДБОКС установлены параметры:

    • Длина ПИН-кода верификации = 4

    • Количество sms-запросов для одного номера телефона = 2

    • Количество попыток сверки ПИН-кода = 2

    • Таймаут отправки sms при выдаче/замене карты с ПИН-кодом верификации (сек) = 60

  2. Покупателю приходит SMS с кодом подтверждения 1234

Сценарий 1. Ввод неверного проверочного кода при списании бонусов

  1. Кассир добавляет товары в чек.

  2. Кассир производит добавление карты любым доступным способом (вручную, по штрихкоду, прокатыванием магнитной полосы).

  3. Кассир переходит к расчету.

  4. Кассир нажимает Списание бонусов.

  5. В форме ввода количества к списанию отображена максимально доступная сумма списания бонусов для данного чека.

  6. Кассир подтверждает списание бонусов.

  7. Касса отображает форму для ввода кода Код подтверждения отправлен на номер +7 *** *** 12 34. Введите код подтверждения.

  8. Кассир вводит невалидный код: 123.

  9. Касса проверяет введенный код в соответствии с настройкой длины.

    1. Проверка не пройдена.

  10. Касса открывает окно с сообщением Неверный код. Проверьте и введите код из СМС заново (количество попыток сверки ПИН-кода остается прежним, так как ввод невалидного по формату кода система не учитывает как попытку).

  11. Кассир выбирает Ввести заново.

  12. Касса повторно отображает форму для ввода кода Код подтверждения отправлен на номер +7 *** *** 12 34. Введите код подтверждения.

  13. Кассир вводит валидный, но неверный код: 1235.

  14. Касса проверяет введенный код в соответствии с настройкой длины:

    1. введен валидный код.

    2. плагин отправляет в mindbox JSON-запрос Offline.CheckMobilePhoneAuthorizationCode, в котором передается:

      1. номер телефона временно сохраненного в данных чека /customer/mobilePhone

      2. введенный кассиром код подтверждения /authentificationCode

    3. в ответ плагин получает:

      1. успешный статус запроса /status = Success

      2. статус неуспешной валидации введенного кода подтверждения customer/processingStatus = FoundValidationError

  15. На экране кассы отображается сообщение Неверный код. Проверьте и введите код из СМС заново. Осталась 1 попытка.

  16. Кассир нажимает кнопку Ввести заново.

  17. Касса повторно отображает Код подтверждения отправлен на номер +7 *** *** 12 34. Введите код подтверждения (новое СМС-сообщение не отправляется).

  18. Кассир вводит код 1236.

  19. Касса проверяет введенный код в соответствии с настройкой длины:

    1. введен валидный код;

    2. плагин отправляет в mindbox JSON-запрос Offline.CheckMobilePhoneAuthorizationCode, в котором передается:

      1. номер телефона временно сохраненного в данных чека /customer/mobilePhone

      2. введенный кассиром код подтверждения /authentificationCode

    3. в ответ плагин получает:

      1. успешный статус запроса /status = Success

      2. статус неуспешной валидации введенного кода подтверждения customer/processingStatus = FoundValidationError

  20. Касса показывает сообщение Неверный код. Отправить новый код по СМС или отменить подтверждение? 

  21. Кассир выбирает кнопку Отправить СМС.

  22. Повторяются шаги 7-21 (то есть кассир производит две неверные попытки ввода кода и запрашивает отправку еще одного СМС-сообщения).

  23. Касса отображает сообщение: Вы исчерпали лимит отправки СМС для этого чека.

  24. Кассир нажимает Закрыть.

  25. Касса переходит обратно в чек без возможности списать бонусы в этом чеке.

Сценарий 2. Регистрация нового покупателя (таймаут не истек)

  1. Покупатель изъявляет желание получить карту лояльности.

  2. Кассир выбирает в меню функцию Выдача/замена карты.

  3. Кассир вводит номер телефона клиента.

  4. Плагин отправляет запрос в Mindbox для проверки существования клиента в системе.

  5. Клиент не найден.

  6. В Mindbox создается профиль клиента.

  7. Плагин отправляет запрос в Mindbox Offline.SendMobilePhoneAuthorizationCode для отправки кода подтверждения и получает в ответ успешный статус запроса /status = Succes.

  8. Касса отображает поле ввода кода.

  9. Кассир вводит валидный, но неверный код: 1235.

  10. Касса проверяет введенный код в соответствии с настройкой длины:

    1. введен валидный код;

    2. плагин отправляет в mindbox JSON-запрос Offline.ConfirmMobilePhone, в котором передается:

      1. номер телефона временно сохраненного в данных чека /customer/mobilePhone

      2. введенный кассиром код подтверждения /authentificationCode

    3. в ответ плагин получает:

      1. успешный статус запроса /status = Success

      2. статус неуспешной валидации введенного кода подтверждения "smsConfirmation": {
        "processingStatus": "IncorrectConfirmationCode"}

  11. Касса показывает сообщение Неверный код. Отправить новый код по СМС или отменить подтверждение?

  12. Кассир выбирает Отправить СМС.

  13. На экране кассы отображается сообщение: Новый код по СМС можно запросить через {1 минуту}.

  14. Кассир нажимает Закрыть.

  15. Кассир выбирает в меню Выдача/замена карты по номеру телефона:

    1. минута не прошла.

  16. Кассир вводит номер телефона клиента.

  17. На экране кассы отображается сообщение: Новый код по СМС можно запросить через {1 минуту}.

  18. Кассир нажимает Закрыть.

  19. Кассир выбирает в меню Выдача/замена карты по номеру телефона:

    1. минута прошла.

  20. Кассир вводит номер телефона клиента.

  21. Плагин отправляет запрос в Mindbox для проверки существования клиента в системе.

  22. Клиент не найден.

  23. В Mindbox создается профиль клиента.

  24. Плагин отправляет запрос в Mindbox для отправки кода подтверждения:

    1. плагин отправляет в mindbox JSON-запрос Offline.SendMobilePhoneAuthorizationCode, в котором передается:

      1. номер телефона временно сохраненного в данных чека /customer/mobilePhone

    2. в ответ плагин получает:

      1. успешный статус запроса /status = Success

  25. Касса отображает поле ввода кода.

  26. Кассир вводит код 1234, присланный в СМС на сохраненный номер телефона.

  27. Касса проверяет введенный код в соответствии с настройкой длины:

    1. введен валидный код;

    2. плагин отправляет в mindbox JSON-запрос Offline.ConfirmMobilePhone, в котором передается:

      1. номер телефона, временно сохраненного в данных чека /customer/mobilePhone

      2. введенный кассиром код подтверждения /authentificationCode

    3. в ответ плагин получает:

      1. успешный статус запроса /status = Success

      2. статус успешности валидации введенного кода подтверждения "processingStatus": "MobilePhoneConfirmed"

  28. Касса запрашивает тип выдаваемой карты.

  29. Кассир выбирает Физическая.

  30. Касса запрашивает ввод номера карты для выдачи.

  31. Кассир сканирует карту для выдачи клиенту.

  32. Касса отправляет запрос в Mindbox для проверки номера карты на возможность выдачи клиенту.

  33. Mindbox привязывает карту к клиенту и возвращает на кассу успешный ответ.

  34. Касса применяет карту лояльности в чек.

  35. Кассир добавляет товары и переходит к расчету.

  36. На кассе применяются доступные по карте преференции.

  37. Кассир закрывает чек любым доступным способом.


© 1994-2025, ООО «Кристалл Сервис Интеграция».
Все права защищены.

Политика обработки персональных данных