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

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

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

Важно учесть, что используются два разных URL-запроса для контрагентов на сервисе Чекко. Для компаний — https://api.checko.ru/v2/company, для индивидуальных предпринимателей — https://api.checko.ru/v2/entrepreneur.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В подмодели реализована проверка ИНН на корректность ввода данных.

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

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

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

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

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

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

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

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

в) Объединение ошибок

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

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

Валидные ИНН юр.лиц
Валидные ИНН ИП
Некорректные ИНН

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

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

В подмодели выполняется параллельный запрос к сервису Чекко. Затем выполняется преобразование ответа от сервиса Чекко в таблицу данных.

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

Имя	Метка	Значение
`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 в дерево в основные параметре устанавливаем следующие параметры:

"Имя столбца" — столбец "Ответ сервера"
"Формат даты и времени" — "YYYY-MM-DDThh:mm:ss"

В мастере настройки узла Дерево в таблицу выбираем ветки, которые будут преобразованы в таблицу.

В подмодели Обработка пустого ответа сервера добавляется поле с сообщением для ИНН с пустой информацией.

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

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