Система автоматической выгрузки документов n8n из Bitrix24 в облачное хранилище

В Bitrix24 хранилось большое количество файлов, прикреплённых к сделкам и пользовательским полям. Для работы с ними сотрудникам приходилось вручную открывать каждую сделку, скачивать документы, создавать нужную структуру папок и следить за актуальностью версий

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

Основные требования:

получать только новые и изменённые сделки

обрабатывать все страницы выдачи Bitrix24 без пропуска данных

извлекать файлы из пользовательских полей сделок

поддерживать документы, созданные через Document Generator

автоматически формировать структуру папок по компании, группе и работнику

сохранять файлы с однозначными именами

архивировать предыдущую версию документа при замене

корректно продолжать работу после временных ошибок и перезапусков

исключить повторную обработку уже синхронизированных данных

автоматически очищать технические журналы

Разработан workflow в n8n, который каждые 10 минут проверяет изменения в Bitrix24 и автоматически переносит документы в Яндекс Диск

Система использует дату последней модификации сделки как контрольную точку и запрашивает только новые или обновлённые данные. Для обработки больших объёмов реализована пакетная загрузка с поддержкой постраничной выдачи Bitrix24

В рамках автоматизации реализованы:

• получение списка изменённых сделок через Bitrix24 REST API

• последовательная обработка всех страниц и batch-запросов

• извлечение файлов из необходимых пользовательских полей

• получение временного токена доступа для защищённых ссылок Bitrix24

• скачивание оригинальных файлов

• загрузка документов в Яндекс Диск

• автоматическое создание структуры каталогов по шаблону «Компания / Группа / Работник»

• формирование уникальных имён файлов с указанием работника, типа документа и идентификатора

• перенос предыдущей версии файла в архив при обновлении

• обработка документов, созданных через Bitrix24 Document Generator

• пакетная обработка 976 ранее созданных документов

• хранение контрольной точки для продолжения синхронизации после перезапуска

• обработка ошибок и автоматическая очистка технических логов

В результате была создана автономная инфраструктура синхронизации, которая связывает CRM и облачное хранилище, поддерживает актуальность документов и устраняет необходимость вручную обрабатывать файлы по каждой сделке

Я самостоятельно спроектировал логику workflow, интеграцию с API Bitrix24 и Яндекс Диска, правила именования и архивирования файлов, механизм контрольных точек, обработку ошибок и серверное развёртывание системы

В результате клиент получил полностью автоматизированную систему синхронизации документов между Bitrix24 и Яндекс Диском

Workflow каждые 10 минут проверяет новые и изменённые сделки, получает прикреплённые файлы и документы из Bitrix24 Document Generator, после чего сохраняет их в структурированное облачное хранилище

Реализованная система позволяет:

• автоматически обрабатывать все изменённые сделки без ручного запуска

• сохранять документы по структуре «Компания / Группа / Работник»

• присваивать файлам однозначные имена с указанием типа документа и идентификатора

• архивировать предыдущие версии при обновлении

• восстанавливать работу с последней контрольной точки после перезапуска

• обрабатывать большие объёмы данных через batch-запросы и постраничную загрузку

• автоматически очищать технические журналы

В рамках первоначальной обработки было выгружено около 976 документов, созданных через Bitrix24 Document Generator

Автоматизация развёрнута в production-среде и работает автономно, без постоянного участия сотрудников. Архитектура позволяет подключать дополнительные поля, типы документов и правила хранения без полной переработки workflow