3. Описание веб-сервиса

Организация межведомственного взаимодействия
с Росреестром через интерфейс веб-сервисов по
каналам СМЭВ
Версия 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
Введение
1.
В
рамках
реализации
комплексных
мероприятий
по
обеспечению
межведомственного и межуровневого взаимодействия Росреестром разработан веб-сервис
для оказания следующих государственных услуг в электронном виде:
Предоставление информации из Единого государственного реестра прав
(ЕГРП) в виде выписки:
•
•
•
выписки содержащей сведения о зарегистрированных правах на объект
недвижимости;
выписки о правах отдельного лица на имеющиеся у него объекты недвижимого
имущества;
справки о содержании правоустанавливающего документа.
Предоставление информации
недвижимости (ГКН)в виде:
•
•
•
•
внесенной
в
государственный
кадастр
кадастровой выписки об объекте недвижимости;
кадастрового паспорта объекта недвижимости;
кадастрового плана территории;
копии документа.
Сервис предназначен для обеспечения полного цикла информационного
взаимодействия в рамках оказания услуг в электронном виде. Сервис предназначен как
для взаимодействия с органами, предоставляющими государственные услуги, и органами,
предоставляющими муниципальные услуги через СМЭВ, так и с ЕПГУ. Под полным
циклом взаимодействия подразумевается: прием заявления в электронном виде,
информирование о ходе исполнения услуги (обновление статусов по запросу и в
инициативном порядке), выдача пакета документов, являющегося результатом оказания
услуги.
2.
Предварительные требования к потребителю
Для организации межведомственного взаимодействия с использованием
описываемого в настоящем документе веб-сервиса потребителю информации необходимо:
1. Разработать программный клиент, соответствующий требованиям, изложенным в
настоящем документе;
2. Выполнить организационные и технические мероприятия по подключению к
СМЭВ и организации защищенного канала между потребителем и СМЭВ,
установленные приказом Министерства связи и массовых коммуникаций
Российской Федерации от 27.12.2010 № 190 «Об утверждении технических
требований к взаимодействию информационных систем в единой системе
межведомственного электронного взаимодействия».
3.
Описание веб-сервиса
3.1. Описание процесса информационного
взаимодействия
Информационное взаимодействие производится по инициативе системыпотребителя информации. Взаимодействие осуществляется в асинхронном режиме.
Общая схема процесса взаимодействия представлена на Рисунок 1.
Системапоставщик
(Росреестр)
Системапотребитель
Создание заявления. Вызов метода CreateRequest
Ответ-квитанция, содержащий идентификационный номер, присвоенный заявлению. Либо
сообщение об ошибке
СМЭВ
Запрос статуса обработки заявления. Вызов метода GetStatus
Ответ, содержащий код актуального статуса. В случае окончания обработки заявления
одновременно со статусом возвращается результат выполнения заявления
Рисунок 1
Процесс взаимодействия состоит из следующих шагов:
1. Система-потребитель вызывает метод веб-сервиса CreateRequest и передает пакет
заявления;
a. В ответ на вызов метода CreateRequest система-потребитель получает ответквитанцию, содержащий номер заявления, присвоенный ведомственной
системой-поставщиком;
b. В случае сбоя, в ответ на вызов метода придет сообщение об ошибке.
2. После получения идентификационного номера заявления, система-потребитель
может неограниченное количество раз вызывать метод GetStatus для получения
актуальной информации о ходе обработки заявления.
a. В ответ на вызов метода GetStatus система-потребитель получает сообщение
с указанием кода актуального статуса;
b. Если статус обработки окончательный (заявление выполнено), то вместе с
кодом статуса система-потребитель получает результат выполнения
заявления.
c. В случае сбоя, в ответ на вызов метода придет сообщение об ошибке.
3.2. Описание методов
Веб-сервис предоставляет следующие методы:1
CreateRequest – создание заявления;
GetStatus – запрос актуального статуса по заявлению.
3.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 - номер заявки в информационной системе-отправителе
(регламентируется методическими рекомендациями Минкомсвязи).
Описанные в WSDL методы GetEvents и LoadEventDetails используются в редких случаях при оказании
услуги «Постановка объектов недвижимости на государственный кадастровый учет». За консультациями о
порядке использования данных методов можно обратиться по адресу: developer.support@fccland.ru
2
Последнюю версию методических рекомендаций Минкомсвязи можно скачать на технологическом
портале СМЭВ по адресу http://smev.gosuslugi.ru/techportal/index.html
1
 MessageData/AppData/createRequestBean/requestType - тип заявления (например
"558101010000" для заявлений получения сведений из ГКН, "558102100000" для
заявлений о предоставлении сведений из ЕГРП) (обязательный параметр).
 MessageData/AppData/createRequestBean/okato - ОКАТО региона
