Руководство пользователя электронного сервиса смэв (стр. 1 )

Министерство внутренних дел Российской Федерации

Руководство пользователя

электронного сервиса смэв

«Сведения о службе в ОВД»

Дата: 27.06.2012

Версия: 2.0

Листов: 62

СОДЕРЖАНИЕ

1 Общие сведения.. 4

1.1 Руководящие документы.. 4

1.2 Описание электронного сервиса. 4

1.3 Операции (методы) электронного сервиса. 5

1.4 Сценарии использования. 5

1.5 Схема взаимодействия. 5

1.6 Связи с другими электронными сервисами. 6

2 Руководство пользователя.. 7

2.1 Операция «Запрос на предоставление сведений». 7

2.1.1 Общие сведения. 7

2.1.2 Описание входных параметров. 7

2.1.3 Описание выходных параметров. 7

2.1.4 Коды возвратов. 7

2.1.5 Контрольные примеры.. 8

2.1.5.1 Сведения об общей продолжительности службы в ОВД.. 8

2.2 Операция "Запрос на получение ответа". 11

2.2.1 Общие сведения. 11

2.2.2 Описание входных параметров. 12

2.2.3 Описание выходных параметров. 12

2.2.4 Коды возвратов. 12

2.2.5 Контрольные примеры.. 12

2.2.5.1 Сведения об общей продолжительности службы в ОВД.. 12

3 Методика испытаний.. 17

3.1 Общие условия. 17

3.2 Параметры испытаний на тестовой среде. 17

3.3 Параметры испытаний на тестовой среде. 17

3.4 Особые условия. 17

4 Приложения.. 18

4.1 Описание сервиса (WSDL) 18

4.2 Описание общих структур данных. 41

4.3 Описания справочников. 54

4.3.1 Справочник кодов возврата. 54

4.3.2 Список кодов региона ФКУ «ГИАЦ МВД России» и информационных центров, исполняющих государственную услугу. 54

4.3.3 Справочник ведомств (СМЭВ) 56

4.3.4 Список государственных услуг (функций), оказываемых (исполняемых) МВД России, размещенных в сводном реестре, с указанием идентификационных номеров. 58

4.3.5 Справочник внутренних систем МВД России. 60

4.4 Правила заполнения служебных элементов электронных сообщений в СМЭВ.. 61

изменения

Версия	Дата	Автор	Изменения
1.1	23.01.2012		Приведены актуальные xsd-схемы.
1.2	27.01.2012		Добавлен раздел по заполнению служебного блока атрибутов сообщений СМЭВ.
1.3	02.02.2012		Добавлен адрес тестового экзеспляра СМЭВ. Приведены актуальные схемы, примеры. Изменен тип элемента InitialRegNumber
1.4	09.02.2012		Актуализировано описание тестового сервиса (версия 07.02.2012)
1.5	21.03.2012		Добавлены примеры и описание формата ответов в случае мотивированного отказа. Удалены соответствующие коды возврата.
1.6	04.04.2012		Откорректирована ссылка на тестовый стенд
1.7	18.04.2012		Приведены актуальные примеры тестового сервиса.
1.8	14.05.2012		Приведены актуальные примеры
2.0	27.06.2012		Приведены актуальные примеры

термины/СОКРАЩЕНИя

Термин/сокращение	Описание
МВД России	Министерство внутренних дел РФ
СМЭВ	Система межведомственного электронного взаимодействия
Поставщик	Организация-владелец электронного сервиса
WSDL	Web Services Description Language — язык описания веб-сервисов.
XSD	XML Schema definition - язык описания структуры XML документа.
SOAP	Simple Object Access Protocol - протокол обмена структурированными сообщениями в распределённой вычислительной среде.
XML	eXtensible Markup Language — расширяемый язык разметки.

1  Общие сведения

1.1 Руководящие документы

Основанием для разработки данного документа является требование п. 48 Приказа Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. № 000 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия» в соответствии с которым, для подключения информационной системы к системе межведомственного электронного взаимодействия Поставщик предоставляет Оператору СМЭВ следующие документы:

¾  паспорт электронного сервиса, регистрируемого в системе взаимодействия;

¾  методику испытаний электронного сервиса, регистрируемого в системе взаимодействия, включая контрольный пример обращения к электронному сервису;

¾  руководство пользователя электронного сервиса, регистрируемого в системе взаимодействия.

Основанием для создания и использования электронного сервиса являются перечисленные ниже документы.

Нормативно-правовые документы:

¾  Постановление Правительства Российской Федерации от 8 сентября 2010 г. № 000 «О единой системе межведомственного электронного взаимодействия»;

¾  Приказ Министерства связи и массовых коммуникаций Российской Федерации от 01.01.01 г. № 000 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия».

Технологические стандарты:

¾  Методические рекомендации по разработке электронных сервисов и применению технологии электронной подписи при межведомственном взаимодействии.

1.2 Описание электронного сервиса

