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

ОПИСАНИЕ ФОРМАТА

ЭЛЕКТРОННОГО СЕРВИСА РСМЭВ

И

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

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

Формат сведений о государственной регистрации актов гражданского состояния, представляемых в форме электронных документов

Дата: 13.06.2012

Версия: 1.0

Листов: 84

СОДЕРЖАНИЕ

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

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

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

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

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

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

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

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

2.1 Операция «getPersonalCertificateBirth». 8

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

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

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

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

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

2.1.5.1 Пример вызова сервиса. 12

2.1.5.2 Пример ответа на ошибочный запрос. 17

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

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

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

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

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

4.1 Описание сервиса (SmevUpZAGSAdapter_ws. wsdl) 20

4.2 Описание сервиса (wsdl. wsdl) 20

4.3 Описание схемы InterDepPersonalService. xsd. 21

4.4 Описание схемы LocalInterDepPersonalService. xsd. 22

4.5 Описание схемы actor. xsd. 31

4.6 Описание схемы common. xsd. 38

4.7 Описание схемы documents. xsd. 42

4.8 Описание схемы externaldocuments. xsd. 68

4.9 Описание схемы smev. *****. rev111111.xsd. 78

изменения

Версия

Дата

Автор

Изменения

0.1

13.06.2012

Создание документа

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

Термин/сокращение

Описание

АГС

Акты гражданского состояния - действия граждан или события, влияющие на возникновение, изменение или прекращение прав и обязанностей, а также характеризующие правовое состояние граждан.

Актовая запись

Письменные сведения об АГС, зафиксированные в установленном законом порядке компетентными органами с целью удостоверения подлинности соответствующих событий и действий. Запись является доказательством определенных обстоятельств, влекущих за собой юридические последствия.

ИС

Информационная система

Минюст России

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

Поставщик

Организация-владелец электронного сервиса.
Поставщик предоставляет сервис в адрес Оператора СМЭВ.

Поставщиком сервиса Единичных сведений об АГС является Минюст России.

Потребитель

Организация, направляющая межведомственный запрос с использованием СМЭВ в адрес Поставщика информации.

Потребителями информации предоставляемой сервисом Единичных сведений об АГС являются ФОИВ.

РФ

Российская Федерация

Сервис Единичных сведений об АГС

Сервис, описываемый в настоящем документе и предоставляющий в рамках его вызова информацию только по ОДНОЙ актовой записи

СМЭВ

Система межведомственного электронного взаимодействия

ФОИВ

Федеральный орган исполнительной власти

ЭП

Электронная подпись

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 г. № 000 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия» в соответствии с которым, для подключения информационной системы к системе межведомственного электронного взаимодействия Поставщик предоставляет Оператору РСМЭВ следующие документы:

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

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

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

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

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

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

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

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

