Организация межведомственного взаимодействия с Росреестром через интерфейс веб-сервисов по каналам СМЭВ
Версия 2.0
Содержание
1. Введение. 3
2. Предварительные требования к потребителю.. 3
3. Описание веб-сервиса. 4
3.1. Описание процесса информационного взаимодействия. 4
3.2. Описание методов. 5
3.2.1. Метод CreateRequest 5
3.2.2. Метод GetStatus. 8
3.3. Доступ к веб-сервису. 11
3.4. Электронная подпись уполномоченного лица. 11
3.5. Поддержка. 12
3.5.1 Контактная информация. 12
3.5.2 Состав сведений обращения. 12
3.6. Лист изменений. 12
2. Введение
В рамках реализации комплексных мероприятий по обеспечению межведомственного и межуровневого взаимодействия Росреестром разработан веб-сервис для оказания следующих государственных услуг в электронном виде:
Предоставление информации из Единого государственного реестра прав (ЕГРП) в виде выписки:
• выписки содержащей сведения о зарегистрированных правах на объект недвижимости;
• выписки о правах отдельного лица на имеющиеся у него объекты недвижимого имущества;
• справки о содержании правоустанавливающего документа.
Предоставление информации внесенной в государственный кадастр недвижимости (ГКН)в виде:
• кадастровой выписки об объекте недвижимости;
• кадастрового паспорта объекта недвижимости;
• кадастрового плана территории;
• копии документа.
Сервис предназначен для обеспечения полного цикла информационного взаимодействия в рамках оказания услуг в электронном виде. Сервис предназначен как для взаимодействия с органами, предоставляющими государственные услуги, и органами, предоставляющими муниципальные услуги через СМЭВ, так и с ЕПГУ. Под полным циклом взаимодействия подразумевается: прием заявления в электронном виде, информирование о ходе исполнения услуги (обновление статусов по запросу и в инициативном порядке), выдача пакета документов, являющегося результатом оказания услуги.
3. Предварительные требования к потребителю
Для организации межведомственного взаимодействия с использованием описываемого в настоящем документе веб-сервиса потребителю информации необходимо:
1. Разработать программный клиент, соответствующий требованиям, изложенным в настоящем документе;
2. Выполнить организационные и технические мероприятия по подключению к СМЭВ и организации защищенного канала между потребителем и СМЭВ, установленные приказом Министерства связи и массовых коммуникаций Российской Федерации «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия».
4. Описание веб-сервиса
4.1. Описание процесса информационного взаимодействия
Информационное взаимодействие производится по инициативе системы-потребителя информации. Взаимодействие осуществляется в асинхронном режиме.
Общая схема процесса взаимодействия представлена на Рисунок 1.
Рисунок 1
Процесс взаимодействия состоит из следующих шагов:
1. Система-потребитель вызывает метод веб-сервиса CreateRequest и передает пакет заявления;
a. В ответ на вызов метода CreateRequest система-потребитель получает ответ-квитанцию, содержащий номер заявления, присвоенный ведомственной системой-поставщиком;
b. В случае сбоя, в ответ на вызов метода придет сообщение об ошибке.
2. После получения идентификационного номера заявления, система-потребитель может неограниченное количество раз вызывать метод GetStatus для получения актуальной информации о ходе обработки заявления.
a. В ответ на вызов метода GetStatus система-потребитель получает сообщение с указанием кода актуального статуса;
b. Если статус обработки окончательный (заявление выполнено), то вместе с кодом статуса система-потребитель получает результат выполнения заявления.
c. В случае сбоя, в ответ на вызов метода придет сообщение об ошибке.
4.2. Описание методов
Веб-сервис предоставляет следующие методы:[1]
CreateRequest – создание заявления;
GetStatus – запрос актуального статуса по заявлению.
4.2.1. Метод CreateRequest
Метод предназначен для регистрации заявления (запроса) в информационной системе поставщика (Росреестра).
Параметры заявления (запроса):
- MessageData/AppDocument/BinaryData - zip-файл со сформированным заявлением (обязательный параметр).
- Message/Originator/Code- код системы-инициатора цепочки запросов-ответов в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи[2]).
- Message/Originator/Name – наименование системы инициатора цепочки запросов-ответов в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Sender/Code - код системы потребителя запроса в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Sender/Name - наименование системы потребителя запроса в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Recipient/Code - код системы получателя запроса в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Recipient/Name - наименование системы получателя запроса в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/TypeCode – тип запроса (обязательный параметр).
- Message/Date – дата создания запроса (обязательный параметр).
- Message/RequestIdRef - идентификатор сообщения-запроса, инициировавшего взаимодействие (регламентируется методическими рекомендациями Минкомсвязи).
- Message/OriginRequestIdRef - идентификатор сообщения-запроса, инициировавшего цепочку из нескольких запросов-ответов, объединенных единым процессом в рамках взаимодействия (регламентируется методическими рекомендациями Минкомсвязи).
- Message/ServiceCode - код услуги (регламентируется методическими рекомендациями Минкомсвязи).
- Message/CaseNumber - номер заявки в информационной системе-отправителе (регламентируется методическими рекомендациями Минкомсвязи).
- MessageData/AppData/createRequestBean/requestType - тип заявления (например "" для заявлений получения сведений из ГКН, "" для заявлений о предоставлении сведений из ЕГРП) (обязательный параметр).
- MessageData/AppData/createRequestBean/okato - ОКАТО региона (месторасположения объекта или субъекта, в случае запроса на права отдельного лица на территории РФ указывается значение «») (обязательный параметр).
- MessageData/AppData/createRequestBean/oktmo - ОКТМО объекта, в отношении которого создаётся заявление (необязательный параметр).
Параметры ответа:
- MessageData/AppData/eServiceResult/comment - сообщение о статусе обработки запроса ("Вызов обработан успешно" для успешной обработки, "При обработке вызова возникли ошибки" для проблемного случая и "Не передан zip-файл заявления" - специальное сообщение для случая отсутствия архива).
- MessageData/AppData/eServiceResult/extOrderNumber - идентификатор созданного заявления на стороне Росреестра.
- Message/ServiceCode - идентификатор услуги, запрошенной в указанном заявлении ("78" - получение сведений из ГКН).
- MessageData/AppData/eServiceResult/orgOrderStatusCode - код статуса обработки запроса ("0010" для ошибки при создании заявления, "0" для успешного сценария).
- MessageData/AppData/responseHeader/error/errorCode - код статуса выполнения запроса (0L - если вызов прошёл успешно, 0010L - если не удалось создать заявление).
- MessageData/AppData/responseHeader/error/errorMessage - сообщение о статусе выполнения запроса ("ОК" - если вызов прошёл успешно, "Не передан zip-файл заявления" - в случае отсутствия архива, либо сообщение, описывающее ошибку создания заявления).
- Message/Originator/Code- код системы-инициатора цепочки запросов-ответов в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Originator/Name – наименование системы инициатора цепочки запросов-ответов в СМЭВ. (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Sender/Code - код организации Росреестра в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Sender/Name – наименование кода организации Росреестра в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Recipient/Code - код системы получателя запроса в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Recipient/Name - наименование системы получателя запроса в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/TypeCode – тип запроса (обязательный параметр).
- Message/Date - дата формирования ответа на запрос (обязательный параметр).
4.2.1.1. Пример вызова метода CreateRequest
Наименование услуги | Примеры запросов |
Предоставление сведений, содержащихся в Государственном Кадастре Недвижимости |
|
Предоставление сведений, содержащихся в Едином Государственном Реестре прав на недвижимое имущество и сделок с ним |
|
4.2.1.2. Примеры формирования файла заявления в зависимости от типа запроса
Наименование услуги | Примеры запросов |
Пример формирования запроса в ЕГРП о правах отдельного лица. |
|
Пример формирования запроса в ЕГРП о правах на объект недвижимости. |
|
Предоставление сведений государственного кадастра недвижимости о земельном участке в виде кадастрового паспорта объекта недвижимости. |
|
Предоставление сведений государственного кадастра недвижимости о земельном участке в виде кадастровой выписки. |
|
Предоставление сведений государственного кадастра недвижимости о территории в пределах кадастрового квартала в виде кадастрового плана территории. |
|
4.2.1.3. Правила формирования zip-архива, содержащего файл заявления
Имя файла: req_<GUID_пакета>.zip
GUID_пакета имеет вид xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Состав:
В обязательном порядке содержит в корне архива один xml-файл с данными заявления (req_<GUID_заявления>.xml).
Может содержать файлы электронных документов (межевые планы, технические паспорта, сканы документов) и образы приложенных документов, которые могут находиться на любом уровне вложенности в архиве, но пути должны быть прописаны в xml-файле с данными заявления (req_<GUID_заявления>.xml).
Для правильного формирования Пакета заявления следует руководствоваться XSD схемой, соответствующей типу запрашиваемой услуги. XSD схемы для различных типов услуг приведены в таблице ниже:
Наименование услуги | Описание XSD схемы |
Предоставление сведений, содержащихся в Государственном Кадастре Недвижимости |
|
Предоставление сведений, содержащихся в Едином Государственном Реестре прав на недвижимое имущество и сделок с ним |
|
4.2.2. Метод GetStatus
Параметры запроса:
- Message/Originator/Code- код системы-инициатора цепочки запросов-ответов в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Originator/Name – наименование системы инициатора цепочки запросов-ответов в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Sender/Code - код системы потребителя запроса в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Sender/Name - наименование системы потребителя запроса в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Recipient/Code - код системы получателя запроса в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Recipient/Name - наименование системы получателя запроса в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/TypeCode – тип запроса (обязательный параметр).
- Message/Date – дата создания запроса (обязательный параметр).
- Message/RequestIdRef - идентификатор сообщения-запроса, инициировавшего взаимодействие (регламентируется методическими рекомендациями Минкомсвязи).
- Message/OriginRequestIdRef - идентификатор сообщения-запроса, инициировавшего цепочку из нескольких запросов-ответов, объединенных единым процессом в рамках взаимодействия (регламентируется методическими рекомендациями Минкомсвязи).
- Message/ServiceCode - код услуги (регламентируется методическими рекомендациями Минкомсвязи).
- Message/CaseNumber - номер заявки в информационной системе-отправителе (регламентируется методическими рекомендациями Минкомсвязи).
- MessageData/AppData/requestNumber - переданный в ответном конверте операции CreateRequest идентификатор созданного заявления на стороне Росреестра (обязательный параметр).
Параметры ответа:
- MessageData/AppData/eServiceResult/comment - сообщение о статусе заявления или сообщение об ошибке обработки запроса (примеры: "В работе",..).
- MessageData/AppData/eServiceResult/extOrderNumber - идентификатор заявления на стороне Росреестра (эквивалентен requestHeader/requestId запроса).
- Message/ServiceCode - идентификатор услуги, запрошенной в указанном заявлении ("78" - получение сведений из ГКН, "79" - регистрация прав, в остальных случаях - внутренняя константа).
- MessageData/AppData/eServiceResult/orgOrderStatusCode - код текущего статуса заявления на стороне Росреестра (например, "0010", "003",..).
- MessageData/AppData/responseHeader/error/errorCode - код статуса выполнения запроса (0L - если вызов прошёл успешно, -1L - если не удалось выполнить (например, не найдено заявление с указанным номером)).
- MessageData/AppData/responseHeader/error/errorMessage - сообщение о статусе выполнения запроса ("ОК" - если вызов прошёл успешно, "Заявка не найдена" - если не удалось выполнить (например, не найдено заявление с указанным номером)).
- Message/Originator/Code- код системы-инициатора цепочки запросов-ответов в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Originator/Name – наименование системы инициатора цепочки запросов-ответов в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Sender/Code - код организации Росреестра в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Sender/Name – наименование кода организации Росреестра в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Recipient/Code - код системы получателя запроса в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/Recipient/Name - наименование системы получателя запроса в СМЭВ (регламентируется методическими рекомендациями Минкомсвязи).
- Message/TypeCode – тип запроса (обязательный параметр).
- Message/Date - дата формирования ответа на запрос (не обязательный заполняется, если одновременно с конечным статусом передается ответ по заявлению).
- MessageData/AppDocument/BinaryData – документ в приложении (не обязательный заполняется, если одновременно с конечным статусом передается ответ по заявлению).
4.2.2.1. Пример вызова метода GetStatus
4.2.2.2. Перечень возможных статусов
Код статуса | Название статуса | Описание статуса |
000 | Создана | Заявка зарегистрирована в ИС Росреестра |
001 | На проверке | Осуществляется проверка ФЛК и проверка ЭЦП |
0010 | Проверка не пройдена | ФЛК, либо проверка ЭЦП не пройдена |
003 | В работе | Заявка прошла проверку и находится на исполнении. |
004 | Завершена | Заявление завершено с положительным результатом. Одновременно с данным статусом возвращается результат выполнения заявления. |
0040 | Завершена отказом | Принято решение об отказе в предоставлении сведений/проведении учетных действий. |
0041 | Сведения отсутствуют | Учетная Система не нашла объектов по указанным в запросе параметрам. |
0043 | Отказ в обработке | Учетная Система отказала в обработке заявления (например, не все необходимые документы приложены). |
4.2.2.3. Форматы возвращаемых результатов обработки заявления
В таблице ниже представлены схемы формирования электронных результатов оказания услуги:
Наименование услуги | Схема ответа |
Предоставление сведений, содержащихся в Государственном Кадастре Недвижимости |
|
Предоставление сведений, содержащихся в Едином Государственном Реестре прав на недвижимое имущество и сделок с ним (в виде выписки из Единого государственного реестра прав на недвижимое имущество и сделок с ним о правах отдельного лица на имеющиеся у него объекты недвижимости имущества на территории) |
|
Предоставление сведений, содержащихся в Едином Государственном Реестре прав на недвижимое имущество и сделок с ним (в виде выписки из Единого государственного реестра прав на недвижимое имущество и сделок с ним, содержащей сведения о зарегистрированных правах на объект недвижимости) |
|
4.3. Доступ к веб-сервису
Участникам межведомственного взаимодействия получить доступ к сервису можно через СМЭВ по адресу: http://oraas. *****:7777/gateway/services/SID0003109?wsdl или http://oraas. *****:7777/gateway/services/SID0003187
Для тестирования и отладки необходимо использовать тестовый экземпляр сервисов: http://test-ext. *****:80/smev/smevService - прямой доступ из интернет;
http://46.61.162.210:7777/gateway/services/SID0003280?wsdl – доступ через тестовый СМЭВ, без проверки ведомственной подписи;
http://188.254.16.92:7777/gateway/services/SID0003011?wsdl - доступ через тестовый СМЭВ, с проверкой ведомственной подписи.
4.4. Электронная подпись уполномоченного лица
4.4.1.1. Требования к ключам подписи
Состав объектных идентификаторов (ОИД):
Для сертификата руководителя/зам. руководителя ФОИВ:
1.2.643.5.1.24.2.20 - Руководитель федерального органа исполнительной власти или иное уполномоченное лицо данного органа в соответствии с федеральным законом
1.2.643.100.2.1 - Уполномоченное лицо для подписания электронных документов при межведомственном взаимодействии
Для сертификата руководителя/зам. руководителя территориального органа ФОИВ:
1.2.643.5.1.24.2.43 - Руководитель территориального органа федерального органа исполнительной власти или иное уполномоченное лицо данного органа в соответствии с федеральным законом
1.2.643.100.2.1 - Уполномоченное лицо для подписания электронных документов при межведомственном взаимодействии
Для подписания ЭЦП электронных сообщений, которыми обмениваются Система-потребитель и Система-поставщик, Система-потребитель должна иметь сертификат, полученный в одном из Удостоверяющих Центров, входящих в единое пространство доверия.
4.4.1.2. Тестовые ключи
Для формирования электронной подписи ответственного лица на тестовом контуре рекомендуется использовать ключи, сформированные на основании рекомендаций изложенных в разделе 3.2.1.1. настоящего документа.
Для формирования подписи можно использовать приложенные ключи:
4.5. Поддержка
3.5.1 Контактная информация
Обращение в электронном виде в службу технической поддержки осуществляется по адресу электронной почты.
3.5.2 Состав сведений обращения
Состав сведений указываемых при подаче запроса в службу технической поддержки:
- в теме обращения в обязательном порядке указывается признак «СМЭВ» наименование ведомства потребителя информации, и причина обращения в службу технической поддержки (вопрос, предложение и т. п.);
- контур, на который подавался запрос (тестовый/продуктивный);
- наименование базового ресурса (ЕГРП, ГКН);
- тип заявления (запрос о правах отдельного лица, о правах на объект недвижимости и т. п.);
- номер входящего запроса, сообщенного Росреестром (отсутствие данного номера с большой долей вероятности указывает на ошибку формирования/подписания конверта и говорит о том, что конверт не дошел до сервиса Росреестра);
- сведения об ошибке;
- описание сути обращения.
Состав прилагаемых данных:
- SOAP конверт запроса;
- zip-файл архива, содержащего xml-заявления и файл подписи.
4.6. Лист изменений
Версия | Дата изменения | Перечень изменений |
1.0 | 07.06.2011 | |
1.1 | 08.06.2011 | 1. В разделе 3.2.2.3 в архив «Выписки ГКН. rar» добавлены описания xsd-схем ответов; 2. Добавлен раздел 3.5 Лист изменений. |
1.2 | 09.06.2011 | |
1.3 | 18.08.2011 | Внесены изменения согласно методическим рекомендациям версии 2.3.3 |
1.4 | 06.09.2011 | Изменен адрес сервиса в тестовом СМЭВ с проверкой ведомственной подписи |
1.5 | 16.12.2011 | |
2.0 | 20.12.2011 |
[1] Описанные в WSDL методы GetEvents и LoadEventDetails используются в редких случаях при оказании услуги «Постановка объектов недвижимости на государственный кадастровый учет». За консультациями о порядке использования данных методов можно обратиться по адресу: developer. *****@***ru
[2] Последнюю версию методических рекомендаций Минкомсвязи можно скачать на технологическом портале СМЭВ по адресу http://smev. *****/techportal/index. html
