API КВЕД для бухгалтерії: розшифровка кодів і статус для ФОП
Оновлено 26.09.2026
Бухгалтер, який приймає нового клієнта-ФОП, першим ділом дивиться на його КВЕД: чи можна з цими видами діяльності бути на обраній групі єдиного податку. Initask API за кодом КВЕД повертає офіційну назву за ДК 009:2010, пояснення Держстату «що включає» і «що не включає» і для класу окремий статус для 1, 2 і 3 групи з нормами Податкового кодексу. Запит один: `GET https://dani.initask.com/v1/kved/{code}`.
Задачі бухгалтерії, які закриває API КВЕД
Прийом нового клієнта
Клієнт приносить виписку з реєстру з переліком кодів. Бухгалтер проганяє кожен код через API і отримує таблицю: назва, статус для єдиного податку, пояснення. Одразу видно, чи є серед кодів такі, з якими обрана група неможлива, і це обговорюється з клієнтом до початку обслуговування.
Вибір групи для нового ФОП
Людина відкриває ФОП і питає, на якій групі їй працювати. Поле `fop` для кожного класу дає статус і пояснення окремо для кожної групи. Для 62.01 «Компʼютерне програмування» це 2 група з умовою щодо клієнтів і 3 група без обмежень. Бухгалтер пояснює клієнту умову і показує норму.
Перевірка перед додаванням нового виду діяльності
Клієнт хоче додати новий КВЕД. До подання змін бухгалтер перевіряє статус нового коду: якщо він `forbidden` для єдиного податку, додавання змінить усю систему оподаткування клієнта.
Значення статусу для єдиного податку
| Значення fop.status | Що означає для бухгалтера |
|---|---|
| allowed | можна на єдиному податку |
| only3 | лише 3 група |
| check | потрібна перевірка умов |
| forbidden | на єдиному податку заборонено |
| na | статус для цього рівня не визначається |
Статус `check` найважливіший для консультації: код дозволений лише за певних умов, і саме бухгалтер пояснює клієнту, чи він під них підпадає. Пояснення і норми ПКУ для кожної групи приходять у тій самій відповіді.
Статус є лише у класу, найдетальнішого рівня класифікатора. Для секції, розділу чи групи поле `fop` не заповнюється, бо всередині них можуть бути коди з різним статусом.
Як записати код
Шлюз приймає код у будь-якій звичній формі: 62,01 читається як 62.01, літеру секції можна писати малою. Для бухгалтера це означає, що код можна вставляти просто з таблиці чи документа клієнта, без ручного переписування.
``` curl -H "Authorization: Bearer $INITASK_KEY" "https://dani.initask.com/v1/kved/62.01" ```
Пояснення «що включає» і «що не включає»
Поля `includes` і `excludes` містять пояснення Держстату. Вони рятують у спірних випадках, коли діяльність клієнта схожа на кілька кодів одразу. Для 62.01 у `excludes` сказано, що видання стандартного програмного забезпечення належить до 58.29. Бухгалтер показує це клієнту і разом з ним обирає правильний код.
Помилки
| Код | Помилка | Коли |
|---|---|---|
| 400 | bad_request | рядок має форму, відмінну від коду КВЕД |
| 404 | not_found | такого коду у класифікаторі немає |
404 у виписці клієнта зазвичай означає одрук при перенесенні або код зі старого класифікатора. Чинний класифікатор ДК 009:2010, назви з набору Держстату на data.gov.ua.
Строки для обраної групи
Коли група визначена, наступне питання клієнта: що і коли подавати. Податковий календар з тим самим ключем повертає строки звітності і сплати на місяць для ФОП 1, 2 чи 3 групи. Разом два ендпоінти дають бухгалтерії повний старт обслуговування нового клієнта.
Для клієнтів-юросіб КВЕД зручно брати з картки компанії за ЄДРПОУ і розшифровувати цим ендпоінтом.
Ліміти
| План | Запитів | Ціна, грн на місяць |
|---|---|---|
| Безкоштовний | 100 на добу | 0 |
| Старт | 10000 на місяць | 990 |
| Про | 100000 на місяць | 2990 |
Класифікатор змінюється рідко, тому відповідь кешується на 1440 хвилин. Бухгалтерській фірмі вистачає безкоштовного плану: коди клієнтів перевіряються при прийомі і при змінах. Ключ передається заголовком `Authorization: Bearer КЛЮЧ` або параметром `key`.
Що робити
- Відкрийте документацію КВЕД і перевірте коди свого найскладнішого клієнта.
- Складіть для кожного клієнта-ФОП таблицю кодів зі статусом для його групи.
- Коди зі статусом `check` обговоріть з клієнтом з поясненням умов.
- Перед додаванням нового КВЕД перевіряйте його статус.
- Строки звітності для групи клієнта беріть з податкового календаря, тарифи на сторінці Ціни і ліміти.
Питання і відповіді
Як перевірити, чи можна з КВЕД бути на єдиному податку?
Запит GET https://dani.initask.com/v1/kved/{code} для класу повертає поле fop зі статусом і поясненнями окремо для 1, 2 і 3 групи з нормами Податкового кодексу.
Що означає статус check для КВЕД?
Код дозволений на єдиному податку лише за певних умов. Пояснення і норми ПКУ для кожної групи приходять у тій самій відповіді.
Чи можна передати код КВЕД з комою?
Так, 62,01 шлюз читає як 62.01, літеру секції можна писати малою.