Проактивное создание заявлений

Содержание

• Общая информация
• Нормативные акты
• Этапы оказания проактивной услуги
• Этапы настройки, тестирования и вывода в продуктивную среду услуги с проактивным созданием заявления
• Этап 1. Создание шаблона уведомлений ТГЭПС
• Этап 2. Сбор информации о пользователе в ВИС
• Этап 3. Интеграция ВИС с шаблоном ГЭПС
• Этап 4. Реализация формы услуги в ВКУ
• Настройка услуги
• Этап 5. Сквозное интеграционное тестирование
• Этап 6. Вывод услугу в продуктивный контур
• Как указать на форме возможность подачи заявления в проактивном порядке
• Полный перечень НПА
• Термины и сокращения

Общая информация

Проактивное создание заявлений — это функциональность, которая готовит заявление, направляет уведомление и приглашает пользователя к подаче в систему ЕПГУ при определённых действиях или событиях. Это помогает значительно уменьшить объём ручной работы, ускорить процесс подачи заявлений и повысить уровень автоматизации на платформе

Примеры:

• Присвоение статуса многодетной семьи — автоматическая генерация черновика заявления при рождении или усыновлении третьего ребёнка
• Продление срока разрешения/прохождения аттестации
• Продление срока разрешительных документов

В некоторых случаях проактивная подача заявления может быть реализована внутри услуги без дополнительных настроек на уровне вида сведений (ВС) и оказываться без участия заявителя. Например, когда нужно продлить срок действия какого-либо документа и у ведомства есть вся необходимая информация для этого. Такие случаи в данной инструкции не рассматриваются

Данная инструкция нужна для настройки проактивной подачи заявления, когда необходимо непосредственное участие заявителя, например для подтверждения полученных ранее данных или же для предоставления любой другой недостающей информации

Нормативные акты

С полным списком использованных при разработке НПА можно ознакомиться ниже

Этапы оказания проактивной услуги

1. Сбор информации о пользователе в ВИС для формирования события и решения по проактивной услуге
2. Формирование уведомления и приглашение для подачи заявления / получения результата
3. Упрощённая форма услуги, максимально заполненная из доступных источников (ВИС, витрины, ЦП) (опционально)
4. Получение результата в ведомстве (опционально)
5. Настройки проактивного создания заявления внутри услуги

Настройка, тестирование и вывод в продуктивную среду услуги с проактивным созданием заявления состоит из следующих этапов:

1. Создание шаблона уведомлений ТГЭПС
2. Сбор информации о пользователе в ВИС
• Вариант 1: в ВИС формируется событие о потенциальной потребности получить услугу
• Вариант 2: в ВИС формируется полная модель данных, достаточных для предоставления услуги и пользователь вызывается на подачу заявления
• Вариант 3: в ВИС оформляется услуга и результат приходит на ЕПГУ в виде уведомления в ЕЛК без формы
3. Интеграция ВИС с шаблоном ГЭПС
4. Реализация формы услуги в ВКУ
5. Сквозное интеграционное тестирование
6. Вывод услугу в продуктивный контур

Этап 1. Создание шаблона уведомлений ТГЭПС

Необходимо создать шаблон уведомлений ГЭПС, который будет использоваться для отправки сообщений пользователям

Подробно прочитать о том, что такое ГЭПС, принципах его работы, условиях взаимодействия и создании шаблонов вы можете, скачав регламент подключения к ГЭПС
Регистрация нового шаблона уведомления в тестовой и продуктивной среде, его корректировка описаны в пункте 6 данного регламента

Ознакомившись с инструкцией, выполните шаги для создания шаблона уведомлений, указав в нём все необходимые параметры. Например, заголовки и подзаголовки уведомлений

Убедитесь, что шаблон сохранён и готов к использованию. ID шаблона будет использован в дальнейшем для формирования сообщений

Этап 2. Сбор информации о пользователе в ВИС

Второй этап включает в себя доработку ИС Ведомства (в случае необходимости) для информационного взаимодействия с ГЭПС ЕПГУ посредством ВС ГЭПС в тестовой среде

Для взаимодействия с ГЭПС рекомендуется использовать Универсальный ВС (рекомендуемый)

Этап 3. Интеграция ВИС с шаблоном ГЭПС

У ИС Ведомства должна быть реализована технологическая возможность взаимодействия с СМЭВ и ТСМЭВ

Должна быть реализована передача всех необходимых сведений, таких как:

• Идентификаторы, предполагаемые для поиска пользователей ЕПГУ
• Необходимые статусы прочтения, вручения и т.п.
• Необходимость отображения переключателя подписки/отписки в настройках Госпочты тестовой среды ЕПГУ
• Наименование Отправителя в разделе настройки Госпочты тестовой среды ЕПГУ (при наличии переключателя подписки/отписки)
• Описание уведомлений в разделе настройки Госпочты тестовой среды ЕПГУ (при наличии переключателя подписки/отписки)

Описание добавления параметров в черновик заявления из сообщений по ВС ГЭПС см. ниже в пунктах 12-15 «пошаговой инструкции по настройке правил проактивности в услуге» в разделе «Настройки»

Этап 4. Реализация формы услуги в ВКУ

1. Разработка услуги в ВКУ
2. Настройка услуги для проактивного создания заявления (см. ниже)
   Необходимо настроить:
   • Используемый шаблон уведомления
   • Прикладываемые данные для заполнения черновика
   • Раскладку полей уведомления по полям заявления
   Если данные есть в витринах – они грузятся на форму в момент заполнения заявления
   Если данные есть в ведомстве – о их наличии в ведомстве можно указать
3. Тестирование услуги

Настройка услуги

Настройки проактивного создания заявлений находятся в разделе «Настройки услуги» во вкладке «Проактивное создание заявлений»

Варианты проактивного создания заявления

  Для ведомств доступен только один вариант проактивного создания заявлений:

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

Проактивное создание на основе ГЭПС

Это правило проактивного создания заявлений срабатывает, когда событие поступает через систему ГЭПС

ГЭПС является частью более широкого процесса взаимодействия государственных и муниципальных организаций через СМЭВ, которая обеспечивает электронный обмен документами и данными между различными государственными и муниципальными системами

В отличие от обычного события, это событие приходит по каналу СМЭВ (через ГЭПС), что подразумевает использование стандартизированных форматов и протоколов обмена данными, характерных для государственных и муниципальных сервисов

Подготовительный этап к настройке проактивного создания заявления

Перейдём к настройке проактивного создания заявления непосредственно в услуге

Описание блоков настроек «Проактивное создание на основе ГЭПС»

№	Название поля	Описание
Блок «Настройки события»
1	Код события	Код события = код шаблона, который ведомство получает при подключении к ВС ГЭПС и подготовке шаблона
2	Включить правило проактивного создания	Признак активности правила. Если установлено значение false, правило не активно. (Булевый тип). Это значит, что если придёт какое-то событие, то правило не сработает, даже если заполнены все другие поля
Блок «Маппинг полей черновика»
4	Источник значения	Определяет, откуда брать значение: - «Фиксированное значение» (например, строка или код) - «Переменная из сообщения» (например, значение из поля события)
5	1) Фиксированное значение / 2) Переменная из сообщения	1) Значение, которое будет добавляться в компонент, как указанная строка. Если выбрано это значение, то содержимое будет передано в компонент в виде строки  / 2) Значение, которое будет добавляться, как значение переменной из сообщения. Указывать тот атрибут, откуда будет браться информация
6	Идентификатор компонента, в который передается значение	Указывается идентификатор компонента, в который должно попадать значение

Дополнительные замечания:

Для типа «Проактивное создание на основе ГЭПС» важно, чтобы события и данные, передаваемые через ГЭПС, соответствовали стандартам и требованиям для межведомственного обмена, установленным в рамках СМЭВ

Механизмы безопасности: События, приходящие через ГЭПС, требуют соблюдения строгих стандартов безопасности, чтобы обеспечить соответствие законодательным требованиям

Не использовать UIN в параметрах при формировании XML-сообщения в ГЭПС и группировку в шаблоне сообщения, в таком случае заявление не будет создано

Пример xml-запроса отправляемого в ГЭПС и уведомления отправляемого пользователю в ленту

<geps:epguGepsServiceRequest xmlns:geps="http://epgu.gosuslugi.ru/geps/2.0.3&quot; xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">     <geps:getSendMessageReq>         <geps:GepsUserId>3079063862</geps:GepsUserId>         <geps:MessageType>SIM_CARD</geps:MessageType>         <geps:Param>             <geps:Name>operatorName</geps:Name>             <geps:Value>МТС</geps:Value>         </geps:Param>         <geps:Param>             <geps:Name>routeNumber</geps:Name>             <geps:Value>779903</geps:Value>         </geps:Param>         <geps:Param>             <geps:Name>corpPhoneData</geps:Name>             <geps:Value>+7(900)1233434</geps:Value>         </geps:Param>         <geps:Param>             <geps:Name>orgName</geps:Name>             <geps:Value>АО Лабс</geps:Value>         </geps:Param>         <geps:Param>             <geps:Name>inn</geps:Name>             <geps:Value>1233123333</geps:Value>         </geps:Param>     </geps:getSendMessageReq> </geps:epguGepsServiceRequest>

