1С-Битрикс здесь — внешняя CMS-витрина, а мозгом обработки заказов становится RetailCRM. Связка строится на официальном модуле intaro.retailcrm, который выгружает каталог в формате ICML и держит двустороннюю синхронизацию заказов и статусов.
Как устроена связка
В паре «сайт + CRM» роли распределяются жёстко: 1С-Битрикс отвечает за витрину и приём заказа, а RetailCRM — за обработку, коммуникации, доставку и аналитику. Обмен идёт через официальный модуль intaro.retailcrm из Маркетплейса 1С-Битрикс, который использует REST API RetailCRM.
- Каталог уходит из Битрикса в RetailCRM файлом ICML (товары, торговые предложения, остатки, цены).
- Заказы и клиенты передаются в RetailCRM при оформлении на сайте.
- Статусы, оплаты и данные заказа синхронизируются в обе стороны: менеджер меняет статус в CRM — он отражается на сайте, и наоборот.
sale). На «Стандарте» без интернет-магазина полноценного обмена заказами не будет.Что подготовить до старта
Перед установкой соберите доступы и наведите порядок в справочниках — это экономит половину времени внедрения.
- Создайте в RetailCRM отдельный API-ключ с правами на нужные методы (Настройки → Интеграция → Ключи доступа к API).
- Зафиксируйте URL аккаунта вида
https://ваш-магазин.retailcrm.ru. - Проверьте, что в Битриксе заполнены типы плательщиков, службы доставки и платёжные системы — их предстоит сопоставить.
- Убедитесь, что у товаров есть внешние коды (
XML_ID) — по ним идёт связка позиций.
Отдельно продумайте, какие типы заказов на сайте соответствуют каким в CRM: розница, опт, самовывоз.
Установка и первичная настройка модуля
Модуль ставится штатно через Marketplace → Установить решение, после чего появляется раздел настроек. Ключевые вкладки:
| Вкладка | Что задаётся |
|---|---|
| Соединение | URL аккаунта и API-ключ, проверка связи |
| Каталог | инфоблоки для выгрузки, цены, склады |
| Заказы | сопоставление типов заказа, оплат, доставок |
| Статусы | маппинг статусов сайта и групп статусов CRM |
После ввода ключа нажмите проверку соединения — модуль подтянет справочники из RetailCRM для сопоставления. Только после успешной проверки переходите к маппингу.
Выгрузка каталога в ICML
RetailCRM принимает товарную базу в собственном формате ICML (Intaro Catalog Markup Language) — это XML со структурой «категории — товары — торговые предложения». Модуль генерирует файл по расписанию и кладёт его в корень сайта, например /retailcrm/retailcrm.xml, а в RetailCRM указывается ссылка на него.
- Формирование файла запускается агентом Битрикса или cron; для крупных каталогов используйте cron, чтобы не грузить хиты.
- Товар в ICML — контейнер, а
offer— конкретное торговое предложение (размер, цвет) со своим артикулом и ценой. - Остатки по складам передаются в разрезе
store, если складов несколько.
XML_ID или с дублями артикулов. В ICML они склеятся или не подтянутся, и заказ в CRM придёт «без товара».Синхронизация заказов и клиентов
Когда покупатель оформляет заказ на сайте, модуль передаёт его в RetailCRM: создаётся заказ и карточка клиента, срабатывают триггеры и распределение по менеджерам. Обратно на сайт возвращаются изменения статуса, суммы, состава.
Обмен бывает двух видов:
- Событийный — заказ уходит в CRM сразу при создании/изменении на сайте.
- Периодический — история и «догон» изменений по расписанию через
/bitrix/tools/-скрипты обмена (cron).
Клиенты дедуплицируются в RetailCRM по телефону и email, поэтому корректная валидация контактов на сайте напрямую влияет на чистоту базы.
Соответствие статусов
Статусы — самое чувствительное место. На сайте их немного (например, «Принят», «Оплачен», «Доставлен»), а в RetailCRM статусов десятки, и они собраны в группы. Задача маппинга — чтобы движение по воронке в CRM корректно отражалось на сайте и наоборот.
| Статус сайта | Группа/статус RetailCRM |
|---|---|
| Принят | Новый → Согласование |
| Оплачен | Оплачен / Комплектование |
| Отправлен | Доставка → Передан в доставку |
| Выполнен | Выполнен |
| Отменён | Отменён (с причиной) |
Проверка и типовые проблемы
После настройки прогоните тестовый цикл: оформите заказ на сайте, убедитесь, что он появился в RetailCRM с товарами и контактом, смените статус в CRM и проверьте отражение на сайте.
- Заказ не уходит в CRM — проверьте API-ключ и права, логи обмена модуля.
- Товар «пустой» в заказе — рассинхрон артикулов ICML и позиций сайта.
- Статус не меняется — пропуск в таблице маппинга или конфликт двустороннего обмена.
- Дубли клиентов — разный формат телефона на сайте и в CRM.
Логи обмена и файл ICML — первые места, куда стоит смотреть при любом сбое.
Итог
Интеграция RetailCRM с 1С-Битрикс держится на трёх опорах: модуль intaro.retailcrm, корректный каталог в ICML и продуманный маппинг статусов, оплат и доставок. Сделанная аккуратно, связка превращает сайт в чистую витрину, а всю обработку заказов уводит в CRM — с триггерами, аналитикой и доставкой.
Мы внедряем RetailCRM и настраиваем обмен с сайтами на 1С-Битрикс под ключ: от аудита справочников до тестового цикла заказов и обучения операторов. Если нужна не только настройка модуля, но и выстраивание процессов вокруг него — поможем собрать всё в единую рабочую систему.
Частые вопросы
Нужна ли редакция Битрикса с интернет-магазином?
Да, для обмена заказами обязателен модуль «Интернет-магазин» (sale). Без него можно выгружать только каталог, но не синхронизировать заказы.
В каком формате RetailCRM принимает каталог?
В формате ICML — это XML-фид, который модуль генерирует из инфоблоков Битрикса и публикует по ссылке, доступной RetailCRM.
Обмен заказами двусторонний?
Да. Заказы и клиенты уходят с сайта в CRM, а изменения статусов, сумм и состава возвращаются на сайт.
По какому полю связываются товары?
По внешнему коду товара и артикулу торгового предложения. Поэтому важно, чтобы XML_ID и артикулы были уникальными и заполненными.
Как часто обновляется каталог?
По расписанию агента или cron. Для больших каталогов рекомендуется cron с интервалом, который выдерживает сервер, чтобы не перегружать хиты.
Что делать с разным набором статусов на сайте и в CRM?
Настроить таблицу соответствия: один статус сайта — один статус CRM, при этом несколько статусов CRM могут сводиться к одному статусу сайта.
Почему клиенты дублируются?
Чаще всего из-за разного формата телефона или email на сайте и в CRM. RetailCRM дедуплицирует по контактам, поэтому нужна единая нормализация.
Поможем с настройкой и поддержкой RetailCRM
Поможем с настройкой, доработкой и поддержкой RetailCRM.