К статье
Практический материал

Другое · 7 мин

Как подключить 1С к веб-сервису

Как подключить 1С к веб-сервису: настройка HTTP-сервиса, WSDL, аутентификация, проверка соединения и типичные ошибки интеграции.

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

Перед началом настройки важно понимать, в какую сторону пойдёт обмен: 1С будет вызывать чужой сервис (исходящее подключение) или сторонняя система будет обращаться к 1С (входящее). От этого зависит выбор инструментов, порядок настройки и требования к безопасности.

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

Что нужно проверить перед подключением

Сначала уточните у поставщика веб-сервиса адрес конечной точки, формат описания (WSDL или REST), способы аутентификации и ограничения по количеству запросов. Без этих данных настройка в 1С невозможна, так как программа не сможет составить корректный запрос.

Проверьте, что компьютер или сервер с 1С имеет выход в сеть к адресу веб-сервиса. Прокси-серверы, брандмауэры и фильтрация трафика могут блокировать соединение, даже если интернет в целом работает.

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

Создание HTTP-сервиса в конфигурации 1С

В конфигураторе 1С создайте объект типа HTTP-сервис, укажите его имя и методы, которые будут доступны для вызова. Для каждого метода описываются параметры и тип возвращаемого значения, чтобы внешние системы могли корректно формировать запросы.

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

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

Порядок создания HTTP-сервиса
  1. 1
    Создать объект HTTP-сервис в конфигураторе 1С
  2. 2
    Описать методы, параметры и возвращаемые значения
  3. 3
    Опубликовать сервис и получить адрес доступа
  4. 4
    Настроить права доступа по ролям
  5. 5
    Проверить доступность адреса извне

Настройка подключения к внешнему веб-сервису

Если 1С должна вызывать чужой сервис, в конфигурации создаётся соединение HTTP-сервиса с указанием адреса сервера и порта. Для работы с описанием WSDL используется генерация внешнего компонента или работа через встроенные средства обработки XML и SOAP.

Укажите адрес конечной точки, метод запроса и формат данных. При работе с SOAP формируйте конверт запроса в соответствии со схемой WSDL, при REST — передавайте JSON или XML в теле запроса с нужными заголовками.

После настройки выполните тестовый вызов метода сервиса. Успешный результат подтверждает, что адрес доступен, параметры запроса верны и сторона поставщика принимает соединение от 1С.

Аутентификация и безопасность

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

Не передавайте пароли и токены в открытом виде в коде модулей. Используйте отдельные настройки хранения конфиденциальных данных и ограничьте доступ к ним по ролям пользователей.

Если сервис использует защищённое соединение HTTPS, убедитесь, что сертификат сервера доверен на стороне 1С. Иначе соединение может устанавливаться с ошибкой или блокироваться средствами защиты.

Проверка результата и отладка

Признаком успешного подключения является получение ожидаемого ответа от веб-сервиса: справочник заполнен, документ создан, статус доставки обновлён. Сравните полученные данные с тем, что возвращает сервис напрямую.

Если обмен не работает, проверьте журнал регистрации 1С, текст ошибки HTTP и доступность адреса через обычный браузер с того же компьютера. Часто проблема кроется в неверном адресе, блокировке порта или несоответствии формата данных.

Для отладки удобно использовать промежуточные файлы или отладочный вывод, где фиксируются отправленный запрос и полученный ответ. Это позволяет отделить ошибку настройки 1С от ошибки на стороне внешнего сервиса.

Контрольные точки

Как проверить результат

Тестовый вызов метода сервиса
Норма

Получен корректный ответ без ошибок HTTP

Тревожный признак

Ошибка соединения, тайм-аут или неверный формат ответа

Журнал регистрации 1С
Норма

Записи об успешном обмене данными

Тревожный признак

Записи об ошибках аутентификации или доступа

Доступность адреса из сети 1С
Норма

Адрес открывается в браузере

Тревожный признак

Адрес недоступен или требует прокси

Типичные ошибки и ограничения

Частая ошибка — указание адреса сервиса без учета прокси-сервера корпоративной сети. В итоге 1С не может достучаться до адреса, хотя браузер на том же компьютере открывает сайт.

Другая ошибка — несоответствие типов данных в параметрах запроса и схеме WSDL. Даже небольшое различие в формате даты или названии поля приводит к отказу сервиса в обработке запроса.

Типичные ошибки
01
Неверный адрес или блокировка порта прокси-сервером
02
Несоответствие типов данных параметров схеме WSDL
03
Хранение паролей и токенов в открытом коде модулей
04
Превышение лимитов количества запросов к сервису

Ограничения могут касаться количества запросов в единицу времени, размера передаваемых данных и доступных методов. Превышение лимитов ведёт к временной блокировке доступа со стороны сервиса.

Альтернативы и когда подключение не требуется

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

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

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

Итог

Что важно запомнить

Подключение 1С к веб-сервису требует точного адреса, способа аутентификации и проверки сетевой доступности, после чего обмен тестируется и отлаживается по журналам и ответам сервиса.

Часто задаваемые вопросы

Нужен ли программист для подключения 1С к веб-сервису?

Простые настройки может выполнить администратор 1С, но работа с WSDL, SOAP и формированием запросов часто требует навыков программирования на встроенном языке 1С.

Что делать, если адрес веб-сервиса недоступен из 1С?

Проверьте подключение к адресу из браузера на том же компьютере, настройки прокси и брандмауэра, а также уточните у поставщика сервиса, нет ли ограничений по IP-адресам.

Как защитить пароли и токены при настройке?

Не храните конфиденциальные данные в открытом коде модулей, используйте отдельные настройки и ограничьте доступ к ним по ролям пользователей.

Можно ли подключиться к сервису без WSDL?

Да, можно работать с REST-интерфейсами через HTTP-запросы и форматы JSON или XML, но описание методов и параметров нужно получить у поставщика сервиса отдельно.