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

Другое · 6 мин

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

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

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

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

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

Что такое веб-сервис в 1С и когда он нужен

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

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

Подготовка конфигурации: объект Веб-сервис и методы

В конфигураторе создаётся объект «Веб-сервис», в котором описываются публичные методы. Методы должны быть экспортируемыми функциями или процедурами модуля менеджера, а параметры и возвращаемые значения — типами, которые платформа может сериализовать для внешнего вызова.

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

Сценарий SOAP-веб-сервиса платформы

Классический веб-сервис 1С формирует WSDL автоматически на основе описания объектов конфигурации. Внешняя система может сгенерировать клиентский код по этому WSDL и вызывать методы через SOAP. Уточняйте поддерживаемые протоколы и привязки в документации к используемому релизу платформы.

Порядок подготовки веб-сервиса
  1. 1
    Определите задачи обмена и список доступных объектов
  2. 2
    Создайте объект «Веб-сервис» и экспортируемые методы
  3. 3
    Проверьте права доступа к используемым справочникам и документам
  4. 4
    Сохраните конфигурацию и обновите базу данных

Публикация на веб-сервере и проверка WSDL

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

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

Встроенный веб-сервер против IIS и Apache

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

Аутентификация, SSL и права доступа

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

При работе через интернет подключение должно быть защищено шифрованием. Без SSL логин, пароль и данные передаются открытым текстом. Настройку сертификата и порта выполняйте совместно с администратором сети или хостинга, чтобы не нарушить работу других служб.

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

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

Доступность адреса службы
Норма

Открывается описание или WSDL без ошибки входа

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

Страница ошибки, тайм-аут или отказ в соединении

Права пользователя
Норма

Метод выполняется в рамках роли и записывает действия в журнал

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

Доступ запрещён или выполняются действия вне роли

Вызов извне и пример интеграции

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

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

Типичные ошибки
01
Публикация под учётной записью без прав на изменение документов приводит к молчаливым отказам в записи
02
Изменение методов без повторной публикации вызывает работу со старой версией службы

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

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

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

Итог

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

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

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

Нужно ли покупать отдельную лицензию для веб-сервиса?

Требования к лицензированию зависят от способа подключения и числа пользователей. Уточняйте условия лицензионного соглашения 1С:Предприятия для вашей конфигурации и режима работы.

Можно ли публиковать веб-сервис на обычном хостинге?

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

Что делать, если внешняя система не видит методы?

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

Безопасно ли передавать пароли через веб-сервис?

Только по защищённому соединению и с использованием отдельных учётных записей с ограниченными правами. Без шифрования передача учётных данных недопустима.