К статье
Практический материал

Автоматизация · 11 мин

Как интегрировать 1С с Битрикс24: практическое руководство

Способы интеграции 1С с Битрикс24: штатный модуль, REST API, коннекторы. Настройка синхронизации товаров, заказов и контрагентов, типичные ошибки и FAQ.

Интеграция 1С и Битрикс24 решает типичную проблему учётных систем и CRM: менеджеры работают со сделками и клиентами в портале, а заказы, остатки, цены и счета живут в 1С. Без связи данные приходится переносить вручную, что порождает расхождения в ценах, просроченные счета и двойной ввод контрагентов.

Для связи систем существует несколько рабочих способов: штатный модуль «1С + Битрикс24» от вендора, обмен через REST API и вебхуки, а также готовые коннекторы и middleware. Выбор зависит от редакции 1С (УТ 11, КА 2, ERP, УНФ), режима работы Битрикс24 (облако или коробка) и требований к глубине синхронизации — только контрагенты и счета или полный обмен товарами, заказами и статусами оплат.

Ниже разобраны условия выбора способа, пошаговая настройка штатного модуля, проверка результата и типичные ошибки, из-за которых обмен ломается или портит данные в обеих системах.

Какие способы интеграции существуют и как выбрать подходящий

Первый вариант — официальный модуль синхронизации, который устанавливается в 1С и соединяется с порталом Битрикс24 по токену. Он покрывает стандартные сценарии: выгрузка контрагентов в компании и контакты CRM, синхронизация товаров и цен, создание счетов и сделок, передача статусов оплаты и отгрузки. Модуль подходит большинству компаний на УТ 11, КА 2, ERP и УНФ.

Второй вариант — прямая интеграция через REST API Битрикс24 и HTTP-запросы из 1С. Этот путь оправдан, когда нужна нестандартная логика: например, создание лидов из заказов покупателей, синхронизация пользовательских полей, которых нет в штатном модуле, или обмен с самописной конфигурацией. Здесь потребуется разработчик, знающий и платформу 1С, и API Битрикс24.

Третий вариант — готовые коннекторы и сервисы-посредники (middleware). Они полезны, когда в цепочке участвуют и другие системы: интернет-магазин, телефония, складской софт. Платный коннектор снимает часть работ по поддержке, но добавляет зависимость от стороннего сервиса и его тарифных ограничений.

Сравнение вариантов

Штатный модуль 1С + Битрикс24

Подходит для типового обмена контрагентами, товарами и счетами. Ограничение — только предусмотренные вендором сценарии и поддерживаемые конфигурации.

REST API и вебхуки

Подходит для нестандартной логики и самописных конфигураций. Ограничение — нужен разработчик и постоянная поддержка кода при обновлениях.

Коннекторы и middleware

Подходят для цепочек с несколькими системами. Ограничение — абонентская плата и зависимость от стороннего сервиса.

Что подготовить перед настройкой

Проверьте редакцию и версию конфигурации 1С: штатный модуль поддерживает актуальные релизы УТ 11, КА 2, ERP 2 и УНФ, а для устаревших версий может потребоваться обновление. Уточните режим работы Битрикс24 — облачный портал или коробочная версия: для коробки адрес подключения будет своим, а для облака используется адрес вида portal.bitrix24.ru.

Определите, какая система будет «мастером» по каждому типу данных. Обычно товары, цены и остатки ведутся в 1С и только выгружаются в CRM, а лиды и сделки рождаются в Битрикс24 и передаются в 1С как заказы. Двустороннее редактирование одних и тех же объектов без чётких правил — главный источник конфликтов.

Сделайте резервную копию базы 1С и по возможности настройте обмен сначала на тестовой копии и тестовом портале. Ошибочное соответствие полей при первой синхронизации может создать тысячи дублей контрагентов, которые потом придётся вычищать вручную или обработкой.

Настройка штатного модуля: пошаговый порядок

Установите модуль синхронизации в 1С: для типовых конфигураций он поставляется как расширение или встроенный функционал «Синхронизация с Битрикс24» в разделе администрирования и интеграций. После установки в настройках подключения укажите адрес портала и ключ доступа (токен), который генерируется в Битрикс24 при установке приложения интеграции из раздела приложений.

