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

Организация межведомственного взаимодействия
с Росреестром через интерфейс веб-сервисов по
каналам СМЭВ
Версия 1.3
Содержание
1.
Введение .................................................................................................................................3
2.
Предварительные требования к потребителю ....................................................................3
3.
Описание веб-сервиса ...........................................................................................................3
3.1.
Описание процесса информационного взаимодействия .............................................3
3.2.
Описание методов ...........................................................................................................4
3.2.1.
Метод CreateRequest ................................................................................................5
3.2.2.
Метод GetStatus .......................................................................................................7
3.3.
Доступ к веб-сервису ......................................................................................................9
3.4.
Требования к ЭЦП ..........................................................................................................9
3.5.
Лист изменений ...............................................................................................................9
1.
Введение
В
рамках
реализации
комплексных
мероприятий
по
обеспечению
межведомственного и межуровневого взаимодействия Росреестром разработан веб-сервис
для оказания следующих государственных услуг в электронном виде:
1. Постановка объектов недвижимости на государственный кадастровый учет;
2. Предоставление сведений, содержащихся в Государственном Кадастре
Недвижимости;
3. Предоставление сведений, содержащихся в Едином Государственном
Реестре прав на недвижимое имущество и сделок с ним;
Сервис предназначен для обеспечения полного цикла информационного
взаимодействия в рамках оказания услуг в электронном виде. Сервис предназначен как
для взаимодействия с органами, предоставляющими государственные услуги, и органами,
предоставляющими муниципальные услуги через СМЭВ, так и с ЕПГУ. Под полным
циклом взаимодействия подразумевается: прием заявления в электронном виде,
информирование о ходе исполнения услуги (обновление статусов по запросу и в
инициативном порядке), выдача пакета документов, являющегося результатом оказания
услуги.
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 – запрос актуального статуса по заявлению.
Описанные в WSDL методы GetEvents и LoadEventDetails используются в редких случаях при оказании
услуги «Постановка объектов недвижимости на государственный кадастровый учет». За консультациями о
порядке использования данных методов можно обратиться по адресу: developer.support@fccland.ru
1
3.2.1. Метод CreateRequest
Метод предназначен для регистрации заявления (запроса) в информационной
системе поставщика (Росреестра).
Параметры заявления (запроса):
 MessageData/AppDocument/BinaryData - zip-файл со сформированным











заявлением.
Message/Originator/Code- код системы-инициатора цепочки запросов-ответов в
СМЭВ.
Message/Originator/Name – наименование системы инициатора цепочки запросовответов в СМЭВ.
Message/Sender/Code - код системы потребителя запроса в СМЭВ.
Message/Sender/Name - наименование системы потребителя запроса в СМЭВ.
Message/Recipient/Code - код системы получателя запроса в СМЭВ.
Message/Recipient/Name - наименование системы получателя запроса в СМЭВ.
Message/TypeCode – тип запроса
Message/Date – дата создания запроса
MessageData/AppData/createRequestBean/requestType - тип заявления
("558101010000" для заявлений получения сведений из ГКН, "558101020000" для
заявлений постановки на кадастровый учёт, "558102100000" для заявлений о
предоставлении сведений из ЕГРП).
MessageData/AppData/createRequestBean/okato - ОКАТО объекта, в отношении
которого создаётся заявление.
MessageData/AppData/createRequestBean/oktmo - ОКТМО объекта, в отношении
которого создаётся заявление.
Параметры ответа:
 MessageData/AppData/eServiceResult/comment - сообщение о статусе обработки





