Получение информации о компании по ИНН

Чекко — сервис, который позволяет легко и быстро получить информацию о компании или индивидуальном предпринимателе по ИНН. Сервис бесплатный и предоставляет только открытую информацию о контрагентах, которая доступна из официальных источников.

Обратите внимание, что сервис имеет свои ограничения и правила, которые необходимо учитывать при его использовании. Для ознакомления с ними следует обратиться к документации по API.

Запустить демо

Установить локально

Примечание: Демопример имеет ограничение демонстрации всех возможностей при запуске на демостенде (Запустить демо). Рекомендуем установить пример локально.

Предварительная подготовка

Для доступа к Чекко необходимо получить API-ключ.

Примечание: Лимит запросов к сервису — 100 в день.

Получение API-ключа

Для получения API-ключа выполняются следующие шаги:

  1. Зайти на портал Чекко и зарегистрироваться.

  2. В личном кабинете зайти на вкладку API и скопировать ключ.

Примечание: Это ваш личный API-ключ, привязанный к вашей учетной записи и балансу, храните его в секрете.

Описание алгоритма

1. Импорт данных

Имя Метка
 inn ИНН

2. Валидация ИНН

а) Первичная проверка

В подмодели Первичная проверка осуществляется проверка поля с ИНН на корректность данных.

В выходном порту подмодели выводятся следующие типы ошибок:

  • Неправильное количество символов
  • Содержит не только цифры

С помощью узла Выборка первичных ошибок выделены в отдельный набор данных записи с ошибками. На основе записей, прошедших первичную проверку, в узле Разделение на типы ИНН сформированы 2 набора: ИНН юр.лиц и ИНН физ.лиц.

б) Проверка контрольного числа

Входные порты подмодели Проверка контрольного числа принимают данные ИНН юридических и физических лиц. В подмодели используется узел Проверка контрольного числа, в котором рассчитывается контрольное число для каждого субъекта по методике, разработанной Федеральной налоговой службой (ФНС).

Если конторольное число не сходится с проверкой, то эти данные попадают на выходной порт Ошибки ИНН. Далее ошибки по каждому субъекту объединяются с использованием узла Объединение.

В узле Параметры полей удаляются поля, которые не нужны в финальной выборке.

На выходе формируются три порта:

  • Достоверный ИНН юр. лиц
  • Достоверный ИНН физ. лиц
  • Ошибки
в) Объединение

Данный узел объединяет ошибки подмоделей Первичная проверка и Проверка контрольного числа в одну таблицу.

3. Получение данных от сервиса

В подмодели Получение данных от сервиса выполняется запрос к сервису Чекко. Затем с помощью производного компонента parseJSON table эти данные, представленные в формате JSON, преобразуются в таблицу.

Во входном порту переменных пользователя задается переменная:

Имя Метка Значение
 key АPI-ключ Вводится полученный API-ключ
а) Запрос данных

На странице Подключения настроено подключение REST-сервис со следующими параметрами:

  • URL сервиса в зависимости от субъекта:
URL Комментарий
https://api.checko.ru/v2/company Информация о юридических лицах
https://api.checko.ru/v2/entrepreneur Информация об индивидуальных предпринимателях
  • Метод: GET
  • Параметры запроса:
Имя Тип данных
 key Строковый
 inn Строковый
  • Тип аутентификации: Не требуется

К исходному набору данных присоединяется переменная АPI-ключ. В мастере настройки узла Соединение задаются следующие параметры:

  • Дополнение до наибольшего набора - Повторять набор данных
  • Количество строк соответствует - Максимальному набору

Отправка запроса происходит в узле REST-запрос. В настройках узла установлены следующие связи между Полями и Параметрами запроса:

  • ИНН - inn
  • API-ключ - key
б) Парсинг и обработка данных

На входной порт узла Преобразование JSON в таблицу подаётся JSON для парсинга, который затем преобразуется в таблицу для дальнейшей обработки.

Узел Преобразование JSON в таблицу создан на основе производного компонента, доступного на панели Производные компоненты. Базовый узел данного производного компонента расположен в зашифрованном пакете, подключенном по ссылке.

В настройках входного порта переменных включен параметр Генерировать составные метки полей (по умолчанию флаг выключен). При наличии данного флага в каждой метке поля будет отражена иерархия относительно корневого элемента, иначе метки полей будут повторяться.

Состав полей в выходном порту формируется динамически (используется автосинхронизация полей) и зависит от структуры полученного JSON. Набор данных содержит обязательное поле Error (Исключение), которое выводится в строке с проблемным элементом JSON.

В настройках узла Группировка выбираются поля, которые выводятся в результирующую таблицу. Обратите внимание, при изменении количества полей, выбранных для группировки, возможно возникновение дубликатов данных из-за особенностей работы парсера JSON.

В подмодели Проверка полученных данных анализируется наличие данных. В случае их отсутствия выводится сообщение об ошибке.

в) Объединение

С помощью узла Объединение происходит объединение ошибок, полученных в подмодели Проверка полученных данных для юридических и физических лиц.


Парсинг JSON

Скачайте и откройте файл в Loginom. При необходимости Loginom CE можно скачать бесплатно

Скачать демопример

Минимальные требования к системе:

  • Операционная система: Windows 10 и выше
  • CPU x64: 2 core 1
  • Оперативная память: 4 GB
  • Жесткий диск: 10 GB

1 Поддерживается работа на x64 процессорах Intel Core, AMD FX и более новых, содержащих инструкции SSE4.2 (POPCNT, LZCNT).