Приложение N 1. Инструкция для выполнения запросов по СНИЛС в СФР через СМЭВ (для работы через отдельный веб-интерфейс http://10.129.222.34:8050)

Приложение N 1

Инструкция
для выполнения запросов по СНИЛС в СФР через СМЭВ
(для работы через отдельный веб-интерфейс http://10.129.222.34:8050)

1. Протокол обмена (вид сведений)

Для получения страхового номера индивидуального лицевого счёта (СНИЛС) застрахованного лица с учётом дополнительных сведений о месте рождения, документе, удостоверяющем личность предлагается использовать следующий вид сведений СМЭВ 3, выведенный СФ РФ:

Предоставление страхового номера индивидуального лицевого счёта (СНИЛС) застрахованного лица с учётом дополнительных сведений о месте рождения, документе, удостоверяющем личность

URI: http://kvs.pfr.com/snils-by-additionalData/1.0.3

Версия: 1.0.3

Ссылка (ЛК УВ): https://lkuv.gosuslugi.ru/paip-portal/#/inquiries/card/dd08b435-d9cd-11eb-87f2-6dd2d98a56b1?tab=0

Указанный вид сведений СМЭВ позволяет получить СНИЛС гражданина через запрос с указанием следующих сведений о лице:

- ФИО;

- Дата рождения;

- Пол;

- Место рождения (не обязательно);

- Данные документа, удостоверяющего личность (не обязательно).

Важно! Заполнение сведений о месте рождения является обязательным, если не заполнены сведения о документе, удостоверяющем личность! То есть, могут быть заполнены оба элемента "Место рождения" и "Документ, удостоверяющий личность", либо один из них.

На запрос по данному виду сведений возможно получение двух вариантов ответа:

- Сведения о лице, дополненные СНИЛС:

- ФИО;

- СНИЛС;

- Дата рождения;

- Пол;

- Место рождения (не обязательно);

- Данные документа, удостоверяющего личность (не обязательно);

- Отказ (сведения о СНИЛС лица не найдены).

2. Функционал интерфейса сервиса

Для отправки продуктивных запросов по описываемому виду сведений о СНИЛС гражданина в СФР необходимо использовать пользовательский интерфейс специально разработанного ПО, размещенного по адресу:

http://10.129.222.34:8050

После перехода по указанному адресу для формирования запросов необходимо:

1) Нажать на кнопку "Направить запрос".

2) Выбрать на открывшейся странице в левом вертикальном навигационном меню пункт "Сведения о СНИЛС застрахованного лица".

3) Заполнить в правой части страницы атрибуты формы запроса в соответствии с требованиями, описанными в Разделе 3.

4) Нажать кнопку "Отправить запрос".

5) Сохранить уникальный идентификатор запроса (MessageId), который отобразится после отправки запроса.

Для получения ответов необходимо:

1) Выбрать в левом навигационном меню "Получение ответов из СМЭВ".

2) Заполнить в правой части открывшейся страницы ранее сохраненный идентификатор (MessageId).

3) Выбрать в разворачивающемся списке значение "Ответ".

4) Просмотреть отображенный внизу страницы ответ. Описание атрибутов ответа приведено в Разделе 4.

3. Описание запросов

Выше было упомянуто (см. Раздел 1), что для получения СНИЛС застрахованного необходимо заполнить в запросе определенный набор обязательных сведений:

- ФИО;

- Дата рождения;

- Пол ("Male" - "Мужской", "Female" - "Женский").

Дополнительно должны быть заполнены оба или хотя бы один из необязательных блоков сведений:

- Место рождения;

- Данные документа, удостоверяющего личность.

Настоятельно рекомендуется заполнять именно паспортные данные, что должно обеспечивать гарантированное получение успешного ответа. Блок сведений о месте рождения заполнять только в том случае, если нет данных о паспорте гражданина.

Атрибуты блока сведений о месте рождения описаны в Таблице N 1.

Таблица 1. Атрибуты блока сведений о месте рождения лица

