Руководство пользователя электронного сервиса СМЭВ (стр. 2 )

Термин/сокращение	Описание
ГУ	Государственная услуга
ГФ	Государственная функция
ЕПГУ	Единый портал государственных и муниципальных услуг
ОГВ	Орган власти
Поставщик	Организация-владелец электронного сервиса
СМЭВ	Система межведомственного электронного взаимодействия
Федеральный реестр	Федеральный реестр государственных и муниципальных услуг (функций)
WSDL	Web Services Description Language — язык описания веб-сервисов.
XSD	XML Schema definition - язык описания структуры XML документа.
SOAP	Simple Object Access Protocol - протокол обмена структурированными сообщениями в распределённой вычислительной среде.
XML	eXtensible Markup Language — расширяемый язык разметки.

1  Общие сведения

1.2  Руководящие документы

Основанием для разработки данного документа является требование п. 48 Приказа Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. № 000 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия» в соответствии с которым, для подключения информационной системы к системе межведомственного электронного взаимодействия Поставщик предоставляет Оператору СМЭВ следующие документы:

·  паспорт электронного сервиса, регистрируемого в системе взаимодействия;

·  методику испытаний электронного сервиса, регистрируемого в системе взаимодействия, включая контрольный пример обращения к электронному сервису;

·  руководство пользователя электронного сервиса, регистрируемого в системе взаимодействия.

Основанием для создания и использования электронного сервиса являются перечисленные ниже нормативно-правовые документы:

·  Постановление Правительства Российской Федерации от 8 сентября 2010 г. № 000 «О единой системе межведомственного электронного взаимодействия»;

·  Приказ Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. № 000 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия».

1.3  Описание электронного сервиса

Наименование:	Сервис получения информации о государственных услугах, органах власти
Назначение:	Сервис предназначен для обеспечения возможности получения информационными системами информации об услуге (функции, органе власти), а также осуществления информационного взаимодействия с ЕПГУ для обеспечения полноты и достоверности данных
Поставщик:	Министерство экономического развития Российской Федерации
Область применения:	Базовый реестр

1.4  Операции (методы) электронного сервиса

Типовой вариант использования данного сервиса состоит в получении списка изменённых и удалённых объектов, и последующем получении полного описания для каждого изменённого объекта. Помимо этого сервис обеспечивает взаимодейсвтие с ЕПГУ в рамках механизмов обратной связи и предпросмотра. Таким образом, для обеспечения обмена данными в рамках интеграции Федерального реестра с внешними системами-поставщиками данных о государственных органах реализованный веб-сервис содержит методы, обеспечивающие:

-  передачу переченя отозванных сущностей;

-  передачу переченя изменных сущностей;

-  поиск информации об услуге по ее идентификатору;

-  поиск информации об ОГВ по его идентификатору;

-  обновление статуса сущности;

-  прием сообщений от ЕПГУ в рамках обеспечения механизма обратной связи;

-  передача результатов обработки сообщений от ЕПГУ в рамках механизма обратной связи;

-  получение реквизитов страницы предпросмотра на ЕПГУ;

-  передачу перечня базовых справочников;

-  передачу значений заданного базового справочника.

