Вернуться к документации

Настройки приложения

Вкладки раздела «Настройки» в панели управления МСБонус

Где находится

Откройте панель управления МСБонус (из меню приложений МойСклад или по адресу panel.msbonus.ru) и перейдите в раздел «Настройки». Внутри 7 вкладок: Профиль, МойСклад, API, Интеграции, Общие, Импорт, Опасная зона.
1

Профиль

Информация о компании, логотип и контакты

Часть данных подтягивается из аккаунта МойСклад при установке. Остальное заполняется вручную и используется в Mini App клиента, шаблонах сообщений и сертификатов.

Название и логотип

Видны клиенту на бонусной карте, в Mini App и в подвале сертификатов.

Контакты

Телефон, email, сайт — отображаются в разделе «О компании» в Mini App.

2

МойСклад

Подключение, синхронизация и фильтры

Аккаунт МойСклад подключается автоматически при установке из маркетплейса. На вкладке настроек МойСклад видна техническая информация и параметры синхронизации.

Синхронизация контрагентов и каталога

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

Группы контрагентов

Можно ограничить программу лояльности конкретными группами в МойСклад — остальные клиенты бонусы получать не будут.

Подробнее — в разделе Интеграция с МойСклад.

3

API

API-ключ тенанта для своих интеграций

На вкладке отображается текущий API-ключ, есть кнопка скопировать его и кнопка сгенерировать новый. После регенерации старый ключ перестаёт работать — все интеграции, которые им пользовались, нужно обновить.

Хранение ключа

Ключ показывается один раз при создании. Скопируйте его сразу и храните в защищённом месте — например, в переменной окружения серверного приложения. В панель ключ позже можно только обновить, не посмотреть.

Полный справочник методов и примеры — в разделе REST API для разработчиков.

4

Интеграции

Сторонние сервисы, которые подключаются к МСБонус

На вкладке «Интеграции» собраны переключатели и настройки внешних сервисов. Каждая интеграция — отдельный блок: ключи, домены, ссылки на инструкции.

Сайт на Tilda

Включается виджет, выдаётся токен и инструкция по вставке. Подробнее — Сайт на Tilda.

Сайт на WordPress

Скачивается плагин и токен. Подробнее — Сайт на WordPress.

Битрикс24 beta

Виджет в карточке контакта и сделки, авто-начисление по стадии. Подробнее — Битрикс24.

5

Общие

Базовые параметры программы лояльности

Тип программы и валюта

Переключатель режима работы: бонусы или дисконт (автоматическая скидка по уровню). Здесь же — название бонусов («бонусы», «баллы», свой термин), валюта программы и часовой пояс для расписаний и отчётов. Подробнее — Скидки вместо бонусов.

Начисление

Приветственные бонусы

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

Задержка активации

Бонусы появятся на балансе спустя N дней — защита от возвратов.

Что считается продажей

Можно отключить начисление через кассу или через отгрузки, либо включить начисление по заказам покупателя.

Если между заказом и отгрузкой проходит много времени, включите «Сохранять начисление из заказа до отгрузки». Для новых проведённых заказов фиксируются бонусы по правилам начисления и уровню лояльности. Они будут начислены при отгрузке, даже после окончания или изменения правила.

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

Выбор позиций и ручное начисление

Чекбоксы в виджете отгрузки и кнопка ручного начисления в карточке клиента.

Округления

Округление начисленного бонуса до целого и округление цены при скидке (до рубля или десятки рублей).

Товары без начисления бонусов

В блоке «Начисление бонусов» нажмите «Настроить» в строке «Товары без начисления»: найдите товары по названию или артикулу, добавьте их списком либо выберите группы товаров и нажмите «Применить». Подгруппы тоже исключаются; исключение товара распространяется на его модификации, а отдельную модификацию можно выбрать самостоятельно.

Общий список действует для правил начисления и всех уровней лояльности. Сумма исключённых позиций не участвует в расчёте бонусов и проверке порогов правил, но полная сумма покупки учитывается для перехода на следующий уровень. Например, при покупке на 2 000 ₽, исключённых товарах на 500 ₽ и уровне 5% начислится 75 бонусов. Списание бонусов и скидки эта настройка не меняет.

Изменения действуют при новых расчётах. Начисление, ранее сохранённое из заказа до отгрузки, сохраняет свои условия. Если интеграция передаёт только сумму покупки без состава товаров, при включённых исключениях расчёт вернёт 0 бонусов: для начисления необходимы позиции покупки.

Срок жизни бонусов

Единый срок (например, 365 дней), бессрочные бонусы и сгорание частями (через 90 дней — половина, через 180 — остальное). Срок можно переопределять в правилах начисления и в уровнях лояльности. Уведомление о скором сгорании отправляется клиенту за заданное число дней до даты.

Списание

Подтверждение кодом

Перед списанием клиент получает 4-значный код через бот, SMS или email. Можно отправлять во все включённые каналы сразу.

Списание за текущий заказ

Разрешает использовать только что начисленные бонусы на эту же покупку.

Не начислять при списании

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

Игнорировать минимальную цену

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

6

Импорт

Перенос балансов с другой системы лояльности

Если у вас уже есть бонусная программа в другой системе, перенесите балансы клиентов в МСБонус, чтобы никто не потерял накопленное.

Импорт встроенных баллов из МойСклад

Штатная бонусная программа МойСклад должна быть включена на момент импорта. Когда она отключена, МойСклад скрывает поля бонусного баланса, поэтому МСБонус не может их прочитать. Если баллы записаны в дополнительное поле контрагента, укажите его название в настройках импорта — в этом случае включать штатную программу не требуется.
  1. Откройте «Настройки» → «Импорт».
  2. Перед прямым импортом из МойСклад синхронизируйте контрагентов с МСБонус. Для импорта из файла подготовьте Excel или CSV с телефоном или точным именем клиента и балансом бонусов.
  3. Выберите файл либо нажмите «Импорт из МойСклад». При хранении баланса в дополнительном поле укажите его точное название.
  4. Проверьте предпросмотр и запустите импорт — балансы будут начислены найденным клиентам.
7

Опасная зона

Действия, которые необратимо изменяют данные

Сброс настроек

Возвращает параметры к значениям по умолчанию. Клиенты, транзакции и история сохраняются.

Обнуление балансов

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

Полная очистка данных

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

Перед опасной операцией

Скачайте текущие балансы клиентов в Excel или CSV из раздела «Клиенты» — это страховка на случай, если результат окажется не таким, как ожидалось.

Что находится в других разделах

Нужна помощь?

Если у вас возникли вопросы по этой теме, свяжитесь с нашей поддержкой

Написать в Telegram