N3S
Связаться

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

API 1С для интеграций: HTTP-сервисы, OData и COM

API 1С для интеграций: HTTP-сервисы, OData и COM

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

HTTP-сервисы

Произвольные сервисы, которые разработчик описывает в конфигурации в ветке «Общие», «HTTP-сервисы». У сервиса есть шаблоны адресов с параметрами и методы с привязкой к HTTP-методам. Запрос приходит объектом «HTTPСервисЗапрос», ответ формируется объектом «HTTPСервисОтвет», данные можно отдавать в JSON, XML или текстом. Если адрес не совпал ни с одним шаблоном, платформа отвечает 404.

Это основной инструмент для своих интеграций: внешняя система получает понятный REST-подобный интерфейс под конкретную задачу, например «отдать остатки по складу», «принять заказ», «вернуть статус документа». Логика проверки и записи остаётся в 1С, и это правильно: внешняя система не должна знать устройство конфигурации.

Публикуется так же, как веб-сервисы, через публикацию на веб-сервере, аутентификация и разделение данных работают так же.

Стандартный интерфейс OData

Платформа умеет автоматически публиковать REST-интерфейс ко всем объектам конфигурации по протоколу OData: справочники, документы, регистры доступны по адресам вида «odata/standard.odata/Catalog_Номенклатура». Включается при публикации из конфигуратора флажком о публикации стандартного интерфейса OData, поддерживает фильтры, выбор полей и формат JSON. Программирования на стороне 1С не требуется.

Подходит для чтения справочников и остатков внешними системами и для простых записей. Не подходит, когда запись требует бизнес-логики: проведение документа с проверками, подбор договора, расчёт цен. В таких случаях запись делается HTTP-сервисом, а OData остаётся для чтения. Ограничения доступа задаются ролями пользователя, под которым работает внешняя система, и этот пользователь не должен быть администратором.

Веб-сервисы SOAP

Старший механизм, описывается в конфигурации по WSDL. Работает, но для новых интеграций мы его не выбираем: HTTP-сервисы проще для клиента, меньше объём данных и меньше нагрузка, как отмечает сама 1С.

COM-соединение

Два варианта только для Windows: Automation-сервер, который запускает полноценный клиент 1С, и внешнее соединение, компактный COM-сервер с функциями бизнес-логики. 1С относит их к устаревшим и оставленным для совместимости. Используются в старых интеграциях и в скриптах на том же сервере, для новых проектов не подходят: привязка к Windows, хрупкость при обновлениях, сложности с правами.

Планы обмена и файлы

Для обмена между базами 1С и с системами, понимающими формат EnterpriseData, работают планы обмена с регистрацией изменений: передаются только изменённые данные, сообщения нумеруются и квитируются. Транспорт: файловый каталог, FTP, веб-сервис или почта, по расписанию или вручную. Это правильный механизм для связки 1С:УТ и 1С:Бухгалтерия или для обмена с филиалами, и неправильный для сайта или CRM, которым нужны ответы в реальном времени.

Что подготовить на стороне 1С

  1. Публикация на веб-сервере. Apache или IIS, доступ по HTTPS, отдельный адрес для сервисов.
  2. Отдельный пользователь для внешней системы с минимальными правами и аутентификацией по паролю или токену.
  3. Тестовая база с публикацией, идентичной боевой. Интеграция сначала живёт там.
  4. Расширение конфигурации для HTTP-сервисов, чтобы не трогать типовую конфигурацию и не ломать обновления.
  5. Журнал вызовов внутри 1С: кто, когда, с какими параметрами, с каким результатом. Без него разбор инцидентов превращается в гадание.
  6. Регламент обновлений. Кто проверяет сервисы после обновления конфигурации, потому что обновление может изменить реквизиты.

Как мы выбираем

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

Для Битрикс24 и сайта поверх этих механизмов ставится сервис обмена с очередью и защитой от дублей, схемы описаны в статьях об интеграции Битрикс24 с 1С и об интеграции 1С с сайтом. Как мы делаем такие интеграции, на странице услуги, а три паттерна связки 1С и собственной системы учёта в отдельной статье.

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

Нужна ли лицензия на дополнительных пользователей для внешней системы? Внешняя система подключается под пользователем 1С, и каждое одновременное соединение занимает лицензию. При частых запросах соединения нужно закрывать, а при высокой нагрузке держать пул соединений и считать лицензии заранее.

Что быстрее: OData или HTTP-сервис? Для чтения одного справочника разница невелика. Для сложных выборок HTTP-сервис быстрее, потому что запрос к базе пишется разработчиком с учётом индексов, а OData строит его автоматически.

Можно ли обойтись без публикации на веб-сервере? Нет, HTTP-сервисы и OData работают только через веб-сервер. Без публикации остаются планы обмена с файлами и устаревшее COM-соединение.

Кто сопровождает интеграцию после запуска? Обычно разработчик 1С отвечает за сервисы внутри базы, а команда интеграции за сервис обмена между системами. Границу ответственности лучше закрепить письменно до старта.

Источники

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

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