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

smev3 link

smev manual

Атрибут Значение
Название 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"
}