Далее настройте дерево соответствий: какие поля контрагента 1С в какие поля компании и контакта CRM выгружаются, как соотносятся виды цен, единицы измерения, ставки НДС. Особое внимание уделите уникальным идентификаторам связи — модуль хранит соответствие объектов по внутренним ID, и удаление этих связей приводит к повторному созданию объектов.

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

Порядок действий
  1. 1
    Сделайте резервную копию базы 1С и подготовьте тестовый портал или отдельную воронку
  2. 2
    Установите модуль синхронизации в 1С и приложение интеграции в Битрикс24
  3. 3
    Введите адрес портала и токен подключения, проверьте соединение
  4. 4
    Настройте соответствие полей контрагентов, товаров, цен и ставок НДС
  5. 5
    Выполните тестовую выгрузку одного контрагента и одного товара, сверьте результат
  6. 6
    Настройте расписание или событийный обмен и включите полную синхронизацию
  7. 7
    Проверьте журнал обмена на ошибки в первые дни работы

Синхронизация товаров, цен и остатков

Товары обычно выгружаются из 1С в каталог CRM Битрикс24 с сохранением иерархии групп. Проверьте, что в 1С заполнены обязательные для обмена реквизиты: наименование, артикул, единица измерения, ставка НДС. Незаполненная ставка НДС — частая причина ошибок при создании счетов из CRM.

Цены передаются по выбранному виду цен: укажите в настройках, какой тип цен 1С соответствует базовой цене в CRM. Если в компании несколько прайсов (розница, опт, дилер), штатный модуль позволяет выгружать дополнительные типы цен, но их использование в сделках нужно проверить отдельно — не все сценарии поддерживают выбор прайса на стороне CRM.

Остатки на складах передаются в Битрикс24, если включён соответствующий режим и в CRM используется складской учёт. Учтите, что при большом каталоге первичная выгрузка товаров может занять заметное время — планируйте её на нерабочие часы и следите за лимитами запросов к API облачного портала.

Обмен заказами, счетами и сделками

Типовой сценарий выглядит так: менеджер создаёт счёт или сделку в Битрикс24, документ передаётся в 1С как заказ покупателя или счёт на оплату, а после проведения оплаты и отгрузки в 1С статусы возвращаются в CRM. Это позволяет менеджеру видеть актуальное состояние оплаты без доступа в учётную систему.

Настройте соответствие статусов: какие стадии сделки в CRM означают создание заказа в 1С, при какой стадии документ можно изменять, а при какой он блокируется для редактирования. Без таких правил менеджер может изменить состав сделки после того, как по ней уже проведена отгрузка, и системы разойдутся.

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

Интеграция через REST API для нестандартных задач

Когда штатного модуля недостаточно, используют REST API Битрикс24. На стороне портала создаётся входящий вебхук с правами на нужные сущности (CRM, каталог, задачи), а из 1С выполняются HTTP-запросы методами платформы. Так можно создавать лиды из документов 1С, обновлять пользовательские поля сделок или запускать бизнес-процессы.

Обратное направление делается через исходящие вебхуки и роботов Битрикс24: при изменении сделки портал вызывает HTTP-сервис, опубликованный на стороне 1С. Для этого база должна быть доступна извне по HTTPS, что требует публикации на веб-сервере и продуманной авторизации — открытый без защиты HTTP-сервис 1С является серьёзной уязвимостью.

