Руководство по установке#

🕮 Содержание раздела

Перед установкой модуля для обмена информацией с ЕПГУ требуется подключение к формам - концентраторам.

Подключение выполняется в порядке, указанном в руководстве.

1. Подключиться к СМЭВ

Если на проекте подключение к СМЭВ 3 не выполнялось, то нужно это сделать (См. Подключение к СМЭВ)

2. Получить доступ в продуктивной среде в качестве потребителя к ВС «Универсальный вид сведений для приема событий электронного заявления на портале государственных услуг (функций)»

Для этого выполните следующее:

  1. если проверка СМЭВ в тестовом контуре уже выполнялась, то переходите к следующему шагу. Если нет, то выполните подготовку окружения

    • распакуйте архив SmevMezhvedTestContour.zip в каталог /home /GEMS/SmevMezhvedTestContour

    • в файле appsettings.json в теге Enabled установите значение true для вида сведений EventService. Если проверку в тестовом контуре нужно выполнить для одного ВС, то true нужно установить только для него

    ../../../_images/event_service.png

    • запустите SmevTestContourTestingApp:

      dotnet Gems.Smev.TestContourCheckingApplication.dll

    • проверьте результаты тестирования

      Пример результата тестирования для «Универсального вида сведений для приема событий электронного заявления на портале государственных услуг (функций)»:

      Скачать примеры

  2. после получения ответов на тестовый запрос нужно оформить заявку на получение доступа и передать ее заказчику для передачи в СМЭВ 3. К заявке необходимо приложить архив с полученными результатами тестирования.

Пример заявки: Скачать

В заявке желтым цветом выделена информация, которую заполняет разработчик, зеленым - заказчик.

Как заполнить заявку#

Раздел заявки

Как заполнить

Полное или краткое наименование Участника

Присваивается при получении доступа СМЭВ 3 (при отсутствии информации пункт заполняет заказчик)

Мнемоника Участника в Продуктивной среде

Присваивается при получении доступа СМЭВ 3 (при отсутствии информации пункт заполняет заказчик)

Полное или краткое наименование ИС

Присваивается при получении доступа СМЭВ 3 (при отсутствии информации пункт заполняет заказчик)

Мнемоника ИС в Продуктивной среде

Присваивается при получении доступа СМЭВ 3 (при отсутствии информации пункт заполняет заказчик)

Информация о предварительном тестировании в Тестовой среде

Дата/время прохождения тестирования

Заполняется после прохождения тестирования значением тэга DeliveryTimestamp из файла Request0\ response__answer.xml [1]

MessageID запроса

Заполняется после прохождения тестирования значением тэга MessageID из файла Request0\ Request0.xml [2]

3. Оформить заявку на получение доступа и передать ее заказчику для передачи в СМЭВ 3.

Как заполнить заявку#

Раздел заявки

Как заполнить

Полное или краткое наименование Участника

Присваивается при получении доступа СМЭВ 3 (при отсутствии информации пункт заполняет заказчик)

Мнемоника Участника в Продуктивной среде

Присваивается при получении доступа СМЭВ 3 (при отсутствии информации пункт заполняет заказчик)

Полное или краткое наименование ИС

Присваивается при получении доступа СМЭВ 3 (при отсутствии информации пункт заполняет заказчик)

Мнемоника ИС в Продуктивной среде

Присваивается при получении доступа СМЭВ 3 (при отсутствии информации пункт заполняет заказчик)

Код маршрутизации

ОКТМО Субъекта РФ

Примеры заявок: Скачать

В заявках желтым цветом выделена информация, которую заполняет разработчик, зеленым - заказчик.

Важно

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

4. Тестирование в тестовой среде для получения доступа к видам сведений в качестве поставщика по каждой услуге в продуктивной среде

Подсказка

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

  • В ответ на отправленные заявки на получение доступа к формам ЕПГУ по каждой услуге в тестовой среде заказчику придет ответ вида:

    В целях прохождения тестирования ВС "Прием заявлений с ЕПГУ по форме «<Наименование услуги>»" версии 1.0.1 в качестве Поставщика в тестовой среде СМЭВ 3.0 службой эксплуатации СМЭВ был направлен запрос:

a324b918-f12c-11eb-a91a-c0b88376c776

c кодом маршрутизации …в адрес ИС "ГИСОГД …" с мнемоникой ….

Запрос успешно помещен в очередь получателя.

Необходимо получить запрос из очереди ИС (метод GetRequestRequest), подтвердить получение с указанием message_id полученного сообщения (метод Ack),  сформировать ответ и направить с помощью метода SendResponseRequest. После чего необходимо проинформировать СЭ СМЭВ о прохождении цепочки взаимодействия и  предоставить id ответа, сформированный методом SendResponseRequest или xml файл ответа.

