Предоставление ИНН ФЛ

Метод используется для отправки запроса на предоставление ИНН ФЛ по его полным паспортным данным.

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

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

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

Запрос на предоставление ИНН ФЛ

Метод: POST

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

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

Название	Тип данных	Обязательно	Описание
`id_request`	string (до 36 символов)	Нет	Сквозной идентификатор запроса
`last_name`	string (не более 60 символов)	Да	Фамилия
`first_name`	string (не более 60 символов)	Да	Имя
`middle_name`	string (не более 60 символов)	Да, при наличии	Отчество
`birth_date`	string (формат `YYYY-MM-DD`)	Да	Дата рождения
`birth_place`	string (не более 255 символов)	Нет	Место рождения
`seriya`	string (4 цифры)	Да	Серия паспорта РФ
`number`	string (6 цифр)	Да	Номер паспорта РФ
`issue_date`	string (формат `YYYY-MM-DD`)	Нет	Дата выдачи
`issuer_code`	string (формат `\d{3}-\d{3} или \d{6}`)	Нет	Код подразделения
`issuer_name`	string (не более 255 символов)	Нет	Наименование органа, выдавшего документ

{
  "id_request": "AC439881-E925-771B-E040-A8C062C84DEE",
  "last_name": "ЧАХЛОВ",
  "first_name": "ПЕТР",
  "middle_name": "АЛЕКСЕЕВИЧ",
  "birth_date": "1954-07-12",
  "birth_place": "РОССИЯ,,ГОРЬКОВСКАЯ ОБЛ.,АРЗАМАССКИЙ Р-Н,,НИКОЛЬСКОЕ С., ,,,",
  "seriya": "2202",
  "number": "919928",
  "issue_date": "2002-11-16",
  "issuer_code": "450-021",
  "issuer_name": "АРОВД"
}

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

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

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

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

{
  "request_id": "eddc16e3-abae-4981-87ab-5c320e263ab4"
}

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

Получение результата на предоставление ИНН ФЛ

Метод: GET

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

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

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

GET /v1/smev3/fns/inn-singular/eddc16e3-abae-4981-87ab-5c320e263ab4

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

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

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

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

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

{
  "state": "in_progress"
}

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

{
  "state": "finished",
  "result":
  {
    "status": "found",
    "inn": "520205004556"
  }
}

state — статус запроса
- in_progress — в обработке
- finished — завершён
result — результат обработки (в случае state = finished)
- status — результат поиска
  - not_found — ИНН не найден
  - found — ИНН найден
- inn — ИНН ФЛ