Интеграция с МойСклад

Как MSBonus работает внутри МойСклад: виджеты, синхронизация, касса

Как работает интеграция?

MSBonus встроен прямо в МойСклад

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

Виджеты в МойСклад

MSBonus добавляет виджеты прямо в интерфейс МойСклад

Виджет в карточке контрагента

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

Виджет в отгрузке

Баланс покупателя, количество начисляемых бонусов за текущую покупку и возможность списать бонусы.

Панель управления (iframe)

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

Дополнительные поля

MSBonus автоматически создаёт доп. поля в МойСклад

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

На контрагенте

Бонусный баланс — числовое поле

Уровень лояльности — текстовое поле

На отгрузке

Бонусный баланс — на момент отгрузки

Начислено бонусов — за эту отгрузку

Списанные бонусы отражаются как скидка в позициях.

Формулы для печатной формы

Добавьте в шаблон печатной формы (xls) формулы:

${formatter.findAttribute(o, "Бонусный баланс").value != 0 ? "Бонусный баланс: " + formatter.findAttribute(o, "Бонусный баланс").value : ""}

${formatter.findAttribute(o, "Начислено бонусов").value != 0 ? "Начислено бонусов: " + formatter.findAttribute(o, "Начислено бонусов").value : ""}

Поля скрываются автоматически если значение равно 0.

Задержка обновления

Данные о бонусах записываются через несколько секунд после сохранения отгрузки. Обновите страницу перед печатью.

Синхронизация данных

Данные синхронизируются автоматически через вебхуки

Автоматическая синхронизация

После установки MSBonus регистрирует вебхуки в вашем аккаунте МойСклад. Любые изменения контрагентов и отгрузок обрабатываются автоматически.

Ручная синхронизация

Синхронизировать контрагентов

Загрузить всех клиентов из МойСклад

Синхронизировать отгрузки

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

Когда нужна ручная синхронизация

При первоначальной настройке для загрузки исторических данных. В штатном режиме всё синхронизируется автоматически.

Работа с кассой (POS)

MSBonus поддерживает Loyalty API для кассы МойСклад

Если вы используете модуль «Касса МойСклад» или POS-терминал, MSBonus поддерживает стандартный Loyalty API для начисления и списания бонусов прямо на кассе.

Поиск покупателя

Баланс бонусов

Расчёт начисления

Списание бонусов

Начисление бонусов

Обработка возвратов

Автоматическая интеграция

Loyalty API подключается автоматически при установке. Дополнительная настройка не требуется — касса МойСклад сама обнаружит MSBonus.

Устранение проблем

Решение распространённых ошибок

Клиенты не синхронизируются

Причина: У контрагентов не указаны телефоны

Решение: Заполните телефоны/email. Проверьте фильтр в настройках

Бонусы не начисляются

Причина: Нет правил начисления или условия не подходят

Решение: Проверьте правила, условия и что отгрузка проведена

Достигнут лимит клиентов

Причина: Превышен лимит тарифа

Решение: Перейдите на тариф выше в маркетплейсе МойСклад

Виджет не отображается

Причина: Приложение приостановлено/деактивировано

Решение: Проверьте статус подписки в маркетплейсе

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

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

Написать в Telegram