После выполнения вышеуказанной процедуры предоставить XML файлы:

- GetRequestResponse;
- GetRequestRequest;
- Ack;
- SendResponseRequest;
- SendResponseResponse.

При отсутствии ответа обращение будет закрыто через три календарных дня.

После получения данного ответа в течение 3 дней необходимо:

  • На сервер где проводилось тестирование из п. 2 положить утилиту <Номер сборки>\Дистрибутивы\Products\SmevProducerEmulator (не ниже 5.6)

  • В файле appsettings.json указать номер сертификата и пароль

    ../../../_images/event_service4.png

  • Перейти в папку с утилитой и запустить ее командой:

    dotnet Gems.Smev.ProducerEmulator.dll

  • По окончании работы утилиты перейти в каталог \ProducerEmulator\EnvelopeFiles\<дата запуска утилиты>. В нем появится каталог с наименованием, соответствующим номеру, указанному в заявке - службой эксплуатации СМЭВ был направлен запрос: a324b918-f12c-11eb-a91a-c0b88376c776.

  • Проверить, что в каталоге присутствуют 6 файлов:
    - AckRequest.xml
    - AckResponse.xml
    - GetRequestRequest.xml
    - GetRequestResponse.xml
    - SendResponseRequest.xml
    - SendResponseResponse.xml

  • Содержимое каталога упаковать в архив и передать заказчику вместе с содержимым тега MessageID из файла SendResponseRequest.xml

Важно

Не удаляйте утилиту и полученные результаты с сервера. Часто информация от заказчиков поступает позднее, чем СМЭВ направляет запросы для прохождения тестирования. Утилита в процессе работы получает все запросы и повторно их получить не будет возможности

5. Тестирование в продуктивной среде для получения доступа к видам сведений в качестве поставщика по каждой услуге в продуктивной среде

После прохождения предыдущего пункта от СМЭВ придет ответ вида:

Тестирование в тестовой среде СМЭВ 3.0 пройдено успешно. Просьба пройти тестирование в продуктивной среде СМЭВ 3.0.

В целях прохождения тестирования ВС "Прием заявлений с ЕПГУ по форме «<наименование услуги>»" версии 1.0.1

в качестве Поставщика в продуктивной среде СМЭВ 3.0 службой эксплуатации СМЭВ был направлен запрос:

1) 4687b813-f5b4-11eb-9761-c0b88376c776

c кодом маршрутизации 04000000 в адрес ИС "…" с мнемоникой ….

Запрос успешно помещен в очередь получателя.

Необходимо получить запрос из очереди ИС (метод GetRequestRequest), подтвердить получение с указанием message_id полученного сообщения (метод Ack), сформировать ответ и направить с помощью метода SendResponseRequest. После чего необходимо проинформировать СЭ СМЭВ о прохождении цепочки взаимодействия и предоставить id ответа, сформированного методом SendResponseRequest или xml файл ответа.

После выполнения вышеуказанной процедуры предоставить XML файлы:
  - GetRequestResponse
  - GetRequestRequest
  - Ack
  - SendResponseRequest
  - SendResponseResponse

После получения ответа в течение 3 дней необходимо выполнить действия из п. 5 на боевом сервере.

Важно

Перед запуском утилиты SmevProducerEmulator из п. 6 в файле appsettings.json заменить адрес СМЭВ на "SmevUri": "http://172.20.3.12:7500/smev/v1.2/ws?wsdl",

../../../_images/event_service5.png

Обратите внимание

Если не удалось поймать запрос СМЭВ через утилиту ProducerEmulator, запрос был пойман Аmber и ушел в БД.

  1. Установите программу LiteDB Explorer /

  2. Выполните в БД запрос:

select * from amber.http_exchange where "ResponseBody" like '%21e260e0-8f37-11ec-99aa-c8d9d293d75d%'

Где 21e260e0-8f37-11ec-99aa-c8d9d293d75d - номер запроса СМЭВ.

  1. Сохраните значение поля [RegisteredApplicationKey], например 49/

  2. Выполните в БД запрос:

select * from amber.http_exchange where "RegisteredApplicationKey" = 49

  1. Запрос выдаст несколько строк. Значения первых двух самых ранних по времени строк и их значения в полях [ResponseBody] и [RequestBody] сохраните в файлы с соответствующими наименованиями (AckRequest.xml, AckResponse.xml, GetRequestRequest.xml, GetRequestResponse.xml)

  2. Каждое значение полей [ResponseBody] и [RequestBody] в начале xml-описания содержит теги <ns1:AckRequest, <ns1:GetRequestRequest, <ns2:AckResponse, <ns2:GetRequestResponse, которые соответствуют наименованиям файлов, в которые необходимо сохранить значения полей.

