Валидация СНИЛС

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

Во всех запросах необходимо передавать заголовки запроса:

Название	Тип	Обязательно	Описание
X-Api-Key	string	Да	Уникальный идентификатор магазина
X-Signature	string	Да	Подпись запроса

При формировании подписи используется secret_key - секретный ключ, который находится в настройках магазина мерчанта.

Запрос на проверку

Метод: POST

• Production: https://api.baas.kvell.group/v1/smev3/sfr/snils-validation
• Stage: https://api.baas.stage.kvell.group/v1/smev3/sfr/snils-validation

Параметры запроса (JSON)

Название	Тип данных	Обязательно	Описание
last_name	string (не более 100 символов)	Да	Фамилия
first_name	string (не более 100 символов)	Да	Имя
middle_name	string (не более 100 символов)	Да, при наличии	Отчество
birth_date	string (формат YYYY-MM-DD)	Да	Дата рождения
snils	string (11 цифр)	Да	СНИЛС
gender	string enum (Male или Female)	Да	Пол

{
  "last_name": "Петина",
  "first_name": "Елена",
  "middle_name": "Владимировна",
  "birth_date": "1966-09-12",
  "snils": "02773319862",
  "gender": "Female"
}

Формирование подписи

Подпись X-Signature формируется конкатенацией X-Api-Key, json <тело запроса> и secret_key. Формируется sha256 от полученной строки:

sha256({x-api-key}{json <тело запроса>}{secret_key})

Ответ запроса

200: OK

{
  "request_id": "7663de3c-f5dc-4938-a379-b63834287b8a"
}

request_id — идентификатор запроса, используется для получения результата.

Получение результата проверки

Метод: GET

• Production: https://api.baas.kvell.group/v1/smev3/sfr/snils-validation/{request_id}
• Stage: https://api.baas.stage.kvell.group/v1/smev3/sfr/snils-validation/{request_id}

Параметры запроса в URL

Название	Тип данных	Обязательно	Описание
request_id	string	Да	Идентификатор запроса

GET /v1/smev3/sfr/snils-validation/7663de3c-f5dc-4938-a379-b63834287b8a

Формирование подписи

Подпись X-Signature формируется конкатенацией X-Api-Key, request_id и secret_key. Формируется sha256 от полученной строки:

sha256({x-api-key}{request_id}{secret_key})

Ответ запроса

Пример 1Пример 2Пример 3Пример 4

{
  "state": "in_progress"
}

{
  "state": "finished",
  "result": {
    "status": "invalid"
  }
}

{
  "state": "finished",
  "result": {
    "status": "valid"
  }
}

{
  "state": "finished",
  "result": {
    "status": "error"
  }
}

• state — статус запроса
  • in_progress — в обработке
  • finished — завершён
• result — результат обработки (в случае state = finished)
  • status — результат проверки
    • valid — данные соответствуют
    • invalid — данные не соответствуют
    • error — запрос в СФР не обработан (повторить запрос позднее)