Интеграция 1С-Битрикс и RetailCRM

RetailCRM — специализированная CRM для интернет-торговли: она собирает заказы со всех каналов, ведёт клиентов и триггерные сценарии. Интеграция с 1С-Битрикс связывает витрину и CRM так, что заказы попадают в обработку мгновенно, а каталог и статусы всегда актуальны.

Что даёт связка Битрикс и RetailCRM

RetailCRM берёт на себя обработку заказов, сегментацию клиентов, триггерные рассылки и аналитику продаж, а Битрикс остаётся витриной и точкой оформления. В связке решаются задачи:

• единая обработка заказов с сайта, маркетплейсов и телефонии в одном окне;
• карточка клиента с историей покупок и коммуникаций;
• автоматические статусы и уведомления;
• каталог из Битрикс как основа для товарных рекомендаций и триггеров.

Важно понимать разделение ролей: Битрикс остаётся мастером каталога и источником заказов, а RetailCRM становится рабочим местом менеджера и мозгом маркетинга. Сайт не заменяется, а дополняется — покупатель по-прежнему оформляет заказ на витрине Битрикс, но дальше он живёт и обрабатывается уже в CRM.

Из чего состоит интеграция

Полная связка складывается из четырёх независимых потоков данных. Настраивать их можно поэтапно.

Готовый модуль или своя интеграция

Есть два пути подключения, и они не взаимоисключающие.

1. Официальный модуль RetailCRM для Битрикс (intaro.retailcrm) из Маркетплейса. Он ставится в раздел модулей, настраивается через мастер: соответствие статусов, типов оплаты и доставки, выгрузка заказов и генерация ICML. Покрывает большинство типовых магазинов.
2. Собственная интеграция на REST API v5 — когда логика заказов нестандартная, есть кастомные поля или нужен полный контроль над обменом.

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

Порядок настройки

Рекомендуемая последовательность подключения официального модуля:

1. В RetailCRM создать API-ключ с нужными правами (Настройки → Интеграция → Ключи доступа к API).
2. Установить модуль intaro.retailcrm в Битрикс, указать адрес аккаунта и ключ.
3. Настроить соответствие справочников: статусы заказов, способы оплаты и доставки, типы заказов.
4. Настроить выгрузку каталога — модуль генерирует ICML по расписанию.
5. Включить выгрузку заказов и историю изменений (обратный поток).
6. Проверить на тестовых заказах в обе стороны.

Соответствие справочников — ключевой этап

Самый частый источник проблем — несведённые справочники статусов, оплат и доставок. Если статус на сайте и в CRM не сопоставлен, заказы «зависают» или получают неверное состояние.

Клиенты и дедупликация

RetailCRM строит сегменты, триггеры и историю покупок вокруг карточки клиента, поэтому дубли контактов особенно вредны — они размывают аналитику и ломают рассылки.

• Ключ поиска клиента — нормализованный телефон и email; создавать нового только если не нашли существующего.
• Гости и зарегистрированные покупатели Битрикс должны сводиться к одной карточке в CRM.
• Согласия на рассылки и персональные данные передавайте с учётом 152-ФЗ.

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

Обратный поток и вебхуки

Изменения в RetailCRM должны возвращаться на сайт: смена статуса, правка состава заказа, данные оплаты. Здесь работают два механизма.

• Вебхуки/уведомления RetailCRM — мгновенно сообщают об изменении заказа или клиента.
• Метод history API (/orders/history, /customers/history) — периодический опрос изменений с фиксацией последней обработанной точки, надёжен при пропущенных вебхуках.

Комбинация «вебхуки + периодическая сверка по history» даёт и скорость, и защиту от потери событий. Точку сверки (ID последнего обработанного изменения) храните в своей таблице, чтобы после перезапуска обмен продолжил с нужного места, а не с нуля.

Итог

Интеграция Битрикс и RetailCRM — это четыре потока: каталог по ICML, заказы и клиенты по REST API v5, обратные статусы по вебхукам и history. Официальный модуль intaro.retailcrm закрывает типовые магазины, но кастомные поля и нестандартная логика почти всегда требуют доработки. Критичнее всего — до запуска свести справочники статусов, оплат и доставок.

Мы в B2Bsite настраиваем связку Битрикс ↔ RetailCRM под ключ: разворачиваем и дорабатываем модуль, сводим справочники, отлаживаем ICML и обратные статусы. Если каталог сложный или в схеме есть склад и маркетплейсы — соберём сквозную интеграцию без потери заказов.