(месторасположения объекта или субъекта, в случае запроса на права отдельного
лица на территории РФ указывается значение «11111111111») (обязательный
параметр).
 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 - дата формирования ответа на запрос (обязательный параметр).
3.2.1.1. Пример вызова метода CreateRequest
Наименование услуги
Примеры запросов
Предоставление сведений,
содержащихся в Государственном
Кадастре Недвижимости
Предоставление сведений,
содержащихся в Едином
Государственном Реестре прав на
недвижимое имущество и сделок с
ним
gkn_req.xml
gkn_resp.xml
egrp_req.xml
egrp_resp.xml
3.2.1.2. Примеры формирования файла заявления в зависимости от типа
запроса
Наименование услуги
Примеры запросов
Пример формирования запроса в
ЕГРП о правах отдельного лица.
res_egrp_s_doc.doc
Пример формирования запроса в
ЕГРП о правах на объект
недвижимости.
res_egrp_obj_doc.d
oc
Предоставление сведений
государственного кадастра
недвижимости о земельном участке в
виде кадастрового паспорта объекта
недвижимости.
Предоставление сведений
государственного кадастра
недвижимости о земельном участке в
виде кадастровой выписки.
Предоставление сведений
государственного кадастра
недвижимости о территории в
пределах кадастрового квартала в
виде кадастрового плана территории.
res_gkn_zu_kp_doc.
doc
res_gkn_zu_kv_doc.
doc
res_gkn_tkk_kpt_doc
.doc
3.2.1.3. Правила формирования zip-архива, содержащего файл
заявления
Имя файла: req_<GUID_пакета>.zip
GUID_пакета имеет вид xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Состав:
В обязательном порядке содержит в корне архива один xml-файл с данными
заявления (req_<GUID_заявления>.xml).
Может содержать файлы электронных документов (межевые планы, технические
паспорта, сканы документов) и образы приложенных документов, которые могут
находиться на любом уровне вложенности в архиве, но пути должны быть прописаны в
xml-файле с данными заявления (req_<GUID_заявления>.xml).
Для правильного формирования Пакета заявления следует руководствоваться XSD
схемой, соответствующей типу запрашиваемой услуги. XSD схемы для различных типов
услуг приведены в таблице ниже:
Наименование услуги
Предоставление сведений, содержащихся в
Государственном Кадастре Недвижимости
Описание XSD схемы
xsd.zip
Предоставление сведений, содержащихся в
Едином Государственном Реестре прав на
недвижимое имущество и сделок с ним
3.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 – документ в приложении (не обязательный
заполняется, если одновременно с конечным статусом передается ответ по
заявлению).
3.2.2.1. Пример вызова метода GetStatus
request.xml
response.xml
3.2.2.2. Перечень возможных статусов
Название статуса
Описание статуса
Заявка зарегистрирована в ИС Росреестра
Осуществляется проверка ФЛК и проверка ЭЦП
ФЛК, либо проверка ЭЦП не пройдена
003
Создана
На проверке
Проверка не
пройдена
В работе
004
Завершена
0040
Завершена отказом
0041
Сведения
отсутствуют
Отказ в обработке
Код
статуса
000
001
0010
0043
Заявка прошла проверку и находится на
исполнении.
Заявление завершено с положительным
результатом. Одновременно с данным статусом
возвращается результат выполнения заявления.
Принято решение об отказе в предоставлении
сведений/проведении учетных действий.
Учетная Система не нашла объектов по указанным
в запросе параметрам.
Учетная Система отказала в обработке заявления
(например, не все необходимые документы
приложены).
3.2.2.3. Форматы возвращаемых результатов обработки заявления
В таблице ниже представлены схемы формирования электронных результатов оказания
услуги:
Наименование услуги
Схема ответа
Предоставление сведений, содержащихся в
Государственном Кадастре Недвижимости
Предоставление сведений, содержащихся в
Едином Государственном Реестре прав на
недвижимое имущество и сделок с ним (в
виде выписки из Единого государственного
реестра прав на недвижимое имущество и
сделок с ним о правах отдельного лица на
имеющиеся у него объекты недвижимости
имущества на территории)
Предоставление сведений, содержащихся в
Едином Государственном Реестре прав на
недвижимое имущество и сделок с ним (в
виде выписки из Единого государственного
реестра прав на недвижимое имущество и
сделок с ним, содержащей сведения о
зарегистрированных правах на объект
недвижимости)
3.3. Доступ к веб-сервису
Участникам межведомственного взаимодействия получить доступ к сервису можно через
СМЭВ по адресу: http://oraas.rt.ru:7777/gateway/services/SID0003109?wsdl или
http://oraas.rt.ru:7777/gateway/services/SID0003187
Для тестирования и отладки необходимо использовать тестовый экземпляр сервисов:
http://test-ext.fccland.ru:80/smev/smevService - прямой доступ из интернет;
http://46.61.162.210:7777/gateway/services/SID0003280?wsdl – доступ через тестовый
СМЭВ, без проверки ведомственной подписи;
http://188.254.16.92:7777/gateway/services/SID0003011?wsdl - доступ через тестовый
СМЭВ, с проверкой ведомственной подписи.
3.4. Электронная подпись уполномоченного лица
3.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 - Уполномоченное лицо для подписания электронных документов при
межведомственном взаимодействии
Для подписания ЭЦП электронных сообщений, которыми обмениваются Системапотребитель и Система-поставщик, Система-потребитель должна иметь сертификат,
полученный в одном из Удостоверяющих Центров, входящих в единое пространство
доверия.
3.4.1.2. Тестовые ключи
Для формирования электронной подписи ответственного лица на тестовом контуре
рекомендуется использовать ключи, сформированные на основании рекомендаций
изложенных в разделе 3.2.1.1. настоящего документа.
Для формирования подписи можно использовать приложенные ключи:
3.5. Поддержка
3.5.1 Контактная информация
Обращение в электронном виде в службу технической поддержки осуществляется
по адресу электронной почты Support_Site@rosreestr.ru.
3.5.2 Состав сведений обращения
Состав сведений указываемых при подаче запроса в службу технической поддержки:
 в теме обращения в обязательном порядке указывается признак «СМЭВ»






