Перейти к содержанию

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

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

URL

Метод: POST

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

Параметры тела запроса

Название Тип данных Обязательно Описание
last_name string (не более 100 символов) Да Фамилия
first_name string (не более 100 символов) Да Имя
middle_name string (не более 100 символов) Да, при наличии Отчество
birth_date string (формат YYYY-MM-DD) Да Дата рождения
snils string (11 цифр) Да СНИЛС 
{
  "last_name": "Петина",
  "first_name": "Елена",
  "middle_name": "Владимировна",
  "birth_date": "1966-09-12",
  "snils": "02773319862"
}

Заголовки запроса

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

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

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

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

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

{
  "created_at": "string",
  "query_id": "string",
  "error": "string",
  "result": "string"
}
  • created_at — время запроса в смэв4
  • query_id — идентификатор запроса в смэв4
  • result — результат обработки
    • not found — соответствие не найдено (ФИО, СНИЛС и/или дата рождения не соответствуют друг другу)
    • true — СНИЛС действительный/актуальный
    • false — СНИЛС не действительный/аннулирован

{
  "errors":
  [
    {
      "code": 0,
      "message": "Field required",
      "field": "last_name"
    }
  ]
}
  • code — код ошибки
  • message — текст ошибки
  • field — наименование поля из запроса, не прошедшего валидацию

{
  "errors":
  [
    {
      "code": 45,
      "message": "СМЭВ не доступен"
    }
  ]
}
  • code — код ошибки
  • message — текст ошибки