Сегодня 1С — это не просто учетная система, которая живет отдельно от остальных ИТ-инструментов компании. Все чаще она становится частью единой цифровой экосистемы: обменивается данными с сайтами, мобильными приложениями, интернет-магазинами, CRM, логистическими сервисами и другими внешними системами. Чтобы такая интеграция работала корректно, в платформе «1С:Предприятие» используются специальные механизмы обмена данными. Одни из ключевых — веб-сервисы и HTTP-сервисы. На первый взгляд, эти понятия похожи: и те, и другие позволяют обращаться к данным и функциональности 1С через интернет-протоколы. Но на практике они решают разные задачи, работают по разным принципам и подходят для разных сценариев.

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

В платформе «1С:Предприятие» существует два основных механизма для предоставления доступа к данным и функциональности через интернет-протоколы: веб-сервисы (Web Services) и HTTP-сервисы. Несмотря на схожесть названий, они предназначены для решения совершенно разных задач и работают по разным принципам.

Основное различие заключается в том, что веб-сервис — это инструмент для межпрограммного взаимодействия (машина с машиной), а HTTP-сервис — это инструмент для создания программных интерфейсов, ориентированных на пользователя или клиентское приложение (человек/браузер с программой).

Рассмотрим их ключевые отличия подробнее.

Веб-сервисы (Web Services)

Веб-сервисы в 1С чаще всего реализуют протокол SOAP (Simple Object Access Protocol). Это более "тяжелая" и формализованная технология.

• Назначение: Интеграция между информационными системами. Их главная задача — вызвать конкретную функцию на стороне сервера 1С из другой программы (другой базы 1С, сайта на PHP, мобильного приложения).
• Формат данных: Исторически основной формат — XML. Платформа автоматически формирует WSDL-файл (описание сервиса) и упаковывает все данные в XML-сообщения. Работа с JSON возможна, но требует дополнительных усилий по сериализации/десериализации.
• Принцип работы: Вызов происходит через строго определенные операции (методы). Клиент отправляет запрос на вызов конкретной операции с набором параметров, а сервер возвращает структурированный ответ. Это похоже на вызов функции в коде, только через сеть.
• Структура URL: Запрос всегда идет по одному и тому же адресу (точке входа в сервис), а конкретная операция определяется не адресом, а содержимым SOAP-конверта.
• Пример использования: Мобильное приложение курьера обращается к веб-сервису в центральной базе 1С с командой GetOrdersForToday, передавая ID курьера. База 1С обрабатывает запрос и возвращает список заказов в формате XML.

HTTP-сервисы

Это более современный, легкий и гибкий механизм, появившийся в последних версиях платформы. Он позволяет создавать аналоги REST API.

• Назначение: Создание пользовательских интерфейсов (frontend) для приложений, интеграция с современными веб-сайтами и SPA (Single Page Application), предоставление данных в удобном для JavaScript виде.
• Формат данных: Гибкий выбор. Вы можете настроить HTTP-сервис так, чтобы он принимал и возвращал данные в любом формате, но наиболее распространенные — JSON и XML. JSON является стандартом де-факто для современных веб-технологий.ё
• Принцип работы: Основан на использовании стандартных методов HTTP (GET, POST, PUT, DELETE) и адресации через URL. Каждая конечная точка (URL) соответствует определенному ресурсу или действию.
• Структура URL: Ключевое отличие. Логика сервиса распределена по URL-адресам.
  
  Например:

GET /api/v1/customers — получить список клиентов.

GET /api/v1/customers/15 — получить информацию о клиенте с ID=15.
POST /api/v1/orders — создать новый заказ.

• Пример использования: На сайте компании есть страница со списком товаров. JavaScript-код на этой странице делает асинхронный GET-запрос к HTTP-сервису 1С по адресу /goods/list. Сервис возвращает массив товаров в формате JSON, который сайт тут же отрисовывает на странице без перезагрузки.

Веб-сервисы "1С:Предприятие"

В основе этой технологии лежит понятие веб-сервиса — это программный модуль, который принимает запросы по стандартным протоколам (HTTP/HTTPS) и возвращает данные в структурированном виде, чаще всего в формате XML или JSON.

Как это работает

Для создания веб-сервиса в среде 1С не требуется писать код на сторонних языках вроде PHP или Python. Вся логика реализуется встроенными средствами платформы:

