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

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

Megaplan — російська CRM-система, орієнтована на управління завданнями та угодами. При переході на Бітрікс24 компанії часто розраховують на «простий експорт», але Megaplan не надає повного API для вивантаження всіх даних. Частина сутностей доступна лише через веб-інтерфейс або вимагає спеціального запиту до підтримки.

Що можна отримати з Megaplan

Megaplan надає API (REST, версія 3.x). Основні доступні сутності:

• Угоди (/api/v3/deals) — з полями, стадіями, відповідальними
• Контакти (/api/v3/contacts) — фізичні особи
• Компанії (/api/v3/companies) — юридичні особи
• Завдання (/api/v3/tasks) — з коментарями та вкладеннями
• Співробітники (/api/v3/employees) — для маппінгу відповідальних

Що недоступно через API або обмежено:

• Історія змін полів
• Видалені записи
• Звіти в сирому вигляді
• Налаштовані воронки в деталях

Офіційний експорт у CSV (через налаштування акаунту) дає плоску таблицю без прив'язок — підходить лише для невеликих обсягів та простих структур.

Стратегія міграції через API

Використовуємо API Megaplan для посторінкового отримання даних, перетворюємо та завантажуємо через REST API Бітрікс24:

// Отримання угод з Megaplan
$page = 1;
$deals = [];
do {
    $response = $megaplanClient->get('/api/v3/deals', [
        'limit' => 100,
        'offset' => ($page - 1) * 100,
        'fields' => 'id,name,amount,status,responsible,company,contact,created_at',
    ]);
    $deals = array_merge($deals, $response['data']);
    $page++;
} while (count($response['data']) === 100);

Маппінг сутностей

Поля угод у Megaplan включають кастомні поля («Додаткові поля») — їх потрібно ідентифікувати через API (/api/v3/deal-fields) та створити відповідні користувацькі поля в Бітрікс24 через crm.userfield.add.

Завдання та коментарі

Завдання Megaplan мають ієрархічну структуру (підзавдання). У Бітрікс24 ієрархія завдань реалізована через поле PARENT_ID. Коментарі до завдань переносяться через task.commentitem.add.

Вкладення до завдань завантажуються з Megaplan та вивантажуються на Диск Бітрікс24 через disk.folder.uploadfile, потім прив'язуються до завдання через task.item.update із зазначенням UF_TASK_WEBDAV_FILES.

Воронки та стадії

Стадії угод у Megaplan не мають прямої відповідності стадіям Бітрікс24. Необхідно:

1. Отримати список стадій Megaplan (/api/v3/deal-stages)
2. Пересоздати воронки та стадії в Бітрікс24 через crm.dealcategory.add та crm.status.add
3. Скласти таблицю відповідностей для маппінгу при завантаженні угод

Типові терміни

Після міграції необхідний період перевірки: вибіркова звірка 50–100 записів кожного типу для підтвердження коректності перенесення даних та зв'язків.