Публичное пространство
SetRetail10 ◾️ Mindbox
Список работ
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. На вкладке ОБЩИЕ установите следующие настройки:
5. Перейдите на вкладку ПЛАГИН КАРТ МАЙНДБОКС и установите настройки карт:
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-пакет согласно интеграционной документации по экспорту чеков. Экспорт производится с помощью веб-сервисов и файлов.
- Веб-сервис экспорта чеков (на стороне 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="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. Далее кассир производит стандартные операции по фискализации чека.
Выдача карты лояльности на кассе
В версии 10.3.11.0 реализован процесс выдачи или замены карты на кассе с подтверждением номера телефона.
- SR-5446Получение подробных данных проблемы… СТАТУС
- CR-7056Получение подробных данных проблемы… СТАТУС
10.3.11.0
1. Кассир добавляет товары в чек.
2. Кассир выбирает пункт меню Выдача/замена карты.
3. Кассир запрашивает номер телефона покупателя и вводит его.
4. Процессинг отправляет код подтверждения на телефон покупателя.
5. Кассир вводит код из СМС-сообщения.
6. Касса запрашивает выбор типа карты.
7. При выборе виртуальной карты после нажатия на кнопку ВВОД происходит отправка запроса в процессинг, карта регистрируется в процессинге. После успешного ответа от процессинга карта добавляется в чек, отображается значок карты.
При выборе физической карты касса запрашивает номер карты. Кассир сканирует карту или прокатывает ее через карт-ридер или вводит номер карты вручную.