Автоматизация · 10 мин
Как Битрикс24 интегрируется с 1С: способы, настройка и проверка обмена
Разбираем интеграцию Битрикс24 с 1С: готовый модуль обмена, REST API, коннекторы. Что синхронизировать, как настроить обмен и проверить результат.
Интеграция Битрикс24 с 1С решает типичную задачу: менеджеры работают со сделками и клиентами в CRM, а бухгалтерия и склад — в 1С. Без обмена данными одни и те же контрагенты, счета и товары заводятся вручную дважды, что приводит к расхождениям в остатках, ценах и реквизитах. Связка двух систем устраняет двойной ввод: счёт, выставленный из сделки в Битрикс24, попадает в 1С, а факт оплаты возвращается обратно в CRM.
Существует три практических пути интеграции: штатный модуль обмена «1С + Битрикс24» от 1С-Битрикс, обмен через REST API и веб-хуки с собственной разработкой, а также готовые коннекторы и сервисы-посредники. Выбор зависит от конфигурации 1С (Управление торговлей, Комплексная автоматизация, ERP, Бухгалтерия), объёма данных и наличия разработчика.
Ниже разобрано, какие данные имеет смысл синхронизировать, как настроить типовой обмен, какие ограничения есть у каждого способа и как проверить, что интеграция работает корректно, а не создаёт дубли и потери данных.
Какие данные передавать между Битрикс24 и 1С
Прежде чем настраивать обмен, определите состав синхронизируемых объектов. Типовой набор для связки CRM и учётной системы включает контрагентов (компании и контакты), номенклатуру с ценами, счета на оплату, заказы и статусы оплаты/отгрузки. Это покрывает потребности большинства торговых компаний.
Правильное направление потоков данных — ключевой вопрос архитектуры. Общепринятая схема: справочник товаров и цены ведутся в 1С и выгружаются в Битрикс24 (1С — мастер-система), а сделки, лиды и новые клиенты рождаются в CRM и передаются в 1С для оформления документов. Статусы оплаты и отгрузки движутся из 1С обратно в Битрикс24, чтобы менеджер видел реальное состояние сделки.
Не стоит синхронизировать «всё подряд». Каждый лишний объект обмена — это нагрузка, риск конфликтов и сложность поддержки. Например, если первичные документы (акты, накладные) формируются только в 1С и менеджерам не нужны в CRM, передавать их не обязательно — достаточно статуса и ссылки на счёт.
Штатный модуль обмена «1С + Битрикс24»
Фирма «1С» совместно с «1С-Битрикс» выпускает бесплатный модуль обмена данными, который устанавливается в конфигурации на управляемых формах: Управление торговлей 11, Комплексная автоматизация 2, ERP 2, УНФ и некоторые другие. Модуль скачивается с официального портала и подключается как расширение или встраивается в конфигурацию — зависит от версии.
Модуль умеет синхронизировать контрагентов и контактные лица, товары с картинками и ценами, счета и заказы, а также передавать статусы оплаты. Обмен работает через служебный канал связи с порталом Битрикс24 — как с облачным, так и с коробочной версией. Расписание обмена настраивается регламентным заданием, например каждые 15–30 минут.
Ограничение типового модуля — он покрывает стандартные сценарии. Если у вас сильно доработанная конфигурация, нестандартные статусы сделок или специфическая логика резервирования товара, типовой обмен придётся дорабатывать, а это уже задача для программиста 1С.
- 1Обновите конфигурацию 1С до актуального релиза и сделайте резервную копию базы
- 2Скачайте модуль обмена с официального портала 1С-Битрикс и подключите его к конфигурации
- 3В настройках модуля укажите адрес портала Битрикс24 и авторизуйтесь под учётной записью с правами администратора
- 4Настройте соответствие справочников: какие компании, товары и статусы синхронизировать
- 5Выполните первичную выгрузку товаров и контрагентов, проверьте результат на стороне CRM
- 6Включите регламентное задание обмена с нужной периодичностью
Интеграция через REST API и веб-хуки
Когда типового модуля недостаточно, обмен строят на REST API Битрикс24. Платформа предоставляет методы для работы со сделками, контактами, компаниями, счетами и товарами, а также входящие и исходящие веб-хуки. Входящий веб-хук даёт URL с токеном, по которому внешняя система (в том числе 1С) может вызывать методы API без интерактивной авторизации.
Со стороны 1С обращение к API выполняется стандартными средствами HTTP-соединения: формируется запрос с параметрами, ответ приходит в формате JSON и разбирается встроенными средствами платформы. Для обратного направления — уведомлений из Битрикс24 в 1С — используют исходящие веб-хуки на события (например, изменение стадии сделки), которые дёргают опубликованный HTTP-сервис 1С.
Этот путь требует разработчика, знающего и 1С, и REST API. Зато он даёт полную гибкость: можно передавать любые поля, строить свою логику сопоставления и обрабатывать нестандартные события. Важно учитывать лимиты API Битрикс24 на частоту запросов — при массовых выгрузках запросы нужно пакетировать и делать паузы, иначе обмен будет отклоняться с ошибками.
curl -X POST "https://portal.bitrix24.ru/rest/1/WEBHOOK_TOKEN/crm.deal.list" -d "filter[STAGE_ID]=WON&select[]=ID&select[]=TITLE"Готовые коннекторы и сервисы-посредники
Третий вариант — облачные сервисы-интеграторы и готовые коннекторы, которые связывают Битрикс24 и 1С без программирования с вашей стороны. Они работают по подписке: вы авторизуете обе системы, выбираете сценарии обмена в визуальном конструкторе и запускаете синхронизацию.
Такой подход оправдан, когда нет штатного разработчика, а сценарии обмена укладываются в стандартные шаблоны сервиса. Минусы: ежемесячная плата, зависимость от доступности посредника и ограниченная кастомизация. Кроме того, данные компании проходят через сторонний сервис, что нужно учитывать с точки зрения политики информационной безопасности.
Сравнение способов интеграции
Бесплатный, быстрый старт, стандартные сценарии. Не подходит для сильно доработанных конфигураций и нестандартной логики.
Максимальная гибкость, любые объекты и события. Требует разработчика и последующей поддержки кода.
Настройка без программирования, быстрый запуск. Абонентская плата, ограниченная кастомизация, данные идут через третью сторону.
Типичные ошибки и риски при обмене данными
Самая частая проблема — дубли контрагентов. Если в 1С клиент заведён как «ООО Ромашка», а менеджер создал в Битрикс24 «Ромашка ООО», обмен может создать две записи вместо сопоставления. Перед запуском интеграции проведите чистку справочников: объедините дубли, приведите наименования к единому виду, заполните ИНН — именно по ИНН чаще всего строится надёжное сопоставление.
Вторая группа ошибок — конфликты при двустороннем редактировании. Если и менеджер в CRM, и оператор в 1С правят один и тот же объект, без чёткого правила приоритета данные будут затирать друг друга. Определите для каждого объекта мастер-систему и зафиксируйте это в регламенте: кто и где редактирует товары, контрагентов, счета.
Отдельный риск — обмен без резервной копии и тестового контура. Первичная синхронизация может массово изменить тысячи записей, и откатить это вручную практически невозможно. Всегда сначала проверяйте обмен на копии базы или на ограниченном наборе данных (одна папка товаров, десять контрагентов).
Как проверить, что интеграция работает корректно
Проверку начинайте с контрольного сценария сквозной цепочки: создайте тестовую сделку в Битрикс24, выставьте из неё счёт и убедитесь, что счёт появился в 1С с корректными реквизитами, суммами и привязкой к правильному контрагенту. Затем отметьте оплату в 1С и проверьте, что статус обновился в карточке сделки в CRM.
Далее проверьте справочники: измените цену товара в 1С, дождитесь обмена и сверьте цену в Битрикс24. Убедитесь, что количество контрагентов и товаров после синхронизации совпадает с ожидаемым, а журнал обмена не содержит повторяющихся ошибок. Полезно вести первые недели контрольный список расхождений и сверять его после каждого обмена.
Как проверить результат
Счёт создан, реквизиты и суммы совпадают, контрагент сопоставлен
Счёт не создан, создан дубль контрагента или суммы расходятся
После оплаты в 1С сделка в Битрикс24 получила актуальный статус
Статус не меняется или меняется с большой задержкой без причины
Единичные ошибки с понятной причиной, очередь обрабатывается
Повторяющиеся ошибки по одним и тем же объектам, растущая очередь
Цены и остатки в CRM совпадают с 1С после обмена
Расхождения в ценах, пропавшие позиции, дубли номенклатуры
FAQ: частые вопросы по интеграции Битрикс24 и 1С
Работает ли обмен с облачной версией Битрикс24?
Да, штатный модуль обмена поддерживает как облачный, так и коробочный Битрикс24. Для облака не требуется открывать порты или публиковать сервисы — соединение инициируется со стороны 1С через служебный канал. Для REST API в облаке достаточно создать входящий веб-хук в настройках портала.
Можно ли связать Битрикс24 с 1С:Бухгалтерией?
Прямого типового модуля обмена для 1С:Бухгалтерии нет — штатное решение ориентировано на торговые конфигурации (УТ, КА, ERP, УНФ). Для бухгалтерии обмен обычно строят через REST API с собственной разработкой или через коннекторы-посредники, ограничиваясь передачей контрагентов и счетов.
Что делать, если контрагенты дублируются при обмене?
Отключите автоматический обмен, включите сопоставление по ИНН (или ИНН + КПП) в настройках интеграции и выполните повторное сопоставление уже созданных записей — в типовом модуле для этого есть механизм сопоставления. Существующие дубли объединяйте штатными средствами поиска и удаления дублей в 1С, затем запускайте обмен снова на малом объёме.
Как часто должен выполняться обмен?
Оптимальная периодичность зависит от объёма: для небольших баз обычно достаточно интервала 15–30 минут. Слишком частый обмен при больших объёмах приводит к тому, что очередь не успевает обрабатываться. Критичные события (например, оплату счёта) лучше передавать по событию через веб-хук, а не ждать планового обмена.
Куда обращаться, если типовой обмен не покрывает наши процессы?
Сначала зафиксируйте, какие именно сценарии не покрываются: нестандартные статусы, дополнительные поля, своя логика резервов. С этим списком оцените два пути: доработку типового модуля силами программиста 1С или переход на обмен через REST API. Первый вариант дешевле при точечных отличиях, второй оправдан при принципиально иной логике процессов.
Что важно запомнить
Для стандартных сценариев начинайте с бесплатного типового модуля обмена «1С + Битрикс24», для нестандартных — с REST API и веб-хуков. Перед запуском почистите дубли, определите мастер-систему для каждого объекта, сделайте резервную копию и проверьте обмен на тестовом наборе данных. Контролируйте результат по сквозному сценарию: сделка → счёт → оплата → статус в CRM.