Список работ

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

• Официальный сайт - https://mindbox.ru/.
• Документация API - https://developers.mindbox.ru/.
• Документация по системе Mindbox - https://help.mindbox.ru/docs.

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

• Команда разработки А.
• Все ошибки создаются стандартно в 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

6. Кликните .

Шаблон кассы

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

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

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

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

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

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

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

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

5. Кликните .

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

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

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

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

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

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

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

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

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

Чек

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

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

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

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

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

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

10.2.96.0

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

• Веб-сервис экспорта чеков (на стороне SetRetail10) глава Подробная информация по картам, примененным в чеке <card>.
• Экспорт чеков из SetRetail10 в ERP (веб-сервис на стороне SetRetail10) глава Подробная информация по картам, примененным в чеке <card>

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

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

<?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 в бонусном слипе не печатается информация о заблокированных бонусных баллах.

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

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

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

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

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

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

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

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

Начиная с версии 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-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

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

Описание

Начиная с версии 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. Касса распечатает купон вне зависимости от наличия отказа от печати чека.

Авторизация покупателя на кассе по 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 передаются следующие типы оплаты:

Пример запроса в 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",
			"creditCard" : {
				"hash" : "null"
			}
		} ]
	},
 	"customer" : {
		"ids" : {
			"mindboxId" : "45865257"
		},
			"customFields" : { }
	}
}

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

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

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

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

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

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

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