Проверка соответствия ИНН и паспортных данных (ФНС)¶
checkInn¶
Данный вызов недоступен в личном кабинете
Для подключения обратитесь на support@iidx.ru
Тип HTTP запроса: POST
URL вызова: https://api.id-x.org/idx/api2/checkInn
Поддерживаются следующие форматы передачи параметров:
-
JSON, Content-Type: application/json
-
Form submit, Content-Type: application/x-www-form-urlencoded
Параметры:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| accessKey | String | Да | Ключ доступа, выданный при регистрации в Системе IDX |
| secretKey | String | Да | Секретный ключ, выданный при регистрации в Системе IDX |
| lastName | String | Да | Фамилия |
| firstName | String | Да | Имя |
| midName | String | Нет | Отчество (при наличии) |
| birthDate | String | Да | Дата рождения в формате DD.MM.YYYY |
| passportNumber | String | Да | Номер паспорта, серия и номер слитно без разделителей |
| passportDate | String | Нет | Дата выдачи паспорта в формате DD.MM.YYYY |
| inn | String | Да | Индивидуальный налоговый номер |
Функция возвращает:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| resultCode | Int | Да | Результат выполнения функции (0 – успешное завершение функции, отличное от 0 значение – ошибка выполнения) |
| resultMessage | String | Нет | Сообщение об ошибке |
| operationToken | String | Нет | Уникальный идентификатор операции |
| startMoment | String | Нет | Время начала операции |
| stopMoment | String | Нет | Время завершения операции |
| isValid | Boolean | Нет | True - данные соответствуют, False – не соответствуют |
| validationMessage | String | Нет | Описание результата |
Пример вызова:
POST /idx/api2/checkInn
Host: api.id-x.org
Content-Type: application/json
Accept: application/json
{
"accessKey": "выданный accessKey",
"secretKey": "выданный secretKey",
"lastName": "Иванов",
"firstName": "Иван",
"midName": "Иванович",
"birthDate": "20.01.1970",
"passportNumber":"1234567890",
"passportDate": "22.12.2000",
"inn": "123456789012"
}
Пример успешного ответа:
{
"resultCode": 0,
"operationToken": "e71db75acd354bb2b9f1e444e9dfa209",
"startMoment": "01.01.2020 12:08:10 +0300",
"stopMoment": "01.01.2020 12:08:11 +0300",
"isValid": true,
"resultMessage": “Паспортные данные соответствуют ИНН физического лица”
}
Примеры неуспешных ответов:
{
"resultCode": 0,
"operationToken": "e71db75acd354bb2b9f1e444e9dfa209",
"startMoment": "01.01.2020 12:08:10 +0300",
"stopMoment": "01.01.2020 12:08:11 +0300",
"isValid": false,
"resultMessage": "Сведения не соответствуют"
}
{
"resultCode": 0,
"operationToken": "e71db75acd354bb2b9f1e444e9dfa209",
"startMoment": "01.01.2020 12:08:10 +0300",
"stopMoment": "01.01.2020 12:08:11 +0300",
"isValid": false,
"resultMessage": "Сведения не были найдены"
}