ЕСИА КРЕДИТНАЯ ОРГАНИЗАЦИЯ МИНЦИФРЫ МФЦ НПФ ОМСУ РОИВ УЦ ФОИВ

Поиск учетной записи в ЕСИА 1.4.6

Атрибут	Значение
Название	esia-search
Наименование	Поиск учетной записи в ЕСИА
Тип	Адаптер для взаимодействия с ЕСИА через СМЭВ3
Область применения	Межведомственное взаимодействие
Поставщик	Министерство цифрового развития, связи и массовых коммуникаций Российской Федерации
Потребители	УЦ, Кредитные организации, МФЦ, РОИВ, ФОИВ, ОМСУ, Негосударственный пенсионный фонд
Версия ВС	1.4.6
Версия МР	3.5.0.1
Версия СМЭВ	СМЭВ3
Тип маршрутизации	Табличная
URI	`urn://mincomsvyaz/esia/reg_service/find_account/1.4.6`
Корневой элемент	ESIAFindAccountRequest

Описание бизнес-процесса взаимодействия:

ИС организации хочет найти учетную запись в ЕСИА.

ИС организации отправляет запрос через Агредатор, Агредатор в свою очередь отправляет запрос в СМЭВ к виду сведений, СМЭВ получает запрос и направляет его в ЕСИА.

После получения запроса ЕСИА проверяет корректность полученных данных, далее через СМЭВ направляет в Агредатор запрошенные сведения или отказ в предоставлении сведений, Агредатор направляет данную информацию в ИС организации.

Если отправка запроса не произошла, то Агредатор получит от СМЭВ сообщение об ошибке и передаст его в ИС организации.

flowchart LR; A[ИС организации] <--> B[Агредатор]; B <--> C[СМЭВ]; C <--> D[ЕСИА];

Принимаемые параметры

Параметр	Описание	Обязательное	Пример
routing_code	Код маршрутизации на ЕСИА среду	+	TESIA
snils_operator	СНИЛС оператора центра обслуживания	+	135-419-238 52
ra	Идентификатор центра обслуживаня	+	1000321282
last_name	Фамилия	+	Тестов
first_name	Имя	+	Тест
middle_name	Отчество	- обязательно, если отчество присутствует в документе, удостоверяющем личность	Тестович
doc	Документ, удостоверяющий личность пользователя	+	Cоставной элемент Doc
email	Адрес электронной почты пользователя	-¹	test@mail.com
mobile	Номер мобильного телефона пользователя	-¹	+7(920)4021351
snils	СНИЛС пользователя	-¹	229-785-346 20

Необходимо, чтобы был заполнен хотя бы 1 из необязательных элементов запроса: email, mobile, snils. Для наиболее эффективного поиска учётной записи рекомендуется указывать максимально возможное количество входных параметров.

Структура элемента 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	Статус учетной записи	+	unverified
matches	Перечень параметров, по которым была найдена учетная запись	+	["snils", "mobile", "idoc"]
reg_date	Дата регистрации учетной записи	+	2017-11-14
cfm_typ	Тип подтверждения учетной записи	-	POS
biom_stu	Наличие биометрической информации (Y/N)	+	N

Структура элемента error

Детальная информация об ошибке

Параметр	Описание	Обязательное	Пример
code	Код ошибки	+
message	Описание ошибки	+

Примеры

Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:

{
  "routing_code": "TESIA",
  "snils_operator": "135-419-238 52",
  "ra": "1000321282",
  "last_name": "Тестов",
  "first_name": "Тест",
  "middle_name": "Тестович",
  "doc": {
    "type": "RF_PASSPORT",
    "series": "1111",
    "number": "111111",
    "issue_date": "2017-10-01"
  },
  "mobile": "+7(920)4021351",
  "snils": "229-785-346 20"
}

В случае корректной настройки должен прийти следующий ответ:

{
  "accounts": [
    {
      "oid": "1000349826",
      "stu": "trusted",
      "matches": [
        "snils",
        "mobile",
        "idoc"
      ],
      "reg_date": "2017-11-14",
      "cfm_typ": "RA",
      "biom_stu": "N"
    }
  ]
}