Наименование:	Сведения о службе в ОВД
Назначение:	Сервис предназначен для предоставления сведений ¾  об общей продолжительности службы в ОВД; ¾  выписки из приказа об увольнении со службы, с указанием причины увольнения
Поставщик:	Министерство внутренних дел Российской Федерации
Область применения:	Межведомственное взаимодействие

1.3 Операции (методы) электронного сервиса

Электронный сервис предоставления сведений "Сведения о службе в ОВД" обеспечивает обмен данными в рамках интеграции Федерального узла Системы с внешними системами.

Электронный сервис включает методы, обеспечивающие:

¾  Запрос на предоставление сведений:

§  об общей продолжительности службы в ОВД;

§  выписки из приказа об увольнении со службы, с указанием причины увольнения.

¾  Запрос на получение ответа.

Метод	Назначение
Код: sendPLRequest Наименование: Запрос на предоставление сведений	Принимает электронное сообщение, содержащее запрос на предоставление следующих сведений: §  об общей продолжительности службы в ОВД; §  выписки из приказа об увольнении со службы, с указанием причины увольнения. и возвращает номер запроса в системе.
Код: getPLResponse Наименование: Запрос на получение ответа	Принимает на вход номер запроса в системе и возвращает сведения, найденные в результате запроса: §  об общей продолжительности службы в ОВД; §  выписки из приказа об увольнении со службы, с указанием причины увольнения.

1.4 Сценарии использования

Информационная система ведомства вызывает сервис и передает электронное сообщение, содержащее запрос на предоставление сведений, с помощью вызова метода sendPLRequest.

Взаимодействие реализовано по асинхронной схеме. Метод регистрации запроса возвращает управление сразу, не дожидаясь обработки переданных данных. Вызывающей стороне сообщается номер запроса в системе. Далее для получения результата вызывающая система может запросить получение ответа с помощью метода getPLResponse.

1.5 Схема взаимодействия

В рамках взаимодействия информационная система ведомства направляет в адрес веб-сервиса сообщение, содержащее запрос на предоставление сведений (схема request_PL. xsd).

При поступлении запроса, веб-сервис должен возвратить

¾  Сообщение с уведомлением о постановке сведений в очередь на обработку и номером запроса в системе (схема response_ID. xsd с кодом обработки равным "8").

В случае успешной обработки сообщения и возврата номера запроса система ведомства направляет в адрес веб-сервиса сообщение, содержащее запрос на получение ответа (схема request_ID. xsd).

При поступлении запроса, веб-сервис должен возвратить

¾  Сообщение с результатми обработки запроса (схема response_PL. xsd с кодом обработки равным "3").

Схема взаимодействия представлена на рисунке 1.

Клиент веб-сервиса

Веб-сервис

Рисунок 1 «Схема взаимодействия»

1.6 Связи с другими электронными сервисами

Данный сервис не имеет связей с другими сервисами.

2  Руководство пользователя

2.1 Операция «Запрос на предоставление сведений»

2.1.1 Общие сведения

Код операции:	sendPLRequest
Наименование операции:	Запрос на предоставление сведений: §  об общей продолжительности службы в ОВД; §  выписки из приказа об увольнении со службы, с указанием причины увольнения.
Назначение операции:	Операция предназначена для передачи запроса в обработку и получения номера запроса в системе

2.1.2 Описание входных параметров

Входные данные: RequestPL

№	Код параметра	Описание параметра	Обязательность	Способ заполнения/Тип	Комментарий
1	RequestPLPart	Запрос на предоставление сведений:	+	tns:RequestPL

2.1.3 Описание выходных параметров

Выходные данные: ResponseID

№	Код параметра	Описание параметра	Обязательность	Способ заполнения/Тип	Комментарий
1	ResponseIDPart	Ответ на полученный запрос	+	tns:ResponseID

Параметры комплексного типа описаны в приложении «Описание общих структур данных».

2.1.4 Коды возвратов

Код возврата	Описание кода возврата	Условия возникновения
1	Несовпадение сигнатур цифровой подписи	Данный код возврата соответствует ситуации когда возникает несовпадение сигнатур цифровой подписи
2	Ошибка форматно-логического контроля	Данный код возврата соответствует ситуации когда возникает ошибка форматно-логического контроля
4	Системная ошибка	Данный код возврата соответствует ситуации когда возникает системная ошибка
8	Запрос взят в обработку	Данный код возврата соответствует ситуации когда запрос взят в обработку
11	Ошибка проверки СКП: СКП выдан УЦ, не входящим в сеть доверия МВД России	Данный код возврата соответствует ситуации, когда СКП выдан УЦ, не входящим в сеть доверия МВД России
12	Ошибка проверки СКП: СКП просрочен	Данный код возврата соответствует ситуации, когда СКП просрочен
13	Ошибка проверки СКП: СКП отозван	Данный код возврата соответствует ситуации, когда СКП отозван
15	Ошибка проверки СКП	Данный код возврата соответствует ситуации, когда возникают прочие ошибки проверки СКП

2.1.5 Контрольные примеры