Интеграция с 1С: как сделать обмен данными с внешними системами

Интеграция с 1С — это настройка обмена данными между конфигурацией 1С (Управление торговлей, ERP, Бухгалтерия, ЗУП) и внешней системой: сайтом, CRM, складской программой, банковским сервисом или мобильным приложением. Задача сводится к трём вопросам: какие данные передавать, в какую сторону и каким техническим способом.

Универсального «одного правильного» способа нет. Для обмена с сайтом на 1С-Битрикс обычно достаточно типового модуля обмена по CommerceML, для связи с самописной CRM удобнее REST-подход через HTTP-сервисы или OData, а для интеграции двух баз 1С между собой чаще применяют планы обмена или EnterpriseData. Выбор зависит от платформы внешней системы, требований к скорости обмена и наличия разработчика.

Прежде чем приступать к настройке, зафиксируйте требования в письменном виде: перечень объектов (номенклатура, контрагенты, заказы, остатки, цены), направление обмена по каждому объекту, частоту (реальное время, по расписанию, по событию) и правила разрешения конфликтов. Это избавит от переделок, когда выяснится, что заказы должны идти в обе стороны, а остатки — только из 1С.

Шаг 1. Определите состав и логику обмена

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

Определите идентификаторы связи. В 1С у каждого объекта есть уникальный внутренний идентификатор (GUID), во внешней системе — свой. Нужна таблица соответствия: либо хранить внешний ID в дополнительном реквизите 1С, либо вести регистр соответствий. Без этого при повторной выгрузке вы получите дубли контрагентов и товаров.

Продумайте поведение при удалении и изменении. Если товар пометили на удаление в 1С, что должно произойти на сайте — скрытие, обнуление остатка или ничего? Такие правила лучше зафиксировать до начала разработки, а не после первого инцидента с продажей снятого с производства товара.

Шаг 2. Выберите механизм интеграции

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

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

Шаг 3. Настройте интеграцию через HTTP-сервисы

HTTP-сервисы — наиболее универсальный способ для современных интеграций. Внешняя система отправляет HTTP-запрос (GET, POST) на опубликованный адрес 1С и получает ответ в JSON или XML. Разберём порядок настройки.

В конфигураторе 1С создайте объект «HTTP-сервис» в ветке «Общие». Задайте корневой URL, например api. Добавьте шаблоны URL — например, /orders/* для приёма заказов и /stock для отдачи остатков. Для каждого шаблона создайте метод (GET, POST) и напишите обработчик на встроенном языке: разбор тела запроса, поиск или создание объектов, формирование ответа.

Опубликуйте базу на веб-сервере (IIS или Apache) через диалог «Администрирование — Публикация на веб-сервере», отметив флаг публикации HTTP-сервисов. Настройте аутентификацию: минимум — базовая аутентификация по логину и паролю отдельного пользователя 1С с узкими правами, лучше — дополнительно токен в заголовке запроса и ограничение по IP на уровне веб-сервера.

Функция ordersPOST(Запрос)
    Тело = Запрос.ПолучитьТелоКакСтроку();
    Данные = ПрочитатьJSON(Тело);
    // поиск контрагента, создание документа ЗаказПокупателя
    Ответ = Новый HTTPСервисОтвет(200);
    Ответ.УстановитьТелоИзСтроки("{""orderId"":""" + НомерДокумента + """}");
    Возврат Ответ;
КонецФункции

Проверьте работу сервиса до подключения внешней системы — отправьте тестовый запрос через Postman или curl. Отдельно проверьте поведение при некорректных данных: сервис должен возвращать осмысленный код ошибки (400 с описанием), а не падать с исключением, оставляя незавершённую транзакцию.

1. 1
   Создайте в конфигураторе объект HTTP-сервис и задайте корневой URL
2. 2
   Добавьте шаблоны URL и методы с обработчиками на встроенном языке
3. 3
   Создайте отдельного пользователя 1С с минимально необходимыми правами
4. 4
   Опубликуйте базу на веб-сервере с включённой публикацией HTTP-сервисов
5. 5
   Протестируйте каждый метод через Postman: успешный сценарий и ошибочные данные
6. 6
   Настройте журналирование запросов и ошибок в регистре сведений или журнале регистрации

Шаг 4. Используйте OData для быстрого доступа к данным

OData — автоматический REST-интерфейс, который платформа формирует сама без программирования. После публикации базы на веб-сервере с включённым флагом OData данные становятся доступны по адресу вида /base/odata/standard.odata/. Внешняя система может читать справочники и документы стандартными HTTP-запросами, фильтруя и сортируя данные параметрами запроса.

Чтобы ограничить состав доступных данных, используйте функциональную опцию или настройку «Автоматический REST-сервис» — список объектов, выгружаемых через OData, задаётся в конфигураторе в свойствах корня конфигурации. Никогда не открывайте через OData всё подряд: доступ к регистрам расчётов или персональным данным сотрудников через недостаточно защищённый интерфейс — реальный риск утечки.

OData удобен для отчётных выгрузок, интеграции с Power BI, Excel и несложных сценариев записи. Для высоконагруженного обмена (тысячи запросов в минуту) он подходит плохо: каждый запрос создаёт сеанс на сервере 1С, и при росте нагрузки база начнёт тормозить у всех пользователей.

Шаг 5. Настройте обмен файлами и типовые модули

Для связки 1С с интернет-магазином чаще всего используют типовой модуль обмена с сайтом: в 1С настраивается узел обмена (раздел «Администрирование — Синхронизация данных» или «CRM и продажи» в зависимости от конфигурации), указывается адрес сайта, логин и пароль, состав выгружаемых данных и расписание. Модуль передаёт каталог товаров, цены и остатки на сайт и забирает заказы в формате CommerceML.

Файловый обмен через каталог или FTP остаётся рабочим вариантом, когда внешняя система не имеет API: 1С по регламентному заданию формирует CSV или XML в сетевую папку, внешняя система забирает файлы и кладёт ответные. Обязательно предусмотрите маркер успешной обработки — например, переименование обработанного файла или файл-подтверждение, иначе при сбое не отличить «файл не забрали» от «забрали, но не загрузили».

Шаг 6. Тестирование, мониторинг и типичные ошибки

Тестирование проводите в три этапа. Сначала проверьте каждый объект по отдельности на небольшой выборке: один товар, один контрагент, один заказ. Затем проверьте граничные случаи: товар без цены, контрагент без ИНН, заказ с позицией, которой нет в 1С. В конце — нагрузочный тест на объёме, близком к реальному, чтобы оценить время обмена и влияние на работу пользователей.

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

Когда привлекать специалиста

Самостоятельно можно настроить типовые обмены: с сайтом, банком, ЭДО, простую выгрузку в Excel или CSV. Это штатные функции конфигураций, не требующие программирования — достаточно внимательно следовать настройкам мастера.

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

Частые вопросы