Лояльность

Глоссарий

Операция - это сервис, который по API вызывает Mindbox и обрабатывает данные в необходимом формате. Операции находятся на каждом проекте в разделе “Кампании-Операции”.
Шаг операции - это определённый этап метода обработки данных. Из шагов операции складывается целая операция. Настроить шаги операции можно, перейдя в описание конкретной операции и нажав “Редактировать” или создав новую. Пример - набор шагов расчёта скидок перед продажей.
Контракт операции - это код в формате JSON или XML, который поэтапно собирает все необходимые данные для их дальнейшей обработки. Каждая единица информации кладётся в свой параметр. При выполнении операции появляется ответ со своим контрактом, состоящим из результата обработки данных. Каждая единица информации в ответе операции также кладётся в свой параметр.
Операция может быть произведена успешно (со статусом Success), а может выдать ошибку по разным причинам. Подробно про стандартные ошибки сервиса можно прочитать тут.
Авторизованный покупатель - покупатель, прошедший процесс авторизации, то есть подтвердивший одним из способов - например, через диктовку кода из смс - что он и есть тот самый клиент, зарегистрированный в нашей базе.
Неавторизованный покупатель - покупатель, не предоставивший подтверждение в процессе авторизации. Например покупатель, назвавший на кассе номер телефона, но не подтвердивший его через смс.
Анонимный покупатель - покупатель, не прошедший процесс авторизации по какой-либо причине.
Как изменить состав уже сохранённого заказа - для изменения состава уже созданного заказа необходимо снова передать Создать или обновить заказ с идентификатором заказа, который вы хотите изменить. При этом важно не забыть обновить стоимость заказа - для этого нужно вызвать операцию пречека с обновлённым составом и возвращённую стоимость подставить в бегин.
Синхронный вызов операции - это вызов, выдающий ответ на запрос к сервису моментально, без дополнительной обработки. Например, это операции, позволяющие выводить информацию по клиенту в его личный кабинет.
Асинхронный вызов операции - это вызов, отвечающий на запрос к сервису с определённым временным лагом, требующий дополнительной обработки. Такие вызовы создают меньшую нагрузку на систему, чем синхронные, и снижают вероятность перегруза.
Арбитраж промоакций - это иерархическая система между промоакциями в Mindbox, устанавливающая, в какой последовательности акции должны применяться к заказам, какие из них могут работать вместе, а какие исключают друг друга. Дерево арбитража можно посмотреть на любом проекте в разделе “Кампании - Промоакции”.
Публичная акция - акция, которая действует для всех клиентов магазина, независимо от их принадлежности к той или иной группе.
Персональная акция - это акция, распространяющаяся только на клиентов, обладающих определённым рядом характеристик.
Демо-режим - это пробный режим программы лояльности, бесплатный для клиента. Поддерживает до 3000 вызовов API-методов расчета и создания заказа в сутки.

Процессинг на кассе

В Mindbox действует принцип распределённой транзакции. Это означает, что создание заказа происходит не в 1 этап, а в несколько: это позволяет снять определённые системные риски.

Этапы создания заказа:

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

Precheck - расчет скидок перед продажей

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

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

Create - создать или обновить заказ

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

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

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

Возврат товаров

Возврат заказа можно осуществить двумя способами:

Через админку Mindbox - просто нажать на многоточие у действия сохранения заказа и выбрать "Отменить заказ";
Через смену статуса позиций - вызвать операцию, которая поменяет статус позиций заказа, подходит как для возврата заказа целиком, так и для возврата его отдельных позиций.

В случае возврата товара нужно вызвать сервис изменения статуса позиции заказа. Операция принимает идентификатор заказа, идентификатор позиции заказа, идентификатор продукта для определения товара, который нужно вернуть. Также необходимо указать количество возвращаемых товаров и статус, в который они переходят - например, "Returned". Если сервис просит указать идентификатор линии, в которой находился возвращаемый товар, лучше указывать lineNumber, а не lineId.

Сервис должен вызываться асинхронно и не влиять на работу кассового ПО.

Отложенная передача чека

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

Данные покупателя на кассе

Продавец на кассе сможет:

авторизовать покупателя через код подтверждения по смс
найти покупателя по ФИО или любому идентификатору (емэйлу, телефону, номеру карты и тд)
просмотреть личные данные покупателя
получить рекомендации к заказу
подсказать доступные акции для покупателя
просмотреть список товаров покупателя на сайте или в мобильном приложении (корзина, избранное, интересующие товары)

Работа с лояльностью покупателя

Менеджер в магазине:

Загрузка исторических данных

Нужно загрузить

При переносе существующей программы лояльности нужно:

Last modified on May 8, 2026