1. Создание объекта. В конфигураторе создается новый объект типа «Web-сервис».
2. Определение URI пространства имен. Это уникальный идентификатор вашего сервиса, необходимый для корректной работы протокола SOAP.
3. Разработка операций. Внутри веб-сервиса создаются операции (аналоги функций). Для каждой операции задаются параметры ввода и тип возвращаемого значения.
4. Написание кода. На встроенном языке 1С пишется алгоритм обработки запроса внутри этих операций.
5. Публикация. Чтобы сервис стал доступен извне, его необходимо опубликовать через веб-сервер (Apache или IIS) или сервер администрирования кластера 1С.

Платформа автоматически генерирует WSDL-описание (Web Services Description Language) — специальный файл, который служит инструкцией для других систем о том, как подключаться к вашему сервису, какие методы доступны и какие данные они принимают.

Основные сценарии использования

Веб-сервисы на 1С являются мощным инструментом для интеграции. Вот несколько распространенных примеров их применения:

• Интеграция с интернет-магазинами. Веб-сервис может в реальном времени получать заказы с сайта, проверять остатки товаров на складе, резервировать продукцию и передавать статус оплаты обратно в CMS сайта.
• Мобильные приложения. Курьерские службы часто используют мобильные приложения для смартфонов. Приложение обращается к веб-сервису 1С для получения списка заказов на день, отправки отчета о доставке или изменения статуса заказа.
• Обмен данными между базами 1С. Если у компании есть несколько информационных баз (например, центральная база и базы филиалов), веб-сервисы позволяют организовать надежный обмен данными без прямого подключения к базе данных. 
• Взаимодействие со сторонними системами. Сервисы используются для передачи данных в логистические системы, сервисы SMS-рассылок, государственные порталы и другие внешние ресурсы.

Преимущества и недостатки

Преимущества:

1. Единая среда разработки: Не нужно переключаться между разными технологиями; вся логика бизнеса уже написана на 1С.
2. Прямой доступ к данным: Веб-сервис имеет полный доступ ко всем объектам конфигурации (справочникам, документам, регистрам), что упрощает обработку запросов.
3. Безопасность: Интеграция происходит внутри защищенного периметра предприятия, а все механизмы аутентификации платформы остаются в силе.

Недостатки:

• Производительность: Обработка HTTP-запросов может быть менее производительной по сравнению со специализированными фреймворками из-за накладных расходов самой платформы.
• Специфика формата: Исторически 1С сильна в работе с форматом XML (SOAP), работа с JSON требует дополнительных преобразований, хотя современные версии платформы значительно упростили этот процесс.

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

HTTP-сервисы

HTTP-сервисы в платформе «1С:Предприятие» — это современный и гибкий механизм, предназначенный для создания собственного REST API (Application Programming Interface). Если традиционные веб-сервисы (SOAP) ориентированы на межсистемное взаимодействие по строгому контракту, то HTTP-сервисы предоставляют полный контроль над обработкой входящих HTTP-запросов, что делает их идеальным инструментом для интеграции с веб-сайтами, мобильными приложениями и другими внешними системами. Этот функционал появился в платформе 8.3.7 и стал стандартом де-факто для разработки современных интеграционных решений.

В основе работы HTTP-сервисов лежат два фундаментальных понятия:

• URL-шаблон (Шаблон URL) — это адрес, по которому клиенты будут обращаться к вашему сервису. Он задается при создании сервиса в конфигураторе. Например, /api/v1/orders. Внутри этого шаблона можно задавать параметры, которые будут извлекаться из URL.
• Метод запроса (HTTP Method) — определяет действие, которое клиент хочет совершить. Основные методы:

GET — получить данные (чтение).

POST — создать новый ресурс.

PUT / PATCH — обновить существующий ресурс.

DELETE — удалить ресурс.

Для каждой комбинации "URL-шаблон + Метод" в конфигурации создается отдельный шаблон URL, для которого пишется обработчик на встроенном языке 1С.

Создание HTTP-сервиса в Конфигураторе

Процесс настройки состоит из нескольких шагов:

• Добавление объекта: В дереве метаданных вашей конфигурации добавляется объект типа «HTTP-сервис».
• Задание корневого пути: Указывается корневой URI, например api.
• Создание шаблонов URL: Для каждого действия вашего API создается шаблон. Например:

Шаблон: goods/{id_goods}; Метод: GET (получить товар по ID).

Шаблон: goods; Метод: GET (получить список всех товаров).

Шаблон: orders; Метод: POST (создать заказ).

• Написание кода обработки: Для каждого шаблона открывается модуль, где вы пишете код на встроенном языке 1С. В этом коде вам доступны специальные объекты:

Запрос (HTTPСервисЗапрос): Позволяет получить доступ к параметрам URL, заголовкам, телу запроса и файлам.

