Регистрация подтвержденной учетной записи в ЕСИА
Атрибут | Значение |
---|---|
Название | 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 |
Адрес электронной почты пользователя | - | Строка, содержащая символы @ и . | |
mobile | Номер мобильного телефона пользователя | + | Строка в формате +7(xxx)xxxxxxx (x - символы десятичных цифр 0..9) |
citizenship | Гражданство пользователя | + | Строка, содержащая символы согласно классификатору ОКСМ |
mode | Способ доставки пароля для первого входа в систему | + | Строка: email - отправка на адрес электронной почты (при условии, что параметр |
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
}