Часто задаваемые вопросы

• Установленный модуль на сайте интернет-магазина.

• Доступ администратора к сайту и порталу Битрикс24.

• Поле сделки для связи с ID заказа. Рекомендуется создать отдельное числовое поле, а не использовать ORIGIN_ID.

Подробный порядок описан в разделе «Первоначальная настройка модуля».

Вставьте ссылку из настроек модуля, которая называется «Ссылка для приложения». Она формируется после заполнения адреса интернет-магазина и адреса портала.

Локальное приложение создаётся на портале Битрикс24 в разделе Приложения / Разработчикам / Другое. Тип приложения — серверное, «Использует только API» — да.

Для базовой работы нужны права: CRM, Пользователи, Встраивание приложений, Интранет и Каталог. Если права неполные, часть настроек может не открываться, а модуль может выдавать ошибки доступа к CRM или каталогу.

Также модуль должен быть авторизован под пользователем Битрикс24, имеющим права администратора портала.

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

Рекомендуется создать отдельное числовое пользовательское поле сделки для хранения ID заказа и выбрать его в настройках модуля. Использовать ORIGIN_ID нежелательно: это техническое поле может использоваться другими интеграциями, из-за чего возможны конфликты.

Если нужного поля нет в списке, проверьте его тип. Для связи с ID заказа подходят только числовые поля.

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

Минимально нужен один профиль. Если сценариев несколько, например разные сайты, типы плательщиков или разные воронки CRM, создайте отдельные профили.

Фильтр ограничивает, какие заказы будет обрабатывать профиль. Если фильтр пустой, профиль подходит всем заказам. Если условий несколько, заказ должен соответствовать всем условиям.

Например, отдельный профиль можно сделать только для юрлиц, конкретного сайта, типа плательщика или свойства заказа. Важно помнить, что фильтр проверяет данные заказа, а не данные связанной сделки.

На вкладке «Контактные данные» выберите режим обновления существующего контакта: не обновлять, обновить один раз при создании сделки или обновлять при каждом обмене между заказом и сделкой.

Отдельно в «Общих настройках синхронизации» задаётся, как обновлять телефон и e-mail найденного контакта: заменять или дополнять данные.

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

Подробная инструкция находится в разделе «Создание заказов из сделок».

В «Общих настройках синхронизации» выберите режим «Привязывать к сделке существующие в каталоге товары (с вариациями)» и настройте поиск товаров. Каталог магазина и каталог CRM должны быть синхронизированы между собой.

После этого изменение товара, количества или цены в сделке будет передаваться в заказ. Подробнее — в разделе «Работа с составом заказа через сделку».

Если не нужна привязка к каталогу CRM, оставьте режим «Не выгружать товары в каталог». Если товары уже есть в CRM, используйте режим привязки к существующим товарам. Если модуль должен создавать товары по заказам, выберите режим создания товаров. Для совмещения поиска и создания используйте смешанный режим.

Для работы с составом заказа через вкладку «Товары» сделки нужен режим с вариациями.

Нет, модуль работает с товарами в рамках заказов и сделок. В режиме создания товаров он создаёт в каталоге CRM товары из заказов, которые проходят через обмен, но не выполняет полную выгрузку всего каталога магазина.

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

Доставку можно передавать в поля сделки через вкладку «Остальные данные» или выводить отдельной строкой в товарных позициях сделки. За это отвечает блок «Состав заказа» в «Общих настройках синхронизации».

Если доставка должна быть привязана к товару каталога CRM, настройте режим «Доставка как товар» и соответствующий товар в CRM.

Сначала настройте сбор аналитики на сайте в Битрикс24. Затем в профиле модуля передайте ID заказа в отдельное поле сделки и укажите это поле в настройках «Заказы своего магазина» в сквозной аналитике Битрикс24.

Также нужно добавить JavaScript-код Битрикс24 на страницу успешного оформления заказа, чтобы аналитика привязывалась к нужной сделке. Подробнее — в разделе «Настройка сквозной аналитики для заказов».

Проверьте адрес интернет-магазина, адрес портала, путь обработчика в локальном приложении и набор прав приложения. Код и ключ лучше скопировать из локального приложения заново, без лишних пробелов.

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

Обычно дополнительные разделы становятся доступны только после успешного подключения к порталу. Сначала заполните адреса, создайте локальное приложение, сохраните код и ключ, затем перейдите по ссылке подключения к порталу.

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

В профиле каждая вкладка сохраняется отдельно. Если изменить настройки на одной вкладке, перейти на другую и сохранить только её, изменения первой вкладки могут потеряться.

После изменения любой вкладки нажимайте «Сохранить» именно на этой вкладке.

Убедитесь, что синхронизация активна в общих настройках, настроен хотя бы один профиль, заказ подходит под фильтр профиля, а статусы заказов и стадии сделок сопоставлены. Проверьте ошибки в разделе «Диагностика».

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

Проверьте режим синхронизации: для передачи изменений из сделки в заказ нужна двусторонняя синхронизация. Также посмотрите стрелки направления обмена на вкладках «Свойства заказа» и «Остальные данные» в профиле.

Если речь о создании заказов из сделок, отдельно настройте вкладку «Создание заказа» в нужном профиле.

Проверьте вкладку «Статусы и стадии» в профиле. Все стадии, в которых менеджеры могут оставлять сделку, должны быть сопоставлены со статусами заказа.

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

Проверьте вкладку «Контактные данные» в профиле. В настройке «Поле для поиска контакта в момент создания сделки» должно быть указано поле, по которому модуль действительно может найти контакт: телефон, e-mail или другое заполненное поле.

Если выбран поиск по e-mail, а в заказе e-mail пустой или отличается от CRM, контакт найден не будет. Для стабильного поиска заполните таблицы сопоставления контактных данных для каждого типа плательщика.

Также проблема может быть в том, что в таблице сопоставления полей контакта данные берутся не из заказа, а из аккаунта, под которым оформлялся заказ. Данные этого аккаунта могут оказаться неполными.

Сделка должна подходить под фильтр вкладки «Создание заказа» и находиться в направлении CRM, выбранном для профиля. Уже привязанные к заказам сделки модуль игнорирует, чтобы не создавать дубли.

Если сделки создаёт робот или внешняя интеграция, проверьте, заполняются ли в них поля, по которым настроен фильтр создания заказа.

Состав сделки переносится в заказ только в режиме «Привязывать к сделке существующие в каталоге товары (с вариациями)». При этом каталог интернет-магазина и каталог CRM должны быть полностью синхронизированы, а товары должны находиться по настроенным параметрам поиска.

В других режимах заказ создаётся без товаров. Товары можно добавить через вкладку «Правка заказа» или «Добавить товары».

Чаще всего причина в настройках безопасности сайта или сервера. Эту настройку должен выполнять специалист по серверу. Подробности приведены в разделе «Настройка вкладок “Правка заказа” и “Добавить товары”».