3. Описание веб-сервиса - Реализация федерального закона
advertisement
Организация межведомственного взаимодействия с Росреестром через интерфейс веб-сервисов по каналам СМЭВ Версия 1.0 Содержание 1. Введение .................................................................................................................................3 2. Предварительные требования к потребителю ....................................................................3 3. Описание веб-сервиса ...........................................................................................................3 3.1. Описание процесса информационного взаимодействия .............................................3 3.2. Описание методов ...........................................................................................................4 3.2.1. Метод CreateRequest ................................................................................................5 3.2.2. Метод GetStatus .......................................................................................................6 3.3. Доступ к веб-сервису ......................................................................................................8 3.4. Требования к ЭЦП ..........................................................................................................8 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 Метод предназначен для регистрации заявления (запроса) в информационной системе поставщика (Росреестра). Параметры заявления (запроса): requestHeader/documents/document[documentId='01']/content - zip-файл со сформированным заявлением. requestHeader/requestInitiatorCode/serviceOrgCode - код системы-потребителя в СМЭВ. createRequestBean/requestType - тип заявления ("558101010000" для заявлений получения сведений из ГКН, "558101020000" для заявлений постановки на кадастровый учёт, "5581020[1-9]0000" для заявлений о предоставлении сведений из ЕГРП). createRequestBean/okato - ОКАТО объекта, в отношении которого создаётся заявление. createRequestBean/oktmo - ОКТМО объекта, в отношении которого создаётся заявление. Параметры ответа: eServiceResult/comment - сообщение о статусе обработки запроса ("Вызов обработан успешно" для успешной обработки, "При обработке вызова возникли ошибки" для проблемного случая и "Не передан zip-файл заявления" - специальное сообщение для случая отсутствия архива). eServiceResult/extOrderNumber - идентификатор созданного заявления на стороне Росреестра. eServiceResult/eServiceId - идентификатор услуги, запрошенной в указанном заявлении ("78" - получение сведений из ГКН, "28" - постановка на кадастровый учёт, "79" - регистрация прав, в остальных случаях - внутренняя константа). eServiceResult/orgOrderStatusCode - код статуса обработки запроса ("0010" для ошибки при создании заявления, "0" для успешного сценария). responseHeader/authToken - токен авторизации Росреестра ("TEST_TOKEN_1" переданная СМЭВом константа). responseHeader/error/errorCode - код статуса выполнения запроса (0L - если вызов прошёл успешно, 0010L - если не удалось создать заявление). responseHeader/error/errorMessage - сообщение о статусе выполнения запроса ("ОК" - если вызов прошёл успешно, "Не передан zip-файл заявления" - в случае отсутствия архива, либо сообщение, описывающее ошибку создания заявления). responseHeader/requestInitiatorCode/regionCode - код региона Росреестра в СМЭВ ("00" - как и у всех федеральных ведомств). responseHeader/requestInitiatorCode/serviceOrgCode - код организации Росреестра в СМЭВ ("rosreestr" - переданная нам СМЭВом константа). responseHeader/responseDate - дата формирования ответа на запрос. responseHeader/responseIDRef - пустое значение. 3.2.1.1. Пример вызова метода CreateRequest Наименование услуги Постановка объектов недвижимости на государственный кадастровый учет Примеры запросов Предоставление сведений, содержащихся в Государственном Кадастре Недвижимости Предоставление сведений, содержащихся в Едином Государственном Реестре прав на недвижимое имущество и сделок с ним 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 Параметры запроса: requestHeader/requestId - переданный в ответном конверте операции CreateRequest идентификатор созданного заявления на стороне Росреестра. Параметры ответа: eServiceResult/comment - сообщение о статусе заявления или сообщение об ошибке обработки запроса (примеры: "В работе",..). eServiceResult/extOrderNumber - идентификатор заявления на стороне Росреестра (эквивалентен requestHeader/requestId запроса). eServiceResult/eServiceId - идентификатор услуги, запрошенной в указанном заявлении ("78" - получение сведений из ГКН, "28" - постановка на кадастровый учёт, "79" - регистрация прав, в остальных случаях - внутренняя константа). eServiceResult/orgOrderStatusCode - код текущего статуса заявления на стороне Росреестра (например, "0010", "003",..). responseHeader/authToken - токен авторизации Росреестра ("TEST_TOKEN_1" переданная СМЭВом константа). responseHeader/error/errorCode - код статуса выполнения запроса (0L - если вызов прошёл успешно, -1L - если не удалось выполнить (например, не найдено заявление с указанным номером)). responseHeader/error/errorMessage - сообщение о статусе выполнения запроса ("ОК" - если вызов прошёл успешно, "Заявка не найдена" - если не удалось выполнить (например, не найдено заявление с указанным номером)). responseHeader/requestInitiatorCode/regionCode - код региона Росреестра в СМЭВ ("00" - как и у всех федеральных ведомств). responseHeader/requestInitiatorCode/serviceOrgCode - код организации Росреестра в СМЭВ ("rosreestr" - переданная СМЭВом константа). responseHeader/responseDate - дата формирования ответа на запрос. responseHeader/responseIDRef - пустое значение. 3.2.2.1. Пример вызова метода GetStatus 3.2.2.2. Перечень возможных статусов Название статуса Описание статуса Заявка зарегистрирована в ИС Росреестра Осуществляется проверка ФЛК и проверка ЭЦП ФЛК, либо проверка ЭЦП не пройдена 002 Создана На проверке Проверка не пройдена Ожидает оплату 0021 Обработка платежа 003 В работе 004 Завершена Код статуса 000 001 0010 Не используется при межведомственном взаимодействии Не используется при межведомственном взаимодействии Заявка прошла проверку и находится на исполнении. Заявление завершено с положительным результатом. Одновременно с данным статусом возвращается результат выполнения заявления. Код статуса 0040 Название статуса Описание статуса Завершена отказом 0041 Сведения отсутствуют Отказ в обработке Принято решение об отказе в предоставлении сведений/проведении учетных действий. Учетная Система не нашла объектов по указанным в запросе параметрам. Учетная Система отказала в обработке заявления (например, не все необходимые документы приложены). 0043 3.2.2.3. Форматы возвращаемых результатов обработки заявления В таблице ниже представлены схемы формирования электронных результатов оказания услуги: Наименование услуги Схема ответа Постановка объектов недвижимости на государственный кадастровый учет Предоставление сведений, содержащихся в Государственном Кадастре Недвижимости Предоставление сведений, содержащихся в Едином Государственном Реестре прав на недвижимое имущество и сделок с ним (в виде выписки из Единого государственного реестра прав на недвижимое имущество и сделок с ним о правах отдельного лица на имеющиеся у него объекты недвижимости имущества на территории) Предоставление сведений, содержащихся в Едином Государственном Реестре прав на недвижимое имущество и сделок с ним (в виде выписки из Единого государственного реестра прав на недвижимое имущество и сделок с ним, содержащей сведения о зарегистрированных правах на объект недвижимости) Сведения ГКН.rar 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/sm ev/smevService 3.4. Требования к ЭЦП Для подписания ЭЦП электронных сообщений, которыми обмениваются Системапотребитель и Система-поставщик, Система-потребитель должна иметь сертификат, полученный в одном из Удостоверяющих Центров, выполнивших требования приказа Росреестра №П/1 от 14.01.2011. Актуальный перечень таких УЦ приведен по адресу: http://portal.rosreestr.ru/wps/portal/cc_ib_UC
