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

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

Настроек подключения недостаточно. В настройках нужной формы на вкладке «RetailCRM» включите «Передавать заявки этой формы в RetailCRM» и выберите способ отправки. По умолчанию передача формы и отправка при поступлении выключены, статусы не выбраны.

Почему нет вкладки «RetailCRM» или кнопки отправки?

Вкладка настроек формы добавляется только администратору приложения «Заявки». Блок в карточке новой, ещё не передававшейся заявки появляется при включённой передаче формы. Если адрес или ключ не заданы либо не проходят проверку формата, вместо кнопки блок покажет «Адрес RetailCRM или ключ API не задан в настройках плагина». Если отправка уже завершена, вместо кнопки показывается результат.

Проверка пишет «RetailCRM отвечает», но заказ не создаётся. Что проверить?

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

Почему список магазинов или менеджеров пустой?

Проверьте сохранённые адрес и ключ. Магазины фильтруются по активности и доступу ключа; менеджеры — по активности. Для чтения нужны reference_read и user_read соответственно. Справочники кешируются на пять минут. Если доступного магазина нет, отправка завершится сообщением «У ключа API нет доступных магазинов RetailCRM».

Можно ли отправлять только после проверки менеджером или только вручную?

Да. Выключите «Отправлять сразу при поступлении» и отметьте нужные статусы заявки. Для ручного режима выключите также все статусы, оставив передачу формы включённой. Ручная кнопка доступна и при автоматическом режиме до успешной отправки.

CRM была недоступна. Заявка потерялась? Как повторить?

Ошибка передачи не удаляет заявку. В её карточке отображаются «Не отправлено: …» и «Повторить». Проверьте причину, восстановите доступ к CRM и нажмите кнопку. При ограничении частоты запросов CRM или медленном ответе повторите позже. Для разработчика есть журнал requests/plugins/retailcrm.log.

Если карточка осталась в состоянии «Отправляется в RetailCRM…», повтор станет доступен после истечения 120 секунд с последнего обновления передачи; заново откройте карточку. Периодического автоматического повтора по cron нет.

Повтор или смена статуса создаст ещё один заказ?

Успешная отправка блокирует последующие передачи той же заявки. При повторе после ошибки плагин сначала ищет заказ предыдущей попытки по externalId и магазину. Если он найден, новый заказ не создаётся. Изменения уже переданной заявки в CRM автоматически не обновляются.

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

Сначала используется существующая связь контакта Вебасиста с клиентом CRM. Без связи плагин ищет по телефону и email. При нескольких совпадениях предпочитается общий клиент по обоим признакам, затем наименьший ID. Если телефон и email принадлежат разным клиентам без общего совпадения, клиент не прикрепляется, а карточка показывает предупреждение. Проверьте клиента заказа и дубли в RetailCRM: данные существующих клиентов плагин не исправляет.

Почему телефон или email попали только в комментарий?

Проверьте «Роль поля» в редакторе формы. Текстовые поля нужно обозначить как «Телефон» и «Email»; для типов phone и email роль определяется автоматически. По названию обычного текстового поля плагин не определяет его назначение. Отсутствующие имя, телефон и email он пытается взять из связанного контакта Вебасиста.

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

В «Поле с суммой» выберите заполненное поле с неотрицательной числовой суммой. Значение вроде 12 500,50 ₽ поддерживается; пустое, отрицательное или нечисловое не создаёт позицию. Сумма передаётся одной позицией с названием формы.

Товары корзины передаются только текстом при включённом «Передавать товары корзины в комментарии» и наличии данных от плагина «Заказы из заявок». Позиции заказа из корзины эта настройка не создаёт.

Файлы загружаются в CRM? Где искать UTM?

В комментарий к заказу передаются имена и публичные ссылки на файлы. Загрузка самих вложений в CRM не выполняется. UTM передаются в источник заказа, если в заявке заполнены поля с названиями utm_source, utm_medium, utm_campaign, utm_term, utm_content. Подробная таблица — в статье о данных.

Можно ли подключить другой аккаунт RetailCRM?

Адрес и ключ общие для всех форм. При замене аккаунта сохранённые связи контактов автоматически не сбрасываются, а числовые ID клиентов разных аккаунтов могут совпасть. Перед переключением обратитесь к разработчику для проверки старых связей и незавершённых передач. Отдельной пользовательской кнопки сброса в плагине нет.