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

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

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

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

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

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

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

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

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

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

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

Виджет в заказе покупателя

Списание бонусов прямо в заказе покупателя. Скидка автоматически переносится в отгрузку при её создании.

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

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

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

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

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

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

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

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

На отгрузке

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

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

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

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

Добавьте в шаблон печатной формы (xls) каждую формулу в отдельную ячейку, а подпись — в соседнюю. Для заказа покупателя МСБонус создаёт дробные числовые поля:

${formatter.findAttribute(o, "Бонусный баланс").doubleValue}

${formatter.findAttribute(o, "Списано бонусов").doubleValue}

Для отгрузки МСБонус создаёт целые числовые поля:

${formatter.findAttribute(o, "Бонусный баланс").longValue}

${formatter.findAttribute(o, "Начислено бонусов").longValue}

Для значений задайте числовой формат: в заказе — 2 знака после запятой. В объединённой области формулу вводите в верхнюю левую ячейку. Если доп. поля заполнены, а печать пуста, проверьте каждую формулу отдельно в новой ячейке с обычным числовым форматом; контрольную подпись разместите рядом.

Формулы предназначены для печати из карточки соответствующего документа. Если поле создано ранее, проверьте его тип: «Число дробное» — doubleValue, «Число целое» — longValue. Название поля должно совпадать точно. Загрузите изменённый шаблон в МойСклад и выберите его при печати.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Написать в Telegram