Сервисный концентратор Министерства обороны Российской Федерации (стр. 1 )

Министерство обороны Российской Федерации

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

электронного сервиса СМЭВ

Сервисный концентратор Министерства обороны Российской Федерации

Дата: 13.08.2014

Версия: 1.5

Листов: 85

МОСКВА 2014

СОДЕРЖАНИЕ

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

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

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

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

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

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

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

1.7 Типы данных, используемые в сервисе. 10

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

2.1 Операция «Первичный запрос». 11

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

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

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

2.1.4 Контрольные примеры.. 11

2.2 Операция «Вторичный запрос». 16

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

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

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

2.2.4 Контрольные примеры.. 17

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

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

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

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

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

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

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

4.2.1 Запрос, предоставляющий сведения о заключениях по РЭС и ВЧУ (МО) 28

4.2.2 Запрос cведений о получении, погашении или неполучении Государственного жилищного сертификата для приобретения жилой площади. 30

4.3 Описание схем данных (XSD) 34

4.3.1 XSD=1. 34

4.3.2 XSD=2. 38

4.3.3 XSD=3. 61

4.3.4 XSD=4. 62

4.3.5 XSD=5. 64

4.3.6 XSD=6. 73

4.3.7 XSD=7. 79

4.4 Описания справочников. 85

4.4.1 Коды возврата. 85

Status. 85

изменения

Версия	Дата	Автор	Изменения
1.0	21.06.2013		Разработка руководства пользователя
1.1	09.12.2013		Вставка описания сведений о заключениях по РЭС и ВЧУ
1.2	14.01.2014		Обновил КП, добавил адреса сервиса в продуктивной среде
1.3	03.02.2014		Добавил адрес сервиса в тестовом контуре СМЭВ
1.4	03.03.2014		Добавил пункты 4.2.2 4.2.3, обновил КП.
1.5	13.08.2014		Обновил контрольные примеры, разделы 2.1.4 и 2.2.4.

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

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

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

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

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

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

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

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

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

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

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

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

-  Распоряжение Правительства Российской Федерации от 17 марта 2011 г. .

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

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

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

Сервисный концентратор Министерства обороны Российской Федерации включает методы, обеспечивающие:

·  регистрацию заявки по предоставлению сведений, находящихся в распоряжении Министерства обороны Российской Федерации, в электронном виде;

·  запрос состояния принятой заявки по предоставлению сведений, находящихся в распоряжении Министерства обороны Российской Федерации, в электронном виде и/или ответа на заявку.

Метод	Назначение
Код: PutDocument Наименование: первичный по предоставлению сведений, находящихся в распоряжении Министерства обороны Российской Федерации,	Принимает электронное сообщение в формате XML с данными заявки на предоставление сведений, находящихся в распоряжении Министерства обороны Российской Федерации, в электронном виде и возвращает квитанцию.
Код: GetDocumentResult Наименование: вторичный запрос на получение результатов обработки первичного запроса (формы заявления, принятой сервисом)	Принимает электронное сообщение в формате XML с запросом состояния заявки и возвращает состояние и/или результат обработки заявки.

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

Взаимодействие реализовано по асинхронной схеме.

Информационная система ведомства вызывает сервис и передает данные заявки по предоставлению сведений, находящихся в распоряжении Министерства обороны Российской Федерации, в электронном виде с помощью метода putDocument. Этот метод проводит регистрацию запроса по предоставлению сведений, находящихся в распоряжении Министерства обороны Российской Федерации, в электронном виде и возвращает квитанцию с результатом регистрации.

Для получения результата обработки заявки (формы заявления, принятого сервисом), система-потребитель должна вызвать метод getDocument, результатом работы которого будет ответ, содержащий сведения о состоянии обрабтки заявки и/или данные ответа на заявку.

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

В рамках взаимодействия информационная система ведомства направляет в адрес сервиса следующие виды сообщений:

·  сообщение с данными для регистрации заявки на предоставление сведений, находящихся в распоряжении Министерства обороны Российской Федерации, в электронном виде;

·  сообщение с запросом результата обработки заявки;

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

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

Рисунок 1.

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

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

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

2.7 Типы данных, используемые в сервисе

№ п/п	Наименование типа переменной	Тип	Значение (длина для String)	Комментарий
1.	DVarchar80Type	string	80
2.	DDateType	date	xxxx-yy-zz	год-месяц-число
3.	DExternalKeyType	string	40
4.	DVarchar3000Type	string	3000
5.	DVarchar1000Type	string	1000
6.	DDatetimeType	dateTime	xxxx-yy-zzThh-mm-ss	Год-месяц-число часы-минуты-секунды
7.	DIntegerType	integer	max = 2147483647 min = -2147483648
8.	DDescriptionType	string	1000
9.	DVarchar10Type	string	10
10.	DIdType	integer	max = 2147483647 min = -2147483648
11.	DOkoguCodeType	string	5
12.	DEmailAddressType	string	100
13.	DAddressType	string	250
14.	DCode2Type	string	2
15.	DVarchar250Type	string	250
16.	DVarchar50Type	string	50
17.	DInnulType	string	10
18.	DKppType	string	9
19.	DVarchar100Type	string	100
20.	DOgrnType	string	15
21.	DInnType	string	12
22.	DOkopfType	string	2
23.	DInnipType	string	12
24.	DVarchar2Type	string	2
25.	DCaptionType	string	80
26.	DVarchar150Type	string	150
27.	DVarchar20Type	string	20
28.	DVarchar4Type	string	4
29.	DVarchar40Type	string	40
30.	DVarchar3Type	string	3
31.	DOgrnulType	string	13
32.	DPassportDeepType	string	2

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