Поиск информации об учетной записи в ЕСИА
| Атрибут | Значение |
|---|---|
| Название | esia-find-user |
| Наименование | Поиск информации об учетной записи в ЕСИА |
| Тип | Адаптер для взаимодействия с ЕСИА через СМЭВ3 |
| Область применения | Межведомственное взаимодействие |
| Поставщик | Министерство цифрового развития, связи и массовых коммуникаций Российской Федерации |
| Потребители | Кредитные организации, Операторы подвижной радиотелефонной связи |
| Версия ВС | 1.0.1 |
| Версия МР | 3.5.0.1 |
| Версия СМЭВ | СМЭВ3 |
| Тип маршрутизации | Табличная |
| URI | urn://mincomsvyaz/esia/find_user/1.0.1 |
| Корневой элемент | ESIAFindUserRequest |
Описание бизнес-процесса взаимодействия:
ИС организации хочет найти информацию об учетной записи в ЕСИА.
ИС организации отправляет запрос через Агредатор, Агредатор в свою очередь отправляет запрос в СМЭВ к виду сведений, СМЭВ получает запрос и направляет его в ЕСИА.
После получения запроса ЕСИА проверяет корректность полученных данных, далее через СМЭВ направляет в Агредатор запрошенные сведения или отказ в предоставлении сведений, Агредатор направляет данную информацию в ИС организации.
Если отправка запроса не произошла, то Агредатор получит от СМЭВ сообщение об ошибке и передаст его в ИС организации.
Принимаемые параметры
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| routing_code | Код маршрутизации на ЕСИА среду | + | TESIA |
| last_name | Фамилия | + | Тестов |
| first_name | Имя | + | Тест |
| middle_name | Отчество | - обязательно, если отчество присутствует в документе, удостоверяющем личность |
Тестович |
| doc | Документ, удостоверяющий личность пользователя | + | Cоставной элемент Doc |
| Адрес электронной почты пользователя | -1 | test@mail.com | |
| mobile | Номер мобильного телефона пользователя | -1 | +7(920)4021351 |
| snils | СНИЛС пользователя | -1 | 229-785-346 20 |
| person_inn | ИНН пользователя (физического лица) | -1 | 176056662438 |
Необходимо, чтобы был заполнен хотя бы 1 из необязательных элементов запроса вида сведений: email, mobile, snils, person_inn. Для наиболее эффективного поиска учётной записи рекомендуется указывать максимально возможное количество входных параметров.
Структура элемента Doc
Документ, удостоверяющий личность пользователя
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| type | Тип документа, удостоверяющего личность | + | RF_PASSPORT |
| series | Серия документа | - | 1111 |
| number | Номер документа/Номер личного дела | + | 111111 |
| issue_date | Дата выдачи документа | + | 2017-10-01 |
| expiry_date | Дата окончания срока действия документа (для паспорта РФ не указывается, для заграничного паспорта РФ и документа иностранного гражданина - при наличии даты) | - | |
| issued_by | Кем выдан документ | - |
Типы документов, удостоверящих личность
| Код | Описание документа |
|---|---|
| RF_PASSPORT | Паспорт гражданина РФ |
| FID_DOC | Документ иностранного гражданина |
| FRGN_PASS | Заграничный паспорт гражданина РФ |
Параметры ответа
Сервис возвращает последовательность элементов о состоянии регистрации образцов, указанных в запросе.
accounts - список найденных учетных записей
или
errors - список ошибок
Структура элемента account
Информация о найденном аккаунте пользователя
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| oid | Идентификатор учетной записи | - | 1000349826 |
| stu | Статус учетной записи | + | trusted |
| matches | Перечень параметров, по которым была найдена учетная запись | + | ["snils", "mobile", "idoc", "personinn"] |
| reg_date | Дата регистрации учетной записи | + | 2017-11-14 |
| auth_date | Дата последней авторизации пользователя | + | 2022-02-23 |
| cfm_typ | Тип подтверждения учетной записи | - | RA |
| biom_stu | Наличие биометрической информации (Y/N) | + | N |
Структура элемента error
Детальная информация об ошибке
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| code | Код ошибки | + | |
| message | Описание ошибки | + |
Примеры
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:
{
"routing_code": "TESIA",
"last_name": "Тестов",
"first_name": "Тест",
"middle_name": "Тестович",
"doc": {
"type": "RF_PASSPORT",
"series": "1111",
"number": "111111",
"issue_date": "2009-05-02"
},
"mobile": "+7(920)4021351",
"snils": "229-785-346 20",
"person_inn": "176056662438"
}
В случае корректной настройки должен прийти следующий ответ:
{
"accounts": [
{
"oid": "1000349826",
"stu": "trusted",
"matches": [
"snils",
"mobile",
"idoc",
"personinn"
],
"reg_date": "2017-11-14",
"auth_date": "2022-02-23",
"cfm_typ": "RA",
"biom_stu": "N"
}
]
}