Получение информации о компании по ИНН
Чекко — сервис, который позволяет легко и быстро получить информацию о компании или индивидуальном предпринимателе по ИНН. Сервис бесплатный и предоставляет только открытую информацию о контрагентах, которая доступна из официальных источников.
Обратите внимание, что сервис имеет свои ограничения и правила, которые необходимо учитывать при его использовании. Для ознакомления с ними следует обратиться к документации по API.
Примечание: Демопример имеет ограничение демонстрации всех возможностей при запуске на демостенде (Запустить демо). Рекомендуем установить пример локально.
Предварительная подготовка
Для доступа к Чекко необходимо получить API-ключ.
Примечание: Лимит запросов к сервису — 100 в день.
Для получения API-ключа выполняются следующие шаги:
Зайти на портал Чекко и зарегистрироваться.
В личном кабинете зайти на вкладку 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.
В подмодели Проверка полученных данных анализируется наличие данных. В случае их отсутствия выводится сообщение об ошибке.
С помощью узла Объединение происходит объединение ошибок, полученных в подмодели Проверка полученных данных для юридических и физических лиц.
Скачайте и откройте файл в Loginom. При необходимости Loginom CE можно скачать бесплатно
Минимальные требования к системе:
- Операционная система: Windows 10 и выше
- CPU x64: 2 core 1
- Оперативная память: 4 GB
- Жесткий диск: 10 GB
1 Поддерживается работа на x64 процессорах Intel Core, AMD FX и более новых, содержащих инструкции SSE4.2 (POPCNT, LZCNT).