запроса ("Вызов обработан успешно" для успешной обработки, "При обработке
вызова возникли ошибки" для проблемного случая и "Не передан zip-файл
заявления" - специальное сообщение для случая отсутствия архива).
MessageData/AppData/eServiceResult/extOrderNumber - идентификатор
созданного заявления на стороне Росреестра.
Message/ServiceCode - идентификатор услуги, запрошенной в указанном заявлении
("78" - получение сведений из ГКН, "28" - постановка на кадастровый учёт, "79" регистрация прав, в остальных случаях - внутренняя константа).
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 - код организации Росреестра в СМЭВ ("RR" - переданная
нам СМЭВом константа).
Message/Sender/Name – наименование кода организации Росреестра в СМЭВ
("rosreestr" - переданная нам СМЭВом константа).
Message/Recipient/Code - код системы получателя запроса в СМЭВ.
Message/Recipient/Name - наименование системы получателя запроса в СМЭВ.
Message/TypeCode – тип запроса
Message/Date - дата формирования ответа на запрос.
3.2.1.1. Пример вызова метода CreateRequest
Наименование услуги
Постановка объектов недвижимости
на государственный кадастровый
учет
Предоставление сведений,
содержащихся в Государственном
Кадастре Недвижимости
Предоставление сведений,
содержащихся в Едином
Государственном Реестре прав на
недвижимое имущество и сделок с
ним
Примеры запросов
request.xml
response.xml
request.xml
response.xml
request.xml
response.xml
3.2.1.2. Правила формирования zip-архива, содержащего файл
заявления
Имя файла: req_<GUID_пакета>.zip
GUID_пакета имеет вид xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Состав:
В обязательном порядке содержит в корне архива один xml-файл с данными
заявления (req_<GUID_заявления>.xml).
Может содержать файлы электронных документов (межевые планы, технические
паспорта, сканы документов) и образы приложенных документов, которые могут
находиться на любом уровне вложенности в архиве, но пути должны быть прописаны в
xml-файле с данными заявления (req_<GUID_заявления>.xml).
Для правильного формирования Пакета заявления следует руководствоваться XSD
cхемой, соответсвующей типу запрашиваемой услуги. 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 – дата создания запроса
MessageData/AppData/requestNumber - переданный в ответном конверте
операции CreateRequest идентификатор созданного заявления на стороне
Росреестра.
Параметры ответа:
 MessageData/AppData/eServiceResult/comment - сообщение о статусе заявления






или сообщение об ошибке обработки запроса (примеры: "В работе",..).
MessageData/AppData/eServiceResult/extOrderNumber - идентификатор
заявления на стороне Росреестра (эквивалентен requestHeader/requestId запроса).
Message/ServiceCode - идентификатор услуги, запрошенной в указанном заявлении
("78" - получение сведений из ГКН, "28" - постановка на кадастровый учёт, "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 - код организации Росреестра в СМЭВ ("RR" - переданная
нам СМЭВом константа).
Message/Sender/Name – наименование кода организации Росреестра в СМЭВ
("rosreestr" - переданная нам СМЭВом константа).
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. Перечень возможных статусов
Название статуса
Описание статуса
Заявка зарегистрирована в ИС Росреестра
Осуществляется проверка ФЛК и проверка ЭЦП
ФЛК, либо проверка ЭЦП не пройдена
002
Создана
На проверке
Проверка не
пройдена
Ожидает оплату
0021
Обработка платежа
003
В работе
004
Завершена
0040
Завершена отказом
0041
Сведения
отсутствуют
Отказ в обработке
Код
статуса
000
001
0010
0043
Не используется при межведомственном
взаимодействии
Не используется при межведомственном
взаимодействии
Заявка прошла проверку и находится на
исполнении.
Заявление завершено с положительным
результатом. Одновременно с данным статусом
возвращается результат выполнения заявления.
Принято решение об отказе в предоставлении
сведений/проведении учетных действий.
Учетная Система не нашла объектов по указанным
в запросе параметрам.
Учетная Система отказала в обработке заявления
(например, не все необходимые документы
приложены).
3.2.2.3. Форматы возвращаемых результатов обработки заявления
В таблице ниже представлены схемы формирования электронных результатов оказания
услуги:
Наименование услуги
Постановка объектов недвижимости на
государственный кадастровый учет
Предоставление сведений, содержащихся в
Государственном Кадастре Недвижимости
Предоставление сведений, содержащихся в
Едином Государственном Реестре прав на
недвижимое имущество и сделок с ним (в
виде выписки из Единого государственного
реестра прав на недвижимое имущество и
сделок с ним о правах отдельного лица на
имеющиеся у него объекты недвижимости
имущества на территории)
Предоставление сведений, содержащихся в
Едином Государственном Реестре прав на
недвижимое имущество и сделок с ним (в
виде выписки из Единого государственного
реестра прав на недвижимое имущество и
сделок с ним, содержащей сведения о
зарегистрированных правах на объект
недвижимости)
Схема ответа
V01_STD_REESTR_EXTRACT_SBJ.rar
V01_STD_REESTR_EXTRACT.rar
3.3. Доступ к веб-сервису
Участникам межведомственного взаимодействия получить доступ к сервису можно через
СМЭВ по адресу: http://oraas.rt.ru:7777/gateway/services/SID0003109?wsdl – это что за
адрес?
Для тестирования и отладки необходимо использовать тестовый экземпляр сервисов:
http://test-ext.fccland.ru:80/smev/smevService
3.4. Требования к ЭЦП
Для подписания ЭЦП электронных сообщений, которыми обмениваются Системапотребитель и Система-поставщик, Система-потребитель должна иметь сертификат,
полученный в одном из Удостоверяющих Центров, выполнивших требования приказа
Росреестра №П/1 от 14.01.2011. Актуальный перечень таких УЦ приведен по адресу:
http://portal.rosreestr.ru/wps/portal/cc_ib_UC
3.5. Лист изменений
Версия
1.0
Дата изменения
07.06.2011
1.1
08.06.2011
1.2
09.06.2011
Перечень изменений
1. В разделе 3.2.2.3 в архив «Выписки ГКН.rar»
добавлены описания xsd-схем ответов;
2. Добавлен раздел 3.5 Лист изменений.
1.3
18.08.2011
Внесены изменения согласно методическим
рекомендациям версии 2.3.3