Организация межведомственного взаимодействия с Росреестром через интерфейс веб-сервисов по каналам СМЭВ Версия 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 Изменен адрес сервиса в тестовом СМЭВ с проверкой ведомственной подписи