Пример передаваемых параметров в XML:

MessageType — это код события, в примере равен SIM_CARD

GepsUserId — уникальный идентификатор пользователя в ГЭПС

Блок Param содержит дополнительные параметры, которые передаются ведомством

Пошаговая инструкция по настройке правил проактивности в услуге

1. Переходим в раздел «Настройки услуги»
   



2. Выбираем вкладку «Проактивное создание заявлений»
3. Выбираем «Проактивное создание на основе ГЭПС»
4. Нажимаем «Добавить элемент»
   



5. В поле «Код события» вводим код шаблона, который ведомство получает при подключении к ВС ГЭПС и подготовке шаблона. Например: SIM_CARD
6. Ставим отметку в поле «Включить правило проактивного создания»
7. Выбираем признак момента создания черновика. Если признак «Запускать проактивное создание заявления сразу при получении события» выставлен, то в таком случае черновик будет создан сразу при попадании ГЭПС в ЛК пользователя и при переходе на услугу должен открыться уже ранее созданный черновик. 
   В обратном случае черновик будет создан при переходе пользователя по ссылке и при переходе на услугу должен открыться только что созданный черновик. Разница заключается в том, что черновик пользователь сразу в ЛК не увидит, и он будет создан при переходе по ссылке
8. Выбираем признак активности правила «Возможность удаления проактивного заявления в ЛК». Если установлено значение false, правило не активно. По умолчанию активно (true)
9. Нажимаем «Добавить элемент» в разделе «Маппинг полей черновика»
   



10. Настраиваем маппинг
    Фиксированное значение
1. В добавленном элементе выбираем «Фиксированное значение»
2. В поле «Фиксированное значение» вводим значение, которое будет копироваться в компонент, как указанная строка. Например, это может быть текстовое сообщение или код, который должен быть отображён. Пользователь сам определяет, что вводить в рамках его текущих задач. Если выбрано «Фиксированное значение», это будет значение, переданное в черновик как строка (например, «Hello World»)
3. В поле «Идентификатор компонента, в который передаётся значение» вводим идентификатор компонента, в который попадёт значение. Например, «c6»
4.  При необходимости передачи значения в циклический компонент в полях:
• «Идентификатор атрибута внутри компонента» указывается идентификатор атрибута внутри компонента
• «Идентификатор циклического компонента, внутри которого находится компонент» указывается идентификатор циклического компонента, внутри которого находится компонент
• «Порядковый номер элемента внутри циклического компонента» указывается порядковый номер элемента внутри циклического компонента, нумерация начинается с нуля




Переменная из сообщений

1. В добавленном элементе выбираем «Переменная из сообщений»
2. В поле «Переменная из сообщений» вводим значение, которое будет добавляться, как значение переменной в блоке params сообщения по ВС ГЭПС, где geps:Name – имя переменной, geps:Value – значение



3. В поле «Идентификатор компонента, в который передаётся значение» вводим идентификатор компонента, в который попадет значение. Например, «c7»
4.  При необходимости передачи значения в циклический компонент в полях:
• «Идентификатор атрибута внутри компонента» указывается идентификатор атрибута внутри компонента
• «Идентификатор циклического компонента, внутри которого находится компонент» указывается идентификатор циклического компонента, внутри которого находится компонент
• «Порядковый номер элемента внутри циклического компонента» указывается порядковый номер элемента внутри циклического компонента, нумерация начинается с нуля



Данные из ЛК ФЛ

1. В добавленном элементе выбираем «Данные из ЛК ФЛ»
2. В поле «Переменная из ЛК пользователя» выбрать необходимое поле из личного кабинета пользователя, которое будет копироваться в компонент. Например, «Имя»
3. В поле «Идентификатор компонента, в который передаётся значение» вводим идентификатор компонента, в который скопируется значение поля из личного кабинета пользователя. Например, «c6»
4. При необходимости передачи значения в циклический компонент в полях:
• «Идентификатор атрибута внутри компонента» указывается идентификатор атрибута внутри компонента
• «Идентификатор циклического компонента, внутри которого находится компонент» указывается идентификатор циклического компонента, внутри которого находится компонент
• «Порядковый номер элемента внутри циклического компонента» указывается порядковый номер элемента внутри циклического компонента, нумерация начинается с нуля




Данные из ЛК ЮЛ или ИП

