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

Другое · 9 мин

Добавление ссылки на веб-сервис в 1С: пошаговая инструкция

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

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

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

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

Что такое ссылка на веб-сервис в 1С и зачем она нужна

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

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

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

Когда добавлять собственную ссылку, а когда использовать опубликованный сервис

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

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

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

1С выступает потребителемНужно добавить ссылку на внешний веб-сервис

Проверьте доступность WSDL и права на сетевой адрес

1С выступает поставщикомНужно опубликовать собственный веб-сервис

Настройте публикацию и права доступа к опубликованным объектам.

Неясное направление обменаТребуется уточнение с разработчиком удалённой системы

Запросите документацию и пример адреса сервиса

Подготовка перед добавлением ссылки

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

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

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

Как добавить ссылку на внешний веб-сервис в конфигураторе

Откройте конфигурацию в режиме редактирования и перейдите к разделу работы с веб-сервисами. Выберите действие добавления новой ссылки и укажите адрес WSDL или описания API. Мастер попробует считать метаданные и предложит имена для сгенерированных объектов.

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

Не вносите правки в сгенерированные объекты вручную, если не уверены в последствиях. Лучше обновить ссылку повторно после изменения описания на стороне удалённого сервиса, чем править прокси-код самостоятельно.

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

Использование добавленной ссылки в коде

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

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

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

Проверка результата и типичные ошибки

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

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

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

Ограничения и безопасная самостоятельная работа

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

Типичные ошибки
01
Указание неверного адреса WSDL приводит к невозможности сгенерировать прокси
02
Отключение проверки сертификата создаёт угрозу перехвата данных
03
Ручное изменение сгенерированных объектов ломает ссылку при обновлении
04
Запуск вызовов без обработки исключений вызывает остановку обработки данных

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

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

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

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

Ссылка отображается в конфигураторе
Норма

Веб-сервис добавлен и компилируется

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

Ошибка чтения адреса или отсутствие объекта

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

Получен ожидаемый ответ

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

Таймаут, ошибка сертификата или неверные параметры

Работа в запущенной базе
Норма

Вызов выполняется под нужной ролью

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

Ошибка доступа или отсутствие прав на внешние соединения

Как проверить, что связь работает корректно

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

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

Итог

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

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

Чем отличается добавление ссылки от публикации веб-сервиса?

Добавление ссылки делает 1С потребителем чужого API: вы подключаетесь к удалённому сервису по его адресу. Публикация делает вашу конфигурацию поставщиком: внешние системы обращаются к вашим опубликованным объектам. Выбирайте вариант по направлению обмена данными.

Нужен ли программист для добавления ссылки?

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

Что делать, если ссылка перестала работать после обновления сервиса?

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

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

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

Можно ли редактировать сгенерированные объекты веб-сервиса вручную?

Не рекомендуется: при обновлении ссылки изменения могут пропасть или привести к несоответствию с описанием сервиса. Лучше обновить ссылку через мастер и при необходимости изменить только свой код вызовов.