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

smev3 link

smev   manual

Атрибут Значение
Название esia-search
Тип Адаптер для взаимодействия с ЕСИА через СМЭВ3
Наименование Поиск учетной записи в ЕСИА
Область применения Межведомственное взаимодействие
Версия 1.4.0
Версия МР 3.0
Версия СМЭВ СМЭВ3

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

Параметр Название Обязательное Пример
routing_code код маршрутизации на ЕСИА среду -
возьмется из переменной окружения ROUTING_CODE
DEV
snils_operator СНИЛС оператора центра обслуживания + 135-419-238 52
ra идентификатор центра обслуживаня -
возьмется из переменной окружения RA_ID
1000321282
lastname Фамилия + Иванов
firstname Имя + Иван
middlename Отчество -
обязательно, если отчество присутствует в документе, удостоверяющем личность
Иванович
email Адрес электронной почты пользователя - test@mail.com
mobile Номер мобильного телефона пользователя - +7(920)4021351
snils СНИЛС пользователя - 987-654-321 95
doc Документ, удостоверяющий личность пользователя + составной тип

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

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

Параметр Название Обязательное Пример
type Тип документа, удостоверяющего личность + RF_PASSPORT
series Серия документа + 0489
Строка. Для паспорта РФ имеет формат XXXX, для заграничного паспорта гражданина РФ имеет формат XX, для документа иностранного гражданина – не более 32 символов
number Номер документа + 123456
Строка. Для паспорта РФ имеет формат ХХХХХХ, для заграничного паспорта гражданина РФ имеет формат XXXXXXX, для документа иностранного гражданина – не более 32 символов

Типы документов, удостоверящих личность

Код Описание документа
RF_PASSPORT Паспорт гражданина РФ
FID_DOC Документ иностранного гражданина
FRGN_PASS Заграничный паспорт гражданина РФ

Параметры ответа

Сервис возвращает последовательность элементов о состоянии регистрации образцов, указанных в запросе.

accounts - список найденных учетных записей

errors - список ошибок

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

Параметр Название Обязательное Пример
oid Идентификатор учетной записи + 1000349826
stu Статус учетной записи + trusted
stu_description Описание статуса учетной записи + Подтвержденная
regDate Дата регистрации учетной записи + 2017-11-14
cfmTyp Тип подтверждения учетной записи - RA
cfmTyp_description Описание типа подтверждения - Центр обслуживания
biomStu Наличие биометрической информации (Y/N) + N
matches Перечень параметров, по которым была найдена учетная запись + ["snils", "mobile","idoc"]

Примеры

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

{
 "routing_code": "DEV",
  "snils_operator": "123-456-789 10",
  "ra": "42",
  "lastname": "Иванов",
  "firstname": "Иван",
  "middlename": "Иванович",
  "doc": {
      "type": "RF_PASSPORT",
      "series": "0404",
      "number": "776947"
  },
  "email": "test@mail.com",
  "mobile": "+7(999)0001117",
  "snils": "987-654-321 10"
}

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

{
  "accounts": [
    {
      "oid": "1000349826",
      "stu": "trusted",
      "matches": [
        "snils",
        "mobile",
        "idoc"
      ],
      "regDate": "14.11.2017",
      "cfmTyp": "RA",
      "biomStu": "N",
      "stu_description": "Подтвержденная",
      "cfmTyp_description": "Центр обслуживания"
    }
  ]
}