Migration toolkit для 1С Битрикс: переносим аккаунт между инстансами через crm.*.list + идемпотентность по ORIGINATOR_ID

В сфере искусственного интеллекта произошло заметное событие. yakov_etern8 3 минуты назад Migration toolkit для 1С Битрикс: переносим аккаунт между инстансами через crm. list + идемпотентность по ORIGINATOR_ID Уровень сложности Средний Время на прочтение 12 мин Охват и читатели 0 1С-Битрикс * Node. JS * TypeScript * Проектирование API * Кейс Зачем переносить аккаунт Битрикс между инстансами В предыдущей статье ( как отдавать лиды из Next.

js в 1С Битрикс ) я показывал outbound-интеграцию: сайт пишет лид к себе в PostgreSQL, через after() отдаёт его в Битрикс, в строку лида подкладывает bitrix_id . Архитектура работает, пока Битрикс один. Но в реальной жизни Битрикс редко остаётся один.

Технические детали

Сценарии, в которых нужна полноценная миграция между инстансами, я ловил на проектах четыре раза за последний год: Переезд серверов. Клиент держал self-hosted Битрикс на старом VPS, переезжает на новый. SaaS-инстанс на новый домен — то же самое.

Разделение test/prod. Команда работала в одном продакшн-аккаунте. Хотят отдельный staging, в который скопирован срез реальных данных, чтобы тестировать без риска для живой воронки.

Компания делится на два юридических лица, каждому нужен свой Битрикс с частью общей клиентской базы. Тестовый контур интеграции. Я как разработчик не могу гонять интеграцию по живой CRM клиента.

Отраслевые последствия

Мне нужен инстанс с зеркалом данных — чтобы отлаживать синхронизатор без риска налажать на проде. Во всех четырёх случаях задача одна: перенести лиды, сделки, контакты, компании из source-инстанса в target-инстанс, не плодя дубли при повторных прогонах . То есть не просто скрипт «один раз залить и забыть», а инструмент, который можно запускать 5 раз — и пятый раз он не создаст ещё пять копий каждого лида.

В этой статье — паттерн migration toolkit, который мы используем на проекте маркетплейса недвижимости. Один Node-скрипт, два webhook URL в env-переменных, никаких очередей и отдельной БД. Идемпотентность держится через ORIGINATOR_ID + ORIGIN_ID — это и есть главное, что отличает migration toolkit от наивного «слил-залил».

Архитектура: один скрипт, два webhook Migration toolkit не нужен как сервис. Это разовый CLI-инструмент , который запускается оператором руками, сверяется с логом и при необходимости прогоняется повторно. ┌────────────────────┐ ┌────────────────────┐ │ BITRIX_SOURCE │ ── crm.

Этот прогресс даёт важные сигналы о будущем отрасли, и технологический мир внимательно наблюдает.