Миграция данных из RetailCRM в Битрикс24

Миграция данных из RetailCRM в Битрикс24

RetailCRM — специализированная российская CRM для интернет-торговли. Её сильная сторона — глубокая интеграция с интернет-магазинами, маркетплейсами и логистическими сервисами. Переход на Битрикс24 происходит когда компания хочет объединить CRM с корпоративным порталом, задачами и внутренними коммуникациями на одной платформе. Нужно понимать: часть функциональности RetailCRM (специфика e-commerce) в Битрикс24 CRM реализована иначе.

Объектная модель RetailCRM

RetailCRM строится вокруг заказов (Orders) как центральной сущности, что отличает её от классических CRM вроде Битрикс24, ориентированных на сделки:

• Order — заказ с составом, статусом, доставкой, оплатой
• Customer — покупатель (физическое лицо или компания)
• Product — товар (берётся из каталога интернет-магазина)
• Task — задачи (встроены в интерфейс)
• Note — комментарии к заказам и покупателям
• Segment — сегменты покупателей (маркетинговые)
• Loyalty — программа лояльности (баллы, уровни)

API RetailCRM

RetailCRM предоставляет хорошо документированный REST API v5. Аутентификация через API-ключ в заголовке X-API-KEY. Лимит: зависит от тарифа, обычно 100–500 запросов в минуту.

// Получение заказов с пагинацией
$page = 1;
$orders = [];
do {
    $response = $retailCrm->get('/api/v5/orders', [
        'filter' => ['createdAtFrom' => '2020-01-01', 'createdAtTo' => '2024-12-31'],
        'page'   => $page,
        'limit'  => 100,
    ]);
    $orders = array_merge($orders, $response['orders']);
    $page++;
} while ($response['pagination']['totalPageCount'] >= $page);

Стратегия маппинга

Ключевой вопрос: куда мигрируют заказы RetailCRM? Зависит от того, есть ли в компании интернет-магазин на Битрикс:

Если есть Битрикс-магазин: заказы RetailCRM уже могут быть синхронизированы с ним через интеграцию. В этом случае мигрировать нужно только покупателей и историю — заказы уже в Битрикс.

Если Битрикс-магазина нет: заказы RetailCRM переносятся как Сделки в CRM Битрикс24, покупатели — как Контакты и Компании.

Статусы заказов

RetailCRM имеет многоуровневую систему статусов заказов с настраиваемыми группами (новые, в обработке, доставляются, завершены, отменены). В Битрикс24 CRM это стадии сделки. Необходимо вручную создать соответствующие стадии и сохранить маппинг.

Покупатели и история покупок

Покупатели из RetailCRM мигрируют в контакты Битрикс24. Важно сохранить историю заказов для RFM-анализа и повторных продаж. Если Битрикс24 используется как CRM без интернет-магазина, история заказов передаётся через комментарии таймлайна или через кастомную сущность «История покупок».

// Добавление записи о покупке как комментарий к контакту
$bitrix->call('crm.timeline.comment.add', [
    'fields' => [
        'ENTITY_TYPE' => 'contact',
        'ENTITY_ID'   => $contactId,
        'COMMENT'     => "Заказ #{$order['number']}: {$order['totalSumm']} руб. от {$order['createdAt']}",
    ],
]);

Программа лояльности

Данные программы лояльности (баллы, уровень, история начислений) мигрируют в Битрикс через модуль бонусных баллов интернет-магазина или через кастомные поля контакта. Структура зависит от того, как реализована лояльность в целевой системе.

Типичные сроки

Особое внимание уделяется верификации: сверка суммарных показателей (число заказов по статусам, сумма GMV) до и после миграции подтверждает полноту переноса.