Например, xml из данного поля необходимо сохранить в файл AckRequest.xml

../../../_images/amber1.png

  1. На сервере в папке …/ProducerEmulator/EnvelopeFiles/ создайте папку с текущей датой, например 2022-02-18.

  2. В папке 2022-02-18 создайте папку с номером запроса, например 21e260e0-8f37-11ec-99aa-c8d9d293d75d

  3. В папке …/ProducerEmulator/EnvelopeFiles/2022-02-18/21e260e0-8f37-11ec-99aa-c8d9d293d75d разместите подготовленные xml файлы (AckRequest.xml, AckResponse.xml, GetRequestRequest.xml, GetRequestResponse.xml).

  4. Из папки …/ProducerEmulator/ скопируйте на компьютер файл TestRequestsCurator.db.

  5. Запустите программу, установленную на шаге 1 с правами администратора.

  6. В программе выберите пункт File-Открыть-выбрать файл TestRequestsCurator.db.

  7. Отредактировать любой из старых запросов, у которых в колонке IsProcessed стоит true, следующим образом:

../../../_images/amber2.png

Заранее откройте в текстовом редакторе файл GetRequestResponse.xml:

13.1. Выберите запрос.

13.2. Нажмите кнопку «Edit».

13.3. В поле [MessageId] укажите номер запроса 21e260e0-8f37-11ec-99aa-c8d9d293d75d.

13.4. В полях [ReceiveDate] и [ResponseDate] укажите текущую дату, например 2022-02-18.

13.5. Убрерите галочку IsProcessed.

13.6. В поле [LastSuccessStep] впишите AckSent.

13.7. В поле [ReplyTo] укажите значение тега <ns2:ReplyTo> из файла GetRequestResponse.xml, например:

../../../_images/amber3.png

13.8. В поле [MessagePrimaryContent] укажите значение тега <tns:request вместе с тегом, например:

../../../_images/amber4.png

13.9. В поле [RelativePath] укажите значение тега <ns2:MessageID>, например:

../../../_images/amber5.png

13.10. Нажмите кнопку «ОК». Файл TestRequestsCurator.db автоматически сохранится.

  1. Замените файл TestRequestsCurator.db в папке …/ProducerEmulator/ на новый.

  2. Запустите утилиту ProducerEmulator.

  3. В папке …/ProducerEmulator/EnvelopeFiles/2022-02-18/21e260e0-8f37-11ec-99aa-c8d9d293d75d появятся еще два файла (SendResponseRequest.xml, SendResponseResponse.xml).

  4. Передайте заказчику папку …/ProducerEmulator/EnvelopeFiles/2022-02-18/21e260e0-8f37-11ec-99aa-c8d9d293d75d с шестью файлами(AckRequest.xml, AckResponse.xml, GetRequestRequest.xml, GetRequestResponse.xml, SendResponseRequest.xml, SendResponseResponse.xml).

6. Регистрация в тестовой среде ЕПГУ

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

Примеры заявок: Скачать

В заявках желтым цветом выделена информация, которую заполняет разработчик, зеленым - заказчик.

Как заполнить заявку#

Раздел заявки

Как заполнить

Код маршрутизации

ОКТМО Субъекта РФ

Наименование региона

Наименование Субъекта РФ

Номер заявки на подключение в тестовой среде СМЭВ 3.х в качестве поставщика к виду сведений «<наименование вида сведений соответствующего услуге>»

Номер заявки направленной заказчиком на получение доступа к видам сведений из п.3 в формате INC0000000000000

7. Заполнить справочник «Уполномоченный орган предоставляющий услугу»

После получения доступа по п.4 необходимо проверить наличие значений в справочнике «Уполномоченный орган предоставляющий услугу»:

  1. Зайдите в тестовую среду ЕПГУ и введите логин: 112-233-446 96, пароль: 11111111, учетная запись: И.В. Каменев.

  2. В правом верхнем углу выберите необходимый Субъект РФ

../../../_images/event_service3.png

  1. Заполните все поля заявления.

  2. На последнем этапе необходимо выберите Уполномоченный орган предоставляющий услугу.

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


    Адрес тестовой среды: http://esnsi.test.gosuslugi.ru
    Адрес продуктивной среды: http://esnsi.gosuslugi.ru

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

