Запрос персональных данных пользователя ЕСИА при наличии его согласия

smev3 link

smev manual

Устаревший сервис
Атрибут Значение
Название 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"
        }
      ]
    }
  ] 
}