Ответ (HTTPСервисОтвет): Объект, который вы заполняете данными для отправки клиенту (код состояния, тело ответа, заголовки).

Пример реализации: Простой каталог товаров

Представим, что нам нужно создать API для получения списка товаров.

Шаг 1: Настройка в конфигураторе

1. Создаем HTTP-сервис с именем CatalogAPI и корневым путем api.
2. Добавляем в него шаблон URL с именем GetGoodsList, установив путь goods и метод GET.

Шаг 2: Код в модуле шаблона

Вот как будет выглядеть код обработки этого запроса:

// Обработчик GET-запроса по адресу /api/goods

Процедура ПолучитьСписокТоваров(Запрос, Ответ)

    // 1. Получаем данные из базы

    ЗапросКБазе = Новый Запрос;

    ЗапросКБазе.Текст = "ВЫБРАТЬ Наименование, Артикул ИЗ Справочник.Номенклатура ГДЕ НЕ ПометкаУдаления";

    Результат = ЗапросКБазе.Выполнить();

    // 2. Преобразуем результат в JSON

    Выборка = Результат.Выбрать();

    МассивТоваров = Новый Массив;

    Пока Выборка.Следующий() Цикл

        Товар = Новый Структура("Наименование, Артикул", Выборка.Наименование, Выборка.Артикул);

        МассивТоваров.Добавить(Товар);

    КонецЦикла;

    // Используем стандартный инструмент сериализации

    ЗаписьJSON = Новый ЗаписьJSON;

    ЗаписьJSON.УстановитьСтроку();

    ЗаписатьJSON(ЗаписьJSON, МассивТоваров); // Сериализуем массив структур в JSON-строку

    // 3. Формируем ответ

    Ответ.Заголовки.Вставить("Content-Type", "application/json"); // Указываем тип содержимого

    Ответ.УстановитьТелоИзСтроки(ЗаписьJSON.Закрыть());

    Ответ.КодСостояния = 200; // OK

КонецПроцедуры

Преимущества использования HTTP-сервисов

• Гибкость и контроль: Вы полностью контролируете каждый этап обработки запроса: от парсинга URL до формирования тела ответа и установки HTTP-заголовков.
• Современность: Легкая интеграция с любым современным фронтендом (React, Vue.js, Angular), мобильными приложениями и сторонними системами благодаря поддержке формата JSON.
• Соответствие принципам REST: Возможность проектировать API, понятные любому современному разработчику, используя стандартные методы HTTP (GET, POST и т.д.).
• Работа с файлами: Через HTTP-сервисы можно реализовать загрузку файлов в базу 1С или отправку файлов из нее.
• Безопасность: Можно легко реализовать различные схемы аутентификации (например, через токены в заголовках запроса) перед выполнением основной логики.

Таким образом, HTTP-сервисы являются мощным и незаменимым инструментом для любого 1С-разработчика, занимающегося интеграцией и созданием комплексных IT-решений.

Подведем итог

Веб-сервисы и HTTP-сервисы в 1С решают одну общую задачу — помогают системе обмениваться данными с внешним миром. Но выбирать между ними важно не по принципу «что современнее», а по тому, какая интеграция нужна бизнесу. Если требуется надежное межсистемное взаимодействие по строгому контракту, например между корпоративными системами или несколькими базами 1С, чаще подходит веб-сервис с SOAP и WSDL. Он удобен там, где важна формализованная структура обмена и предсказуемость взаимодействия.

Если же нужно связать 1С с сайтом, мобильным приложением, личным кабинетом или современным frontend-решением, чаще эффективнее использовать HTTP-сервис. Он дает больше гибкости, позволяет работать с JSON, стандартными HTTP-методами и выстраивать API в привычной для веб-разработчиков логике.

Правильно выбранный механизм интеграции помогает не просто «соединить системы», а сделать обмен данными устойчивым, понятным и удобным для дальнейшего развития. Поэтому перед запуском проекта важно оценить не только текущую задачу, но и то, как интеграция будет масштабироваться вместе с бизнесом.


АВТОР СТАТЬИ - Алексей Самохвалов, программист 1С компании Диалог ИТ. 

Статья была полезной?

Еще больше новостей в нашем Telegram-канале t.me/dialog_it - анонс вебинаров, бизнес-новости, лайфхаки по 1С 

Для того, чтобы купить, установить, настроить программы или сервисы 1С, а также по всем вопросам позвоните нам по номеру +7 (812) 704-80-93 или напишите it@dialogit.ru