Регистрация подтвержденной учетной записи в ЕСИА

smev3 link

smev manual

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


Переменные окружения

Название Описание
CA_CERT сертификат центра сертификации для подключения к rabbitmq
CLIENT_CERT сертификат, используемый для подключения к rabbitmq
CLIENT_KEY ключ, используемый для подключения к rabbitmq
MQ_HOST хост rabbitmq
MQ_PORT порт rabbitmq
SMEV_SERVICE название смэв сервиса, на который будут отправляться запросы
ROUTING_CODE код маршрутизации на ЕСИА среду
RA_ID идентификатор центра обслуживания

Переменные для конфигурирования подключения к БД:

DATABASE_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USER, DATABASE_PASS.

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

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

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

Параметр Название Обязательное Пример
RoutingCode Код маршрутизации на ЕСИА среду + Значение используется для маршрутизации между средами ЕСИА. В продуктивной среде допустимо только значение PROD
SnilsOperator СНИЛС оператора центра обслуживания + Строка в формате: xxx-xxx-xxx xx (x - символы десятичных цифр 0..9)
ra Идентификатор центра обслуживания + Целое положительное число
snils СНИЛС пользователя + Строка в формате: xxx-xxx-xxx xx (x - символы десятичных цифр 0..9)
lastName Фамилия + Строка
firstName Имя + Строка
middleName Отчество -
Обязательно, если отчество присутствует в документе, удостоверяющем личность
Строка
gender Пол пользователя + Строка: M - мужской, F - женский
birthDate Дата рождения пользователя + Строка, задается в формате ДД.ММ.ГГГГ
doc Документ, удостоверяющий личность пользователя + См. описание типа document2Type
email Адрес электронной почты пользователя - Строка, содержащая символы @ и .
mobile Номер мобильного телефона пользователя + Строка в формате +7(xxx)xxxxxxx (x - символы десятичных цифр 0..9)
citizenship Гражданство пользователя + Строка, содержащая символы согласно классификатору ОКСМ
mode Способ доставки пароля для первого входа в систему + Строка: email - отправка на адрес электронной почты (при условии, что параметр задан), mobile - отправка на номер мобильного телефона
address Адрес - См. описание address
birthPlace Место рождения - Строка

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

Параметр Название Обязательное Пример
type Тип документа, удостоверяющего личность + RF_PASSPORT
latinLastName Фамилия (латиницей) - Строка
latinFirstName Имя (латиницей) - Строка
series Серия документа + 0489
Строка. Для паспорта РФ имеет формат XXXX, для заграничного паспорта гражданина РФ имеет формат XX, для документа иностранного гражданина – не более 32 символов
number Номер документа + 123456
Строка. Для паспорта РФ имеет формат ХХХХХХ, для заграничного паспорта гражданина РФ имеет формат XXXXXXX, для документа иностранного гражданина – не более 32 символов
issueId Идентификатор организации, выдавшей документ 1, обязательно
"для паспорта РФ код подразделения в формате XXXXXX для документа иностранного гражданина не заполняется"
Строка
issueDate Дата выдачи документа 1, обязательно Строка, задается в формате ДД.ММ.ГГГГ
expiryDate Дата окончания срока действия документа 0, необязательно
(для паспорта гражданина РФ не указывается - элемент должен отсутствовать в запросе)
Строка, задается в формате ДД.ММ.ГГГГ
issuedBy Кем выдан документ 0, необязательно Строка

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

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

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

Параметр Название Обязательное Пример  
type Тип адреса + Строка. Может иметь следующие значения: PRG - регистрации, PLV - проживания  
region Код региона (субъекта РФ) - Строка. Задается в формате ХХ  
fiasCode Идентификатор адреса в ФИАС - Строка. Поле содержит буквенно-цифровой код . Задается в формате ХХХХХХХХ-ХХХХ-ХХХХ-ХХХХ-ХХХХХХХХХХХХ  
addressStr Адресная строка + Строка, содержащая элементы адреса (перечисляются через разделитель ?,?, не более 2000 символов)  
countryId Код страны - Строка. Трехсимвольный код страны (по Alpha3)  
zipCode Почтовый индекс + Строка, содержащая индекс (не более 256 символов, для адресов в РФ задается в формате ХХХХХХ, для адресов за пределами РФ формат может отличаться)  
street Улица - Строка, содержащая наименование улицы (не более 256 символов)  
house Дом - Строка. Номер дома (может содержать строчные и прописные буквы кириллического и латинского алфавита, арабские цифры 0…9, а также спецсимволы). Обязательно в случае отсутствия значений в полях frame и building
flat Квартира - Строка  
frame Корпус -
Обязательно в случае отсутствия значений в полях house и building
Строка. Номер корпуса (может содержать строчные и прописные буквы кириллического и латинского алфавита, арабские цифры 0…9, а также спецсимволы)  
building Строение -
Обязательно в случае отсутствия значений в полях frame и house
Строка. Номер строения (может содержать строчные и прописные буквы кириллического и латинского алфавита, арабские цифры 0…9, а также спецсимволы)  

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

Сервис возвращает состояние запроса о регистрации пользователя.

Параметр Название Обязательное Пример  
status Статус выполнения операции + См. Справочник статусов выполнения операций  
oid Идентификатор учетной записи - Строка  
requestId Идентификатор операции на регистрацию учетной записи в ЕСИА - xs:string Строка, возвращается при запуске проверок документов
warning Предупреждение, в случае совпадения указанных при регистрации контактов с уже имеющимися в ЕСИА - xs:string Строка
errorStatusInfo Детальная информация об ошибке 0..25 -
Обязательно, если отсутствует поле requestId
См. описание типа errorstatusinfoType и Справочник кодов и описаний ошибок вида сведений Регистрация подтвержденной учётной записи в ЕСИА  

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

Примеры

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

{
  "routingCode": "DEV",
  "snilsOperator": "135-419-238 52",
  "ra": "1000321282",
  "snilsPerson": "229-785-346 20",
  "lastName": "Тестов",
  "firstName": "Тест",
  "middleName": "Тестович",
  "gender": "M",
  "birthDate": "11.11.1988",
  "doc": {
      "type": "RF_PASSPORT",
      "series": "1111",
      "number": "111111",
      "issueId": "111111",
      "issueDate": "01.10.2017",
      "issuedBy": "выдан"
  },
  "mobile": "+7(920)4021351",
  "citizenship": "RUS",
  "mode": "mobile",
  "email": "user_email@smth.ru",
  "address": {
      "type": "PLV",
      "region": "23",
      "fiasCode": "720b25da-f43e-4204-9013-3cb06be3e9e4",
      "addressStr": "Кемеровская Область, Таштагольский Район, Шерегеш Поселок городского типа",
      "countryId": "RUS",
      "zipCode": "394000",
      "street": "Советская Улица",
      "house": "86/1",
      "flat": "пом.419",
      "frame": "204у",
      "building": "e"
  },
  "birthPlace": "воронеж"
}

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

{
  "status": "SUCCEEDED",
  "oid": 1000350988,
  "requestId": 1113688
}