Интеграция Битрикс24 с 1С: полное руководство по настройке обмена данными
Введение
Интеграция Битрикс24 и 1С — одна из самых востребованных задач при внедрении CRM на российских предприятиях. По данным опросов, более 60% компаний, использующих Битрикс24, параллельно ведут учёт в 1С, и ручной перенос данных между системами занимает у менеджеров от 2 до 4 часов в день.
Штатный коннектор к 1С решает эту проблему: он обеспечивает двусторонний обмен данными, автоматизацию документооборота и синхронизацию статусов в реальном времени. В этой статье мы подробно разберём все подсистемы интеграции, схемы обмена для разных конфигураций 1С и дадим пошаговую инструкцию по настройке.
Материал будет полезен как руководителям отдела продаж, так и техническим специалистам, отвечающим за внедрение.
Быстрый старт
| Компонент | Описание |
|---|---|
| Приложение | «Коннектор к 1С» — устанавливается из Маркетплейса Битрикс24 |
| Конфигурации 1С | Управление торговлей, Бухгалтерия, УНФ, УПП, Комплексная |
| Обмен | Двусторонний: сделки ↔ заказы, контакты ↔ контрагенты, товары ↔ номенклатура |
| Режимы | Реального времени, по расписанию, ручной |
| REST API | crm.deal.*, crm.contact.*, crm.product.* |
Что такое коннектор к 1С
Коннектор к 1С — это приложение из Маркетплейса Битрикс24, которое устанавливается в коробочную версию или облачный портал. Он выступает промежуточным звеном между REST API Битрикс24 и HTTP-сервисами 1С, преобразуя форматы данных и управляя очередью обмена.
Основные функции коннектора:
- публикация печатных форм и отчётов 1С в ленте новостей Битрикс24;
- двусторонняя синхронизация справочников (контрагенты, номенклатура, склады);
- автоматическое создание документов в 1С при изменении стадий сделок;
- открытие документов 1С прямо в карточке CRM.
Пять подсистем коннектора
Интеграция включает пять подсистем, каждая из которых отвечает за свой аспект обмена:
| Подсистема | Назначение |
|---|---|
| Экспорт печатных форм и отчётов | Публикует документы 1С (счета, накладные, акты) в ленте новостей или прикрепляет к сделке |
| Интеграция сервисов | Позволяет открывать формы 1С внутри интерфейса Битрикс24 через iframe |
| Автоматизация | Запускает создание документов и бизнес-процессы при наступлении событий в CRM |
| Синхронизация данных | Двусторонний обмен справочниками и документами по расписанию или в реальном времени |
| Смарт-процессы | Расширенная логика с условными переходами, проверками и уведомлениями |
Синхронизация данных: как это работает
Модуль синхронизации — ядро интеграции. Он настраивает соответствие между объектами Битрикс24 и 1С:
| Битрикс24 | 1С | Направление |
|---|---|---|
| Сделка | Заказ покупателя | ↔ двусторонняя |
| Контакт / Компания | Контрагент | ↔ двусторонняя |
| Товарная позиция | Номенклатура | 1С → Битрикс24 |
| Счёт | Реализация / Акт | 1С → Битрикс24 |
| Статус сделки | Статус заказа | ↔ двусторонняя |
У каждой конфигурации 1С свой набор синхронизируемых объектов:
- 1С:Бухгалтерия — обменивается счетами на оплату и актами;
- 1С:Управление торговлей — сделками в Битрикс24 и заказами в 1С, а также остатками и ценами;
- 1С:УНФ — счетами и сделками, а также производственными заказами.
Три режима обмена
| Режим | Как работает | Когда использовать |
|---|---|---|
| Реального времени | Изменения на стороне 1С или Битрикс24 мгновенно запускают синхронизацию через веб-хуки | Оперативная торговля, где важна актуальность статусов в моменте |
| По расписанию | Обмен выполняется автоматически cron-заданием с заданной периодичностью (раз в N минут / часов) | Бухгалтерия: достаточно синхронизации раз в сутки или по окончании рабочего дня |
| Ручной | Менеджер запускает обмен вручную из интерфейса 1С или Битрикс24 | Тестирование после настройки или разовые выгрузки |
REST API Битрикс24: обмен без коннектора
Если штатный коннектор не подходит (например, используется облачная 1С или нужна глубокая кастомная логика), интеграцию можно реализовать напрямую через REST API Битрикс24. Вот как выглядят ключевые запросы:
Создание сделки из 1С
POST /rest/crm.deal.add
{
"fields": {
"TITLE": "Заказ №123 от 21.05.2026",
"CONTACT_ID": 42,
"STAGE_ID": "NEW",
"CATEGORY_ID": 2,
"OPPORTUNITY": "15000.00",
"CURRENCY_ID": "RUB",
"UF_CRM_1C_ORDER_ID": "1c-000123"
}
}Добавление товарных позиций в сделку
POST /rest/crm.deal.productrows.set
{
"id": 123,
"rows": [
{
"PRODUCT_ID": 15,
"PRICE": 5000.00,
"QUANTITY": 2
},
{
"PRODUCT_ID": 22,
"PRICE": 5000.00,
"QUANTITY": 1
}
]
}Получение обновлений статусов (веб-хук из 1С)
В 1С на стороне HTTP-сервиса обрабатывается запрос от Битрикс24 при смене стадии сделки. Пример обработчика на встроенном языке 1С:
Функция ОбработкаДанныхСтатуса(Запрос, Ответ)
Данные = Запрос.JSON;
ИдСделки = Данные.data.FIELDS.ID;
Статус = Данные.data.FIELDS.STAGE_ID;
// Поиск заказа в 1С по внешнему ID
Заказ = Справочники.ЗаказыПокупателей.НайтиПоРеквизиту(
"ВнешнийКод", "B24-" + ИдСделки
);
Если Заказ.Пустая() Тогда
Ответ.УстановитьКодСостояния(404);
Возврат;
КонецЕсли;
// Обновление статуса
Соответствие = Новый Соответствие;
Соответствие.Вставить("NEW", "Принят");
Соответствие.Вставить("PREPARATION", "ВОбработке");
Соответствие.Вставить("EXECUTING", "Отгружен");
Соответствие.Вставить("FINAL_INVOICE", "Закрыт");
Статус1С = Соответствие.Получить(Статус);
Если Статус1С <> Неопределено Тогда
ОбъектЗаказа = Заказ.ПолучитьОбъект();
ОбъектЗаказа.Статус = Статус1С;
ОбъектЗаказа.Записать();
КонецЕсли;
Ответ.УстановитьКодСостояния(200);
Ответ.УстановитьТелоИзСтроки(
"{"+"status": "OK"}"
);
КонецФункцииСценарий работы отдела продаж с 1С:Управление торговлей
Рассмотрим на примере, как выглядит рабочий процесс после настройки интеграции:
- Менеджер создаёт сделку в Битрикс24 — заполняет название, контакт, сумму, прикрепляет коммерческое предложение.
- После перевода сделки в стадию «Подтверждён» коннектор автоматически создаёт заказ в 1С:Управление торговлей. В карточку сделки подгружается печатная форма счёта из 1С.
- Кладовщик отгружает товар в 1С — статус заказа меняется на «Отгружен». Битрикс24 получает уведомление, стадия сделки автоматически переключается на «Отгружен», менеджеру приходит push-уведомление.
- Бухгалтер формирует закрывающие документы в 1С — акт и счёт-фактура публикуются в ленте сделки. Клиент получает ссылку на документы из CRM.
Настройка интеграции: пошаговая инструкция
Шаг 1. Установка коннектора
Перейдите в Маркетплейс вашего Битрикс24, найдите приложение «Коннектор к 1С» и установите его. Для коробочной версии скачайте дистрибутив из раздела «1С-Битрикс24 — Решения для коробочных версий».
Шаг 2. Настройка публикации 1С
В 1С откройте меню «Администрирование» → «Публикация веб-сервисов».
Укажите папку для публикации (обычно C:\inetpub\wwwroot\1c-exchange)
и включите публикацию стандартных HTTP-сервисов для обмена.
Шаг 3. Сопоставление полей
В интерфейсе коннектора укажите соответствия между полями Битрикс24 и реквизитами 1С:
- Поле «Телефон» контакта ↔ Реквизит «Телефон» контрагента;
- Стадия «Успешно» ↔ Статус «Закрыт и оплачен»;
- Пользовательское поле
UF_CRM_1C_ORDER_ID↔ Номер заказа в 1С.
Шаг 4. Настройка роботов и бизнес-процессов
В разделе «CRM» → «Настройки» → «Роботы» создайте правило: при переходе сделки в стадию «Подтверждён» запускать создание заказа в 1С. Используйте действие «Создать документ в 1С».
Шаг 5. Тестирование
Создайте тестовую сделку, проведите её по всем стадиям. Проверьте, что:
- заказ создался в 1С;
- товарные позиции перенеслись в заказ с корректными ценами;
- при изменении статуса в 1С обновилась стадия сделки в Битрикс24;
- печатные формы появились в ленте сделки.
Шаг 6. Запуск в продуктив
Выберите режим обмена — «реального времени» для активных продаж или «по расписанию» для бухгалтерских операций. Обучите команду работе с интеграцией.
Сравнение конфигураций 1С
| Конфигурация | Объекты синхронизации | Особенности |
|---|---|---|
| 1С:Управление торговлей (УТ) | Заказы, Контрагенты, Номенклатура, Цены, Остатки | Полная двусторонняя синхронизация; поддерживает склады и серийный учёт |
| 1С:Бухгалтерия (БП) | Счета на оплату, Акты, Контрагенты | Односторонняя (1С → Битрикс24) для документов; двусторонняя для контрагентов |
| 1С:УНФ | Заказы, Счета, Контрагенты, Номенклатура | Поддерживает производственные заказы и взаиморасчёты |
| 1С:ERP | Все объекты УТ + Бюджетирование, Планирование | Максимальная глубина интеграции; требует дополнительной донастройки под специфику |
Польза интеграции для бизнеса
- Снижение времени на ввод данных — менеджеры перестают дублировать информацию в двух системах, высвобождается до 30% рабочего времени.
- Исключение ошибок ручного ввода — данные о клиенте, товарах и суммах переносятся автоматически, без опечаток и расхождений.
- Прозрачность статусов — менеджер видит актуальный статус заказа (оплачен, отгружен, в пути) прямо в карточке сделки без переключения в 1С.
- Автоматический документооборот — печатные формы (счета, накладные, акты) формируются в 1С и сразу появляются в ленте сделки, доступные клиенту.
- Улучшение клиентского опыта — клиент получает точную информацию о статусе заказа и может скачать закрывающие документы из личного кабинета.
Типовые проблемы и их решение
| Проблема | Причина | Решение |
|---|---|---|
| Не создаётся заказ в 1С | Не настроено соответствие статусов сделки и заказа | Проверьте робота на стадии «Подтверждён»: действие «Создать документ в 1С» должно быть активно |
| Ошибка «Не удалось подключиться к 1С» | Недоступен HTTP-сервис 1С по указанному адресу | Проверьте доступность URL через браузер; убедитесь, что веб-сервер (IIS / Apache) запущен |
| Товары не синхронизируются | Не совпадает GUID номенклатуры или не настроено сопоставление | Запустите полную синхронизацию справочников вручную из коннектора |
| Дублируются контрагенты | Отключена проверка дубликатов при синхронизации | В настройках коннектора включите «Контроль дубликатов по ИНН/email» |
| Печатная форма не публикуется в ленту | Не настроен шаблон печатной формы в 1С для внешнего доступа | В 1С настройте публикацию внешней печатной формы через «Администрирование» → «Печатные формы» |
Чек-лист готовности интеграции
Перед запуском проверьте каждый пункт:
- На сервере 1С опубликован HTTP-сервис для обмена
- URL публикации доступен из сети Битрикс24 (проверено через браузер)
- В Битрикс24 установлен и настроен коннектор к 1С
- Настроено сопоставление полей (контакты, сделки, товары)
- Создан робот для автоматического создания заказов при смене стадии сделки
- Выполнена тестовая синхронизация (создана сделка, проведена по всем стадиям)
- Проверена двусторонняя связь: изменение статуса в 1С отражается в Битрикс24
- Команда обучена работе с интеграцией
Пример кода для кастомной интеграции через REST API
Если вам нужен более гибкий обмен, чем предоставляет штатный коннектор, используйте REST API Битрикс24 напрямую. Ниже — пример PHP-скрипта, который создаёт сделку и передаёт её в 1С через внешний веб-сервис:
<?php
// ============================================================
// Пример интеграции Битрикс24 <-> 1С через REST API
// Создание сделки в Битрикс24 и отправка в 1С
// ============================================================
const B24_WEBHOOK_URL = 'https://ваш-портал.bitrix24.ru/rest/1/ТОКЕН/';
const URL_1C_HTTP_SERVICE = 'http://server-1c/obmen/hs/orders';
// 1. Создаём сделку в Битрикс24
function createDealInB24($data)
{
$response = file_get_contents(B24_WEBHOOK_URL . 'crm.deal.add', false, stream_context_create([
'http' => [
'method' => 'POST',
'header' => 'Content-Type: application/json',
'content' => json_encode(['fields' => $data]),
]
]));
return json_decode($response, true);
}
// 2. Отправляем заказ в 1С
function sendOrderTo1C($orderData)
{
$response = file_get_contents(URL_1C_HTTP_SERVICE, false, stream_context_create([
'http' => [
'method' => 'POST',
'header' => "Content-Type: application/json\r\nAuthorization: Basic " . base64_encode('user:pass'),
'content' => json_encode($orderData),
]
]));
return json_decode($response, true);
}
// Данные сделки
$dealFields = [
'TITLE' => 'Заказ от Иванова И.И.',
'CONTACT_ID' => 42,
'STAGE_ID' => 'NEW',
'OPPORTUNITY' => 25000.00,
'CURRENCY_ID' => 'RUB',
];
// Создаём сделку
$dealResult = createDealInB24($dealFields);
if (!empty($dealResult['result'])) {
$dealId = $dealResult['result'];
// Передаём заказ в 1С вместе с ID сделки
$orderData = [
'external_id' => 'B24-' . $dealId,
'client' => 'Иванов Иван Иванович',
'amount' => 25000.00,
'items' => [
['product' => 'Товар 1', 'quantity' => 2, 'price' => 10000],
['product' => 'Товар 2', 'quantity' => 1, 'price' => 5000],
],
];
sendOrderTo1C($orderData);
echo "Сделка #{$dealId} создана и передана в 1С";
}Заключение
Интеграция Битрикс24 с 1С — это не просто техническое решение, а стратегический шаг в автоматизации бизнес-процессов. Она позволяет синхронизировать заказы клиентов и сделки, исключает ручной ввод данных, ускоряет документооборот и даёт менеджерам полную картину по каждому клиенту без переключения между системами.
Штатный коннектор покрывает 80% типовых задач. Для остальных 20% используйте REST API напрямую — это даёт максимальную гибкость. В любом случае, инвестиции в настройку интеграции окупаются за 1–2 месяца за счёт экономии времени сотрудников и снижения количества ошибок.
Часто задаваемые вопросы
Официально поддерживаются: 1С:Управление торговлей, 1С:Бухгалтерия, 1С:УНФ, 1С:ERP, 1С:Комплексная, 1С:УПП. Для нетиповых конфигураций потребуется доработка HTTP-сервисов на стороне 1С.
Коннектор отслеживает изменения через веб-хуки: при смене стадии сделки в Битрикс24 отправляется запрос в 1С, и наоборот. Сопоставление статусов настраивается в интерфейсе коннектора один раз.
Да, через REST API напрямую, минуя штатный коннектор. Облачная 1С должна предоставлять HTTP-сервис, доступный из интернета. Альтернатива — настроить промежуточный шлюз для трансляции запросов.
Базовая настройка коннектора занимает 2–4 часа. Если требуется кастомизация (нестандартные поля, дополнительные бизнес-процессы) — от 1 до 5 рабочих дней.
Проверьте: запущен ли веб-сервер (IIS/Apache), доступен ли URL публикации 1С из браузера, открыт ли порт в фаерволле, включена ли базовая аутентификация в настройках публикации 1С.
Ключевые моменты
- Коннектор Устанавливается из Маркетплейса Битрикс24; поддерживает коробочные версии 1С с опубликованным HTTP-сервисом
- Обмен Двусторонняя синхронизация сделок ↔ заказов, контактов ↔ контрагентов, товаров ↔ номенклатуры
- Режимы Реального времени (веб-хуки), по расписанию (cron), ручной — выбирается под задачи бизнеса
- REST API Для кастомной интеграции используйте методы
crm.deal.*,crm.contact.*,crm.product.* - Ошибки 80% проблем решаются проверкой доступности HTTP-сервиса 1С и корректностью сопоставления полей
