Соответствие паспорта и ИНН

Запрос о соответствии паспортных данных и ИНН физического лица.

Сведения содержат информацию о ФЛ, в отношении которого формируется запрос о соответствии паспортных данных и ИНН физического лица, в том числе:

информацию о ФИО ФЛ
информацию о документе, удостоверяющем личность ФЛ
информацию об ИНН ФЛ

А также информацию о результате выполнения запроса по сведениям ЕГРН:

«Сведения соответствуют» или
«Сведения не соответствуют»

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

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

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

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

Метод: POST

Production: https://api.baas.kvell.group/v1/smev3/fns/pasp-inn
Stage: https://api.baas.stage.kvell.group/v1/smev3/fns/pasp-inn

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

Название	Тип данных	Обязательно	Описание
`last_name`	string (не более 60 символов)	Да	Фамилия
`first_name`	string (не более 60 символов)	Да	Имя
`middle_name`	string (не более 60 символов)	Да, при наличии	Отчество
`inn`	string (формат (`[0-9]{1}[1-9]{1}\|[1-9]{1}[0-9]{1})[0-9]{10}`)	Да	ИНН ФЛ
`doc_type_id`	string enum	Нет (по умолчанию 21 – паспорт)	Код вида документа, удостоверяющего личность
`doc_num`	string (1-25 символов)	Да	Серия и номер документа
`issue_date`	string (формат`YYYY-MM-DD`)	Нет	Дата выдачи документа
`issuer_name`	string (не более 255 символов)	Нет	Наименование органа, выдавшего документ
`issuer_code`	string (7 символов)	Нет	Код подразделения органа, выдавшего документ

Допустимые значения doc_type_id и соответствующий ему формат doc_num можно посмотреть здесь.

{
  "inn": "520205004556",
  "last_name": "ЧАХЛОВ",
  "first_name": "ПЕТР",
  "middle_name": "АЛЕКСЕЕВИЧ",
  "doc_num": "22 02 919928",
  "issue_date": "2002-11-16",
  "issuer_code": "000-000",
  "issuer_name": "АРОВД"
}

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

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

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

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

{
  "request_id": "b48c09bc-6efb-4da4-95aa-4a85ff923425"
}

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

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

Метод: GET

Production: https://api.baas.kvell.group/v1/smev3/fns/pasp-inn/{request_id}
Stage: https://api.baas.stage.kvell.group/v1/smev3/fns/pasp-inn/{request_id}

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

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

GET /v1/smev3/fns/pasp-inn/b48c09bc-6efb-4da4-95aa-4a85ff923425

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

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

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

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

Пример 1Пример 2

{
  "state": "in_progress"
}

{
  "state": "finished",
  "result":
  {
    "conf_code": "1"
  }
}

state — статус запроса
- in_progress — в обработке
- finished — завершён
result — результат обработки (в случае state finished)
- conf_code — код соответствия паспортных данных и ИНН, возможные значения:
  - 1 — данные соответствуют
  - 2 — данные не соответствуют
- message — сообщение о соответствии (опционально)