Автоматизация · 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С: штатный модуль поддерживает актуальные релизы УТ 11, КА 2, ERP 2 и УНФ, а для устаревших версий может потребоваться обновление. Уточните режим работы Битрикс24 — облачный портал или коробочная версия: для коробки адрес подключения будет своим, а для облака используется адрес вида portal.bitrix24.ru.
Определите, какая система будет «мастером» по каждому типу данных. Обычно товары, цены и остатки ведутся в 1С и только выгружаются в CRM, а лиды и сделки рождаются в Битрикс24 и передаются в 1С как заказы. Двустороннее редактирование одних и тех же объектов без чётких правил — главный источник конфликтов.
Сделайте резервную копию базы 1С и по возможности настройте обмен сначала на тестовой копии и тестовом портале. Ошибочное соответствие полей при первой синхронизации может создать тысячи дублей контрагентов, которые потом придётся вычищать вручную или обработкой.
Настройка штатного модуля: пошаговый порядок
Установите модуль синхронизации в 1С: для типовых конфигураций он поставляется как расширение или встроенный функционал «Синхронизация с Битрикс24» в разделе администрирования и интеграций. После установки в настройках подключения укажите адрес портала и ключ доступа (токен), который генерируется в Битрикс24 при установке приложения интеграции из раздела приложений.
Далее настройте дерево соответствий: какие поля контрагента 1С в какие поля компании и контакта CRM выгружаются, как соотносятся виды цен, единицы измерения, ставки НДС. Особое внимание уделите уникальным идентификаторам связи — модуль хранит соответствие объектов по внутренним ID, и удаление этих связей приводит к повторному созданию объектов.
Включите нужные направления обмена и расписание: синхронизация может выполняться в реальном времени по событиям или регламентным заданием с интервалом. Для баз с большим числом документов реальное время предпочтительнее для счетов и сделок, а справочники разумно обновлять по расписанию, чтобы не грузить портал.
- 1Сделайте резервную копию базы 1С и подготовьте тестовый портал или отдельную воронку
- 2Установите модуль синхронизации в 1С и приложение интеграции в Битрикс24
- 3Введите адрес портала и токен подключения, проверьте соединение
- 4Настройте соответствие полей контрагентов, товаров, цен и ставок НДС
- 5Выполните тестовую выгрузку одного контрагента и одного товара, сверьте результат
- 6Настройте расписание или событийный обмен и включите полную синхронизацию
- 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С является серьёзной уязвимостью.
// Пример: создание лида в Битрикс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 совпадают с видом цен 1С, ставки НДС корректны
Нулевые цены, ошибки НДС при выставлении счёта
Сделка создаёт заказ в 1С, оплата возвращает статус в CRM
Документ не создаётся или статус не обновляется
Ошибок нет или они разобраны и устранены
Повторяющиеся ошибки соединения или соответствия полей
Перед массовой выгрузкой контрагентов почистите справочник в 1С: объедините очевидные дубли и заполните ИНН. Поиск дублей в модуле синхронизации часто опирается на ИНН и наименование, и качество исходных данных напрямую определяет чистоту CRM после обмена.
Ответы на частые вопросы
Работает ли интеграция с облачной 1С (1С:Фреш)?
Да, штатный модуль синхронизации доступен и для баз в сервисе 1С:Фреш при условии, что конфигурация входит в список поддерживаемых. Настройка выполняется так же — через подключение по токену, но возможности публикации собственных HTTP-сервисов в облаке ограничены, поэтому обратный обмен через вебхуки там реализовать сложнее.
Можно ли синхронизировать только контрагентов без товаров и заказов?
Можно. В настройках модуля направления обмена включаются независимо: оставьте активной только синхронизацию контрагентов, а обмен товарами и документами отключите. Это разумный первый шаг перед запуском полного обмена.
Что делать, если после синхронизации появились дубли компаний?
Сначала остановите обмен, чтобы дубли не множились. Затем определите причину: чаще всего это потеря соответствий или разные ключи поиска. Дубли в Битрикс24 объединяйте штатным механизмом контроля дублей CRM, после чего восстановите связи и повторите синхронизацию на малом объёме.
Поддерживается ли обмен с коробочной версией Битрикс24?
Да, модуль работает и с коробкой: в настройках подключения указывается адрес вашего корпоративного портала вместо облачного. Убедитесь, что сервер 1С имеет сетевой доступ к порталу и что на коробке установлены актуальные обновления модуля интеграции.
Кто должен поддерживать интеграцию после запуска?
Штатный модуль обычно обслуживает штатный администратор 1С: контроль журнала обмена, обновление модуля, корректировка соответствий полей. Самописную интеграцию через API должен сопровождать разработчик — при обновлениях конфигурации и изменениях на стороне Битрикс24 код может потребовать доработки.
Передаются ли остатки товаров в реальном времени?
Зависит от режима обмена: при событийной синхронизации остатки обновляются при изменениях в 1С, при обмене по расписанию — с заданным интервалом. Для большинства компаний достаточно обновления несколько раз в час; гарантировать секундную точность остатков в CRM не стоит ни в одном из режимов.
Что важно запомнить
Для типового обмена выбирайте штатный модуль, для нестандартной логики — REST API с участием разработчика. Назначьте систему-мастер для каждого типа данных, настройте соответствия полей и статусов, начинайте с тестовой выгрузки на резервной копии и контролируйте журнал обмена после запуска.