Предоставление данных организаций и индивидуальных предпринимателей, зарегистрированных в ЕСИА, при наличии согласия на получение данных
| Атрибут | Значение |
|---|---|
| Название | esia-receiving-org-documents |
| Тип | Адаптер для взаимодействия с ЕСИА через СМЭВ3 |
| Наименование | Предоставление данных организаций и индивидуальных предпринимателей, зарегистрированных в ЕСИА, при наличии согласия на получение данных |
| Поставщики | Министерство цифрового развития, связи и массовых коммуникаций Российской Федерации |
| Потребители | ОИВ, ОМСУ, КО, Верховный суд РФ, Брокеры, Управляющие, Депозитарии, Управляющие компаний специализированных обществ, НПФ, Платежный агент, Банковский платежный агент, Страховые организации, осуществляющие ОСАГО, операторы подвижной радиотелефонной связи, Иная организация |
| Область применения | Межведомственное взаимодействие |
| Версия | 1.0.1 |
| Версия МР | 3.5 |
| Версия СМЭВ | СМЭВ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.
Принимаемые параметры
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| routing_code | Код ИС обработчика запроса в СМЭВ (для продуктовой версии значение должно быть равно ISIA01001). | + | ISIA01001 |
| requests | Запросы на поиск данных организации или индивидуального предпринимателя, зарегистрированных в ЕСИА, при наличии согласия на получение данных | + | Последовательность элементов Request. Не более 1000 элементов. |
Структура элемента Request
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| data_type | Тип запрашиваемого сведения или документа организации или индивидуального предпринимателя, зарегистрированных в ЕСИА, при наличии согласия на получение данных | + | ORG_DATA |
| inn | ИНН организации (ЮЛ, ОГВ) или ИП, у кого запрашиваются согласия | -1 | 4291623269 |
| ogrn | ОГРН юридического лица (ЮЛ или ОГВ) или ОРГНИП индивидуального предпринимателя, у кого запрашиваются согласия | -1 | 1234567891234 |
1 - обязательно должен присутствовать только один из элементов
Параметры ответа
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| responses | Ответы на запрос поиска данных организации или индивидуального предпринимателя, зарегистрированных в ЕСИА, при наличии согласия на получение данных | + | Последовательность элементов Response |
| attachment | Информация о переданном архиве вложении загруженном в файловое хранилище Агредатора | - | Составной элемент Attachment |
Структура элемента Response
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| status | Статус выполнения операции (SUCCEEDED или FAULT) | + | SUCCEEDED |
| error_status_info | Детальная информация об ошибке | - | Составной элемент ErrorStatusInfo |
| oid | Идентификатор учётной записи организации, зарегистрированной в ЕСИА | - | 7435832 |
| data_type | Тип найденного по запросу сведения или документа организации или индивидуального предпринимателя | - | ORG_DATA |
| proof_block | Информация о достоверности сведения или документа организации или индивидуального предпринимателя | - | Составной элемент ProofBlock |
| files_info | Информация о вложениях | - | Последовательность элементов FileInfo |
Структура элемента ErrorStatusInfo
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| code | Код ошибки | + | ESIA-038000 |
| message | Описание ошибки | + | Организация не найдена |
Структура элемента ProofBlock
Информация о достоверности сведения или документа организации или индивидуального предпринимателя
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| status | Статус достоверности сведения или документа организации или индивидуального предпринимателя, зарегистрированных в ЕСИА | - | |
| legal_force | Возможность проверить подлинность данных, полученных из ГИС (документы, подписанные ЭП ведомства) | - | true |
| receipt_doc_date | Дата и время получения сведения или документа | - | |
| validate_date_doc | Дата и время валидации сведения или документа | - |
Структура элемента FileInfo
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| filename | Название файла | + | ORG_DATA_3197CE146D.xml |
| mime_type | Тип файла | + | application/xml |
Структура элемента Attachment
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| smev_id | Идентификатор вложения, используемый в СМЭВ конверте | + | fc575a79-7731-11ee-b016-669f8e3543ff |
| uuid | Идентификатор файла в хранилище | + | 8d90242cf88b39b7b5c865e55be12763c21ccc7b56fcecbdb82f2cec034ed29a |
| checksum | Контрольная сумма | + | 2f26c25c2cc2269bfb5b383293fc4d1ed7e0032cefb59b5304f30b0676045218 |
| mime_type | MIME тип файла | + | application/zip |
| filename | Имя загруженного файла | + | SignedContent.zip |
Примеры
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:
{
"routing_code": "MNSV10",
"requests": [
{
"data_type": "ORG_DATA",
"inn": "213000262765"
}
]
}
В случае корректной настройки должен прийти ответ следующего вида вида:
{
"attachment": {
"type": "ftp",
"smev_id": "fc575a79-7731-11ee-b016-669f8e3543ff",
"uuid": "8d90242cf88b39b7b5c865e55be12763c21ccc7b56fcecbdb82f2cec034ed29a",
"checksum": "2f26c25c2cc2269bfb5b383293fc4d1ed7e0032cefb59b5304f30b0676045218",
"mime_type": "application/zip",
"filename": "SignedContent.zip"
},
"responses": [
{
"status": "SUCCEEDED",
"oid": "7435832",
"data_type": "ORG_DATA",
"files_info": [
{
"filename": "ORG_DATA_3197CE146D.xml",
"mime_type": "application/xml"
}
]
}
]
}