Частые вопросы

Почему проверка соединения не видит новые реквизиты?

Кнопка «Проверить» обращается к API с сохранёнными настройками. После изменения «Аккаунт RetailCRM» или «API ключ» нажмите «Сохранить», затем повторите проверку. Проверьте также «Код сайта» и права ключа.

Почему изменения CRM не приходят в магазин?

Включите «Включить синхронизацию». Для обратной загрузки нужны отдельные команды retailcrmPluginSyncCustomers и retailcrmPluginSyncOrders либо кнопка «Синхронизировать историю» на соответствующей вкладке. «Обновить статус» лишь обновляет сведения о курсоре. Входящие триггеры CRM в этой конфигурации не подключены.

Почему новый менеджерский заказ CRM не создаётся в Shop-Script?

Включите «Импортировать заказы, созданные в CRM» на вкладке «Заказы», разрешите способ оформления в «Справочники → Способы оформления заказов» и запустите получение истории. Товары заказа должны находиться в Shop-Script по идентификаторам офферов. Если ни один товар не найден, заказ не удаётся импортировать.

Почему импорт не меняет статус заказа?

Проверьте «Справочники → Статусы заказов». Если текущий статус магазина не сопоставлен, плагин оставляет его без изменения и пишет предупреждение. Нужны корректные соответствия статусов обеих систем.

Почему покупатель не экспортируется или не сопоставляется?

По умолчанию исключены сотрудники и контакты без email, телефона или OAuth. Проверьте «Экспортировать любых клиентов» и «Экспортировать сотрудников и системных пользователей в CRM». Сопоставление по телефону/email может быть неоднозначным; используйте отчёты CLI. «Создавать контакты при сопоставлении» влияет на CLI-сопоставление, а не на верификацию.

Почему пропадает строка товара или меняется количество в CRM?

Проверьте одинаковые офферы, разрешение отдельных строк в CRM и настройки «В RetailCRM разрешены одинаковые позиции», «Объединять одинаковые товары в одну позицию», «xmlId в позициях заказа». Объединение помогает только одинаковым ценам. Дубли xmlId каталога нужно разбирать отдельно. Товар CRM, которого нет в магазине, также может исчезнуть при обновлении состава из Shop-Script.

Можно ли просто сменить «Формат ID товара»?

На действующей интеграции нужно остановить обмен, сменить формат и повторно загрузить ICML. До завершения обработки каталога CRM не возобновляйте обмен. После этого проверьте существующие заказы: обновление может пересоздать товарные строки и затронуть скидки.

Почему ICML недоступен или в нём нет нужного товара?

Включите «Включить ICML», сгенерируйте профиль и используйте URL из «ICML-файл». Проверьте выбор товаров, минимальную цену, фильтры скрытых товаров/категорий и параметр retailcrm.ignored. Для обновления по времени нужен запрос URL или cron. Неизвестный хеш возвращает 404, выключенная выдача — 403.

Почему чекбокс подписки не показывается?

Нужны checkout 2.0, включённые «Включить синхронизацию» и «Выводить чекбокс «Подписаться» в оформлении заказа», непустое сопоставление «Подписки RetailCRM» и выбранный в «Место вывода» шаг. Покупателю с активными подписками CRM чекбокс не показывается. Проверьте вывод соответствующего хука темой.

Почему нет брошенных корзин или они перестали отправляться?

Гостевые корзины не собираются. Проверьте вкладку «Корзины», включение функции и общей синхронизации, загрузку каталога в CRM, задержку и запуск retailcrmPluginSendAbandonedCarts. Посмотрите «Последний отказ»: после трёх неудачных попыток запись возвращается в обработку только при изменении состава корзины покупателем.

Почему бонусный баланс обновляется не сразу или списание меньше ожидаемого?

Проверьте счёт и программу лояльности CRM, «ID программы лояльности», «TTL аккаунтов (сек)» и «TTL программы (сек)». Баланс может читаться из кеша. «Макс. процент списания» ограничивает списание с учётом уже применённых скидок; окончательный расчёт также ограничен правилами CRM. «Процент начисления» задаёт только приблизительную оценку для гостей.

Почему нет кнопки синхронизации остатков или поля распределения бонусов?

В текущем шаблоне эти блоки скрыты, хотя параметры есть в конфигурации. Для каталога используйте ICML. Не ищите скрытые настройки как обязательные шаги подключения: описание маркета и доступная форма в этих местах отличаются.