Автоматизация · 13 мин
Как соединить Битрикс и 1С: практическое руководство по интеграции
Как настроить обмен данными между 1С и Битрикс: типовой модуль, CommerceML, REST API. Пошаговая настройка, проверка обмена, типичные ошибки и решения.
Связка «1С + Битрикс» — стандартное решение для интернет-магазинов и корпоративных порталов: товары, цены и остатки ведутся в 1С, а заказы с сайта автоматически попадают в учётную систему. Без интеграции менеджеры вынуждены вручную переносить заказы и обновлять цены, что приводит к ошибкам, расхождениям остатков и продажам товаров, которых нет на складе.
Интеграция строится вокруг типового модуля обмена с сайтом, который входит в состав большинства конфигураций 1С на управляемых формах («Управление торговлей», «Комплексная автоматизация», «ERP»). Модуль обменивается данными с Битриксом по протоколу CommerceML — специальному XML-формату, разработанному совместно 1С и 1С-Битрикс именно для этой задачи.
Ниже разобрано, как подготовить обе системы, настроить обмен, проверить результат и что делать, если данные не синхронизируются. Также рассмотрены альтернативные способы интеграции для нестандартных сценариев.
Какие данные передаются между 1С и Битриксом
Прежде чем настраивать обмен, важно понять, какие сущности участвуют в интеграции и в каком направлении идёт поток данных. От этого зависит, какие настройки потребуются с обеих сторон.
Из 1С на сайт выгружаются: номенклатура (товары, характеристики, свойства), цены по выбранным видам цен, остатки по складам, структура каталога (разделы), а также контрагенты при обмене с B2B-порталом. С сайта в 1С загружаются: заказы с составом, статусами и данными покупателей, а также новые контрагенты, оформившие заказ.
Обмен может быть односторонним (только выгрузка каталога, заказы обрабатываются вручную) или двусторонним. Двусторонний обмен — рабочий стандарт для действующего магазина: заказ, созданный на сайте, через минуты появляется в 1С, а изменение его статуса в 1С может возвращаться на сайт.
Подготовка: что проверить перед настройкой
Интеграция требует согласованной подготовки обеих систем. Пропуск этого этапа — главная причина того, что обмен «вроде настроен», но данные не передаются или передаются с ошибками.
Со стороны Битрикса проверьте: редакцию продукта (обмен с 1С поддерживается в редакциях «Малый бизнес» и выше для «Управление сайтом»), корректность работы сайта по HTTPS (для защищённой передачи данных обмена), наличие свободного места на диске и актуальность обновлений платформы.
Со стороны 1С убедитесь, что конфигурация содержит подсистему «Обмен с сайтом» (присутствует в типовых «Управлении торговлей 11», «Комплексной автоматизации 2», «ERP 2»), а пользователь, от имени которого выполняется обмен, имеет соответствующие права. Если конфигурация сильно доработана, проверьте, не заблокированы ли типовые механизмы обмена.
Отдельно подготовьте данные: заполните в 1С наименования, артикулы, единицы измерения и цены номенклатуры. Мусор в справочниках (дубли, пустые наименования, незаполненные единицы) напрямую перенесётся на сайт и создаст проблемы с каталогом.
Настройка пользователя и прав на стороне Битрикса
Обмен выполняется под учётной записью на сайте, поэтому первый шаг — создать отдельного пользователя для интеграции. Не используйте учётную запись администратора: это риск безопасности и источник проблем при смене пароля.
В административном разделе Битрикса перейдите в «Настройки → Пользователи → Список пользователей» и создайте нового пользователя, например с логином exchange_1c. Добавьте его в группу, которой разрешён обмен с 1С: в типовой поставке это группа «Администраторы» либо специально созданная группа с правами на выполнение обмена.
Проверьте настройку в «Настройки → Настройки продукта → Настройки модулей → Интернет-магазин»: там задаётся, каким группам пользователей разрешён обмен с 1С, а также параметры экспорта заказов (статусы, сайт, типы плательщиков). Если группа пользователя обмена не указана в этой настройке, 1С получит отказ в доступе при подключении.
Настройка узла обмена в 1С
В 1С обмен настраивается через создание узла плана обмена «Обмен с сайтом». Путь зависит от конфигурации: обычно это «Администрирование → Синхронизация данных → Обмен с сайтом» или «CRM и продажи → Настройки интеграции с сайтом».
Создание узла и параметры подключения
Создайте новый узел обмена и заполните основные параметры: адрес сайта в формате https://ваш-сайт.ру, имя пользователя и пароль, созданные на предыдущем шаге. После заполнения нажмите «Проверить соединение» — 1С выполнит тестовый запрос к сайту и сообщит об успехе или покажет текст ошибки.
Если проверка соединения не проходит, типичные причины: неверный адрес (лишний или отсутствующий слэш, http вместо https), пользователь не входит в группу с правом обмена, блокировка со стороны хостинга или файрвола, ограничение на длительность выполнения скриптов на сервере.
Настройка выгрузки товаров и загрузки заказов
На вкладке выгрузки товаров задайте отбор: какие группы номенклатуры выгружать, какой вид цен считать ценой сайта, с каких складов брать остатки. Отбор настраивается через стандартный механизм отборов СКД — можно выгружать, например, только товары с ненулевым остатком или только определённую товарную группу.
На вкладке обмена заказами укажите параметры создания документов: организацию, по которой оформляются заказы, соглашение с клиентом по умолчанию, способ поиска контрагентов (по ИНН, наименованию, e-mail). От корректности этих настроек зависит, не будут ли плодиться дубли контрагентов при каждом заказе.
- 1Создайте резервные копии сайта и базы 1С
- 2Создайте на сайте отдельного пользователя для обмена и дайте ему нужные права
- 3Проверьте настройки модуля интернет-магазина: группы, статусы заказов для выгрузки
- 4В 1С создайте узел обмена с сайтом, укажите адрес, логин и пароль
- 5Проверьте соединение кнопкой «Проверить»
- 6Настройте отбор товаров, вид цен и склады для выгрузки
- 7Настройте параметры загрузки заказов и поиска контрагентов
- 8Выполните первый обмен вручную и проверьте результат на сайте и в 1С
- 9Настройте регламентное задание для автоматического обмена
Первый обмен и проверка результата
Первый обмен запускайте вручную из формы узла обмена кнопкой «Выполнить обмен данными». Полная выгрузка большого каталога может занять продолжительное время — это нормально, модуль передаёт данные порциями.
После завершения проверьте сайт: появился ли каталог в нужном инфоблоке, корректно ли выгрузились цены и остатки, не создались ли дубли разделов. Затем оформите тестовый заказ на сайте и выполните обмен ещё раз — заказ должен появиться в 1С в списке заказов покупателей с корректным составом и контрагентом.
Журнал обмена — главный инструмент диагностики. В 1С ошибки записываются в журнал регистрации и в протокол обмена узла, на стороне Битрикса — в логи обмена. Если часть товаров не выгрузилась, в протоколе будет указана причина: например, отсутствует цена или единица измерения.
Как проверить результат
Товары в нужных разделах, цены и остатки совпадают с 1С
Дубли разделов, товары без цен, пустые наименования
Заказ создан с корректным составом, контрагент найден или создан без дублей
Заказ не загружается, контрагент дублируется при каждом заказе
Передаются только изменения, время обмена короткое
Каждый раз идёт полная выгрузка, обмен длится долго
Нет ошибок, все пакеты обработаны
Ошибки доступа, таймауты, отказ в записи данных
Автоматизация: регламентный обмен по расписанию
Ручной обмен подходит только для тестирования. В рабочем режиме обмен должен выполняться автоматически: товары и остатки — с нужной периодичностью (обычно от нескольких раз в день до ежечасно), заказы — как можно чаще.
Для автоматизации используется регламентное задание в 1С. В настройках узла обмена включите автоматический обмен и задайте расписание. Учтите, что регламентные задания работают в файловой базе только при запущенном сеансе 1С с соответствующей настройкой, а в клиент-серверном варианте — на сервере 1С.
Разумная практика — разделить расписания: полная выгрузка каталога ночью, выгрузка изменений (остатки и цены) — каждые 15–60 минут, загрузка заказов — каждые 5–15 минут в рабочее время. Режим «только изменения» существенно снижает нагрузку и на сайт, и на 1С.
Если остатки на сайте критичны (товаров мало, спрос высокий), не полагайтесь только на периодический обмен. Настройте резервирование при оформлении заказа на сайте и контроль остатков при проведении заказа в 1С — это защитит от продажи отсутствующего товара между сеансами обмена.
Альтернативные способы интеграции
Типовой обмен через CommerceML закрывает большинство сценариев, но не все. Если требуется передавать нестандартные данные (специфические статусы, дополнительные документы, данные самописной конфигурации), рассмотрите альтернативы.
Первый вариант — REST API Битрикса. Из 1С можно выполнять HTTP-запросы к API сайта и передавать любые данные в произвольной структуре. Это гибкий, но трудоёмкий путь: потребуется разработка и на стороне 1С, и, возможно, доработка обработчиков на сайте.
Второй вариант — готовые коннекторы и сервисы интеграции, которые работают как промежуточное звено между 1С и Битриксом. Они подходят, когда нужно быстро связать системы без программирования, но добавляют зависимость от стороннего сервиса и его стоимости.
Третий вариант — обмен через файлы или промежуточную базу данных: 1С выгружает данные в файл (XML, CSV, JSON), а на сайте скрипт по расписанию его обрабатывает. Способ прост в реализации, но требует самостоятельного контроля целостности и актуальности данных.
Сравнение вариантов интеграции
Подходит для стандартного магазина: товары, цены, остатки, заказы. Не требует программирования. Ограничение — только предусмотренные форматом данные.
Подходит для нестандартных данных и тонкой логики. Требует разработки с обеих сторон и последующей поддержки кода.
Подходят для быстрого запуска без разработчиков. Ограничение — стоимость подписки и зависимость от возможностей сервиса.
Подходит для простых сценариев и редких выгрузок. Требует ручного контроля и не обеспечивает оперативность.
Типичные ошибки и способы их устранения
Большинство проблем обмена укладывается в несколько повторяющихся сценариев. Знание их экономит часы диагностики.
Ошибка авторизации при проверке соединения чаще всего означает, что пользователь не входит в группу с правом обмена или пароль содержит символы, некорректно передаваемые в запросе. Проверьте группу пользователя в настройках модуля интернет-магазина и попробуйте временно задать простой пароль из латиницы и цифр.
Обрыв обмена на больших каталогах обычно связан с ограничениями хостинга: максимальное время выполнения скрипта, лимит памяти, таймаут веб-сервера. Решение — уменьшить размер порций в настройках узла обмена (параметры выгрузки частями) и увеличить лимиты на хостинге по согласованию с администратором.
Дубли контрагентов в 1С возникают, когда не настроен поиск существующих контрагентов. Настройте критерии поиска (ИНН + КПП для юрлиц, телефон или e-mail для физлиц) и периодически объединяйте дубли штатной обработкой.
Что важно запомнить
Интеграция Битрикс и 1С строится на типовом модуле «Обмен с сайтом» и формате CommerceML: создайте отдельного пользователя обмена, настройте узел в 1С, проверьте соединение и выполните первый обмен на тестовой копии. Автоматизируйте обмен через регламентные задания, контролируйте протоколы и настройте поиск контрагентов, чтобы избежать дублей.
Частые вопросы
Можно ли связать 1С с Битрикс24, а не с «Управлением сайтом»?
Да, но это другой сценарий. Для Битрикс24 существуют отдельные механизмы интеграции: синхронизация счетов, товаров CRM и контактов через встроенные средства или приложения из каталога Битрикс24. Типовой модуль «Обмен с сайтом» для этого не предназначен — он работает с интернет-магазином на «1С-Битрикс: Управление сайтом».
Как часто нужно выполнять обмен остатками?
Зависит от оборачиваемости товара. При высоких продажах и малом складском запасе — каждые 15–30 минут в режиме выгрузки изменений. При стабильных остатках достаточно нескольких раз в день. Полную выгрузку каталога с картинками разумно делать раз в сутки в нерабочее время.
Почему заказы с сайта не попадают в 1С, хотя товары выгружаются?
Выгрузка товаров и загрузка заказов настраиваются независимо. Проверьте, что в узле обмена включён обмен заказами, а в настройках модуля интернет-магазина на сайте указаны статусы заказов, разрешённые к экспорту. Также проверьте протокол: заказ может отклоняться из-за незаполненной организации или соглашения в параметрах загрузки.
Работает ли обмен, если база 1С файловая и находится в офисе?
Да, обмен инициируется со стороны 1С исходящими запросами к сайту, поэтому открывать входящий доступ к базе не требуется. Достаточно, чтобы с компьютера или сервера 1С был доступ в интернет. Учтите, что регламентный обмен в файловой базе выполняется только при запущенном сеансе 1С.
Что делать, если конфигурация 1С самописная и модуля обмена нет?
Для нестандартных конфигураций есть три пути: внедрить подсистему обмена из типовой конфигурации (требует разработчика 1С), организовать обмен через REST API Битрикса с произвольной структурой данных или использовать выгрузку в файлы с последующей обработкой на сайте. Выбор зависит от объёма данных и требований к оперативности.
Безопасно ли хранить пароль обмена в настройках узла 1С?
Пароль хранится в базе 1С и доступен пользователям с правами на настройку обмена. Минимизируйте риски: используйте отдельного пользователя обмена с минимально необходимыми правами на сайте, сложный уникальный пароль и обязательно HTTPS. Ограничьте круг лиц с доступом к настройкам узла обмена в 1С.