N3S
Связаться

← Все статьи · Enterprise · 16 ноября 2026 г. · 4 мин чтения

Модуль интеграции 1С: что это и когда нужен свой

Модуль интеграции 1С: что это и когда нужен свой

Когда заказчик просит «модуль интеграции с 1С», сначала нужно понять, о чём речь. У платформы 1С:Предприятие 8.3 есть десяток встроенных механизмов обмена, у вендоров сервисов есть готовые расширения, а под нестандартный процесс пишется свой модуль. Ниже три уровня с границами каждого по документации 1С.

Уровень 1. Что уже есть в платформе

Страница «Интеграция» на сайте платформы перечисляет механизмы: HTTP-сервисы, веб-сервисы, REST-интерфейс OData, обмен данными через планы обмена, XML и JSON, XDTO, Automation-сервер, внешние компоненты, внешнее соединение COM, 1С:Шина, система взаимодействия, WebSocket-клиент. Для интеграций с внешними системами на практике важны четыре.

HTTP-сервисы: объект конфигурации с шаблонами URL вида {параметр}, для каждого метода свой обработчик на встроенном языке, публикуются на веб-сервере так же, как веб-сервисы. Это основной инструмент для событийного обмена: внешняя система вызывает 1С, 1С отвечает JSON.

REST-интерфейс OData версии 3.0: формируется для всей конфигурации автоматически, без программирования, даёт чтение, создание, изменение и удаление справочников, документов, регистров с проверкой прав и обработчиками событий. Платформа реализует только серверную часть, то есть 1С отдаёт данные, но сама никого не вызывает.

Планы обмена и формат EnterpriseData: бизнес-ориентированный XML, версия 1.0.1 описывала 94 типа сущностей, текущая версия 1.25 выпущена 31 августа 2026 года, поддержка версии гарантируется год после выхода следующей; встроен в Бухгалтерию 3, Управление торговлей 11, ERP 2, Комплексную автоматизацию, ЗУП; для внешних систем доступен через веб-сервис с методами GetData и PutData, каталог, FTP или почту. Конвертация данных 3.0 это инструмент разработки обменов именно через EnterpriseData.

Внешнее соединение COM: внутрипроцессный COM-сервер, быстрее Automation-сервера, с пулом соединений; работает там, где есть COM, то есть на Windows. Подробный разбор HTTP-сервисов, OData и COM с примерами в статье об API 1С для интеграций.

Отдельно 1С:Шина: продукт класса ESB с коннекторами SOAP, JMS, AMQP и RabbitMQ, JDBC, HTTP и REST, Kafka, файлы и FTP, с гарантированной доставкой через хранилище на диске; новые коннекторы делают только разработчики Шины. Есть и «1С:Интеграция КОРП» с канонической моделью данных для клиент-серверных установок. Это уровень холдинга с десятком систем, для одной интеграции это избыточно.

Уровень 2. Готовые модули вендоров

Большинство сервисов поставляют модуль для 1С в виде расширения конфигурации или внешней обработки. Коннектор Битрикс24: ставится в 1С как расширение, типовую конфигурацию менять не требуется, в Бухгалтерии синхронизируются счета, в Управлении торговлей сделки и заказы, в УНФ счета и сделки, поддерживаются смарт-процессы с полями и статусами, режимы реального времени, ручной и по расписанию; для работы нужно опубликовать HTTP-сервисы расширения на порту 443. Если под конфигурацию модуля нет, справка предлагает адаптировать любой подходящий. Три схемы связки с Битрикс24 разобраны в отдельной статье.

Обмен с сайтом: открытый протокол на основе CommerceML 2, разработанный 1С и 1С-Битрикс, инициатор всегда 1С, режимы checkauth, init, file, import для каталога и query, success для заказов; встроен в УНФ, Комплексную автоматизацию и Управление торговлей, поддерживается большинством CMS. Как это работает на практике, в статье об интеграции 1С с сайтом. Модули сервисов Контура разобраны в соседней статье.

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

Уровень 3. Когда нужен свой модуль

Свой модуль нужен, когда готовый не повторяет процесс. Признаки:

  • Нестандартная или сильно доработанная конфигурация, под которую вендорского модуля нет.
  • Правила сопоставления объектов свои: номенклатура сопоставляется по артикулу поставщика и характеристике, контрагенты по ИНН и КПП с ручной очередью спорных.
  • Двусторонний обмен с конфликтами: одна и та же сущность меняется с обеих сторон, нужно правило, кто главный по каждому полю.
  • Объёмы: десятки тысяч строк остатков в час, которые OData тянет минутами, а пакетный HTTP-сервис отдаёт за секунды.
  • Нужны очередь, повторы и журнал: что ушло, что не дошло, почему, с возможностью переотправить.
  • Вторая система не 1С и не сайт: своя ERP, WMS, портал, где обмен идёт по событиям.

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

Как сделать свой модуль и не слететь с поддержки

  1. Только расширение, без изменения типовой конфигурации; назначение расширения «Адаптация», безопасный режим отключается осознанно и только для нужных операций.
  2. Никакой бизнес-логики в типовых объектах: модуль читает и пишет через стандартные документы и проводит их штатно, чтобы работали проверки и события.
  3. Контракт обмена описан как документ: сущности, поля, кто главный по каждому полю, идентификаторы, формат ошибок.
  4. Идемпотентность: повторная отправка того же пакета не создаёт дубль, у каждой записи внешний ключ.
  5. Журнал обмена в обеих системах с возможностью переотправки одной записи.
  6. Тест на копии базы после каждого обновления типовой конфигурации, расширение проверяется на применимость автоматически.
  7. Версионирование формата: новая версия модуля читает старые пакеты.

Как выбрать уровень

  • Нужно отдать данные из 1С в отчётность или BI: OData без разработки.
  • Нужен обмен с сервисом, у которого есть модуль: ставить модуль, проверив конфигурацию и версию платформы.
  • Нужен обмен с сайтом: CommerceML и встроенный обмен.
  • Нужен обмен со своей системой или с правилами, которых нет в готовом: свой модуль как расширение с HTTP-сервисами.
  • Нужна шина для десятка систем: 1С:Шина или аналог.

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

Источники

Есть тема для статьи или задача? Расскажите.

Обсудить проект →