API КВЕД для інтернет-магазину: B2B-покупці і продавці маркетплейсу
Оновлено 26.09.2026
Інтернет-магазин, який продає компаніям, і маркетплейс, що підключає продавців-ФОП, рано чи пізно стикаються з кодами КВЕД. Покупець-юрособа вказує вид діяльності в профілі, продавець при реєстрації на майданчику обирає свої коди, модератор перевіряє, чи відповідає код тому, що продавець збирається продавати. Initask API повертає за кодом КВЕД офіційну назву за ДК 009:2010, ієрархію, пояснення Держстату і перелік підкодів одним запитом `GET https://dani.initask.com/v1/kved/{code}`.
Три місця, де КВЕД потрібен магазину
Форма реєстрації продавця
Продавцю на маркетплейсі зручніше обирати вид діяльності зі списку, ніж вводити код. Поле `children` дає підкоди з назвами, рівнем і сторінкою. Форма може працювати як дерево: людина обирає секцію, потім розділ, групу і клас, і на кожному рівні бачить зрозумілі назви. Наприкінці у профілі зберігається точний код класу.
Перевірка коду продавця-ФОП
Для класу поле `fop` показує статус на єдиному податку окремо для 1, 2 і 3 групи з нормами Податкового кодексу. Модератор бачить, чи може продавець з цим кодом працювати на своїй групі. Для 62.01 друга група можлива з умовою щодо клієнтів, третя без обмежень, а перша група охоплює лише продаж на ринках і побутові послуги населенню. Статус `check` означає, що з продавцем варто уточнити умови.
Галузь покупця-юрособи
Коли компанія реєструється як покупець, її основний КВЕД підказує, що їй показувати. Секція J з ІТ-компаніями і секція з будівельними компаніями цікавляться різними товарами. Поля `section` і `division` дають рівні для персоналізації каталогу або умов оптових знижок.
Приклад на JavaScript
```javascript const r = await fetch("https://dani.initask.com/v1/kved/62.01", { headers: { Authorization: `Bearer ${process.env.INITASK_KEY}` }, }); const { ok, data, error } = await r.json(); console.log(r.headers.get("X-RateLimit-Remaining"), data); ```
Ключ API тримайте на сервері магазину, у змінній середовища. У браузер він не потрапляє: форма звертається до вашого бекенду, а той до Initask API.
Поля для магазину
| Поле | Що означає |
|---|---|
| name | назва за ДК 009:2010 |
| level | section, division, group або class |
| section | секція: код і назва |
| division | розділ: код і назва |
| fop.status | allowed, only3, check, forbidden або na |
| children | підкоди: код, назва, рівень, сторінка |
Поле `level` підказує формі, чи обрано вже кінцевий клас. Статус для єдиного податку є лише в класу, для вищих рівнів він не визначається.
Пояснення «що включає» для модератора
Найскладніші випадки модерації виникають, коли товар продавця лежить на межі двох кодів. Поля `includes` і `excludes` містять пояснення Держстату: що клас включає і що віднесено до інших кодів. Наприклад, для 62.01 у `excludes` сказано, що видання стандартного програмного забезпечення належить до 58.29. Модератор показує продавцю саме це пояснення, і розмова про правильний код стає короткою і предметною.
Кеш і ліміти
Класифікатор стабільний, відповідь кешується на 1440 хвилин. Дерево кодів для форми вигідно завантажити один раз і зберігати на своєму боці: тоді форма реєстрації працює миттєво і не витрачає ліміт на кожного відвідувача.
| План | Запитів | Ціна, грн на місяць |
|---|---|---|
| Безкоштовний | 100 на добу | 0 |
| Старт | 10000 на місяць | 990 |
| Про | 100000 на місяць | 2990 |
Для перевірки продавців під час модерації маркетплейсу зазвичай вистачає безкоштовного або стартового плану. Ключ передається заголовком `Authorization: Bearer КЛЮЧ` або параметром `key`, без ключа доступно 100 запитів на добу з однієї IP-адреси.
Помилки у формі
| Код | Помилка | Що показати користувачу |
|---|---|---|
| 400 | bad_request | «Перевірте формат коду: літера секції, розділ, група або клас» |
| 404 | not_found | «Такого коду немає в чинному класифікаторі» |
Код з комою шлюз приймає: 62,01 читається як 62.01, тож продавцю не треба пояснювати, як правильно ставити роздільник.
Що робити
- Відкрийте документацію КВЕД і отримайте дерево підкодів для секцій, з якими працює ваш майданчик.
- Зробіть вибір виду діяльності у формі реєстрації продавця деревом з назвами.
- Додайте в модерацію перевірку статусу `fop` для продавців-ФОП.
- Для покупців-юросіб беріть основний КВЕД з картки компанії за ЄДРПОУ.
- Строки звітності для продавців-ФОП дає податковий календар, тарифи на сторінці Ціни і ліміти.
Питання і відповіді
Як зробити вибір КВЕД у формі реєстрації?
Поле children у відповіді API дає підкоди з назвами і рівнем. Форма може показувати дерево від секції до класу і зберігати точний код класу.
Чи можна перевірити, що продавець-ФОП може працювати з кодом на своїй групі?
Так, для класу поле fop дає статус на єдиному податку і пояснення окремо для 1, 2 і 3 групи з нормами Податкового кодексу.
Де зберігати ключ API в інтернет-магазині?
На сервері, у змінній середовища. Форма звертається до вашого бекенду, а він до Initask API.