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