-  Методические рекомендации по разработке электронных сервисов и применению технологии электронной подписи при межведомственном электронном взаимодействии версии 2.4.3 (публикация на http://smev. *****)

НЕ нашли? Не то? Что вы ищете?

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

Наименование:

Сервис предоставления Единичных сведений об актах гражданского состояния, зарегистрированных на территории РФ.

Кратко – сервис Единичных сведений об АГС.

Назначение:

Сервис предназначен для предоставления по запросам ФОИВ информации о зарегистрированных на территории РФ АГС, а также о гражданах – участниках данных АГС, по задаваемым критериям поиска и в запрашиваемом объеме сведений.

Каждый вызов сервиса предоставляет информацию только по ОДНОЙ актовой записи, удовлетворяющей заданным критериям поиска, или сообщение об ошибке (для запросов с отложенным ответом - также и статус исполнения запроса).

Поставщик:

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

Область применения:

Межведомственное взаимодействие

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

Электронный сервис Единичных сведений об АГС обеспечивает обмен данными между Потребителями (ИС ФОИВ) и Поставщиком (ИС «Электронный ЗАГС» федерального уровня, владельцем которой является Минюст России). Электронный сервис включает группы методов, обеспечивающие:

-  проверку существования (наличия) зарегистрированной актовой записи, запрашиваемого ИС Потребителя типа – метод поиска данных в ИС Поставщика по набору параметров;

-  проверку результата обработки запроса – метод получения ответа о готовности результатов поиска в ИС Поставщика по набору параметров и (или) о текущем статусе исполнения поискового запроса, либо об ошибке;

-  предоставление сведений актовой записи в объеме, запрашиваемом ИС Потребителя - метод поиска данных в ИС Поставщика по набору параметров и согласно требуемой полноте результатов поиска.

Метод

Назначение

Код: getPersonalCertificateBirth

Наименование: Запрос на получение сведений в объеме свидетельства о рождении

Метод обрабатывает запрос с быстрым ответом и синхронно возвращает ИС Потребителя. Результат его исполнения: либо персонифицированные сведения по требуемой актовой записи в объеме свидетельства о рождении, либо сообщение об ошибке.

Состав и значение параметров унифицированного служебного блока-обертки данных регламентируется методическими рекомендации по разработке электронных сервисов и применению технологии электронной подписи при межведомственном электронном взаимодействии версии 2.4.4, размещенными на http://smev. *****

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

ИС Потребителя (ИС ФОИВ) вызывает сервис Единичных сведений об АГС с целью получения от ИС Поставщика требуемой информации. Далее будем именовать такие вызовы (типы запросов) входящими.

Сервис Единичных сведений об АГС предполагает асинхронный сценарий работы с входящими запросами.

ИС ФОИВ вызывает метод на исполнение соответствующего запроса, который возвращает номер тикета, присвоенный данному запросу в ИС Поставщика. Далее ИС ФОИВ может периодически вызывать метод получения статуса/результата, который по номеру тикета возвращает либо результат (если он уже готов), либо статус исполнения запроса (если результат еще не готов или возникла ошибка).

При возникновении нештатных ситуаций в обработке сообщений любым из методов, возвращается сообщение об ошибке.

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

В рамках взаимодействия ИС ФОИВ направляет в адрес ИС Поставщика следующие типы сообщений:

-  Сообщение, содержащее запрос на проверку существования зарегистрированной актовой записи,

-  Сообщение, содержащее запрос на предоставление персонифицированной информации по актовой записи в требуемом объеме данных.

В рамках первого типа обрабатываемого сообщения, веб-сервис должен направить в адрес ИС ФОИВ одно из сообщений:

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

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

В случае успешной обработки поступивших сообщений и возврата номера тикета по запросу, ИС ФОИВ направляет в адрес веб-сервиса сообщение, содержащее запрос на получение ответа (согласно поступившему сообщению).

В рамках второго типа обрабатываемого сообщения, веб-сервис должен обработать запрос и в синхронном режиме направить в адрес ИС ФОИВ ответ:

-  Сообщение с результатом, содержащее набор персонифицированных сведений в запрашиваемом объеме данных (справки, копии записи акта, свидетельства);

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

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

Сервис Единичных сведений об АГС предполагает использование другого электронного сервиса в инфраструктуре Электронного правительства - сервиса получения справочных данных, необходимых для исполнения межведомственных запросов, связанных с деятельностью органов ЗАГС. Для работы с сервисом Единичных сведений об АГС необходимы:

-  справочник типов записей актов гражданского состояния,

-  справочник кодов органов ЗАГС.

-  справочник кодов регионов РФ.

Доступ к сервису получения справочных данных (сервис единой системы ведения нормативно-справочной информации) ИС Потребителей предоставляется после публикации этого сервиса на СМЭВ и согласно правам доступа каждого Потребителя.

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

3.1 Операция «getPersonalCertificateBirth»

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

Код операции:

getPersonalCertificateBirth

Наименование операции:

Запрос на получение сведений в объеме свидетельства о рождении.

Назначение операции:

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

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

Фильтр для поиска в запросе сформирован с учетом перечня участников (субъектов) записи АГС о рождении – содержит 3 субъекта: отец, мать и ребенок.

Элементы Soap-сообщения, относящиеся к унифицированному служебному блоку передачи структурированных сведений в соответствии с требованиями поставщика, находятся в пространстве имен http://smev. *****/rev111111.

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

№

Код параметра

Описание параметра

Обязательность

Способ заполнения/Тип

Комментарий

1

smev: Message

Класс электронного сообщения

+

smev: Message

../smev/smev. *****. rev111111.xsd (http://smev. *****/rev111111)

2

certificateBirthFilterRequestObj

Запрос на предоставлении сведений из зарегистрированной актовой записи о рождении в объеме свидетельства о рождении (фильтр для поиска)

+

tns:BirthFilterRequestObj

3

ds:Signature

Подпись поступившего запроса

+

ds:SignatureType

../xmldsig-core-schema. xsd (http://www. w3.org/2000/09/xmldsig#)

Сложный тип BirthFilterRequestObj

№ п. п.

Элемент

К-во

Тип

Примечание

1

child

0..1

tns:PersonFilter

Сведения о ребенке

2

mother

0..1

tns:PersonFilter

Сведения о матери

3

father

0..1

tns:PersonFilter

Сведения о отце

4

actRecordFilter

1..1

tns:ActRecordFilter

Сложный тип PersonFilter

№ п. п.

Элемент

К-во

Тип

Примечание

1

lastName

1..1

xs:string

Фамилия

2

firstName

1..1

xs:string

Имя

3

middleName

0..1

xs:string

Отчество

4

birthDate

1..1

xs:date

Дата рождения

5

birthPlace

0..1

cm:ShortAddress

Место рождения

6

gender

0..1

cm:GENDERS

Пол

7

snils

0..1

cm:SNILS

СНИЛС

Сложный тип ActRecordFilter

№ п. п.

Элемент

К-во

Тип

Примечание

1

requisitesActRecordFilter

0..1

tns:RequisiteActRecordFilter

Реквизиты записи акта

2

requisitesCertificateDocument

0..1

tns:RequisiteCertificateDocumentFilter

Реквизиты сертификата

Сложный тип RequisiteActRecordFilter

№ п. п.

Элемент

К-во

Тип

Примечание

1

requisitesActRecord

0..1

doc:ActRecordRequisites

Реквизиты записи акта

2

IsRecovered

0..1

xs:boolean

Признак востановления записи акта

Сложный тип RequisiteCertificateDocumentFilter

№ п. п.

Элемент

К-во

Тип

Примечание

1

number

1..1

xs:string

Номер свидетельства свидетельства

2

series

1..1

xs:string

Серия свидетельства

Сложный тип ActRecordRequisites

№ п. п.

Элемент

К-во

Тип

Примечание

1

1..1

xsd:any

2

1..1

xsd:any

3

1..1

xsd:any

4

1..1

xsd:any

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

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

Состав и значение параметров блока структурированных сведений приведен в таблице 2 и соответствует требованиям Методических рекомендаций по разработке электронных сервисов и применению технологии электронной подписи при межведомственном электронном взаимодействии версии 2.4.4, опубликованных на http://smev. *****.

Элементы Soap-сообщения, относящиеся к унифицированному служебному блоку передачи структурированных сведений в соответствии с требованиями поставщика находятся в пространстве имен http://smev. *****/rev111111.

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

№

Код параметра

Описание параметра

Обязательность

Способ заполнения/ Тип

Комментарий

1

smev: Message

Класс электронного сообщения

+

smev: Message

../smev/smev. *****. rev111111.xsd (http://smev. *****/rev111111)

2

certificateBirthResponseObj

Ответ на запрос в объеме свидетельства о рождении

+

tns: CertificateBirthResponse

3

ds:Signature

Подпись возвращаемого ответа

+

ds:SignatureType

../xmldsig-core-schema. xsd (http://www. w3.org/2000/09/xmldsig#)

Сложный тип CertificateBirthResponse

№ п. п.

Элемент

К-во

Тип

Примечание

1

1..1

xsd:any

2

MessageData

1..1

xsd:complexType

3

AppData

1..1

xsd:complexType

4

certificateBirthResponseObj

1..1

ns2:CertificateBirthResponseObj

5

0..1

xsd:any

6

AppDocument

1..1

smev:AppDocumentType

Сложный тип CertificateBirthResponseObj

№ п. п.

Элемент

К-во

Тип

Примечание

1

certificateBirth

0..1

doc:CertificateBirth

2

responceStatus

0..1

tns:ResponceStatus

Сложный тип CertificateBirth

№ п. п.

Элемент

К-во

Тип

Примечание

1

1..1

xsd:any

2

certificateBirth

1..1

doc:ActRecordToCertificateBirth

Сложный тип ActRecordToCertificateBirth

№ п. п.

Элемент

К-во

Тип

Примечание

1

1..1

xsd:any

2

1..1

xsd:any

3

1..1

xsd:any

4

1..1

xsd:any

5

child

1..1

ac:Child

сведения о ребёнке

6

father

0..1

ac:Citizen

сведения об отце ребенка (в объеме "Гражданин")

7

mother

0..1

ac:Citizen

сведения о матери ребенка (в объеме "Гражданин")

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

№

Код возврата

Описание кода возврата

Условия возникновения

1

0

Успешно (предоставлено в требуемом объеме)

Данный код возврата соответствует ситуации, когда искомая актовая запись найдена в БД ИС Поставщика и сведения предоставлены в требуемом объеме

2

1

Актовая запись не найдена

Данный код возврата соответствует ситуации, когда искомая актовая запись не найдена в БД ИС Поставщика (либо не точно заданы параметры поиска, либо действительно такая актовая запись не была зарегистрирована на территории РФ)

3

2

Найдено более одной актовой записи

Данный код возврата соответствует ситуации, когда требуется уточнить параметры поиска

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

3.1.5.1  Пример вызова сервиса

Ниже приведена схема xml-контента запроса на получение сведений:

<soapenv:Envelope xmlns:soapenv="http://schemas. xmlsoap. org/soap/envelope/">

<soapenv:Header/>

<soapenv:Body>

<type:certificateBirthFilterRequest xmlns:type="http://ezags. *****/fzags/InterDepPersonalService/type/" xmlns:rev="http://smev. *****/rev111111" xmlns:com="http://ezags. *****/type/common/" xmlns:doc="http://ezags. *****/type/document/">

<rev:Message>

<rev:Sender>

<rev:Code>ZAGS_SYS_1</rev:Code>

<rev:Name>ЗАГС</rev:Name>

</rev:Sender>

<rev:Recipient>

<rev:Code>REG_63_SO_SYS_1</rev:Code>

<rev:Name>Государственная информационная система Самарской области «Система межведомственного электронного взаимодействия Самарской области»</rev:Name>

</rev:Recipient>

<rev:Originator>

<rev:Code>ZAGS_SYS_1</rev:Code>

<rev:Name>ЗАГС</rev:Name>

</rev:Originator>

<rev:TypeCode>GSRV</rev:TypeCode>

<rev:Status>REQUEST</rev:Status>

<rev:Date>T00:00:00</rev:Date>

<rev:ExchangeType>0</rev:ExchangeType>

</rev:Message>

<rev:MessageData>

<AppData>

<birthFilterRequestObj>

<child>

<lastName>QQQQQQQQQQQQQ</lastName>

<firstName>qwe</firstName>

<middleName>qwer</middleName>

<birthDate>06:00</birthDate>

</child>

<actRecordFilter>

<requisitesActRecordFilter>

<requisitesActRecord>

<com:registrarId>654</com:registrarId>

<doc:documentUID>987</doc:documentUID>

<doc:number>198</doc:number>

<doc:documentDate>

<com:day>5</com:day>

<com:month>9</com:month>

<com:year>1999</com:year>

</doc:documentDate>

</requisitesActRecord>

</requisitesActRecordFilter>

<requisitesCertificateDocument>

<number>214</number>

<series>1234</series>

</requisitesCertificateDocument>

</actRecordFilter>

</birthFilterRequestObj>

</AppData>

<AppDocument/>

</rev:MessageData>

</type:certificateBirthFilterRequest>

</soapenv:Body>

</soapenv:Envelope>

Cхема xml-контента ответа на запрос на получение сведений:

Из за большого объема этот материал размещен на нескольких страницах:
1 2