Электронный сервис Единого оператора газификации
Атрибут | Значение |
---|---|
Название | 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": "Заявление получено в ИС ЕОГ"
}
}