Skip to content

Проверка соответствия ИНН и паспортных данных (ФНС)

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": "Сведения не были найдены"
}