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

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

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

Коннектор МойСклад — 1 400 ₽ в месяц

Через магазин приложений МойСклад оплачивается только коннектор: обмен данными, виджеты и работа с кассой. Для программы лояльности нужно отдельно подключить ядро ДАБонус с базовым лимитом 1 000 активных клиентов.

Ядро, расширение лимита клиентов и дополнительные модули оплачиваются в разделе «Биллинг» панели ДАБонус. Полную стоимость выбранной конфигурации можно рассчитать в калькуляторе на сайте. Лицензия самого МойСклад приобретается отдельно.

Для новых компаний ядро доступно бесплатно 14 дней. После этого нужна его отдельная оплата: подписка на коннектор не активирует ядро и не продлевает его пробный период.

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

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

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

Открыть решение в МойСклад →
1

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

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

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

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

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

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

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

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

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

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

Сохранение бонусов заказа до отгрузки

Для новых проведённых заказов МойСклад

В «Настройки → Основные → Начисление бонусов» включите «Сохранять начисление из заказа до отгрузки». При обработке нового проведённого заказа ДАБонус сохранит начисление по действующим правилам и уровню клиента. Баланс пополнится при отгрузке.

Правило закончилось до доставки
Клиент оформил заказ на 10 000 ₽ при начислении 5%. Даже если правило закончится до отгрузки, по сохранённому расчёту ему положены 500 бонусов. При отгрузке частями начисляется доля по отгруженным товарам и количеству.
  • Увеличение цены, количества или добавление товаров после фиксации не увеличивает сохранённое начисление.
  • Отмена отгрузки освобождает её долю; повторная обработка не дублирует начисление.
  • Срок активации и сгорания отсчитывается от отгрузки. Старые заказы задним числом не фиксируются.
  • Дополнительные бонусные акции сохраняют отдельный расчёт на момент отгрузки. Отключение настройки прекращает фиксацию новых заказов.
2

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

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

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

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

Бонусный баланс — числовое поле
Уровень лояльности — текстовое поле

На отгрузке

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

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

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

Добавьте в шаблон печатной формы (xls) каждую формулу в отдельную ячейку, а подпись — в соседнюю. Для заказа покупателя ДАБонус создаёт дробные числовые поля:
${formatter.findAttribute(o, "Бонусный баланс").doubleValue}
${formatter.findAttribute(o, "Списано бонусов").doubleValue}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Причина: Превышен выбранный объём клиентской базы
Решение: Увеличьте объём ядра в биллинге ДАБонус

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

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

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

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

Написать в поддержку в Telegram