Полная двусторонняя интеграция с RetailCRM
Плагин обеспечивает полноценную синхронизацию данных между Shop-Script и RetailCRM: клиенты, заказы, остатки, бонусы, подписки и брошенные корзины. Все операции работают в обе стороны — изменения из CRM автоматически попадают в магазин и наоборот. Поддерживается импорт заказов, созданных менеджерами в RetailCRM (по телефону, мессенджерам).
Синхронизация клиентов
Плагин синхронизирует данные покупателей между Shop-Script и RetailCRM. Поддерживается гибкий маппинг полей через JSON настройки, включая кастомные поля.
Автоматическая синхронизация Shop-Script → CRM:
- При регистрации нового покупателя
- При изменении данных в личном кабинете
- При редактировании контакта в админке
- При оформлении заказа
Синхронизация CRM → Shop-Script: История изменений клиентов загружается автоматически по CRON или вручную из интерфейса плагина.
Кнопки в карточке контакта:
- Обновить в CRM — отправить актуальные данные из Shop в CRM
- Загрузить из CRM — перезаписать данные Shop данными из CRM
- Объединить — двусторонний merge: недостающие данные добавляются с обеих сторон
- Создать в CRM — создать нового клиента в CRM
Массовые операции с покупателями (в настройках плагина):
- Экспорт в CRM — массовая отправка контактов в CRM с проверкой дубликатов
- Верифицировать связи — проверка и автоматическое исправление ошибочных привязок CRM ↔ Shop
- Сопоставить — автоматическая привязка CRM-клиентов к контактам Shop по телефону или email
- Слияние данных — двусторонний merge всех связанных покупателей
- Перезаписать из CRM — полная замена данных в Shop из CRM
Связь клиентов хранится через externalId в RetailCRM и кастомное поле retailcrm_id в контакте Shop-Script. externalId является источником правды для связи. При конфликтах привязки плагин автоматически разрешает их.
Синхронизация заказов
Заказы автоматически отправляются в RetailCRM при создании и изменении. Изменения из CRM (статусы, адрес доставки, комментарии, товары) синхронизируются обратно в Shop-Script. Поддерживается импорт заказов, созданных менеджерами в CRM.
Возможности:
- Автоматическая отправка новых заказов в CRM
- Синхронизация статусов в обе стороны
- Импорт изменённых товаров, адреса доставки и комментариев
- Импорт заказов, созданных менеджерами в RetailCRM (по телефону, мессенджерам)
- Передача данных пунктов выдачи (ID, адрес, комментарий) для доставок до ПВЗ
- Настраиваемый маппинг статусов и справочников
- Округление цен в CRM (applyRound)
- Префикс для номеров заказов (для мультисайтовых конфигураций)
- Фильтры: только определённые статусы, заказы не ранее даты/ID
Логи синхронизации заказов: в карточке каждого заказа доступна история всех операций синхронизации с полными данными запросов и ответов API. Удобно для отладки и проверки. Срок хранения логов настраивается.
Кнопки в карточке заказа:
- Обновить в CRM — отправить актуальные данные заказа в CRM
- Загрузить из CRM — обновить данные заказа из CRM
Справочники
Для корректной синхронизации заказов необходимо сопоставить справочники Shop-Script и RetailCRM. Плагин предоставляет удобный интерфейс для маппинга всех сущностей.
Доступные справочники:
- Статусы заказов
- Способы оплаты
- Статусы оплаты (оплачен / не оплачен)
- Способы доставки
- Склады отгрузки
- Типы заказов
- Способы оформления заказов (фильтр для импорта из CRM)
- Поля адреса доставки
- Дополнительные поля заказа (custom fields)
Синхронизация остатков
Плагин передаёт остатки товаров по складам в RetailCRM. Поддерживается автоматическая отправка при сохранении товара и массовая синхронизация по CRON.
- Маппинг складов Shop-Script ↔ RetailCRM
- Передача склада отгрузки
shipmentStore в заказы на основе stock_id товаров
- Настраиваемое значение для неограниченных остатков (RetailCRM не поддерживает
null)
- Массовая синхронизация всех товаров через CLI
Бонусная программа
Интеграция с программой лояльности RetailCRM. Покупатели могут видеть свой баланс бонусов и оплачивать ими часть заказа прямо в корзине.
Настройки в админке:
- Автоматическое добавление покупателя в программу лояльности при регистрации или заказе
- Настраиваемый максимальный процент списания
- Распределение скидки по товарам или на весь заказ
- Расчёт начисляемых бонусов за заказ
В корзине:
- Отображение баланса доступных бонусов
- Оплата части заказа бонусами с автоматическим пересчётом
- Приглашение в программу лояльности для незарегистрированных участников
В личном кабинете:
- Страница «Мои бонусы» с балансом и историей операций
- Самостоятельная регистрация в программе лояльности
- Информация об уровне и условиях программы
Подписки в личном кабинете
Покупатели могут управлять своими подписками на рассылки прямо из личного кабинета магазина. Изменения автоматически синхронизируются с RetailCRM.
- Страница управления подписками в ЛК
- Синхронизация подписок при регистрации
- Настраиваемый маппинг подписок Shop-Script → RetailCRM
Брошенные корзины
Плагин собирает информацию о брошенных корзинах и отправляет её в RetailCRM для запуска триггерных рассылок.
Настройки в админке:
- Автоматический сбор данных о корзинах авторизованных покупателей
- Настраиваемая задержка перед отправкой
- Автоматическая очистка устаревших записей
- Отправка по CRON
В корзине:
- Автоматическое отслеживание товаров в корзине
- Отправка данных при добавлении/изменении товаров
- Очистка при оформлении заказа
ICML каталог товаров
Выгрузка каталога товаров в формате ICML для импорта в RetailCRM. Профиль экспорта настраивается в разделе «Магазин → Импорт/Экспорт».
- Полноценный профиль экспорта с фильтрами и настройками
- Маппинг полей: штрихкод, маркировка, НДС, артикул производителя
- Несколько форматов ID товара (product+sku, только product, только sku)
- Настраиваемое количество изображений товара
- Фильтры: нулевые остатки, скрытые товары и категории, минимальная цена
- Поддержка закупочной цены (purchasePrice)
- Генерация по CRON или вручную
Типы цен в ICML: поддерживается передача нескольких типов цен для одного товара через тег <price type="код">:
- Акционные цены «Гибкие скидки» — если у товара действует автоматическая скидка через плагин «Гибкие скидки», в ICML добавляется отдельный тип цены с указанным кодом (создаётся в Справочниках RetailCRM → Типы цен)
- Зачёркнутая цена — выгружается как
<price type="oldprice"> для отображения старой цены в CRM
Интерфейс администратора
В настройках плагина доступен полноценный интерфейс для управления синхронизацией и просмотра статистики.
- Проверка соединения с RetailCRM API
- Запуск массовой синхронизации клиентов и заказов
- Просмотр и сброс курсоров истории
- Настройка маппинга статусов заказов
- Очистка отправленных брошенных корзин
- Просмотр статистики синхронизации
CLI команды для CRON
Плагин предоставляет CLI команды для автоматической синхронизации по расписанию. Примеры команд доступны в настройках плагина.
- Синхронизация истории клиентов из CRM
- Синхронизация истории заказов из CRM
- Отправка брошенных корзин
- Генерация ICML каталога
Подмена шаблонов в теме дизайна
Шаблоны страниц личного кабинета можно переопределить в вашей теме дизайна для полной кастомизации внешнего вида.
Доступные шаблоны для переопределения:
retailcrm_plugin.frontend_affiliate.html — страница бонусов
retailcrm_plugin.frontend_subscriptions.html — страница подписок
retailcrm_plugin.include.frontend.my.nav.html — ссылки в меню ЛК
Логирование и отладка
Трёхуровневая система логирования для диагностики проблем:
- Только ошибки — минимум логов, только критичные проблемы
- Обычный — информационные сообщения о синхронизации
- Отладка — полные логи включая API запросы и ответы
Мы в социальных сетях
Узнавайте первыми о наших новых решениях и акциях.