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

Код КВЕД у будь-якій формі (секція J, розділ 62, група 62.0, клас 62.01) повертає офіційну назву за класифікатором ДК 009:2010, місце в ієрархії, пояснення Держстату «що включає» і «що не включає», статус для єдиного податку по групах і перелік підкодів.

Де застосовують: Розшифровка КВЕД у картці клієнта, вибір виду діяльності у формі реєстрації, перевірка коду з виписки.

Запит

GEThttps://dani.initask.com/v1/kved/{code}

Приклади

curl

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

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);

Python

import os, requests

r = requests.get(
    "https://dani.initask.com/v1/kved/62.01",
    headers={"Authorization": f"Bearer {os.environ['INITASK_KEY']}"},
    timeout=10,
)
body = r.json()
print(r.headers["X-RateLimit-Remaining"], body["data"])

Змінна INITASK_KEY містить ваш ключ. Без ключа запит теж пройде в межах 100 запитів на добу.

Відповідь

Справжня відповідь на запит /v1/kved/62.01, масиви скорочено до трьох елементів.

{
  "ok": true,
  "data": {
    "code": "62.01",
    "name": "Компʼютерне програмування",
    "level": "class",
    "section": {
      "code": "J",
      "name": "Інформація та телекомунікації"
    },
    "division": {
      "code": "62",
      "name": "Компʼютерне програмування, консультування та повʼязана з ними діяльність"
    },
    "group": {
      "code": "62.0",
      "name": "Компʼютерне програмування, консультування та повʼязана з ними діяльність"
    },
    "includes": [
      "Цей клас включає розроблення, модифікацію, тестування та технічну підтримку програмного забезпечення.",
      "розроблення структури та контенту та/або розроблення системи команд, необхідних для створення та виконання:",
      "системного програмного забезпечення (у т.ч. оновленого й актуалізованого)"
    ],
    "excludes": [
      "видання стандартного програмного забезпечення, див. 58.29",
      "переклад або адаптацію стандартного програмного забезпечення за власний рахунок, див. 58.29",
      "планування та проектування інтегрованих компʼютерних систем, які поєднують апаратні засоби, програмне забезпечення та комунікаційні технології, навіть якщо надання програмного забезпечення може бути складовою цього процесу, див. 62.02"
    ],
    "fop": {
      "status": "allowed",
      "label": "Можна на єдиному податку",
      "g1": {
        "ok": "no",
        "text": "Перша група охоплює лише продаж на ринках і побутові послуги населенню."
      },
      "g2": {
        "ok": "cond",
        "text": "Так, якщо ваші клієнти це населення або платники єдиного податку. Послуги компаніям на загальній системі та іноземним компаніям потребують 3 групи."
      },
      "g3": {
        "ok": "yes",
        "text": "Так, для будь-яких клієнтів."
      },
      "reasons": [],
      "notes": [],
      "refs": [],
      "lawUrl": "https://zakon.rada.gov.ua/laws/show/2755-17"
    },
    "url": "https://kved.initask.com/62.01",
    "children": []
  },
  "meta": {
    "source": "kved.initask.com",
    "cached": false
  }
}

Помилки

Джерело і свіжість

Дані: Класифікатор ДК 009:2010, Держстат, kved.initask.com. Шлюз тримає відповідь у кеші 24 год, поле meta.cached показує, звідки вона.

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

Яку редакцію КВЕД повертає API?

Чинний класифікатор ДК 009:2010 з назвами з набору Держстату на data.gov.ua.

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

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

Чи можна з цим КВЕД бути на єдиному податку?

Для класу поле fop дає статус і пояснення окремо для 1, 2 і 3 групи з нормами Податкового кодексу. Для 62.01 це 2 група з умовою щодо клієнтів і 3 група без обмежень.

Повʼязані ендпоінти

• API ЄДРПОУ: дані компанії за кодом у JSON
• API податкового календаря: строки звітів і сплати