N	Код поля	Описание параметра	Требования к заполнению (обязательно/не обязательно)	Способ заполнения/Тип данных/Ограничения	Комментарий
1	PlaceType	Тип места рождения	+	Строка, до 50 символов	Значения "Особое" или "Стандартное". "Стандартное" следует указывать, если адрес представляет из себя классический набор атрибутов (страна, регион, район, город и т.п.), как то: "Россия, Московская область, г. Лобня". "Особое" следует указывать в случае, если адрес представлен неполными (специфическими) данными, например: "в/ч 52", "с/х Электроуральский, село Авдеевка"
2	Settlement	Город рождения	+	Строка, до 50 символов	В случае, если адрес является особым, необходимо указывать значение адреса в данном элементе, например, "в/ч 52", "с/х Электроуральский, село Авдеевка"
3	District	Район рождения	-	Строка, до 50 символов
4	Region	Регион рождения	-	Строка, до 50 символов
5	Country	Страна рождения	-	Строка, до 50 символов

Для заполнения блока сведений о документе, удостоверяющем личность лица, предлагается использовать общегражданский паспорт РФ. Атрибутивный состав блока сведений о паспорте приведен в Таблице N 2.

Таблица 2. Атрибуты составного типа "Паспорт РФ"

N	Код поля	Описание параметра	Требования к заполнению	Способ заполнения/Тип
1	Series	Серия	+	Строка, состоящая из четырёх цифр
2	Number	Номер	+	Строка, состоящая из шести цифр
3	IssueDate	Дата выдачи	+	Дата в формате: ДД.ММ.ГГГГ В сообщении с ответом может содержать значение "0001-01-01" в том случае, когда в БД ПФР нет данных о дате выдачи документа
4	Issuer	Кем выдан	+	Строка, до 200 символов В сообщении с ответом может содержать значение "Нет данных" в том случае, когда в БД ПФР нет данных о дате выдачи документа

4. Описание ответов

Рассмотрим возможные варианты ответов на запрос СНИЛС лица, которые могут прийти в двух вариантах:

4.1. Успешный ответ, содержащий запрошенный СНИЛС лица

Примечание:

В успешном ответе обязательно возвращаются персональные данные лица, дополненные значением СНИЛС и содержащие следующие сведения:

- ФИО;

- СНИЛС;

- Дата рождения;

- Пол.

При наличии соответствующих сведений в базе данных СФР в ответе на запрос могут быть также возвращены сведения о месте рождения лица и документе, удостоверяющем личность.

4.2. Отказ (ошибка обработки, или сведения о СНИЛС лица не найдены)

Сообщение об отказе означает, что по атрибутам запроса не обнаружено сведений о СНИЛС лица. Соответственно, скорее всего, в атрибутах запроса были переданные недостоверные данные, данные содержащие грамматические ошибки (например, в ФИО лица), или переданных сведений оказалось недостаточно для однозначной идентификации лица.

В этом случае рекомендуется повторить запрос и расширить переданный изначально набор сведений - включить в запрос сведения о месте рождения лица и (или) документе, удостоверяющем личность лица.

Кроме отказов, в ответах из СФ РФ могут приходить сообщения об ошибках обработки, возникших на стороне Ответчика. Перечень типовых сообщений об ошибках представлен в Таблице N 3.

Таблица 3. Описание кодов возвратов при ошибках и неуспешных проверках

N	RejectionReasonCode	RejectionReasonDescription
1.	FAILURE	KVS01000 - Внутренняя ошибка Компонента КВС
2.	UNKNOWN_REQUEST_DESCRIPTION	KVS01701 - Невозможно разобрать GetRequestResponse на блоки
3.	UNKNOWN_REQUEST_DESCRIPTION	KVS01702 - Значение элемента MessageType не соответствует одному из значений: REQUEST, BROADCAST, CANCEL
4.	UNKNOWN_REQUEST_DESCRIPTION	KVS01704 - Ошибка при определении ВС
5.	UNKNOWN_REQUEST_DESCRIPTION	KVS01705 - Структура MessagePrimaryContent не соответствует xml-схеме ВС, запрашиваемого у ПФР
6.	ACCESS_DENIED	KVS01706 - Сертификат Потребителя не подключён или просрочен
7.	ACCESS_DENIED	KVS01707 - Потребителю не подключен ВС ПФР
8.	FAILURE	KVS03202 - Сервис АИС ПФР недоступен
9.	NO_DATA	KVS03203 - Нет данных
10.	NO_DATA	KVS03204 - Нет данных или найдено несколько ЗЛ
11.	UNKNOWN_REQUEST_DESCRIPTION	KVS03206 - СНИЛС не найден
12.	FAILURE	KVS03210 - Ошибка при обработке ответа АИС ПФР