API КВЕД для CRM: назва виду діяльності і сегмент клієнта

Оновлено 26.09.2026

У картці клієнта в CRM часто стоїть код на кшталт 62.01, і менеджер не памʼятає, що він означає. Ще гірше з аналітикою: щоб порахувати, скільки клієнтів з ІТ, а скільки з торгівлі, коди треба групувати вручну. Initask API за одним запитом `GET https://dani.initask.com/v1/kved/{code}` повертає офіційну назву коду за класифікатором ДК 009:2010, його місце в ієрархії (секція, розділ, група) і пояснення Держстату. Цього досить, щоб CRM сама показувала зрозумілу назву і групувала клієнтів за галузями.

Що дає CRM один запит

Відповідь для класу 62.01 містить назву «Компʼютерне програмування», секцію J «Інформація та телекомунікації», розділ 62 і групу 62.0. Для CRM з цього корисні три речі.

Назва в картці

Поле `name` показується поруч з кодом. Менеджер бачить «Компʼютерне програмування» і розуміє, з ким говорить, без пошуку в довіднику.

Сегмент за секцією і розділом

Поля `section` і `division` дають готові рівні для сегментації. Звіт «виручка за секціями КВЕД» будується групуванням за кодом секції, і не треба вести власну таблицю відповідності кодів галузям. Секція J збирає ІТ і звʼязок, секція G торгівлю, і так далі за класифікатором.

Підказка про єдиний податок

Для класу поле `fop` дає статус для єдиного податку: `allowed`, `only3`, `check`, `forbidden` або `na`, з поясненням для 1, 2 і 3 групи. Для відділу закупівель це підказка: якщо постачальник-ФОП працює за кодом зі статусом `check`, варто уточнити його групу до підписання договору.

Приклад запиту

``` curl -H "Authorization: Bearer $INITASK_KEY" "https://dani.initask.com/v1/kved/62.01" ```

Код можна передавати в будь-якій звичній формі: 62,01 шлюз читає як 62.01, літеру секції можна писати малою. Для CRM це зручно, бо коди в картках часто вводяться вручну і по-різному.

Поля, які варто зберегти в картці

Поля `includes` і `excludes` з поясненнями Держстату в картку зберігати не обовʼязково. Вони корисні, коли менеджер сумнівається, чи правильно вказано вид діяльності клієнта: там сказано, що клас включає і куди віднесено схожу діяльність.

Автозаповнення при створенні картки

Найзручніше викликати API в момент, коли менеджер вводить код у картку. CRM робить запит, і якщо код існує, одразу підставляє назву, секцію і розділ. Якщо приходить 404, поле підсвічується, і менеджер бачить помилку до збереження картки. Так у базі не накопичуються коди з одруками, які потім псують звіти.

Кешування і ліміти

Класифікатор змінюється рідко, тому відповідь кешується на 1440 хвилин. У CRM назву коду достатньо отримати один раз і зберегти: наступні клієнти з тим самим кодом беруть її з вашої бази без запиту.

Для початкового заповнення бази з тисячами клієнтів порахуйте унікальні коди: зазвичай їх небагато, і запитів знадобиться менше, ніж карток. Залишок ліміту видно в заголовку `X-RateLimit-Remaining`, після вичерпання приходить код 429 із заголовком `Retry-After`.

Помилки

404 у картці клієнта найчастіше означає одрук або код зі старого класифікатора. Таку картку варто позначити для перевірки менеджером.

Що робити

1. Відкрийте документацію КВЕД і перевірте запит на кодах своїх найбільших клієнтів.
2. Додайте в CRM поля назви, секції і розділу і заповнюйте їх за унікальними кодами.
3. Побудуйте звіт за секціями і подивіться, з яких галузей ваші клієнти.
4. Для карток з кодами ЄДРПОУ спершу беріть КВЕД з картки компанії за ЄДРПОУ, а потім розшифровуйте тут.
5. Тарифи і ліміти на сторінці Ціни і ліміти.

Питання і відповіді

Як показати в CRM назву КВЕД замість коду?

Запит GET https://dani.initask.com/v1/kved/{code} повертає назву за ДК 009:2010, секцію, розділ і групу. Збережіть назву в картці клієнта поруч з кодом.

Як часто оновлювати назви КВЕД у CRM?

Класифікатор змінюється рідко, відповідь кешується на 1440 хвилин. Назву достатньо отримати один раз для кожного унікального коду.

Чи можна передати код КВЕД з комою?

Так, 62,01 шлюз читає як 62.01, літеру секції можна писати малою.

Джерела даних

• Документація: КВЕД за кодом
• Класифікатор ДК 009:2010, Держстат, kved.initask.com