Модуль RetailCRM для 1С-Битрикс связывает интернет-магазин и CRM в единый контур обмена. От того, насколько аккуратно заполнены соответствия сайтов, магазинов, статусов и способов оплаты, зависит, будут заказы и каталог передаваться чисто или с ошибками. Разбираем установку и первичную настройку по шагам.
Что делает модуль и зачем он нужен
Официальный модуль intaro.retailcrm ставится из Маркетплейса 1С-Битрикс и отвечает за двусторонний обмен между сайтом на Битрикс и аккаунтом RetailCRM. Он решает три задачи: выгружает каталог товаров в формате ICML, передаёт новые заказы с сайта в CRM и синхронизирует изменения статусов, оплат и составов заказов в обе стороны.
Важно понимать разграничение ролей. Витрина, корзина и оформление заказа остаются на стороне Битрикс, а обработка заказа, звонки, задачи менеджерам и аналитика переезжают в RetailCRM. Модуль — это транспорт между двумя системами, а не замена ни одной из них.
Установка модуля из Маркетплейса
Установка выполняется штатным способом через Marketplace → Установленные решения или загрузкой архива. Последовательность такая:
- В административной части откройте
Магазин → RetailCRM— этого пункта нет до установки, поэтому сначала поставьте решение «RetailCRM» из каталога Маркетплейса. - Согласитесь с лицензией и дождитесь копирования файлов в
/bitrix/modules/intaro.retailcrm/. - После установки в меню админки появится раздел настроек модуля.
Требования к площадке: PHP не ниже поддерживаемой модулем версии, установленный и настроенный модуль «Интернет-магазин» (sale) и «Торговый каталог» (catalog). Без них передавать нечего — модуль опирается именно на них.
sale доступна только выгрузка каталога, но не синхронизация заказов.API-ключ и адрес аккаунта
Связь устанавливается по API. В RetailCRM откройте Настройки → Интеграция → Ключи доступа к API и создайте ключ с типом доступа, разрешающим работу с заказами, клиентами и справочниками. Скопируйте сам ключ и адрес аккаунта вида https://ваш-аккаунт.retailcrm.ru.
В настройках модуля на стороне Битрикс введите эти два значения в поля адреса и ключа, сохраните и дождитесь проверки соединения. Если ключ верный, модуль подтянет справочники CRM (статусы, типы оплаты, доставки, магазины) — они понадобятся для маппинга на следующем шаге.
| Параметр | Где взять | Назначение |
|---|---|---|
| URL аккаунта | Адрес кабинета RetailCRM | Куда слать запросы API |
| API-ключ | Настройки → Ключи доступа к API | Авторизация обмена |
| Права ключа | Чекбоксы методов при создании ключа | Разрешённые операции |
Соответствие сайтов, магазинов и справочников
Основная и самая ответственная часть настройки — маппинг сущностей. Модуль должен понимать, какой сайт Битрикс соответствует какому магазину в RetailCRM и как переводить справочники. Настраивается по блокам:
- Сайты и магазины. Каждый сайт Битрикс (при многосайтовости их несколько) привязывается к отдельному магазину/коду сайта в CRM.
- Типы оплаты. Платёжные системы Битрикс сопоставляются с типами оплаты RetailCRM (наличные, карта, безнал, онлайн-касса).
- Службы доставки. Способы доставки сайта — со службами доставки CRM.
- Статусы заказов. Статусы Битрикс сопоставляются со статусами и группами статусов RetailCRM в обе стороны.
- Свойства заказа. Поля покупателя (ФИО, телефон, email, адрес, комментарий) привязываются к соответствующим полям заказа и клиента CRM.
Режим обмена и запуск по расписанию
Модуль поддерживает передачу заказов «на лету» через обработчики событий и периодический обмен по расписанию. Разовые операции (новый заказ) отправляются событием сразу, а массовая синхронизация изменений идёт агентом или cron.
Рекомендуемая схема — вынести обмен на cron, а не на агентов на хитах, чтобы синхронизация не зависела от посещаемости сайта. Пример строки crontab:
*/5 * * * * php -f /home/site/public_html/bitrix/modules/intaro.retailcrm/cron/history.php
В настройках Битрикс при этом переключите режим агентов на cron (Настройки → Настройки продукта → Агенты на cron) и задайте адекватный интервал выгрузки истории. Слишком частый запуск создаёт лишнюю нагрузку, слишком редкий — задержку статусов.
| Режим | Когда подходит | Минус |
|---|---|---|
| Агент на хитах | Мало заказов, есть трафик | Зависит от посещаемости |
| Агент на cron | Большинство магазинов | Нужен доступ к cron |
Проверка обмена и логи
После настройки сделайте контрольный прогон. Оформите тестовый заказ на сайте и убедитесь, что он появился в RetailCRM с корректными позициями, суммой, оплатой и доставкой. Затем смените статус в CRM и проверьте, что он вернулся на сайт.
- Логи обмена модуль пишет в файлы вида
/bitrix/modules/intaro.retailcrm/и в служебный раздел — по ним видно ошибки API и отклонённые заказы. - Историю изменений заказов удобно смотреть на стороне CRM в карточке заказа: там виден источник каждой правки.
- Если заказ не ушёл, чаще всего причина — незамапленный статус, оплата или пустое обязательное поле.
Типичные ошибки настройки
Набор граблей на этом модуле повторяется от проекта к проекту:
- Неверные права ключа — обмен подключается, но часть методов возвращает 403; заказы уходят частично.
- Пустой маппинг статусов — заказы приходят, но статусы не синхронизируются обратно на сайт.
- Дубли заказов — при повторной первичной выгрузке без контроля уже переданных заказов.
- Расхождение свойств заказа — телефон или адрес не долетают, потому что свойство на сайте не сопоставлено с полем CRM.
- Обмен на агентах при низком трафике — статусы обновляются с большой задержкой.
Итог
Настройка модуля RetailCRM в Битрикс — это последовательность из четырёх опор: установка из Маркетплейса, подключение по API-ключу, аккуратный маппинг сайтов и справочников и запуск обмена по cron. Ошибки почти всегда лежат в маппинге и правах ключа, а не в самом модуле.
Мы в B2Bsite подключаем обмен Битрикс и RetailCRM под ключ: настраиваем ключи и права, сопоставляем статусы, оплаты и доставки, выносим обмен на cron и проверяем всю цепочку на тестовых заказах. Если нужен предсказуемый обмен без дублей и потерянных статусов — поможем с внедрением и настройкой.
Частые вопросы
Где скачать модуль RetailCRM для Битрикс?
Официальное решение intaro.retailcrm устанавливается из Маркетплейса 1С-Битрикс в разделе установленных решений. Отдельно качать архив не обязательно.
Нужен ли модуль «Интернет-магазин» для обмена?
Для синхронизации заказов — да, модуль опирается на sale и catalog. На редакциях без интернет-магазина доступна только выгрузка каталога.
Какие права дать API-ключу RetailCRM?
Достаточно доступа к заказам, клиентам, справочникам и складам. Полный доступ давать не стоит из соображений безопасности.
Обмен идёт на агентах или через cron?
Поддерживаются оба варианта, но для стабильности лучше вынести обмен на cron, чтобы синхронизация не зависела от посещаемости сайта.
Почему заказ ушёл в CRM без типа оплаты?
Скорее всего, платёжная система на сайте не сопоставлена с типом оплаты RetailCRM. Проверьте маппинг оплат в настройках модуля.
Можно ли подключить несколько сайтов к одному аккаунту?
Да, при многосайтовости каждый сайт Битрикс привязывается к своему магазину или коду сайта в RetailCRM в блоке соответствия.
Как проверить, что настройка корректна?
Оформите тестовый заказ, проверьте его в CRM, смените статус и убедитесь, что изменение вернулось на сайт. Прогоните всю цепочку до отмены.
Поможем с настройкой и поддержкой RetailCRM
Поможем с настройкой, доработкой и поддержкой RetailCRM.