Все примеры «персональных данных», представленные на данном портале, являются тестовыми (не реальными)! Примеры представлены разработчикам для тестирования ИТ-систем. Доступ к реальным данным осуществляется в соответствии с законами РФ согласно «Методическим рекомендациям». Подробнее.
Если у вас есть законные основания для подключения к Виду сведения, мы можем проконсультировать по техническим и организационным моментам подключения. Связаться с нами
Адаптер для работы с ЕПГУ
| Атрибут | Значение | |
|---|---|---|
| Название | epgu-adapter | |
| Наименование 1 | Адаптер для работы с ЕПГУ | |
| Наименование 2 | Получение государственной или муниципальной услуги для указанного пользователя или организации по инициативе третьей стороны (интеграционный модуль) | |
| Область применения | Межведомственное взаимодействие | |
| Версия | 1.0.3 | |
| Версия МР | 3.0 | |
| Версия СМЭВ | СМЭВ3 |
Адаптер для работы с ЕПГУ через сервис СМЭВ 3 версии 1.0.3
Общее описание и документация (сайт Госуслуг): https://partners.gosuslugi.ru/catalog/integration_module
Описание конкретных сервисов (сайт Госуслуг): https://gu-st.ru/content/partners/Opisanie%20parametrov%20zaprosa%20dlya%20IM.docx
Особенности тестирования и подключения сервиса в СМЭВ
Особенностью данного СМЭВ сервиса является то, что он сам является шлюзом (интеграционным модулем) к сервисам ЕПГУ. Это значит, что процесс обработки запроса выглядит следующим образом: <сервис Агредатора> -> epgu-adapter -> smev3 -> СМЭВ -> ЕПГУ, то есть включает в процесс как конкретный сервис Агредатора (например epgu-pfr-account), так и сервис-адаптер epgu-adapter и адаптер СМЭВ3 - smev3.
Таким образом, процесс подключения состоит из следующих шагов:
- Подключение к тестовому контуру СМЭВ для базовой проверки сервиса. Не требует дополнительных действий - только проверка доступности тестового контура СМЭВ.
- Подключение к тестовому контуру ЕПГУ и прохождение теста.
Проведение испытаний в тестовой среде СМЭВ должно проводиться с использованием тестовой системы поставщика ВС – тестовой среды ЕПГУ: в контрольном примере запроса значение элемента RoutingCode указывается как SVCDEV, в блоке данных запроса должен отсутствовать признак тестового взаимодействия (элемент TestMessage) (см. п.п. 3.2.1 Методических рекомендаций по работе с ЕСМЭВ).
Для выполнения данного требования необходимо:
- поле ConfirmType(confirm_type) установить в значение REST_API
- поле RoutingCode(routing_code) установить в значение SVCDEV
- настроить сервиc smev3 в соответствии с требованием ЕПГУ:
- признак TestMsg убирается настройкой SERVICE_USE_PRODUCTION: "true"
- необходимо указать тестовый адрес SMEV_ENDPOINT: "http://smev3-n0.test.gosuslugi.ru:7500/ws?wsdl"
- Выполнить запрос. Пример:
{
"confirm_type": "REST_API",
"routing_code": "SVCDEV",
"person": {
"snils": "000-000-000 03",
"firstName": "Имя",
"lastName": "Фамилия",
"secondName": "Отчество",
"bdate": "2014-09-19",
"passport": {
"series": "22 33",
"num": "112233",
"issueDate": "2008-09-29",
"issueCode": "123-123"
},
"phone": "+7 (912) 123-22-11"
},
"serviceFormCode": "10000012285",
"serviceCode": "10000569524"
}
- Отправить запрос на подключение к продуктовому контуру, и приложить к нему логи взаимодействия от предыдущего запроса.
Принимаемые параметры
Запрос на получение государственной или муниципальной услуги для указанного пользователя по инициативе третьей стороны
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| routing_code | Код маршрутизации на ЕПГУ среду. Для простого тестирования необходимо указывать DEV. Для прохождения контрольного теста ЕПГУ необходимо указывать SVCDEV. В продуктивной среде допустимо только значение PROD |
- | DEV |
| confirm_type | Тип подтверждения: SMS или REST_API |
- | REST_API |
| service_form_code | Идентификатор электронной формы услуги на ЕПГУ. Обычно заполняется конкретным сервисом (например epgu-pfr-account) |
+ | 10000012285 |
| service_code | Идентификатор цели обращения услуги по ФРГУ. Обычно заполняется конкретным сервисом (например epgu-pfr-account) |
+ | 10000569524 |
| person | Данные пользователя для поиска его в ЕСИА | + | Сложный тип Person |
Запрос на получение государственной или муниципальной услуги для указанной организации по инициативе третьей стороны (Пример: услуга «Получение разъяснений по вопросам применения федеральным антимонопольным органом антимонопольного законодательства»)
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| routing_code | Код маршрутизации на ЕПГУ среду | - | DEV |
| confirm_type | Тип подтверждения | - | SMS |
| service_form_code | Идентификатор электронной формы услуги на ЕПГУ | + | 10000012285 |
| service_code | Идентификатор цели обращения услуги по ФРГУ | + | 10000569524 |
| author | Данные сотрудника-инициатора для поиска его в ЕСИА | + | Сложный тип Person |
| signer | Данные сотрудника-подписанта для поиска его в ЕСИА | + | Сложный тип Person |
| draft | Форма заявления | + | Сложный тип Draft |
| organization | Данные организации | - | Сложный тип Org |
Структура элемента Person
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| snils | СНИЛС пользователя | - | 000-000-000 03 |
| first_name | Имя пользователя | + | Имя |
| last_name | Фамилия пользователя | + | Фамилия |
| second_name | Отчество пользователя | - | Отчество |
| bdate | Дата рождения | + | 2014-09-19 |
| phone | Номер мобильного телефона пользователя | + | +7 (912) 123-22-11 |
| passport | Паспорт гражданина РФ | + | Сложный тип Passport |
Структура элемента Passport
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| series | Серия документа | + | 22 33 |
| num | Номер документа | + | 112233 |
| issue_date | Код подразделения | + | 2008-09-29 |
| issue_code | Дата выдачи документа | + | 123-123 |
Структура элемента Org
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| ogrn | ОГРН организации | + | 0001234000009 |
| inn | ИНН организации | + | 3905074565 |
Структура элемента Draft
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| version | Версия формы услуги для интеграционного модуля | + | 1 |
| fields | Массив полей формы | + | Сложный тип Field |
Структура элемента Field
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| code | Код параметра формы | + | form.FormStep4.Panel1_FL.Panel1.Fias_0 |
| content | Массив частей параметра | + | Сложный тип Part |
Структура элемента Part
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| value | Значение параметра иил его части | + | 465456, г. Москва, р-н. Внуковское, г. Москва, пр-кт. Андропова, д. 6, к. 1, стр. 5, кв. 45 |
| order_number | Порядок части параметра | + | 0 |
Параметры ответа
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| id | Идентификатор заявки, сформированный в Интеграционном модуле | - | 1 |
| statusCode | Статус обработки запроса в интеграционном модуле | + | NEW |
| limit | Общие лимиты для ИС | - | Сложный тип Limit |
| stat | Количество выполненных запросов для ИС | - | Сложный тип Limit |
| errorStatusInfo | Детальная информация об ошибке | - | Последовательноcть элементов сложного типа Info |
Структура элемента Limit
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| day | Количество запросов за день | - | 1000 |
| month | Количество запросов за месяц | - | 10000 |
| total | Общее количество запросов | - | 1000000 |
Структура элемента Info
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| Code | Код ошибки | + | 0 |
| Message | Описание ошибки | + | OK |
Ответ зависит от конкретного сервиса. Описание находится тут: https://gu-st.ru/content/partners/Opisanie%20parametrov%20zaprosa%20dlya%20IM.docx
Примеры
Запрос на получение государственной или муниципальной услуги для указанного пользователя по инициативе третьей стороны
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:
{
"person": {
"snils": "000-000-000 03",
"firstName": "Имя",
"lastName": "Фамилия",
"secondName": "Отчество",
"bdate": "2014-09-19",
"passport": {
"series": "22 33",
"num": "112233",
"issueDate": "2008-09-29",
"issueCode": "123-123"
},
"phone": "+7 (912) 123-22-11"
},
"serviceFormCode": "10000012285",
"serviceCode": "10000569524"
}
В случае корректной настройки должен прийти следующий ответ:
{
"id": "1",
"statusCode": "NEW",
"limit": {
"day": "1000",
"month": "10000",
"total": "1000000"
},
"stat": {
"day": "5",
"month": "166",
"total": "1626"
},
"errorStatusInfo": [
{
"Code": "0",
"Message": "OK"
}
]
}
Запрос на получение государственной или муниципальной услуги для указанной организации по инициативе третьей стороны (Пример: услуга «Получение разъяснений по вопросам применения федеральным антимонопольным органом антимонопольного законодательства»)
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:
{
"ConfirmType": "REST_API",
"author": {
"firstName": "Имя",
"lastName": "Фамилия",
"secondName": "Отчество",
"bdate": "1989-03-20",
"passport": {
"series": "00 00",
"num": "000000",
"issueDate": "2014-08-13",
"issueCode": "360-037"
},
"phone": "+7 (900) 000-00-00"
},
"signer": {
"firstName": "Имя",
"lastName": "Фамилия",
"secondName": "Отчество",
"bdate": "1997-08-08",
"passport": {
"series": "00 00",
"num": "000696",
"issueDate": "2000-11-11",
"issueCode": "123-312"
},
"phone": "+7 (900) 000-00-00"
},
"organization": { "ogrn": "0001234000009", "inn": "3905074565" },
"serviceFormCode": "567",
"serviceCode": "10000526395",
"draft": {
"version": "1",
"fields": [
{
"code": "IQEpguFasUlRukLaw.nameUl",
"content": [
{
"value": "value:Общество с ограниченной ответственностью \"Балтинформ\"",
"orderNumber": "0"
}
]
},
{
"code": "IQEpguFasUlRukLaw.INN",
"content": [
{
"value": "value:3905074565",
"orderNumber": "0"
},
{
"value": "value:0001234000009",
"orderNumber": "1"
}
]
}
]
}
}
В случае корректной настройки должен прийти следующий ответ:
{
"id": "1",
"statusCode": "NEW",
"limit": {
"day": "1000",
"month": "10000",
"total": "1000000"
},
"stat": {
"day": "5",
"month": "166",
"total": "1626"
},
"errorStatusInfo": [
{
"Code": "0",
"Message": "OK"
}
]
}
