Электронный сервис Единого оператора газификации
| Атрибут | Значение |
|---|---|
| Название | epgu-gasification |
| Наименование | Электронный сервис Единого оператора газификации |
| Поставщики | Общество с ограниченной ответственностью «ЭТП ГПБ Консалтинг» |
| Потребители | Единый портал государственных услуг, МФЦ |
| Область применения | Прием заявлений с ЕПГУ/МФЦ |
| Версия | 2.0.0 |
| Версия МР | 3.5.0.4 |
Адаптер для сервиса версии 2.0.0.
Описание бизнес-процесса взаимодействия: Гражданин на портале государственных услуг подает заявление на оказание услуги. ЕПГУ направляет заявление к виду сведений в СМЭВ, СМЭВ направляет заявление в Агредатор, Агредатор направляет заявление непосредственно в ИС организации. После получения запроса, ИС организации направляет через Агредатор код ведомственного статуса или код статуса ЕПГУ, Агредатор направляет данную информацию в СМЭВ к ВС, которая впоследствии направляется в личный кабинет гражданина на ЕПГУ.
Переменные окружения
| Название | Описание |
|---|---|
| CA_CERT | сертификат центра сертификации для подключения к rabbitmq |
| CLIENT_CERT | сертификат, используемый для подключения к rabbitmq |
| CLIENT_KEY | ключ, используемый для подключения к rabbitmq |
| MQ_HOST | хост rabbitmq |
| MQ_PORT | порт rabbitmq |
| SMEV_SERVICE | название смэв сервиса, на который будут отправляться запросы |
| DATABASE_URL | строка подключения к БД |
| EMULATE_CLIENT | флаг эмуляции ответа клиента |
Переменные для конфигурирования отправки метрик в Elasticsearch:
ELASTIC_HOST, ELASTIC_PORT, ELASTIC_METRIC_PREFIX
Принимаемые параметры
В данном разделе приведены параметры, необходимые для формирования ответа на полученный запрос.
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| change_order | Статус услуги ЕПГУ | - | Последовательность элементов ChangeOrderResponse |
| attachments | Описания файлов вложений | - | Последовательность элементов AttachmentInfo |
| attachments_storage_ids | Массив идентификаторов вложений в файловом хранилище агредатора | - | ["71fe00cae91a42000a4e933879c854649cef13e92c1974f10b1d02eb7bceab46"] |
Структура элемента ChangeOrderResponse
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| epgu_id | Номер заявки в ЛК ЕПГУ | + | 12345678 |
| tech_code | Код статуса ЕПГУ. Принимает значения: 1 - Заявление зарегистрировано 2 - Подтверждение о получении 3 - Услуга оказана |
-1 | 3 |
| org_code | Код статуса | -1 | |
| comment | Комментарий | - | Заявление получено в ИС ЕОГ |
Структура элемента AttachmentInfo
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| is_unstructured_format | Признак того, является или нет вложение неструктурированным. По умолчанию true | - | false |
| is_zipped_packet | Признак того, будет ли вложение помещено в zip-архив. По умолчанию true | - | false |
| code_document | Код документа | - | 0001 |
| filename | Имя файла внутри архива | - | |
| original_filename | Оригинальное имя файла | + | Уведомление о регистрации заявки.pdf |
| original_file_mime_type | Оригинальное расширение файла | + | application/pdf |
Параметры ответа
Данный сервис получает запрос от СМЭВ 3 и ожидает получения ответа. В данном разделе указаны параметры, получаемые в результате обработки запроса.
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| env | Атрибут, значение используется для маршрутизации между средами ЕПГУ. В продуктивной среде допустимо только значение «PROD». Принимает значения:<ul><li> DEV</li><li>UAT</li><li>EXUAT</li><li>SVCDEV</li><li>TCOD</li><li>PROD</li></ul> | + | PROD |
| change_order_request | Данные заявления с ЕПГУ | + | Составной элемент ChangeOrderRequest |
| attachments | Данные, необходимые для получения вложений | + | Последовательность элементов AggredatorAttachment. Поле обязательно присутствует, но может быть пустым. |
Структура элемента ChangeOrderRequest
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| order_id | Номер заявления на ЕПГУ | + | 12345678 |
| department | Код ведомства | + | Отдел |
| service_code | Код услуги | + | 123 |
| target_code | Код цели | + | 456 |
| statement_date | Дата заявления на ЕПГУ | + | 2007-10-26 |
Структура элемента AggredatorAttachment
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| uuid | Идентификатор файла в хранилище | + | 7ca24dd0450bf0cc509f384f6198ff9ac12dd52f0ef1fc10d3af8c14c49876aa |
| checksum | Контрольная сумма | + | e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 |
| created_at | Время загрузки файла | + | 2020-11-16T12:27:20.726+03:00 |
| tags | Последовательность строк-тегов файла | + | ["test"] |
| filename | Имя загруженного файла | + | test.txt |
| smev_id | Идентификатор вложения, используемый в СМЭВ конверте | + | attachment.txt |
Примеры
Сервис обрабатывает приходящие запросы от smev3 сервиса и отправляет их в exchange out с следующим ключом service.epgu-gasification.request, где epgu-gasification извлекается из переданного в сервис сертификата в переменной окружения CLIENT_CERT. Отправленное сообщение имеет тип IncomingRequest и имеет следующие заголовки (headers).
| Заголовок | Описание | Обязательное | Пример |
|---|---|---|---|
| type | Тип сообщения | + | IncomingRequest |
| service | Имя сервиса, отправившего сообщение | + | epgu-gasification |
| incoming_id | Идентификатор обрабатываемого запроса | + | eeab18b6-6108-4692-ae34-a0118cd3240e |
В теле сообщения-запроса (payload) передаются следующие поля:
| Поле | Описание |
|---|---|
| envelope | XML ВС, полученного из СМЭВ |
| request | Словарь с разобранными параметрами, извлеченными из XML ВС, переданной в envelope |
| metadata | Словарь метаданных запроса |
Пример запроса:
{
"change_order_request": {
"order_id": "12345678",
"department": "Отдел",
"service_code": "123",
"target_code": "456",
"statement_date": "2007-10-26"
},
"env": "SVCDEV",
"attachments": []
}
Пример ответа:
{
"change_order": {
"epgu_id": "12345678",
"tech_code": 2,
"comment": "Заявление получено в ИС ЕОГ"
}
}