Как настроить выгрузку данных из документа 1С в интернет-магазин через веб-сервис?

Интеграция 1С с интернет-магазинами — одна из наиболее частых прикладных задач. Часто возникает необходимость передавать данные напрямую из документов учетной системы (например, номенклатуру, цены, остатки из документа реализации или установки цен) во внешнюю систему через предоставленный сайтом веб-сервис. Разберем по шагам, как устроена архитектура такого взаимодействия, какие объекты платформы 1С используются для SOAP- и REST-сервисов, как правильно сформировать выборку данных и избежать зависаний интерфейса при вызове методов сервиса.

Архитектура взаимодействия: SOAP против REST

Перед тем как приступать к написанию кода в 1С, выясним тип протокола, по которому работает API интернет-магазина:

1. SOAP-сервисы: взаимодействуют по строго описанному контракту (WSDL-схема). В 1С для работы с ними используются метаданные WS-ссылки, а также объекты WSОпределения и WSПрокси. Обмен данными строится на структурированных пакетах XML и типах XDTO.
2. HTTP/REST-сервисы: отправляют запросы напрямую по URL-путям методами GET, POST, PUT, DELETE, а данные передаются в теле запроса (обычно в формате JSON). Для интеграции с REST-сервисами в 1С применяются объекты HTTPСоединение и HTTPЗапрос.

Шаг 1. Получение данных из документа с помощью запроса

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

Посмотрим на пример запроса к документу реализации:

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

Запрос.УстановитьПараметр("ТекущийДокумент", ДокументСсылка);
РезультатЗапроса = Запрос.Выполнить();
Выборка = РезультатЗапроса.Выбрать();

Шаг 2. Подключение к веб-сервису через статическую WS-ссылку

Если в конфигурацию уже добавлена WS-ссылка (импортирована WSDL-схема сервиса сайта), подключение к сервису выполняется через генерацию прокси-объекта.

Разберем пример создания прокси и вызова операции сервиса:

// Создание WS-прокси на основе статической ссылки
Прокси = WSСсылки.WSСсылка1.СоздатьWSПрокси("http://site.ru/ws", "IrtService", "WS_IServiceSoap");
Прокси.Пользователь = "ЛогинAPI";
Прокси.Пароль = "ПарольAPI";

Пока Выборка.Следующий() Цикл
    // Вызов удаленного метода для каждого товара
    Ответ = Прокси.GetProductCountInName(Выборка.Наименование, Выборка.Количество);
    Сообщить("Результат отправки по товару " + Выборка.Наименование + ": " + Строка(Ответ));
КонецЦикла;

Важно: Использование статических WS-ссылок имеет существенное ограничение. Если структура WSDL, методы или адреса на стороне интернет-магазина изменяются, в 1С требуется повторно обновлять схему через конфигуратор. Кроме того, статические ссылки жестко привязаны к конфигурации и усложняют переключение между тестовым и рабочим серверами.

Шаг 3. Динамическое подключение через WSОпределения и WSПрокси

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

Рассмотрим пример создания динамического соединения с передачей учетных данных и параметров таймаута:

АдресWSDL = "https://site.ru/ws/service.wsdl";
Логин = "api_user";
Пароль = "secret_pass";
Таймаут = 30; // таймаут в секундах

// Настройка защищенного соединения для протокола HTTPS
ЗащищенноеСоединение = Новый ЗащищенноеСоединениеOpenSSL();

// Инициализация WSDL-определений
Определения = Новый WSОпределения(АдресWSDL, Логин, Пароль, , Таймаут, ЗащищенноеСоединение);

URIПространстваИмен = Определения.Сервисы[0].URIПространстваИмен;
ИмяСервиса = Определения.Сервисы[0].Имя;
ИмяТочкиПодключения = Определения.Сервисы[0].ТочкиПодключения[0].Имя;

// Создание динамического WS-прокси
Прокси = Новый WSПрокси(Определения, URIПространстваИмен, ИмяСервиса, ИмяТочкиПодключения, , Таймаут, ЗащищенноеСоединение);
Прокси.Пользователь = Логин;
Прокси.Пароль = Пароль;

Пока Выборка.Следующий() Цикл
    Попытка
        Результат = Прокси.UpdateProduct(Выборка.Артикул, Выборка.Количество, Выборка.Сумма);
    Исключение
        Сообщить("Ошибка при отправке: " + ОписаниеОшибки());
    КонецПопытки;
КонецЦикла;

Шаг 4. Работа со сложными типами (Фабрика XDTO)

Часто веб-сервисы сайтов принимают не скалярные параметры (строка, число), а сложные составные структуры данных XML-схемы. В таком случае передача простых переменных вызовет ошибку сериализации.

Проанализируем, как создавать составные объекты через фабрику XDTO:

// Получение фабрики типов из определений или прокси
Фабрика = Прокси.ФабрикаXDTO;

// Определение типа объекта из схемы сервиса
ТипТовара = Фабрика.Тип(URIПространстваИмен, "ProductItem");

// Создание объекта XDTO и заполнение его свойств
ОбъектТовар = Фабрика.Создать(ТипТовара);
ОбъектТовар.Article = Выборка.Артикул;
ОбъектТовар.Name = Выборка.Наименование;
ОбъектТовар.Quantity = Выборка.Количество;
ОбъектТовар.Price = Выборка.Сумма;

// Передача готового XDTO-объекта в метод сервиса
Ответ = Прокси.SaveProductData(ОбъектТовар);

Причины зависания при вызове веб-сервисов и способы их устранения

При тестировании выгрузки разработчики часто сталкиваются с ситуацией, когда обработка бесконечно ожидает ответа, блокируя интерфейс программы. Выясним основные причины такого поведения:

1. Отсутствие ограничения по таймауту. В обычном приложении 1С синхронный сетевой вызов выполняется в основном потоке. Если сервер магазина не отвечает, сеанс пользователя блокируется. Всегда указывайте параметр таймаута в конструкторах WSОпределения, WSПрокси или HTTPСоединение.
2. Ошибки аутентификации. При использовании Basic-аутентификации указание свойств Прокси.Пользователь и Прокси.Пароль постфактум может не сработать для первичного WSDL-запроса. Передавайте логин и пароль непосредственно в параметры конструкторов.
3. Проблемы с HTTPS и сертификатами. Если сайт работает по безопасному протоколу, обращение без указания ЗащищенноеСоединениеOpenSSL может завершиться сбоем или зависанием на этапе проверки SSL-рукопожатия.
4. Синхронная отправка большого объема данных. Если требуется выгружать множество документов, процесс следует выносить в фоновое или регламентное задание с помощью ФоновыеЗадания.Выполнить(), предварительно регистрируя измененные документы в планах обмена или служебных регистрах сведений.