Какие бывают способы интеграции с 1С
1С:Предприятие поставляется с набором встроенных механизмов интеграции. В документации платформы они описаны так: стандартный интерфейс OData, собственные HTTP-сервисы, SOAP-веб-сервисы, планы обмена с XML-сообщениями, выгрузка и загрузка файлов, формат EnterpriseData, COM-соединение и внешние источники данных для доступа к другим базам.
Главное различие: кто задаёт контракт. OData платформа строит сама по конфигурации. HTTP- и веб-сервисы пишет программист 1С, поэтому контракт ваш. Планы обмена и EnterpriseData — механизмы «1С с 1С» с фиксированным форматом. Файлы — общий знаменатель, когда ничего другого нет.
Перед выбором выясните три вещи: какая конфигурация и версия платформы у заказчика, это своя база или облако, и кто может менять конфигурацию. Последнее решает больше, чем технические предпочтения: собственный HTTP-сервис означает, что программист 1С должен установить код в рабочую базу.
Стандартный интерфейс OData: быстро, но без контроля
1С умеет автоматически генерировать REST-интерфейс на основе протокола OData (версию платформы и поддерживаемые форматы уточните в документации вашего релиза). Базу публикуют на веб-сервере из Конфигуратора с включённым стандартным интерфейсом OData, после чего выбранные для публикации объекты становятся доступны через этот интерфейс.
Плюс в скорости: чтение справочников, документов и регистров, создание и изменение записей через GET, POST, PATCH и DELETE без кода на стороне 1С. Минус в том, что контракт повторяет внутреннее устройство конфигурации. Интеграция зависит от имён объектов, ссылочных ключей и реквизитов, которые бухгалтерская конфигурация может изменить при обновлении.
OData хорош для чтения: прайс, остатки, список контрагентов для сайта или дашборда. Для записи сложных документов (заказ с несколькими шагами проведения) это обычно не тот слой: вы обходите бизнес-логику, которую программист 1С заложил бы в обработчик.
- Подходит: чтение справочников и остатков, простое создание справочных данных, прототипы.
- Осторожно: проведение документов, любые бизнес-правила, всё, что должно пережить обновление конфигурации без правок.
- Цена: нужен веб-сервер и решение, какие объекты открывать.
HTTP-сервисы и веб-сервисы: контракт под вашим контролем
HTTP-сервисы — родной механизм 1С: программист добавляет в конфигурацию HTTP-сервис, задаёт шаблоны URL, привязывает каждый к HTTP-методу и пишет обработчик на языке 1С. Обработчик получает запрос и формирует ответ. Это самое близкое к обычному backend API внутри 1С.
SOAP-веб-сервисы — механизм постарше. Они оправданы, когда другая сторона уже говорит на SOAP или требует WSDL. Для новой интеграции на Go, Node или Python JSON поверх HTTP-сервиса проще тестировать и отлаживать.
Главное преимущество — стабильный контракт. Можно открыть одну операцию, например «создать заказ клиента», а обработчик в 1С выполнит настоящую бизнес-логику и вернёт понятную ошибку. Уточните у программиста 1С, можно ли вынести сервис в расширение конфигурации: от этого зависит, как он переживёт обновление типовой конфигурации. Проектируйте контракт как любой интеграционный API: с версиями и идемпотентной записью. См. проектирование API для интеграций и идемпотентность и повторы запросов.
Практический совет: фиксируйте версию контракта в адресе (например, /v1/orders) и не меняйте поля без согласования. Тогда обновление конфигурации 1С не превращается в сюрприз для сайта, а вы можете развивать обе стороны независимо.
- Подходит: заказы с сайта, обновление статусов, любая запись, которая должна идти через бизнес-логику.
- Нужно: программист 1С на стороне клиента или у нас и способ доставить код в рабочую базу.
- Учесть: аутентификацию, таймауты и то, что сервер 1С не рассчитан на тысячи параллельных запросов.
EnterpriseData и файловый обмен: когда системы обмениваются пакетами
EnterpriseData — бизнес-ориентированный XML-формат на основе XDTO. Каждая конфигурация не изучает все остальные, а преобразует данные в общий формат и обратно. Пакеты можно передавать через каталог, FTP, веб-сервис или почту, полный вариант поддерживает подтверждения получения. Типовой обмен между продуктами 1С, например Бухгалтерия и Управление торговлей, использует его.
Для системы не на 1С EnterpriseData — тяжёлая зависимость: нужно собирать и разбирать большую схему, а расширение под нетиповые поля требует правок с двух сторон. Берите его, когда вторая сторона тоже продукт 1С или уже поддерживает формат.
Обычный файловый обмен (CSV, XML, JSON через ЗаписьXML, ЧтениеXML или запись JSON, доставка по HTTP, FTP или почте) — запасной вариант. Он работает со старыми конфигурациями и закрытыми серверами. Цена: задержка, нет ответа в реальном времени, нужно учитывать недописанные файлы, дубли и кодировки. Относитесь к файлу как к сообщению: идентификатор, контрольная сумма, отметка «обработан».
Почему нельзя обращаться к базе 1С напрямую
Соблазн понятен: данные лежат в SQL-таблицах, почему бы не запросить их? На практике 1С хранит объекты в сгенерированных таблицах с неочевидными именами, дробит поля по нескольким таблицам и меняет структуру между версиями. Запрос, который работает сегодня, сломается после обновления платформы.
Запись ещё хуже. Прямая вставка обходит проведение, права доступа, регистры и движения, база становится внутренне противоречивой. В сообществе 1С также указывают, что прямой доступ к базе противоречит лицензионному соглашению; точную формулировку пункта нам проверить не удалось, поэтому смотрите актуальную редакцию соглашения для вашего случая.
Если нужна аналитика или хранилище, выгружайте данные через OData, HTTP-сервис или плановый обмен и держите копию в собственном Postgres. Если остаётся только читать таблицы, это аварийная мера: только чтение, только на реплике, без записи.
Как выбрать способ интеграции: короткий список
Начните с потока данных, а не с технологии. Выясните, какая система источник истины для каждой сущности, насколько свежими должны быть данные и что происходит при сбое запроса.
Затем подберите шаблон.
Отдельно проверьте нагрузку и окна обслуживания: у 1С бывают регламентные задания, блокировки и перезапуски серверов, поэтому клиент интеграции должен уметь ждать и повторять запрос, а не падать при первой ошибке. Заранее договоритесь, какой объём запросов в минуту допустим для рабочей базы, и держите тестовую копию, на которой можно проверять обновления конфигурации до того, как они дойдут до продакшена.
- Чтение данных на сайт или в дашборд, 1С менять нельзя: OData и кеш на вашей стороне.
- Запись заказов или оплат в 1С с бизнес-правилами: HTTP-сервис в расширении конфигурации, вызов через очередь.
- Синхронизация двух продуктов 1С: типовой обмен через EnterpriseData, а не самописное решение.
- Старая или закрытая база, пакетный обмен раз в ночь подходит: файловый обмен с идентификаторами и контрольными суммами.
- Версия платформы неизвестна или нет доступа программиста: начните с файлов или OData, переход спланируйте позже.
- Никогда: прямая запись в SQL-таблицы.
Интеграция 1С с сайтом, Битрикс и платёжными системами
Сайту от 1С нужны три вещи: каталог с ценами и остатками, способ передать заказ и получить статусы обратно. Каталог и остатки — поток на чтение, подойдут OData или плановая выгрузка. Заказы — поток на запись, надёжнее HTTP-сервис с чётким контрактом ошибок. Не обращайтесь к 1С при каждом просмотре страницы: копируйте данные в свою базу и обновляйте в фоне. См. интеграцию систем через API и вебхуки и фоновые задачи и очереди на Go.
Для сайта на Битрикс стандартный путь — встроенный обмен Битрикс. Он использует XML-формат CommerceML и покрывает каталог, пользователей и заказы. Типовой магазин он закрывает. Сложности начинаются с персональными ценами, нестандартными полями и несколькими складами: тогда добавляют REST API или промежуточный сервис. Точные параметры и настройки скрипта обмена проверьте в официальной документации Битрикс для вашей версии.
С платёжными системами обычно не подключают 1С к провайдеру напрямую. Сайт или небольшой сервис принимает вебхук провайдера, проверяет подпись, один раз фиксирует платёж и передаёт результат в 1С через её HTTP-сервис. Так секреты и повторы остаются вне 1С. Прочитайте про подписи вебхуков и сверьтесь с документацией провайдера по типам событий. Про маркетплейсы — интеграция 1С с маркетплейсами.
Когда кастомная интеграция не нужна и когда нужен подрядчик
Своя разработка не нужна, если готовый коннектор закрывает задачу. Типовой обмен Битрикс для простого магазина или официальный модуль от маркетплейса или платёжного провайдера дешевле, чем разработка с нуля. Не нужна она и когда вы переносите несколько записей в месяц: ручная выгрузка может быть честным ответом.
Подрядчик нужен, когда поток пишет в 1С, когда нужно держать согласованными несколько систем (сайт, CRM, маркетплейс, оплата) или когда сбой стоит денег: потерянные заказы, двойные списания, неверные остатки. Это работа с очередями, повторами и мониторингом не меньше, чем работа с 1С, и именно здесь интеграции чаще всего ломаются. Хороший подрядчик спросит, кто владеет конфигурацией 1С, попросит тестовую базу и предложит контракт и отчёт сверки до написания кода.
Если проблема внутри самой 1С (логика отчёта, доработка конфигурации), нужен специалист по 1С, а не студия интеграций. Лучшая схема — две роли: одна со стороны 1С, другая со стороны интеграции, и один письменный контракт между ними. Для потоков CRM и ERP см. интеграцию CRM и ERP.