Другое · 6 мин
Как создать веб-сервис в 1С и подключить к нему внешние системы
Создание веб-сервиса в 1С: подготовка конфигурации, публикация методов, проверка WSDL, настройка доступа и способы вызова из внешних систем. Безопасность и типичные ошибки.
В 1С:Предприятие веб-сервис позволяет внешним приложениям обращаться к данным и логике конфигурации по протоколу HTTP. Чаще всего это нужно для обмена с интернет-магазинами, мобильными приложениями, сторонними учётными системами или автоматизированными сервисами контрагентов.
Создание веб-сервиса начинается не с публикации на сервере, а с описания объектов конфигурации, которые будут доступны извне. Нужно определить, какие справочники, документы, регистры или отчёты должны участвовать в обмене, и выбрать подходящий интерфейс: встроенный веб-сервис платформы, OData или REST-ориентированное решение.
Публикация веб-сервиса требует доступа к веб-серверу, настройки прав пользователей и, при работе через интернет, защиты канала. Ошибки на этом этапе могут привести к недоступности службы или раскрытию данных, поэтому порядок действий и проверка результата важнее скорости развёртывания.
Что такое веб-сервис в 1С и когда он нужен
Веб-сервис — это публичный интерфейс конфигурации, через который внешняя система может вызывать экспортируемые функции и получать данные в структурированном виде. В 1С такие сервисы обычно используются для выгрузки и загрузки документов, проверки остатков, сверки расчётов с контрагентами и интеграции с сайтами.
Не каждый обмен требует веб-сервиса. Если сторона обменивается файлами раз в сутки, проще использовать обмен файлами через общую папку или FTP. Если нужна оперативная отправка заказа из интернет-магазина в 1С в момент оформления, веб-сервис подходит больше.
Подготовка конфигурации: объект Веб-сервис и методы
В конфигураторе создаётся объект «Веб-сервис», в котором описываются публичные методы. Методы должны быть экспортируемыми функциями или процедурами модуля менеджера, а параметры и возвращаемые значения — типами, которые платформа может сериализовать для внешнего вызова.
Перед публикацией проверьте, что все используемые внутри сервиса справочники и документы доступны для чтения или записи под учётной записью, от имени которой будет работать служба. Избыточные права создают риск несанкционированного изменения данных.
Сценарий SOAP-веб-сервиса платформы
Классический веб-сервис 1С формирует WSDL автоматически на основе описания объектов конфигурации. Внешняя система может сгенерировать клиентский код по этому WSDL и вызывать методы через SOAP. Уточняйте поддерживаемые протоколы и привязки в документации к используемому релизу платформы.
- 1Определите задачи обмена и список доступных объектов
- 2Создайте объект «Веб-сервис» и экспортируемые методы
- 3Проверьте права доступа к используемым справочникам и документам
- 4Сохраните конфигурацию и обновите базу данных
Публикация на веб-сервере и проверка WSDL
Опубликованный веб-сервис размещается на веб-сервере, который может быть встроенным сервером платформы, IIS, Apache или другим решением, поддерживающим работу с 1С:Предприятием. Публикация выполняется через администрирование информационной базы или средствами веб-сервера в зависимости от архитектуры.
После публикации откройте адрес службы в браузере или специализированном клиенте. Если платформа отображает WSDL или описание методов, сервис доступен. Если открывается страница ошибки или соединение отвергается, проверьте адрес, порт, права учётной записи и состояние службы веб-сервера.
Встроенный веб-сервер против IIS и Apache
Встроенный веб-сервер удобен для тестирования и работы в небольшой сети, но для постоянного доступа извне часто выбирают отдельный веб-сервер с настройкой SSL, ограничениями по IP и журналом запросов. Выбор зависит от количества пользователей и требований безопасности.
Аутентификация, SSL и права доступа
Доступ к веб-сервису настраивается через пользователей информационной базы и роли доступа. Внешняя система передаёт логин и пароль, а 1С проверяет их и предоставляет права в соответствии с ролью. Не используйте общие учётные записи для разных интеграций, если нужно отслеживать, кто вносил изменения.
При работе через интернет подключение должно быть защищено шифрованием. Без SSL логин, пароль и данные передаются открытым текстом. Настройку сертификата и порта выполняйте совместно с администратором сети или хостинга, чтобы не нарушить работу других служб.
Как проверить результат
Открывается описание или WSDL без ошибки входа
Страница ошибки, тайм-аут или отказ в соединении
Метод выполняется в рамках роли и записывает действия в журнал
Доступ запрещён или выполняются действия вне роли
Вызов извне и пример интеграции
Внешняя система может сформировать запрос по WSDL, передать параметры метода и получить ответ в формате, поддерживаемом платформой. Перед вводом в эксплуатацию протестируйте сценарий на тестовой базе: создание документа, чтение справочника, обработку ошибки при неверных параметрах.
Учитывайте, что веб-сервис не заменяет полную выгрузку данных при больших объёмах. Для массового обмена лучше выгружать файлы или использовать регулярные процессы обмена, а веб-сервис оставить для точечных запросов и команд.
Ограничения и типичные ошибки
Не все объекты конфигурации удобно опубликовать через веб-сервис. Сложные иерархические справочники, большие табличные части и нестандартные форматы могут потребовать дополнительной разработки и тестирования. Оценивайте сложность перед началом работ.
Частые ошибки: публикация под учётной записью без нужных прав, отсутствие обработки исключений в методах, использование HTTP вместо HTTPS, изменение конфигурации без повторной публикации службы. Каждая из них ведёт к сбоям обмена или потере данных.
Что важно запомнить
Веб-сервис в 1С создаётся в конфигураторе, публикуется на веб-сервере, проверяется по адресу службы и защищается правами и шифрованием.
Частые вопросы
Нужно ли покупать отдельную лицензию для веб-сервиса?
Требования к лицензированию зависят от способа подключения и числа пользователей. Уточняйте условия лицензионного соглашения 1С:Предприятия для вашей конфигурации и режима работы.
Можно ли публиковать веб-сервис на обычном хостинге?
Только если хостинг поддерживает требования 1С:Предприятия и позволяет размещать опубликованные информационные базы. Обычный веб-хостинг для сайтов не всегда подходит.
Что делать, если внешняя система не видит методы?
Проверьте доступность адреса службы, корректность публикации, права учётной записи и актуальность WSDL после последних изменений конфигурации.
Безопасно ли передавать пароли через веб-сервис?
Только по защищённому соединению и с использованием отдельных учётных записей с ограниченными правами. Без шифрования передача учётных данных недопустима.