1. В добавленном элементе выбираем «Данные из ЛК ЮЛ или ИП»
2. В поле «Переменная из ЛК пользователя» выбрать необходимое поле из личного кабинета пользователя, которое будет копироваться в компонент. Например, «Полное наименование»
3. В поле «Идентификатор компонента, в который передаётся значение» вводим идентификатор компонента, в который скопируется значение поля из личного кабинета пользователя. Например, «c8»
4. При необходимости передачи значения в циклический компонент в полях:
• «Идентификатор атрибута внутри компонента» указывается идентификатор атрибута внутри компонента
• «Идентификатор циклического компонента, внутри которого находится компонент» указывается идентификатор циклического компонента, внутри которого находится компонент
• «Порядковый номер элемента внутри циклического компонента» указывается порядковый номер элемента внутри циклического компонента, нумерация начинается с нуля



Автозаполнение данными из ЛК

1. В добавленном элементе выбираем «Автозаполнение данными из ЛК»
2. В поле «Идентификатор компонента, в который передаётся значение» вводим идентификатор компонента, в который скопируется значение поля из личного кабинета пользователя. Копируемые в компонент данные из ЛК зависят от вида указанного компонента и выбранных в нём контактных данных. Например в компонент ConfirmContact с выбранным типом контактных данных "Номер телефона ФЛ" из ЛК скопируется телефонный номер ФЛ

    

   Важно! В данном поле можно указывать только идентификаторы компонентов следующих видов:

   ConfirmAddress

   ConfirmContact

   ConfirmLegalData

   ConfirmPersonalUserData
   
3. При необходимости передачи значения в циклический компонент в полях:
• «Идентификатор атрибута внутри компонента» указывается идентификатор атрибута внутри компонента
• «Идентификатор циклического компонента, внутри которого находится компонент» указывается идентификатор циклического компонента, внутри которого находится компонент
• «Порядковый номер элемента внутри циклического компонента» указывается порядковый номер элемента внутри циклического компонента, нумерация начинается с нуля



11. Прописываем идентификаторы экранов (при необходимости), которые будут предзаполнены и пользователю не нужно будет заполнять эти поля
    
12. Нажимаем «Сохранить»
13. Далее разрабатываем непосредственно саму услуг
14. Тестируем услугу

Этап 5. Сквозное интеграционное тестирование

Проверка результатов

После отправки сообщения ГЭПС, пользователь должен получить два уведомления:

Одно — от ГЭПС, по шаблону, который был настроен ранее

Второе — о создании черновика заявления для заданной услуги

При открытии черновика, пользователь должен увидеть форму услуги

Этап 6. Вывод услугу в продуктивный контур

1. Подключение ИС Заявителя к продуктивной среде СМЭВ и к соответствующей версии ВС ГЭПС
2. Зарегистрировать шаблон (ранее зарегистрированный в тестовой среде) в продуктивной среде ГЭПС

Как указать на форме возможность получения услуг в проактивном порядке

Для того чтобы пользователь узнал о возможности получения услуг в проактивном порядке рекомендуется:

1. Добавить экран с разводящим вопросом «Квиз» с заголовком «Хотите получать меры социальной поддержки в проактивном порядке?»
   Если пользователь может получить одну определённую услугу, то заголовок должен быть в виде: «Хотите получить *название услуги*?»
   Если от пользователя требуется именно согласие, то допустима формулировка: «Вы даёте согласие на получение мер социальной поддержки в проактивном порядке?»
   В подзаголовке экрана должно быть модальное окно «Проактивный порядок» с описанием условий получения услуг в проактивном порядке. Текст должен соответствовать сути предоставляемой услуги. Например: «При наступлении определённых жизненных ситуаций и наличии согласия на предоставление услуг в проактивном формате, ведомство самостоятельно назначит вам социальную выплату, без заполнения заявлений и посещения ведомства»







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

Нормативные акты

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

• Федеральный закон от 27 июля 2010 г. № 210-ФЗ «Об организации предоставления государственных и муниципальных услуг»
• Постановление Правительства Российской Федерации № 697 от 8 сентября 2010 г. «О единой системе межведомственного обмена»
• Постановление Правительства Российской Федерации от 24 октября 2011 г. № 861 «О федеральных государственных информационных системах, обеспечивающих предоставление в электронной форме государственных и муниципальных услуг (осуществление функций)»
• Федеральный закон от 06 апреля 2011 г. № 63-ФЗ «Об электронной подписи»
• Постановление Правительства Российской Федерации № 451 от 08 июня 2011г. «Об инфраструктуре, обеспечивающей информационно-технологической взаимодействие информационных систем, используемых для предоставления государственных и муниципальных услуг в электронной форме»
• Постановление Правительства Российской Федерации от 28 декабря 2011 г. №. 1184 «О мерах по обеспечению перехода федеральных органов исполнительной власти и органов государственных внебюджетных фондов на межведомственное информационное взаимодействие в электронном виде»
• Постановление Правительства Российской Федерации от 22 декабря 2012 г. № 1382 «О присоединении информационных систем организаций к инфраструктуре, обеспечивающей информационно-технологическое взаимодействие информационных систем, используемых для предоставления государственных и муниципальных услуг в электронной форме»