Метод	Назначение
Код: getRevokationList Наименование: Запрос отозванных сущностей	Принимает электронное сообщение с ssn и возвращает перечень отозванных сущностей
Код: getChanges Наименование: Запрос измененных сущностей	Принимает электронное сообщение с ssn и возвращает перечень изменных сущностей
Код: getPsPassport Наименование: Поиск информации об услуге по ее идентификатору	Принимает электронное сообщение с идентификатором ГУ и возвращает описание ГУ
Код: getRStateStructure Наименование: Поиск информации об ОГВ по его идентификатору	Принимает электронное сообщение с идентификатором ОГВ и возвращает описание ОГВ
Код: updateStatus Наименование: Обновление статуса сущности	Принимает электронное сообщение с описанием статуса и сущности для обновления и возвращает результат операции
Код: registerFeedBack Наименование: Прием сообщений от ЕПГУ в рамках обратной связи	Принимает электронное сообщение с описанием найденной ошибки в данных на ЕПГУ и возвращает идентификатор заведенной в Федеральном реестре ошибки
Код: getFeedBack Наименование: Передача результатов обработки сообщений от ЕПГУ в рамках обратной связи	Принимает электронное сообщение от ЕПГУ с идентификатором заведенной в Федеральном реестре ошибки (см. метод registerFeedBack) и возвращает результат обработки сообщений от ЕПГУ
Код: psPassportPreview Наименование: Прием реквизитов страницы предпросмотра на ЕПГУ	Принимает электронное сообщение с реквизитами сформированной на ЕПГУ страницы предпросмотра
Код: getDictionary Наименование: Наименование: Поиск информации о базовом справочнике по его наименованию	Принимает электронное сообщение с наименованием базового справочника и возвращает состав значений справочника
Код: getListDictionary Наименование: Запрос перечня базовых справочников. Принимает электронное сообщение и возвращает перечень базовых справочников	Принимает электронное сообщение и возвращает перечень базовых справочников

1.5  Сценарии использования

Типовой вариант использования данного сервиса состоит в получении списка изменённых и удалённых объектов, и последующем получении полного описания для каждого изменённого объекта.

Методы getChanges и getRevokationList используются для получения списка изменённых либо удалённых объектов. Метод getChanges возвращает список объектов, в которые вносились какие-то изменения. Метод getRevokationList возвращает список объектов, которые снимались с публикации либо удалялись.

Для актуализации данных в реестре и внешней системы используется значение ssn (system state number). Начальное значение ssn=0. При каждом изменении в объектах реестра (госуслуги/госорганы) значение ssn в базе реестра увеличивается. Сервис возвращает изменения начиная с переданного SSN и до текущего момента. Помимо списка изменённых объектов методы возвращают значение SSN соответсвующее этим изменениям. Внешней системе необходимо сохранить это значение, и в следующий раз запросить изменения с этим ssn, чтобы получить список изменений с момента последней синхронизации.

Поддерживается также и получение всех объектов реестра. В этом случае в качестве параметра ssn можно передать значение 0. Данный метод можно возвращать значительный объем информации, что должно учитываться при принятии решения о его применении в каждом конкретном случае.

В реестре существуют два вида основных вида объектов: государственные услуги и органы власти. Методы getPsPassport и getRStateStructure используются для получения полного описания услуги/госоргана по его идентификатору, полученному из методов getChanges/getRevokationList.

Органы и услуги могут содержать перекрестные ссылки, потому рекомендуется сначала полностью получить все изменения, и лишь после этого осуществить проверку ссылочной целостности.

Второй вариант использования данного сервиса состоит в получении от ЕПГУ сообщений о найденных на портале ошибках в сведениях о государственных услугах (функциях) и органах власти (метод registerFeedBack) и отправке обратно по запросу от ЕПГУ результатов обработки сообщений (метод getFeedBack).

Третий вариант использования данного сервиса состоит в получении от ЕПГУ реквизитов сформированной в нем страницы предпросомотра.

Четвертый вариант использования данного сервиса состоит в получении перечня базовых справочников и последующем получении значений выбранного базового справочника.

1.6  Схема взаимодействия

В рамках взаимодействия информационная система ведомства направляет в адрес модуля реестра следующие типы сообщений:

·  Сообщения с идентификатором государственной услуги/ОГВ.

·  Сообщения с контекстной информацией, по которой будет идти поиск перечня идентификаторов государственных услуг/ОГВ.

·  Сообщения с инфомацией о найденных ошибках в описаниях объектов на ЕПГУ.

·  Сообщения с идентификатором зарегистрированного сообщения о найденных ошибках в описаниях объектов на ЕПГУ.

·  Сообщения с информацией о сформированной странице предпросмотра на ЕПГУ.

·  Сообщение на получение перечня базовых справочников.

·  Сообщение с наименованием базового справочника.