Настройка комплексной услуги с созаявителем в ВКУ

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

Комплексная услуга — это услуга, в которой возможно участие нескольких пользователей Портала с разными уровнями взаимодействия. Самый простой вариант использования — согласование подачи заявления несколькими пользователями. Для настройки комплексной услуги добавляются дополнительные файлы, которые формируют настройки бизнес-процесса согласования

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

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

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

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

Ограничения данной инструкции

1. Для приглашения одного созаявителя используется компонент PassportLookup, когда учувствует несколько созаявителей используется компонент RepeatableFields для инициализации цикла, в котором также через компонент PassportLookup вводятся данные всех участников согласования
2. В случае отзыва заявления заявителем или отказа созаявителя процесс получения услуги будет завершён. И заявления перейдут в 10 статус — Заявление отменено
3. Данная статья не применима в случае, если заявление требуется подать для пользователя, не имеющего учётной записи на портале «Госуслуги»
4. Шаблоны уведомлений используются типовые
5. В ведомство будет отправлено основное заявление — то, которое подал заявитель. Ответы, заполненные созаявителем, будут перенесены в черновик основного заявителя
6. В данный момент участниками согласования могут только физические лица

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

Настройка комплексной услуги ВКУ с созаявителем осуществляется в три этапа:

1. Выбор настройки типа согласования в «Настройках услуги»
2. Добавление в услугу ключевых экранов
3. Привязка экранов к бизнес-процессам услуги

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

Можно выбрать следующие вариант типов согласования:

• Простой — созаявитель может согласовать или отклонить заявление
• С отзывом — созаявитель может согласовать или отклонить заявление, при этом заявитель может отозвать заявление
• С отзывом и ограничением по времени — созаявитель может согласовать или отклонить заявление в течение 24 часов, при этом заявитель может отозвать заявление
• С несколькими созаявителями — заявитель может добавить несколько созаявителей и добавить файл для подписания 
• Множественное подписание с отзывом и ограничением по времени — созаявитель может согласовать или отклонить заявление в течение 24 часов, при этом заявитель может отозвать заявление

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

• Идентификатор компонента, инициализирующего цикл — указывается идентификатор компонента, с которого начинается цикл
• Идентификатор загрузчика с файлом для подписания — указывается идентификатор компонента, который позволяет добавлять файл для подписания

При выборе варианта множественного подписания с отзывом и ограничением по времени доступны следующие настройки:

• Требуется отправка заявления в ведомство — отметка ставится в том случае, если требуется отправить заявление в ведомство. По умолчанию чекбокс установлен "true". Если после согласования документ не требуется отправлять в ведомство, отметку следует снять
• Идентификатор компонента, инициализирующего цикл — указывается идентификатор компонента, с которого начинается цикл
• Мнемоника файлов, передаваемых созаявителю — указывается мнемоника сгенерированных файлов или идентификатор компонента загрузчика для приложенных файлов
• Мнемоника подписанных созаявителем файлов для передачи заявителю — указывается мнемоника файлов, подписанных созаявителем
• Идентификатор компонента, в который передаются подписанные файлы созаявителя — указывается идентификатор компонента, в который передаются подписанные файлы
• Идентификатор экрана, отображаемого при получении 14 статуса — указывается идентификатор экрана, который отображается пользователю, в случае получения 14 статуса

Следующим шагом будет интеграция ключевых экранов в услугу. Для этого рекомендуется использовать специально подготовленные шаблоны:

• Шаблон согласования заявления с отзывом и ограничением по времени – при добавлении одного созаявителя
• Шаблон согласования заявления с несколькими участниками – при добавлении нескольких участников согласования

Название экрана	Идентификатор	Принадлежность	Описание
Черновик у второго участника	wait_for_coapp	Экран заявителя	Экран, блокирующий действия заявителя при ожидании действий созаявителя, возможно добавление кнопки отозвать заявление Ссылка на шаблон
Ввод паспортных данных созаявителя	passportInput	Экран заявителя	Экран ввода паспортных данных созаявителя, содержимое этого экрана можно наполнить в соответствии с требованиями заказчика. Нельзя добавлять в конец сценарий заявителя Ссылка на шаблон
Экран согласования созаявителем	sc1	Экран созаявителя	Экран приветствие для созаявителя, содержимое этого экрана можно наполнить в соответствии с требованиями заказчика Ссылка на шаблон
Ссылка устарела	old_link_screen	Экран созаявителя	Экран отображает текстовую информацию о некорректной ссылке Ссылка на шаблон