наименование ведомства потребителя информации, и причина обращения в службу
технической поддержки (вопрос, предложение и т.п.);
контур, на который подавался запрос (тестовый/продуктивный);
наименование базового ресурса (ЕГРП, ГКН);
тип заявления (запрос о правах отдельного лица, о правах на объект недвижимости
и т.п.);
номер входящего запроса, сообщенного Росреестром (отсутствие данного номера с
большой долей вероятности указывает на ошибку формирования/подписания
конверта и говорит о том, что конверт не дошел до сервиса Росреестра);
сведения об ошибке;
описание сути обращения.
Состав прилагаемых данных:
 SOAP конверт запроса;
 zip-файл архива, содержащего xml-заявления и файл подписи.
3.6. Лист изменений
Версия
1.0
Дата изменения
07.06.2011
1.1
08.06.2011
1.2
09.06.2011
1.3
18.08.2011
1.4
06.09.2011
1.5
2.0
16.12.2011
20.12.2011
Перечень изменений
1. В разделе 3.2.2.3 в архив «Выписки ГКН.rar»
добавлены описания xsd-схем ответов;
2. Добавлен раздел 3.5 Лист изменений.
Внесены изменения согласно методическим
рекомендациям версии 2.3.3
Изменен адрес сервиса в тестовом СМЭВ с проверкой
ведомственной подписи