8. Регистрация ВИС в продуктивной среде

Для прохождения данного пункта необходимо наличие значений справочника «Уполномоченный орган предоставляющий услугу» в тестовой среде и наличие доступа по пунктам 2 и 4.

Для регистрации ВИС в продуктивной среде необходимо:

  1. На тестовом стенде с установленным сертификатом установить сборки Geometa и Amber

    При установке модуля Интеграции с ЕПГУ (Amber), в таблице БД amber.global_settings должно быть указано "Environment": "SVCDEV", вместо "Environment": "PROD",

  2. Направить по каждой услуге 2 заявления с тестовой среды ЕПГУ и сохранить себе их номера:

Учетная запись для тестовой среды ЕПГУ:
Логин: 010-000-319 28
Пароль: newpass!1230
Ссылки на услуги#

Услуга

Ссылка

Выдача разрешения на строительство объекта капитального строительства

https://svcdev-beta.test.gosuslugi.ru/600168/1/form

Примечание

Перед подачей заявления на портале необходимо выбрать свой регион, после выбора начать оформлять новое заявление (не из черновика)

  1. Получить заявления в Geometa

  2. По первому заявлению направить промежуточные статусы.

    Для отправки промежуточных статусов в карточке услуги нужно установить статус «Заявление зарегистрировано» и сохранить карточку. Появится сообщение «В ЛК ЕПГУ будет отправлен статус «Заявление зарегистрировано». Продолжить?» – подтвердить отправку и дождаться отображения статуса на портале.

    Затем установить статус «Подготовка документа» и сохранить карточку. Появится сообщение «В ЛК ЕПГУ будет отправлен статус «Заявление принято к рассмотрению». Продолжить?» – подтвердить отправку и дождаться отображения соответствующего статуса на портале.

  3. По первому заявлению направить финальный статус «Услуга оказана».

    Для отправки финального статуса в карточке услуги нужно установить статус «Подготовлен результат» и сохранить карточку.
    Перейти в карточку результата услуги (не отказ), установить у результата услуги статус «Действующий», прикрепить любой файл и сохранить.
    Перейти в карточку услуги, нажать кнопку Отправить и дождаться отображения результата на портале.

  4. По второму заявлению направить финальный статус «Отказано в предоставлении услуги».

    Для отправки финального статуса в карточке услуги установить статус «Подготовлен отказ» и сохранить карточку.
    Перейти в карточку результата услуги «Решение об отказе» *(возврате), установить у результата услуги статус *«Действующий», прикрепить любой файл и сохранить.
    Перейти в карточку услуги, нажать кнопку Отправить и дождаться отображения результата на портале.

  5. Заполнить заявку на регистрацию ВИС и передать ее заказчику для передачи в СМЭВ 3.

Примеры заявок: Скачать примеры

В заявках желтым цветом выделена информация, которую заполняет разработчик, зеленым - заказчик.

В теме письма необходимо указать ИС ХМАО #КУ-СМЭВ3-ПРОД

Как заполнить заявку#

Раздел заявки

Как заполнить

В теме письма необходимо указать ИС ХМАО #КУ-СМЭВ3-ПРОД

Заменить наименование Субъекта РФ

Код маршрутизации

ОКТМО Субъекта РФ

Наименование региона

Наименование Субъекта РФ

Номер заявки на подключение в тестовой среде СМЭВ 3.х в качестве поставщика к виду сведений <наименование вида сведений соответствующего услуге>

Номер заявки направленной заказчиком на получение доступа к видам сведений из в формате INC0000000000000

Номер заявки с промежуточными результатами по заявлению + передача комментария при смене статуса на промежуточный на продуктивной среде (с помощью вида сведений Универсальный вид сведений для приема событий электронного заявления на портале государственных услуг (функций) раздел 11)

Номер ПЕРВОГО заявления

Номер заявки, которая была исполнена (статус заявки 3 – Услуга оказана), в тестовой среде

Номер ПЕРВОГО заявления

Номер заявки с отказом (статус заявки 4 – Отказ), в тестовой среде

Номер ВТОРОГО заявления

  1. После положительного рассмотрения заявок проверить работу услуг в продуктивной среде ЕПГУ.

    Для этого:

    • Направьте заявления по всем услугам в продуктивной среде ЕПГУ

    Ссылки на услуги#

    Услуга

    Ссылка

    Выдача разрешения на строительство объекта капитального строительства

    https://www.gosuslugi.ru/600168/1/form

    • Если на боевом сервере заказчика не установлен Amber, то запустите на боевом сервере заказчика утилиту Дистрибутивы\Products\SmevProducerEmulator (не ниже 5.7) и убедитесь, что в каталоге ProducerEmulator\EnvelopeFiles появились все направленные заявления.

    • Если Amber установлен, то переустановите его с необходимым модулем и получите заявления в Geometa.