bsl
// Пример: создание лида в Битрикс24 через входящий вебхук
Соединение = Новый HTTPСоединение("portal.bitrix24.ru", 443,,,,, Новый ЗащищенноеСоединениеOpenSSL);
Запрос = Новый HTTPЗапрос("/rest/1/ключ_вебхука/crm.lead.add.json");
Запрос.Заголовки.Вставить("Content-Type", "application/json");
Тело = "{""fields"":{""TITLE"":""Заказ из 1С №"" + НомерДокумента + """"}}";
Запрос.УстановитьТелоИзСтроки(Тело);
Ответ = Соединение.ОтправитьДляОбработки(Запрос);

Учитывайте лимиты облачного API: при массовых выгрузках запросы нужно отправлять пакетами (batch) и с паузами, иначе портал начнёт отклонять обращения. Также помните, что код интеграции придётся поддерживать при обновлениях конфигурации и изменениях API — закладывайте это в стоимость решения.

Проверка результата и типичные ошибки

После запуска обмена сверьте контрольные точки: количество выгруженных контрагентов и отсутствие дублей, корректность цен и ставок НДС в товарах CRM, создание заказа в 1С из тестовой сделки и возврат статуса оплаты. Журнал обмена в 1С и история синхронизации в Битрикс24 — основные инструменты диагностики, проверяйте их ежедневно в первую неделю работы.

Контрольные точки

Как проверить результат

Контрагенты в CRM
Норма

Каждая компания и контакт созданы один раз, реквизиты заполнены

Тревожный признак

Дубли компаний, пустые ИНН или адреса

Товары и цены
Норма

Цены в CRM совпадают с видом цен 1С, ставки НДС корректны

Тревожный признак

Нулевые цены, ошибки НДС при выставлении счёта

Заказы и статусы
Норма

Сделка создаёт заказ в 1С, оплата возвращает статус в CRM

Тревожный признак

Документ не создаётся или статус не обновляется

Журнал обмена
Норма

Ошибок нет или они разобраны и устранены

Тревожный признак

Повторяющиеся ошибки соединения или соответствия полей

Типичные ошибки
01
Запуск полной синхронизации без теста — приводит к массовым дублям контрагентов и товаров
02
Двустороннее редактирование одних объектов без правил приоритета — данные в системах расходятся
03
Удаление узла обмена или регистрации соответствий — объекты создаются заново как новые
04
Игнорирование лимитов API при массовой выгрузке — портал отклоняет запросы, обмен встаёт
05
Публикация HTTP-сервиса 1С без авторизации — риск несанкционированного доступа к данным
Перед массовой выгрузкой контрагентов почистите справочник в 1С: объедините очевидные дубли и заполните ИНН. Поиск дублей в модуле синхронизации часто опирается на ИНН и наименование, и качество исходных данных напрямую определяет чистоту CRM после обмена.
ПЗ
Практическое замечание

Ответы на частые вопросы

Работает ли интеграция с облачной 1С (1С:Фреш)?

Да, штатный модуль синхронизации доступен и для баз в сервисе 1С:Фреш при условии, что конфигурация входит в список поддерживаемых. Настройка выполняется так же — через подключение по токену, но возможности публикации собственных HTTP-сервисов в облаке ограничены, поэтому обратный обмен через вебхуки там реализовать сложнее.

Можно ли синхронизировать только контрагентов без товаров и заказов?

Можно. В настройках модуля направления обмена включаются независимо: оставьте активной только синхронизацию контрагентов, а обмен товарами и документами отключите. Это разумный первый шаг перед запуском полного обмена.

Что делать, если после синхронизации появились дубли компаний?

Сначала остановите обмен, чтобы дубли не множились. Затем определите причину: чаще всего это потеря соответствий или разные ключи поиска. Дубли в Битрикс24 объединяйте штатным механизмом контроля дублей CRM, после чего восстановите связи и повторите синхронизацию на малом объёме.

Поддерживается ли обмен с коробочной версией Битрикс24?

Да, модуль работает и с коробкой: в настройках подключения указывается адрес вашего корпоративного портала вместо облачного. Убедитесь, что сервер 1С имеет сетевой доступ к порталу и что на коробке установлены актуальные обновления модуля интеграции.

Кто должен поддерживать интеграцию после запуска?

Штатный модуль обычно обслуживает штатный администратор 1С: контроль журнала обмена, обновление модуля, корректировка соответствий полей. Самописную интеграцию через API должен сопровождать разработчик — при обновлениях конфигурации и изменениях на стороне Битрикс24 код может потребовать доработки.

Передаются ли остатки товаров в реальном времени?

Зависит от режима обмена: при событийной синхронизации остатки обновляются при изменениях в 1С, при обмене по расписанию — с заданным интервалом. Для большинства компаний достаточно обновления несколько раз в час; гарантировать секундную точность остатков в CRM не стоит ни в одном из режимов.

Итог

Что важно запомнить

Для типового обмена выбирайте штатный модуль, для нестандартной логики — REST API с участием разработчика. Назначьте систему-мастер для каждого типа данных, настройте соответствия полей и статусов, начинайте с тестовой выгрузки на резервной копии и контролируйте журнал обмена после запуска.