Запрос персональных данных пользователя ЕСИА при наличии его согласия
| Атрибут | Значение |
|---|---|
| Название | esia-personal-data-docs |
| Тип | Адаптер для межведомственного взаимодействия |
| Наименование | Запрос персональных данных при наличии согласия пользователя ЕСИА |
| Назначение | Вид сведений предназначен для получения внешней ИС запрошенных персональных данных зарегистрированного пользователя ЕСИА. |
| Область применения | Межведомственное взаимодействие |
| Версия ВС | 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 |
Структура элемента Request
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| data_type | Тип запрашиваемого сведения или документа гражданина | + | inn |
| force | Признак-требование принудительного запроса сведения/документа в ведомстве (для сведения/документа, допускающего его запрос в ведомстве): - true - необходимо принудительно (вне зависимости от того - есть запрошенное сведение/документ гражданина в ЕСИА или нет) запросить документ в ведомстве - false (или элемент force отсутствует в запросе) - не выполнять принудительный запрос сведения/документа гражданина в ведомстве при наличии сведения/документа в ЕСИА |
- | true |
| person_data | Персональные данные пользователя в ЕСИА для поиска его учетной записи | + | Составной элемент PersonData |
Структура элемента PersonData
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| oid | Идентификатор (OID) учётной записи гражданина в ЕСИА | -1 | 1245500 |
| snils | СНИЛС гражданина | -1 | 000-510-864 81 |
| inn | ИНН гражданина | -1 | 706550310824 |
| fio_doc | Фамилия, имя, отчество и документ, удостоверяющий личность гражданина | -1 | Составной элемент FIODoc |
1 - должен присутствовать только один из элементов
Структура элемента FIODoc
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| lastname | Фамилия гражданина | + | Фамилия |
| firstname | Имя гражданина | + | Имя |
| middlename | Отчество гражданина (при наличии) | - | Отчество |
| id_doc | Документ, удостоверяющий личность гражданина | + | Составной элемент IdDoc |
Структура элемента IdDoc
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| type | Типы документов, удостоверящих личность гражданина на территории РФ: - RF_PASSPORT – Паспорт гражданина РФ - FRGN_PASS - Заграничный паспорт гражданина РФ - FID_DOC - Паспорт иностранного гражданина |
+ | RF_PASSPORT |
| series | Серия документа, удостоверяющего личность гражданина (атрибут необязателен только для паспорта иностранного гражданина) | - | 0000 |
| number | Номер документа, удостоверяющего личность гражданина | + | 123456 |
| issue_date | Дата выдачи документа, удостоверяющего личность гражданина | + |
Параметры ответа
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| responses | Ответы на запрос поиска персональных данных пользователя ЕСИА | + | Последовательность элементов Response |
Структура элемента Response
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| status | Статус выполнения операции. Принимает значения: - SUCCEEDED – операция успешно выполнена (сведение или документ гражданина найден(о) и возвращён(ено) в ответе) - PROCESSING - операция выполняется (отсутствующее сведение или документ гражданина запрашивается в ведомстве) - FAULT - ошибка при выполнении операции (не найдена учётная запись гражданина, не найдено запрошенное сведение или документ и др.) |
+ | SUCCEEDED |
| error_status_info | Детальная информация об ошибке | - | Составной элемент ErrorStatusInfo |
| oid | Идентификатор учётной записи гражданина в ЕСИА | - | 12345678 |
| data_type | Тип найденного по запросу сведения или документа гражданина | - | fullName |
| info_req_data | Информация о запросах сведения или документа гражданина в ведомстве, возвращается в ответе на запрос вида сведений вместе со статусом PROCESSING или вместе со статусом SUCCEEDED в случае, если часть документа или сведения отсутствует и запрашивается в ведомстве | - | Последовательность элементов InfoReq |
| attachments | Информация о файлах вложениях | - | Составной элемент AggredatorAttachment |
Структура элемента ErrorStatusInfo
| Параметр | Описание | Обязательное |
|---|---|---|
| code | Код ошибки | + |
| message | Описание ошибки | + |
Структура элемента InfoReq
| Параметр | Описание | Обязательное |
|---|---|---|
| request_id | Идентификатор запроса сведения или документа гражданина | + |
| context | Информация о запрашиваемом в ведомстве сведении или документе - для сведений или документов,получаемых из ведомств отдельными запросами (например, сведение или документ за отчётный временной период, сведение или документ за определённый календарный год или квартал календарного года, и т.п.) | - |
Структура элемента AggredatorAttachment
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| smev_id | Идентификатор вложения, используемый в СМЭВ конверте | + | attachment.txtы |
| uuid | Идентификатор файла в хранилище | + | 4833e4c4385dc47f2d2a08469f246e7cd1f66f416691d0b5a92a00d722f8d4ec |
| checksum | Контрольная сумма | + | e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 |
| mime_type | MIME тип файла | + | application/xml |
| filename | Имя загруженного файла | + | test.txt |
Примеры
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:
{
"routing_code": "ISIA01001",
"requests": [
{
"data_type": "inn",
"person_data": {
"snils": "000-510-864 81"
}
},
{
"data_type": "fullName",
"person_data": {
"snils": "000-510-864 81"
}
}
]
}
В случае корректной настройки должен прийти следующий ответ:
{
"responses": [
{
"status": "SUCCEEDED",
"oid": "1077138512",
"data_type": "inn",
"attachments": [
{
"smev_id": "d4a57f9e-c986-11ed-9b13-65d46a441234",
"uuid": "3e08ea8b79677ee719fc647558b61baf624d8731804945c956ff507a6977de91",
"checksum": "80f2522e2fc991d316224833857c972d77ddc96ed2cfec4b30338319272b173a",
"mime_type": "application/xml",
"filename": "inn_01bf774d-a9c1-4d78-9a21-eef221265e59.xml"
}
]
},
{
"status": "SUCCEEDED",
"oid": "1077138512",
"data_type": "fullName",
"attachments": [
{
"smev_id": "7e7fa5fc-c98d-11ed-9b13-65d46a441234",
"uuid": "c3afca6c0ac2d1555cd59b365371aff0204cf489dcc7c78e48674042da3cd288",
"checksum": "e12ee4e991b893b9ab87cc0b3e968048a61855be84eba4d37712defa43fe955c",
"mime_type": "application/xml",
"filename": "ProofData_027154f5-d6cb-43bc-988f-daba175a9150.xml"
}
]
}
]
}