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

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

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

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

 

 

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

 

 

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

 

 

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

 

 

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

 

 

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

 

 

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

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

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

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

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

 

 

 

 

 № 

 

 

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

 

 

 Значение 

 

 

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

 

 

 

 

 

 

 

 

   

 

 

 

 

 400 

 

 

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

 

 

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

 

 

 

 

 

 

   

 

 

 

 

 401 

 

 

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

 

 

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

 

 

 

 

 

 

   

 

 

 

 

 403 

 

 

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

 

 

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

 

 

 

 

 

 

   

 

 

 

 

 409 

 

 

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

 

 

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

 

 

 

 

 

 

   

 

 

 

 

 422 

 

 

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

 

 

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

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

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

 

 

 

 

 

 

   

 

 

 

 

 500 

 

 

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

 

 

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

 

 

 

 

 

 

   

 

 

 

 

 200 

 

 

 ОК