Термины и сокращения

Термин/сокращение	Определение
ГЭПС	Государственная электронная почтовая система
ТГЭПС	Государственная электронная почтовая система в тестовой среде
ВИС	Внешняя информационная система
ВС	Вид сведений
ЕПГУ	Единый портал государственных услуг
ЕСНСИ	Единая система нормативно-справочной информации
ИС	Информационная система
ЛК	Личный кабинет
ЛК УВ	Личный кабинет участника взаимодействия. Адрес: https://lkuv.gosuslugi.ru/
ОИВ	Орган исполнительной власти
СМЭВ	Система межведомственного электронного взаимодействия
ТСМЭВ	Тестовая среда СМЭВ
ФЗ	Федеральный закон
ПП РФ	Постановление правительства Российской Федерации
НПА	Нормативный правовой акт

Проактивное создание заявления на основе поступления события из ЕСИА

Проактивное создание заявления на основе поступления события из ЕСИА — это функциональность, с помощью которой можно автоматически формировать черновик заявления при фиксировании выполнения определённого события в ЕСИА

Описание блоков настроек «Проактивное создание на основе поступления события из ЕСИА»

Поле	Тип	Обязательность	Комментарий
Тип события	string	Да	Прописывать с точкой в середине. Пока что используются только эти типы событий:  PersonOperationEnum.personFioChanged ObjectOperationEnum.updateAddress ObjectOperationEnum.updateDocument DigitalOperationEnum.KidNoCertBrthRecordCreated
Подтип события	string	Нет	Прописывать с точкой в середине
Фильтр по региону: Операция сравнения	string	Да, если нужен фильтр по региону	Выбирать из 4 предложенных вариантов: Равно Не равно Входит в список Не входит в список
Фильтр по региону: Значения для сравнения	string	Да, если нужен фильтр по региону	Прописать название региона. Если нужен список, то указывать через запятую
Включить правило проактивного создания	boolean	Нет	Признак активности текущего настроенного правила
Возможность удаления проактивного заявления в ЛК	boolean	Нет	Признак позволяющий удалять черновик. Показывается в расширенном режиме
Маппинг полей черновика: Источник значения	string	Да, если нужен маппинг	Выбирается из трех вариантов: Фиксированное значение, Переменная из сообщения, Переменная из персональных данных
Маппинг полей черновика: Фиксированное значение	string	Да, если нужен маппинг	Прописывается только если выбирается источником значения "Фиксированное значение"
Маппинг полей черновика: Переменная из сообщения	string	Да, если нужен маппинг	Прописывается только если выбирается источником значения "Переменная из сообщения"
Маппинг полей черновика: Путь до переменной	string	Да, если нужен маппинг	Прописывается только если выбирается источником значения "Переменная из персональных данных". Прописывать путь до переменной
Маппинг полей черновика: Идентификатор компонента, в который передается значение	string	Да, если нужен маппинг	Прописывается в любом случае при выборе одного из трех вариантов: Фиксированное значение, Переменная из сообщения, Переменная из персональных данных
Обязательное продолжение черновика	boolean	Нет	Признак обязательности продолжения черновика. Показывается в расширенном режиме
Настройка предзаполнения экранов	string	Нет	Написать список предзаполненных экранов
Включить отправку уведомления пользователю: Код шаблона уведомления	string	Нет	Cистема может отправлять уведомления пользователю о создании заявления, используя соответствующий шаблон. Для этого необходимо заранее определить код шаблона и код события, чтобы избежать пересечений с другими уведомлениями.
Включить отправку уведомления пользователю: Код события уведомления	string	Нет

Пример сценария использования:

1. Пользователь проходит верификацию паспорта в ЕСИА
2. Системой проверяются правила, указанные в настройках правил проактивного создания заявлений в услуге. Например, проверяется регион регистрации пользователя
3. При выполнении условий в личном кабинете пользователя создается черновик заявления по услуге, при этом в черновик автоматически подставляются данные из ЕСИА (ФИО, паспортные данные)
4. Пользователь получает уведомление о наличии черновика заявления и отправляет заявление