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

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

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

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

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

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

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

Название	Тип	Обязательно	Описание
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Пример 3Пример 4 (HTTP 404)

{
  "state": "in_progress",
  "request_id": "befe8815-24b0-446b-925c-ea128f39667c",
  "response_id": null
}

{
  "state": "finished",
  "request_id": "befe8815-24b0-446b-925c-ea128f39667c",
  "response_id": "df65dc1c-fc66-41cd-abbd-87218127fbeb",
  "result":
  {
    "conf_code": "1"
  }
}

{
  "state": "finished",
  "request_id": "6ed9f77b-c150-4cdb-adcf-9d70d167f6ab",
  "response_id": null,
  "error": {
    "code": "internal",
    "desc": "Ошибка соединения со СМЭВ"
  }
}

{
  "error": "request not found"
}

• state — статус запроса
  • in_progress — в обработке
  • finished — завершён
• request_id — назначенный идентификатор запроса для СМЭВ3 (опционально)
• response_id — идентификатор ответа в системе СМЭВ3, если был получен ответ от ИС ведомства (ФНС)
• result — результат обработки (обязательно, если state = finished и error = null)
  • conf_code — код соответствия паспортных данных и ИНН, возможные значения:
    • 1 — данные соответствуют
    • 2 — данные не соответствуют
  • message — сообщение о соответствии (опционально)
• error — ошибка от внутреннего сервиса, СМЭВ или ИС ведомства (обязательно, если state = finished и result = null)
  • code — код ошибки (обязательно)
  • desc — описание ошибки (обязательно)
  • status_code — статусный HTTP-код от СМЭВ3 (опционально)
  • destname — поле запроса, содержащее ошибку от СМЭВ (опционально)