Авторизация
Системный статус
Настройка идёт по шагам сверху вниз: сначала стенд (1С и Bitrix24), потом правило синхронизации, запуск и, при желании, AI и уведомления. Можно вернуться на любой шаг в любой момент — ничего не сохраняется автоматически без явного нажатия "Сохранить".
Шаг 1. Общие данные стенда
Название и окружение помогают отличать стенды друг от друга, если их несколько (например, тест и пилот). Можно оставить как есть и перейти дальше.
Параметры
Шаг 2. Подключение 1С
Укажите адрес обмена 1С и учётные данные. Если пока нет доступа к реальной базе — включите "Simulate режим", он выполняет обмен с тестовыми данными без реального 1С.
Параметры подключения
Шаг 3. Подключение Bitrix24
Для webhook-режима достаточно "Application token". Для OAuth понадобятся Client ID/Secret и токены доступа. Как и для 1С, есть "Simulate режим" для теста без реального портала.
Параметры подключения
Регистрация приложения в Bitrix24 (для событий в реальном времени)
Без этого шага Exchange Core всё равно может забирать данные из Bitrix24 по расписанию. Этот шаг нужен только для мгновенной реакции на изменения в CRM - пошаговая инструкция по регистрации локального приложения в самом портале лежит в файле integrations/bitrix24/README.md рядом с установкой.
Важно про порядок действий: поле "Install secret" выше при каждом сохранении очищается на экране (как и остальные секреты - "оставьте пустым, чтобы не менять"). Собирайте handler URL сразу после того, как ввели secret, до нажатия "Сохранить подключение" ниже - кнопка использует то, что сейчас введено в поле.
Вставьте этот адрес как "Путь обработчика" при создании локального приложения в Bitrix24. Он содержит секрет в открытом виде - передавайте его так же осторожно, как пароль. Не забудьте затем нажать "Сохранить подключение", чтобы Exchange Core тоже знал этот secret.
Шаг 4. Проверка готовности стенда
Здесь видно, что уже заполнено и что осталось сделать перед тем, как переходить к настройке правила синхронизации.
Сводка
Чеклист готовности
Шаг 5. Правило синхронизации
Правило описывает, какие сущности и поля синхронизировать и в какую сторону. Ниже — список уже созданных подключений и правил, а под ним — конструктор нового правила.
Подключения
Правила
Конструктор правила
Маппинг полей
Для каждой строки можно выбрать трансформер, задать его параметры и явно отметить, является ли поле двусторонним. Для 1С-полей показываются path, ссылочные сущности и колонки табличных частей вроде Товары.*.Количество, доступны пресеты для типовых пар сущностей, фильтры и автоподбор.
Шаг 6. Запуск и мониторинг
Initial load загружает уже существующие данные из источника один раз. После этого очередь обрабатывает изменения постоянно — вручную кнопкой "Обработать" или автоматически через Celery beat.
Initial load
Статус фоновой задачи
Очередь
Dead-letter
Записи, которые не удалось обработать после нескольких попыток. Разберите причину и нажмите Replay (повторить) или Resolve (закрыть без повтора).
Журнал
Шаг 7. Дополнительные настройки
Этот шаг необязателен: уведомления о dead-letter, помощь AI при настройке маппинга и резервное копирование конфигурации между тенантами/окружениями.
Уведомления о dead-letter
Один или несколько каналов — уведомление уходит во все включённые сразу. Отключено по умолчанию, вставьте свои данные для нужных каналов.
Telegram
Email (SMTP)
Webhook (MAX, Slack, свой бот)
AI-провайдер (GigaChat)
Настраивается на подключение (обычно на целевом подключении правила). Ключ хранится зашифрованным и не возвращается обратно в API.