Проверьте, что на ЕПГУ заявления находятся в статусе Получено ведомством

Если не все заявления отобразились в утилите, значит они автоматически были направлены в ПГС. В таком случае заказчику необходимо рекомендовать направить заявку с описанием проблемы.

9. Активация ВИС в продуктивной среде

Для прохождения данного пункта необходимо, чтобы заказчик был готов принимать и обрабатывать заявления и имел на своем сервере Geometa и Amber версии не ниже 5.7.

Для активации ВИС в продуктивной среде необходимо:

  1. На продуктивном стенде заказчика с установленным сертификатом разместить сборку Geometa и Amber версии не ниже 5.7

  2. Развернуть новый проект и настроить получение заявлений на него в таблице amber.global_settings (См. Подготовка к установке)

  3. Направить по каждой услуге 2 заявления с продуктивной среды ЕПГУ и сохранить себе их номера

Ссылки на услуги#

Услуга

Ссылка

Выдача разрешения на строительство объекта капитального строительства

https://www.gosuslugi.ru/600168/1/form

Примечание

Перед подачей заявления на портале необходимо выбрать свой регион, после выбора начать оформлять новое заявление (не из черновика)

  1. Получить заявления в Geometa

  2. По первому заявлению направить промежуточные статусы.

    Для отправки промежуточных статусов в карточке услуги нужно установить статус «Заявление зарегистрировано» и сохранить карточку. Появится сообщение «В ЛК ЕПГУ будет отправлен статус «Заявление зарегистрировано». Продолжить?» – подтвердить отправку и дождаться отображения статуса на портале.

    Затем установить статус «Подготовка документа» и сохранить карточку. Появится сообщение «В ЛК ЕПГУ будет отправлен статус «Заявление принято к рассмотрению». Продолжить?» – подтвердить отправку и дождаться отображения соответствующего статуса на портале.

  3. По первому заявлению направить финальный статус «Услуга оказана».

    Для отправки финального статуса в карточке услуги нужно установить статус «Подготовлен результат» и сохранить карточку.
    Перейти в карточку результата услуги (не отказ), установить у результата услуги статус «Действующий», прикрепить любой файл и сохранить.
    Перейти в карточку услуги, нажать кнопку Отправить и дождаться отображения результата на портале.

  4. По второму заявлению направить финальный статус «Отказано в предоставлении услуги».

    Для отправки финального статуса в карточке услуги установить статус «Подготовлен отказ» и сохранить карточку.
    Перейти в карточку результата услуги «Решение об отказе» *(возврате), установить у результата услуги статус *«Действующий», прикрепить любой файл и сохранить.
    Перейти в карточку услуги, нажать кнопку Отправить и дождаться отображения результата на портале.

  5. Заполнить заявку на активацию ВИС и передать ее заказчику для передачи в СМЭВ 3.

Примеры заявок: Скачать примеры

В заявках желтым цветом выделена информация, которую заполняет разработчик.

В теме письма необходимо указать ИС ХМАО #КУ-СМЭВ3-АКТИВАЦИЯ

Как заполнить заявку#

Раздел заявки

Как заполнить

В теме письма необходимо указать ИС ХМАО #КУ-СМЭВ3-АКТИВАЦИЯ

Заменить наименование Субъекта РФ

Код маршрутизации

ОКТМО Субъекта РФ

Наименование региона

Наименование Субъекта РФ

Номер заявки на подключение в продуктивной среде СМЭВ 3.х в качестве поставщика к виду сведений <наименование вида сведений соответствующего услуге>

Номер заявки направленной заказчиком на получение доступа к видам сведений в формате INC0000000000000

Номер заявления на ЕПГУ с промежуточными результатами по заявлению + передача комментария при смене статуса на промежуточный на продуктивной среде (с помощью вида сведений Универсальный вид сведений для приема событий электронного заявления на портале государственных услуг (функций) раздел 9)

Номер ПЕРВОГО заявления

Номер заявки, которая была исполнена (статус заявки 3 – Услуга оказана), в продуктивной среде

Номер ПЕРВОГО заявления

Номер заявки с отказом (статус заявки 4 – Отказ)

Номер ВТОРОГО заявления

Важно

После оформления всех заявок необходимо изменить настройки в БД в таблице amber.global_settings на реальные данные по всем муниципальным образованиям.

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