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

smev3 link

smev manual

Атрибут Значение
Название esia-search
Наименование Поиск учетной записи в ЕСИА
Тип Адаптер для взаимодействия с ЕСИА через СМЭВ3
Область применения Межведомственное взаимодействие
Поставщик Министерство цифрового развития, связи и массовых коммуникаций Российской Федерации
Потребители УЦ, Кредитные организации, МФЦ, РОИВ, ФОИВ, ОМСУ, Негосударственный пенсионный фонд
Версия ВС 1.4.6
Версия МР 3.5.0.1
Версия СМЭВ СМЭВ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

Справочник кодов ЕСИА сред

Код Среда
DEV Тестовая среда
UAT Тестовая среда
TESIA Интеграционная тестовая среда (должна использоваться при тестировании получения сведений ИС потребителя)
TCOD Тестовая среда
PROD Продуктивная среда

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

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