Другое · 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С генерирует адрес, по которому он будет доступен. Этот адрес передаётся разработчику внешней системы для настройки обратного вызова. Публикация может требовать прав доступа к веб-серверу, на котором развёрнута информационная база.
Важно ограничить права доступа к созданному сервису только теми ролями пользователей, которым действительно нужна работа с внешними данными. Открытый без ограничений сервис создаёт риск несанкционированного доступа к информации базы.
- 1Создать объект HTTP-сервис в конфигураторе 1С
- 2Описать методы, параметры и возвращаемые значения
- 3Опубликовать сервис и получить адрес доступа
- 4Настроить права доступа по ролям
- 5Проверить доступность адреса извне
Настройка подключения к внешнему веб-сервису
Если 1С должна вызывать чужой сервис, в конфигурации создаётся соединение HTTP-сервиса с указанием адреса сервера и порта. Для работы с описанием WSDL используется генерация внешнего компонента или работа через встроенные средства обработки XML и SOAP.
Укажите адрес конечной точки, метод запроса и формат данных. При работе с SOAP формируйте конверт запроса в соответствии со схемой WSDL, при REST — передавайте JSON или XML в теле запроса с нужными заголовками.
После настройки выполните тестовый вызов метода сервиса. Успешный результат подтверждает, что адрес доступен, параметры запроса верны и сторона поставщика принимает соединение от 1С.
Аутентификация и безопасность
Веб-сервисы могут требовать логин и пароль, токен доступа, сертификат или подпись запроса. Способ аутентификации указывается в настройках соединения 1С или добавляется в заголовки HTTP-запроса вручную.
Не передавайте пароли и токены в открытом виде в коде модулей. Используйте отдельные настройки хранения конфиденциальных данных и ограничьте доступ к ним по ролям пользователей.
Если сервис использует защищённое соединение HTTPS, убедитесь, что сертификат сервера доверен на стороне 1С. Иначе соединение может устанавливаться с ошибкой или блокироваться средствами защиты.
Проверка результата и отладка
Признаком успешного подключения является получение ожидаемого ответа от веб-сервиса: справочник заполнен, документ создан, статус доставки обновлён. Сравните полученные данные с тем, что возвращает сервис напрямую.
Если обмен не работает, проверьте журнал регистрации 1С, текст ошибки HTTP и доступность адреса через обычный браузер с того же компьютера. Часто проблема кроется в неверном адресе, блокировке порта или несоответствии формата данных.
Для отладки удобно использовать промежуточные файлы или отладочный вывод, где фиксируются отправленный запрос и полученный ответ. Это позволяет отделить ошибку настройки 1С от ошибки на стороне внешнего сервиса.
Как проверить результат
Получен корректный ответ без ошибок HTTP
Ошибка соединения, тайм-аут или неверный формат ответа
Записи об успешном обмене данными
Записи об ошибках аутентификации или доступа
Адрес открывается в браузере
Адрес недоступен или требует прокси
Типичные ошибки и ограничения
Частая ошибка — указание адреса сервиса без учета прокси-сервера корпоративной сети. В итоге 1С не может достучаться до адреса, хотя браузер на том же компьютере открывает сайт.
Другая ошибка — несоответствие типов данных в параметрах запроса и схеме WSDL. Даже небольшое различие в формате даты или названии поля приводит к отказу сервиса в обработке запроса.
Ограничения могут касаться количества запросов в единицу времени, размера передаваемых данных и доступных методов. Превышение лимитов ведёт к временной блокировке доступа со стороны сервиса.
Альтернативы и когда подключение не требуется
Если обмен данными нужен разовый или редкий, проще использовать импорт и экспорт файлов через обмен по папкам или электронную почту. Настройка полноценного веб-сервиса в таких случаях может быть избыточной.
Для регулярного обмена с известными системами часто уже существуют готовые решения интеграции или стандартные механизмы обмена в конфигурации 1С. Их использование снижает время настройки и количество поддерживаемого кода.
Если внешняя система не предоставляет открытого веб-сервиса, подключение может быть невозможным без участия её разработчика. В этом случае уточните возможность предоставления API или используйте промежуточную интеграционную платформу.
Что важно запомнить
Подключение 1С к веб-сервису требует точного адреса, способа аутентификации и проверки сетевой доступности, после чего обмен тестируется и отлаживается по журналам и ответам сервиса.
Часто задаваемые вопросы
Нужен ли программист для подключения 1С к веб-сервису?
Простые настройки может выполнить администратор 1С, но работа с WSDL, SOAP и формированием запросов часто требует навыков программирования на встроенном языке 1С.
Что делать, если адрес веб-сервиса недоступен из 1С?
Проверьте подключение к адресу из браузера на том же компьютере, настройки прокси и брандмауэра, а также уточните у поставщика сервиса, нет ли ограничений по IP-адресам.
Как защитить пароли и токены при настройке?
Не храните конфиденциальные данные в открытом коде модулей, используйте отдельные настройки и ограничьте доступ к ним по ролям пользователей.
Можно ли подключиться к сервису без WSDL?
Да, можно работать с REST-интерфейсами через HTTP-запросы и форматы JSON или XML, но описание методов и параметров нужно получить у поставщика сервиса отдельно.