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

Перенесення даних з RetailCRM у Bitrix24

RetailCRM — спеціалізована російська CRM для електронної комерції. Її сила полягає в глибокій інтеграції з інтернет-магазинами, маркетплейсами та логістичними сервісами. Перехід на Bitrix24 відбувається, коли компанія хоче поєднати CRM з корпоративним порталом, завданнями та внутрішніми комунікаціями на одній платформі. Важливо розуміти: деякі функціональні можливості RetailCRM (специфіка електронної комерції) в Bitrix24 CRM реалізуються інакше.

Об'єктна модель RetailCRM

RetailCRM будується навколо замовлень (Orders) як центральної сутності, що відрізняє її від класичних CRM на зразок Bitrix24, орієнтованих на угоди:

• 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? Залежить від того, чи є у компанії інтернет-магазин на Bitrix:

Якщо є магазин Bitrix: замовлення RetailCRM можуть вже синхронізуватися з ним через інтеграцію. У цьому випадку потрібно мігрувати лише покупців та історію — замовлення вже в Bitrix.

Якщо магазину Bitrix немає: замовлення RetailCRM переносяться як Угоди в CRM Bitrix24, покупці як Контакти та Компанії.

Статуси замовлень

RetailCRM має багаторівневу систему статусів замовлень з настроюваними групами (нові, в обробці, доставляються, завершені, скасовані). У Bitrix24 CRM це стадії угоди. Необхідно вручну створити відповідні стадії та зберегти відображення.

Покупці та історія покупок

Покупці з RetailCRM мігрують у контакти Bitrix24. Важливо зберегти історію замовлень для RFM-аналізу та повторних продажів. Якщо Bitrix24 використовується як CRM без інтернет-магазину, історія замовлень передається через коментарі таймлайну або через користувацьку сутність «Історія покупок».

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

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

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

Типові графіки виконання

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