Миграция данных из 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 записей каждого типа для подтверждения корректности переноса данных и связей.