Универсальный вид сведений для приема событий электронного заявления на портале государственных услуг (функций)
| Атрибут | Значение |
|---|---|
| Название | epgu-event |
| Тип | Адаптер для взаимодействия с ЕПГУ |
| Наименование | Универсальный вид сведений для приема событий электронного заявления на портале государственных услуг (функций) |
| Назначение | Вид сведений предназначен для приёма событий электронного заявления на портале государственных услуг (функций) от ведомства в процессе исполнения государственной услуги |
| Область применения | Межведомственное взаимодействие |
| Поставщик | Министерство цифрового развития, связи и массовых коммуникаций Российской Федерации |
| Потребители | ФОИВ, РОИВ, ОМСУ, МФЦ, ЗАГС, Министерство связи и массовых коммуникаций Российской Федерации |
| Версия ВС | 3.1.1 |
| Версия МР | 3.1 |
| Версия СМЭВ | СМЭВ3 |
Описание бизнес-процесса взаимодействия:
ИС организации передаёт через Агредатор в СМЭВ данные о событии по ранее принятому заявлению в процессе исполнения государственной услуги. ЕПГУ получает из СМЭВ информацию, подтверждает сохранение информации о событии по заявлению. Подтверждение через СМЭВ направляется обратно в Агредатор, далее в ИС организации.
flowchart LR;
A[ИС организации] <--> B[Агредатор];
B <--> C[СМЭВ];
C <--> D[ЕПГУ];
Переменные окружения
| Название | Описание |
|---|---|
| CA_CERT | Сертификат центра сертификации для подключения к rabbitmq |
| CLIENT_CERT | Сертификат, используемый для подключения к rabbitmq |
| CLIENT_KEY | Ключ, используемый для подключения к rabbitmq |
| MQ_HOST | Хост rabbitmq |
| MQ_PORT | Порт rabbitmq |
| SMEV_SERVICE | Название смэв сервиса, на который будут отправляться запросы |
Переменные для конфигурирования подключения к БД:
DATABASE_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USER, DATABASE_PASS.
Переменные для конфигурирования отправки метрик в Elasticsearch:
ELASTIC_HOST, ELASTIC_PORT, ELASTIC_METRIC_PREFIX
Принимаемые параметры
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| env | Используется для маршрутизации между средами ЕПГУ. В продуктивной среде допустимо только значение «PROD». Принимает значения: DEV, UAT, EXUAT, SVCDEV, TCOD, PROD | - | PROD |
| order_id | Идентификатор заявления в ЛК ЕПГУ | + | 12345678 |
| event_date | Дата и время события в ИС ведомства | - | 2018-03-01T15:00:00+03:00 |
| event_comment | Комментарий к событию | - | Комментарий к статусу |
| event_author | Ф.И.О. сотрудника ведомства | - | Фамилия И.О. |
| order_status_event | Статус заявления | -1 | Составной элемент OrderStatusEvent |
| payment_status_event | Информация о начислении | -1 | Составной элемент PaymentStatusEvent |
| info_event | Информационное событие | -1 | Составной элемент InfoEvent |
| text_message_event | Текстовое сообщение. При наличии обязательное значение true | -1 | true |
| equeue_event | Приглашение на приём | -1 | Составной элемент EqueueEvent |
| is_mtom | Признак передачи вложения с запросом по протоколу MTOM. В противном случае считается, что вложение передается через файловое хранилище СМЭВ | - | true |
| attachments | Информация о переданных файлах вложениях, сохраненных в файловом хранилище Агредатора | - | Последовательность идентификаторов файлов вложений uuid. Поле обязательно присутствует, но может быть пустым. Вложения разрешены только при передаче запроса со статусом заявления. ["31625521a1f842575a3bc814cbc750dfc3017421966f634107699c8d71054f15", "181210f8f9c779c26da1d9b2075bde0127302ee0e3fca38c9a83f5b1dd8e5d3b"] |
1 - обязательно должен присутствовать только один из элементов
Структура элемента OrderStatusEvent
Статус заявления
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| org_code | Код статуса заявления, используемый в ИС ведомства | -1 | |
| tech_code | Технологический код статуса заявления ЕПГУ | -1 | 7 |
| cancel_allowed | Возможность запроса Заявителем отмены заявления в данном статусе. При отсутствии = false. | - | true |
| send_message_allowed | Возможность отправки Заявителем текстовых сообщений в ИС ведомства в данном статусе. При отсутствии = false. | - | true |
1 - обязательно должен присутствовать только один из элементов
Структура элемента PaymentStatusEvent
Статус начисления
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| payment | Информация о начислении | + | Массив (c максимально допустимой длиной 10) составных элементов Payment |
Структура элемента Payment
Информация о начислении
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| uin | Уникальный идентификатор начисления | + | 19200000022577713012 |
| description | Назначение платежа | + | Госпошлина |
Структура элемента InfoEvent
Информационное событие
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| code | Код ведомственного события | + | 150 |
Структура элемента EqueueEvent
Приглашение записаться на приём или флаг отмены приглашения
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| equeue_invitation | Создание приглашения на приём | -1 | Составной элемент EqueueInvitation |
| equeue_closed | Отмена приглашения на приём. При наличии обязательное значение true | -1 | true |
1 - обязательно должен присутствовать только один из элементов
Структура элемента EqueueInvitation
Приглашение записаться на приём с указанием перечня подразделений и кабинетов/специалистов, а также интервала дат
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| organization_data | Перечень подразделений и кабинетов / специалистов | - | Массив (c максимально допустимой длиной 50) составных элементов OrganizationData |
| start_date | Дата, с которой можно записаться на приём | - | 2018-03-10 |
| end_date | Дата, по которую (включительно) можно записаться на приём | - | 2018-03-30 |
Структура элемента OrganizationData
Код подразделения и перечень кодов кабинетов/специалистов
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| organization_id | Код подразделения | + | 2 |
| area_id | Код кабинета или специалиста. Массив не более 10 элементов | - | [15,23] |
Параметры ответа
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| code | Результат обработки события | + | 150 |
| message | Сообщение | + | operation completed |
Примеры
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующие запросы:
{
"env": "DEV",
"order_id": "12345678",
"event_date": "2018-03-01T15:00:00+03:00",
"event_comment": "Комментарий к статусу",
"order_status_event": {
"tech_code": "7",
"cancel_allowed": "true",
"send_message_allowed": "true"
},
"attachments": []
}
{
"env": "DEV",
"order_id": "12345678",
"event_date": "2018-03-01T15:00:00+03:00",
"payment_status_event": {
"payments": [{
"uin": "19200000022577713012",
"description": "Госпошлина"
}]
},
"attachments": []
}
{
"env": "DEV",
"order_id": "12345678",
"event_date": "2018-03-01T15:00:00+03:00",
"event_comment": "Комментарий к событию",
"info_event": {
"code": "150"
},
"attachments": []
}
{
"env": "DEV",
"order_id": "12345678",
"event_date": "2018-03-01T15:00:00+03:00",
"event_comment": "Сообщаем, что срок проверки документов составляет 10 рабочих дней",
"event_author": "Фамилия И.О.",
"text_message_event": "true",
"attachments": []
}
{
"env": "DEV",
"order_id": "12345678",
"event_date": "2018-03-01T15:00:00+03:00",
"event_comment": "Комментарий к статусу",
"equeue_event": {
"equeue_invitation": {
"organization_datas": [
{
"organization_id": "1"
},
{
"organization_id": "2",
"area_ids": [
"15",
"23"
]
}
],
"start_date": "2018-03-10",
"end_date": "2018-03-30"
}
},
"attachments": []
}
{
"env": "DEV",
"order_id": "12345678",
"event_date": "2018-03-01T15:00:00+03:00",
"equeue_event": {
"equeue_closed": "true"
},
"attachments": []
}
В случае корректной настройки должен прийти следующий ответ:
{
"code": "0",
"message": "operation completed"
}