Сбор заявок на догазификацию для Единого оператора газификации через МФЦ
| Атрибут | Значение |
|---|---|
| Название | epgu-mfc-gasification |
| Наименование | Сбор заявок на догазификацию для Единого оператора газификации через МФЦ |
| Поставщики | Общество с ограниченной ответственностью «Газпром газификация» |
| Потребители | МФЦ |
| Область применения | Приём заявлений с РПГУ/МФЦ |
| Версия | 1.0.0 |
| Версия МР | 3.5.0.4 |
Адаптер для сервиса версии 1.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 | |||
| 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-mfc-gasification.request, где epgu-mfc-gasification извлекается из переданного в сервис сертификата в переменной окружения CLIENT_CERT. Отправленное сообщение имеет тип IncomingRequest и имеет следующие заголовки (headers)
| Заголовок | Описание | Обязательное | Пример |
|---|---|---|---|
| type | Тип сообщения | + | IncomingRequest |
| service | Имя сервиса, отправившего сообщение | + | epgu-mfc-gasification |
| incoming_id | Идентификатор обрабатываемого запроса | + | eeab18b6-6108-4692-ae34-a0118cd3240e |
В теле сообщения-запроса (payload) передаются следующие поля:
| Поле | Описание |
|---|---|
| envelope | XML ВС, полученного из СМЭВ |
| request | Словарь с разобранными параметрами, извлеченными из XML ВС, переданной в envelope |
| metadata | Словарь метаданных запроса |
Пример запроса:
{
"change_order_request": {
"order_id": "12345678",
"department": "Отдел",
"service_code": "10003773724",
"target_code": "10003774750",
"statement_date": "2007-10-26"
},
"env": "SVCDEV",
"attachments": []
}
Пример ответа:
{
"change_order": {
"epgu_id": "12345678",
"tech_code": 3,
"comment": "Услуга оказана"
},
"attachments": [
{
"is_unstructured_format": false,
"is_zipped_packet": false,
"code_document": "0001",
"original_filename": "Уведомление о регистрации заявки.pdf",
"original_file_mime_type": "application/pdf"
}
]
}