Настройка

Общие настройки

Обновлено 25 октября 2026

Где находятся настройки

Откройте «Магазин → Плагины → RetailCRM - Полная интеграция». Доступны вкладки «Общие», «Покупатели», «Заказы», «Справочники», «Товары», «Бонусы», «Корзины», «Cron». После изменения значений нажмите «Сохранить».

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

Вкладка «Общие»

Настройка	Что делает	Значения / по умолчанию
Аккаунт RetailCRM	Имя аккаунта, из которого формируется адрес API `https://<аккаунт>.retailcrm.ru/api/v5`	Без протокола и домена; пусто
API ключ	Авторизация запросов к RetailCRM	Ключ из RetailCRM; пусто
Код сайта	Сайт RetailCRM, к которому относится обмен	Код из CRM; пусто. При пустом значении код формируется из имени аккаунта
Включить синхронизацию	Разрешает основные операции обмена	Выключено
Уровень логов	Детализация файловых журналов	«Только ошибки», «Обычный», «Отладка»; по умолчанию «Обычный»
Хранить логи заказов	Срок хранения записей синхронизации из карточки заказа	7, 14, 30, 60, 90 дней или «Хранить вечно»; 30 дней

«Проверить» проверяет подключение и возвращает доступные коды сайтов. Успешная проверка соединения ещё не подтверждает корректность всех соответствий и прав на каждую операцию API.

Общие настройки подключения RetailCRM На вкладке «Общие» видны поля подключения, проверка соединения, включение синхронизации и настройки логирования.

Какие данные передаются

Набор данных зависит от включённых функций и сопоставлений:

Функция	Данные / направление
Покупатели	Идентификаторы связи, имя, фамилия, отчество, email, телефоны, дата рождения, пол и сопоставленные пользовательские поля; магазин ↔ CRM
Заказы	Покупатель, номер, позиции, цены, скидки, доставка, адрес, оплаты, статусы, комментарии и сопоставленные параметры; магазин ↔ CRM
ICML	Каталог, категории, ссылки, изображения, цены, остатки и выбранные поля; магазин → CRM
Подписки	Состояния подписок, заданных соответствиями; магазин ↔ CRM в предусмотренных сценариях
Брошенные корзины	Покупатель и товарные позиции корзины; магазин → CRM
Лояльность	Запросы баланса и расчёта бонусов, участие в программе и операции списания

В «Пользовательские поля RetailCRM» можно выбрать cookie как источник значения: передаётся значение указанной cookie при наличии контекста запроса, а не вся cookie-сессия.

Доступ API

Используйте API ключ аккаунта RetailCRM с доступом к нужному сайту. В зависимости от функций потребуются чтение справочников, клиентов и их истории, заказов и их истории, создание и изменение клиентов, заказов и оплат; для дополнительных функций — каталог, подписки, корзины и программа лояльности.

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

Диагностика для разработчика

Основные файловые журналы относительно wa-log/:

shop/plugins/retailcrm/retailcrm_error.log
shop/plugins/retailcrm/retailcrm_info.log
shop/plugins/retailcrm/retailcrm_debug.log

Уровень «Отладка» включает подробности API-запросов и ответов. Срок «Хранить логи заказов» относится к журналу заказа, а не ко всем этим файлам.

Параметры конфигурации без доступного поля в форме

Перечисленные ниже параметры не доступны в текущей форме настроек плагина; искать соответствующие переключатели в бэкенде не нужно.

Подпись в конфигурации	Что делает	Значение по умолчанию / доступность
API токен Shop-Script	Описан как токен для входящих триггеров	Пусто; блок триггеров закомментирован, рабочий маршрут входящего триггера не подключён
Отключить API запросы	Блокировка API для отладки (`disable_api_requests`)	Выключено; поля в форме нет
Включить синхронизацию остатков	Разрешение отправки остатков через API	Выключено; раздел «Синхронизация остатков» скрыт
Синхронизировать при сохранении	Отправка остатков при сохранении товара	Выключено; поле формы «При сохранении товара» скрыто
Распределять по товарам	Распределение бонусной скидки по позициям	Выключено; поле «Распределять скидку по товарам» скрыто
Автокоррекция распределения	Уменьшение бонусов при невозможности точного распределения	Выключено; поле «Автокоррекция бонусов» скрыто

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