Skip to main content

1.1 Общие требования

СМО взаимодействует с ФЕРЗЛ посредством SOAP-сервисов, использующих XML.

Взаимодействие осуществляется с использованием синхронных и асинхронных SOAP-методов.

Процесс синхронного взаимодействия ФЕРЗЛ с внешними системами состоит из следующих этапов:

  • внешняя система через SOAP-сервисы ФЕРЗЛ посылает запрос;

  • ФЕРЗЛ принимает запрос, обрабатывает его и формирует ответное сообщение, содержащее информацию об успешности или неуспешности проведения операции, а также результаты ФЛК.

Операции, выполняемые асинхронно, выделены в отдельный сервис, где каждая операция представлена двумя методами:

  • Start – запускает операцию и сообщает ее токен - строку, уникально идентифицирующую операцию;

  • Poll – опрашивает готовность операции, предъявляя токен.

Системные результаты выполнения метода возвращаются как код ответа.

В случае, если полученные входные данные не проходят ФЛК, возвращаются коды результата и сообщения об ошибках, препятствующих выполнению операции.

При получении ошибки, данные должны быть откорректированы, и метод должен быть вызван повторно.

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

Таблица — Коды и сообщения об ошибках

Код статуса ошибки

Значение

Возможные причины возникновения ошибки

  1.  

400

Ошибка в формате запроса

Формируется вне прикладного кода.

  1.  

401

Ошибка аутентификации

Неправильный пароль, истёкший токен доступа и т.п.

  1.  

403

Ошибка доступа к ресурсу

Попытка вызвать запрос, на который у текущей сессии нет прав.

  1.  

409

Ошибка бизнес-логики

Введены противоречивые/некорректные параметры.

  1.  

422

Необрабатываемый контент

Ключи для организации не найдены,

Переданное значение не является ОИП,

Версия справочника ключей не найдена

  1.  

500

Системная ошибка

Ошибка инфраструктуры.

  1.  

200

ОК