Как правильно протестировать веб-сервис 1С через Postman и почему не работает пустой запрос

Программист 1С v8.3 (Управляемые формы) IT и автоматизация бизнеса
← На главную

Разработка и отладка веб-сервисов (SOAP) в 1С часто вызывает трудности у новичков, особенно на этапе тестирования через сторонние инструменты, такие как Postman. Одной из самых распространенных ошибок является попытка отправить запрос в формате JSON или с пустым телом, в то время как протокол SOAP требует строгого соблюдения структуры XML. Разберем по шагам, как настроить Postman для успешного взаимодействия с 1С, проанализируем причины возникновения ошибок и выясним, какие нюансы конфигурации 1С на это влияют.

Понимаем разницу между SOAP и HTTP-сервисами

Прежде всего, проанализируем ситуацию: почему при тестировании WS (веб-сервиса) мы не можем просто передать {} в теле запроса? В 1С существует два типа сервисов: HTTP-сервисы и Web-сервисы (SOAP). Если в HTTP-сервисах (HS) мы вольны сами определять формат данных (будь то JSON, XML или обычный текст), то Web-сервисы (WS) работают по строгому стандарту SOAP. Этот стандарт всегда требует передачи данных в виде XML-конверта определенной структуры. Именно поэтому попытка отправить пустой объект приводит к ошибкам формата.

Формирование правильного URL для запроса

Рассмотрим, как правильно обращаться к нашему сервису. Адрес веб-сервиса 1С в общем виде выглядит так:

http://имя_сервера/имя_базы/ws/ИмяВебСервиса.1cws. Для подготовки публикации без участия веб-сервера можно использовать средство для создания файла default.vrd.

Важно помнить: для получения описания сервиса (схемы) в браузере мы добавляем в конце ?wsdl, но при выполнении реального POST-запроса в Postman этот параметр использовать не нужно. Наш запрос должен уходить строго на адрес, заканчивающийся на .1cws.

Настройка заголовков (Headers) в Postman

Выясним причину, по которой сервер 1С может отвергать наш запрос даже при наличии XML. Все дело в заголовках. Для корректной работы SOAP 1.1 необходимо установить следующие параметры на вкладке Headers:

  1. Content-Type: Установим значение text/xml;charset=UTF-8. Если используется версия SOAP 1.2, значение должно быть application/soap+xml.
  2. Authorization: Веб-сервисы 1С практически всегда требуют авторизации. Перейдем на вкладку Authorization, выберем тип Basic Auth и введем логин и пароль пользователя 1С, у которого есть права на использование данного веб-сервиса и роль УдаленныйДоступЧерезВебСервис.

Создание структуры SOAP Envelope (Тело запроса)

Теперь разберем самый важный этап — формирование тела запроса. Даже если ваша функция в 1С не принимает параметров, вы обязаны передать «конверт». Если вы передадите пустую строку или неверный XML, вы увидите ошибку extra content at the end of document. Это означает, что парсер 1С ожидал закрывающий тег или начало структуры, но получил некорректные данные.

Рассмотрим пример правильной структуры XML для функции, которая называется СоздатьКонтрагента и находится в пространстве имен http://www.sample-package.org:


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sam="http://www.sample-package.org">
   <soapenv:Header/>
   <soapenv:Body>
      <sam:СоздатьКонтрагента/>
   </soapenv:Body>
</soapenv:Envelope>

Обратите внимание на пространство имен (Namespace). В свойстве вашего веб-сервиса в конфигураторе 1С указано поле «Пространство имен». Если в XML-запросе оно не будет совпадать с тем, что прописано в 1С, система выдаст ошибку «Неверный формат». В примере выше префикс sam связан с адресом пакета http://www.sample-package.org.

Работа с XDTO-пакетами и типами данных

Проанализируем ситуацию, когда функция все же имеет параметры. В 1С Web-сервисы неразрывно связаны с XDTO-пакетами. Каждый параметр функции должен соответствовать определенному типу из XDTO. Если вы указали тип string (из стандартного пакета http://www.w3.org/2001/XMLSchema), то внутри тега метода в XML должен появиться тег параметра:


<soapenv:Body>
   <sam:СоздатьКонтрагента>
      <sam:Наименование>ООО "Новый Клиент"</sam:Наименование>
   </sam:СоздатьКонтрагента>
</soapenv:Body>

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

Автоматизация через импорт WSDL

Чтобы не составлять XML-структуру вручную (что особенно критично при тестировании сложных запросов к ВетИС) и не гадать с пространствами имен, воспользуемся отличным лайфхаком в Postman:

  1. Нажмите кнопку Import в верхнем левом углу Postman.
  2. Выберите вкладку Link.
  3. Вставьте полную ссылку на ваш WSDL (например, http://localhost/base/ws/MyService.1cws?wsdl).
  4. Postman автоматически создаст коллекцию запросов.

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

Почему опытные разработчики советуют SoapUI?

Несмотря на мощь Postman, для работы с SOAP-сервисами часто рекомендуют специализированный инструмент — SoapUI. Проанализируем, почему. SoapUI спроектирован именно под протокол SOAP. При импорте WSDL он гораздо точнее восстанавливает иерархию типов данных 1С и позволяет на лету генерировать тестовые наборы данных. Если в Postman вы продолжаете получать «Неверный формат», попробуйте открыть этот же сервис в SoapUI — если там заработает, значит, проблема в заголовках или лишних пробелах в Postman.

Стоит ли переходить на HTTP-сервисы?

Как было замечено в обсуждении, если у вас нет жесткого требования использовать именно SOAP (например, интеграция со старой системой, которая понимает только WS), то для современных задач лучше выбрать HTTP-сервисы. В HTTP-сервисах работа с JSON происходит гораздо проще:

Однако, если вы решили продолжать работу с Web-сервисами, помните: 1С ожидает валидный XML, обернутый в SOAP Envelope, с четко указанным пространством имен.

← На главную