Также можно добавить ключевые экраны из предустановленных шаблонов согласно таблице

Интеграция

1. Вставьте шаблон с экраном passportInput (см. таблицу выше) в свою услугу и вставьте его в ветку основного участника (не самым последним)
2. Вставьте шаблон с экраном wait_for_coapp в свою услугу и вставьте его, не связывая его с другими
3. Вставьте шаблон с экраном old_link_screen в свою услугу и вставьте его, не связывая его с другими
4. Вставьте шаблон с экраном sc1 в свою услугу и вставьте его в самое начало ветки созаявителя, связав его с последующими экранами, которые должны следовать за согласием или отказом

Описание типовой настройки экранов

Последним этапом является привязка экранов к бизнес-процессам. Она осуществляется в подразделе «Стартовые экраны для участников заявления» раздела «Настройки версии»

В поле «Роль» выбирается роль участника заявления

В поле «Условие» указывается идентификатор бизнес-процесса и начальный экран для него

Пример настроек:

Описание параметров

Роль	id бизнес-процесса	id экрана	Описание экрана
Заявитель	Applicant	s1	Стартовый экран заявителя
Заявитель	EditCoapplicant	wait_for_coapp	Экран, который увидит заявитель при входе на форму после приглашения созаявителя
Заявитель	WaitingCoapplicant	wait_for_coapp	Экран, который увидит заявитель при входе на форму после приглашения созаявителя до входа одного из созаявителей на форму
Созаявитель	Default	old_link_screen	Экран, который увидит созаявитель при входе на форму если заявление отменено или согласовано
Созаявитель	EditCoapplicant	sc1	Экран, который увидит созаявитель при первом входе на форму

Создание ключевых экранов с нуля

Приветственный экран заявителя (s1) — настраивается как стандартный стартовый экран

Экран добавления паспортных данных созаявителя – составной экран содержащий компонент PassportLookup. В расширенных настройках компонента в разделе «Добавление заявителя» должны быть выставлены «Наименование роли» и «Тип заявителя»

Экран, блокирующий действия созаявителя (old_link_screen) — настраивается как стандартный экран «Ссылка устарела»

Экран, блокирующий действия заявителя при ожидании созаявителя (wait_for_coapp) — должен быть выбран тип экрана «составной», на нём расположить 2 кнопки:

• кнопка возвращения в ЛК «Переход В ЛК в раздел Заявления»
• кнопка отзыва заявления (если выбран соответствующий тип БП Delirium(вариант 2)) как показано на ниже

Экран действий созаявителя (sc1) - должен быть выбран тип экрана «составной», на нём расположить 2 кнопки: 

• подтвердить — кнопка с типом «Переход на следующий шаг», на последнем экране данной ветки необходимо установить флаг «Признак последнего экрана»
• отказаться — кнопка с настройками, как на скриншоте ниже, на последнем экране данной ветки необходимо убрать флаг «Признак последнего экрана»

В настройках финального экрана ветки сценария отклонения согласования должны быть отключены чекбокс: "Признак последнего экрана"

Пример финального экрана отклонения согласования

Тестирование настроенной услуги

После настройки услуги, можно воспроизвести услугу и проверить результат выполнения.
Для этого запустите услугу, на экране добавления созаявителя укажите его паспортные данные

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

• в ЛК созаявителя должно быть заявление в 91 статусе (Ожидает согласия)
   
• уведомление на электронной почте и в ЛК созаявителя о том, что заявитель пригласил согласовать заявление
  

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

• в ЛК заявителя должно быть заявление основного заявителя, отправленного в ведомство, начиная с 17 статуса (Зарегистрировано на портале)
• в ЛК созаявителя должно быть заявление в 81 статусе (Согласие отправлено) 
  
  
• уведомление на электронной почте и в ЛК созаявителя о том, что согласие отправлено 
  
  
• уведомление на электронной почте и в ГЭПС заявителя о том, что созаявитель согласовал заявление

Типовые ошибки при запуске услуги