Интеграция 1С-Битрикс с RetailCRM: настройка и синхронизация

Представьте: чёрная пятница, на сайт заходят сотни покупателей, заказы сыплются один за другим. Но RetailCRM молчит — данные уходят в пустоту. Менеджеры не видят заказы, статусы сбиваются, клиенты звонят. Такая ситуация знакома магазинам, где интеграция 1С-Битрикс с RetailCRM не рассчитана на реальные нагрузки. Проблема усугубляется конфликтами данных: один и тот же заказ может быть создан дважды, если не настроена дедупликация по externalId. Кроме того, при прямых вызовах REST API на каждый заказ сервер Битрикса начинает тормозить, а RetailCRM отклоняет запросы при превышении лимита. RetailCRM, как и любая CRM, требует точного маппинга полей: статусов, складов, типов доставки. Без этого заказы могут потеряться или задвоиться. Наша интеграция решает эти проблемы на уровне протокола. Мы устраняем эти проблемы: настраиваем двустороннюю синхронизацию через REST API RetailCRM v5 и асинхронные очереди на агентах Битрикса, которые выдерживают 500+ заказов в час без потерь. За длительный период мы реализовали более 50 интеграций с RetailCRM — каждая окупилась за несколько месяцев за счёт снижения операционных издержек на 40%.

Сценарии, требующие собственной интеграции RetailCRM с Битрикс

RetailCRM предоставляет официальный модуль для 1С-Битрикс через маркетплейс. Модуль подходит для базовых сценариев. Но когда объём заказов превышает 50–100 в сутки или появляются нестандартные требования, модуль перестаёт справляться. Сравним:

Собственная интеграция нужна, когда:

• Нестандартные статусы заказов или свойства, которых нет в модуле.
• Сложная логика маппинга (несколько магазинов, разные склады).
• Интеграция с другими системами через RetailCRM (телефония, delivery-сервисы).

Кейс: пиковая нагрузка на распродаже

В нашей практике был случай: клиент — магазин одежды — столкнулся с тем, что во время распродажи 800 заказов за 2 часа приводили к 5-секундным задержкам и таймаутам при прямом вызове RetailCRM API. Мы решили проблему через очередь на основе агентов Битрикса. Заказы пишутся в таблицу очереди, агент каждые 10 секунд отправляет порцию по 10 заказов. Пиковая нагрузка сглаживается, заказы проходят за 1–5 минут. Экономия времени на обработку — 70%, снижение нагрузки на сервер — в 3 раза.

Как настроить двустороннюю синхронизацию заказов?

Базовый URL: https://yourdomain.retailcrm.ru/api/v5/. Аутентификация — заголовок X-API-KEY. Ниже — пример нашего клиента: класс для создания заказа в RetailCRM.

class RetailCRMClient { private string $apiKey; private string $siteKey; private string $baseUrl; public function createOrder(\Bitrix\Sale\Order $order): ?string { $basket = $order->getBasket(); $props = $order->getPropertyCollection(); $items = []; foreach ($basket as $item) { $items[] = [ 'offer' => ['xmlId' => (string)$item->getProductId()], 'quantity' => $item->getQuantity(), 'initialPrice' => $item->getBasePrice(), 'discountPercent' => 0, ]; } $orderData = [ 'number' => 'BX-' . $order->getId(), 'externalId' => (string)$order->getId(), 'site' => $this->siteKey, 'status' => $this->mapStatus($order->getField('STATUS_ID')), 'customer' => [ 'externalId' => (string)$order->getUserId(), 'email' => $props->getUserEmail(), 'phone' => $props->getItemByPropertyOrderCode('PHONE')?->getValue(), ], 'items' => $items, 'delivery' => [ 'code' => $this->mapDelivery($order->getDeliveryId()), 'address' => ['text' => $this->getOrderAddress($props)], ], 'paymentType' => $this->mapPayment($order->getPaymentSystemId()), ]; $http = new \Bitrix\Main\Web\HttpClient(); $http->setHeader('X-API-KEY', $this->apiKey); $http->setHeader('Content-Type', 'application/x-www-form-urlencoded'); $response = json_decode($http->post( $this->baseUrl . 'orders/create', 'order=' . urlencode(json_encode($orderData)) . '&site=' . $this->siteKey ), true); return $response['id'] ?? null; } } 

RetailCRM меняет статус заказа (менеджер обработал, поставил на сборку, передал в доставку) — сайт должен обновить статус. RetailCRM поддерживает исходящие вебхуки (RetailCRM Webhooks). Настраиваем их в разделе «Администрирование → Вебхуки»:

$payload = json_decode(file_get_contents('php://input'), true); foreach ($payload['orders'] as $orderData) { $externalId = $orderData['externalId']; $newStatus = $statusMap[$orderData['status']] ?? null; if ($newStatus) { $order = \Bitrix\Sale\Order::load($externalId); $order->setField('STATUS_ID', $newStatus); $order->save(); } } 

Маппинг справочников

RetailCRM хранит справочники: статусы, типы доставки, методы оплаты — каждый с кодом. Коды нужно привести к кодам Битрикса:

Маппинг хранится в настройках модуля или в пользовательской таблице.

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

Прямые синхронные вызовы API при 500+ заказов в час — гарантированные таймауты. Очередь на агентах сглаживает пики и гарантирует доставку. Экономия времени на обработку достигает 70%, снижение нагрузки на сервер — в 3 раза. Стоимость интеграции рассчитывается индивидуально, но в среднем окупается за 2–3 месяца.

Что входит в интеграцию

Процесс работы над интеграцией

1. Аудит — анализируем текущую архитектуру, схему данных, бизнес-процессы.
2. Проектирование — разрабатываем маппинг полей, схему очередей, обрабатываем edge-кейсы.
3. Разработка — пишем REST-клиент, настраиваем вебхуки, реализуем очередь.
4. Тестирование — имитируем пиковую нагрузку, проверяем синхронизацию туда и обратно.
5. Деплой — разворачиваем на production, включаем мониторинг.
6. Поддержка — 30 дней пост-релизной поддержки, исправление возможных ошибок.

Мы занимаемся интеграциями Битрикс с CRM более 5 лет и реализовали свыше 50 проектов с RetailCRM. Свяжитесь с нами для аудита вашей архитектуры интеграции. Закажите разработку — получите стабильную синхронизацию, которая выдержит любой трафик.