API податкового календаря: строки звітності і сплати за місяць
Оновлено 26.09.2026
Initask API віддає строки подання звітності і сплати податків на місяць для обраної ролі: ФОП 1, 2 чи 3 групи, ФОП на загальній системі, ТОВ, платник ПДВ, роботодавець. Кожен строк має дату з урахуванням перенесення з вихідного, назву, норму закону і посилання на опис. Адреса `GET https://dani.initask.com/v1/deadlines`.
Для чого
Нагадування клієнтам бухгалтерської фірми, календар у кабінеті ФОП і планування платежів. Бухгалтер, який веде десятки клієнтів різних груп, не тримає всі строки в голові. Календар з API підставляє строки кожному клієнту за його роллю і дає основу для автоматичних нагадувань.
Параметри
| Параметр | Де | Обовʼязковий | Опис |
|---|---|---|---|
| role | у запиті | ні | роль платника; all дає всі строки; без параметра береться all |
| month | у запиті | ні | місяць YYYY-MM; без параметра береться поточний місяць за Києвом |
Підтримувані ролі: `all`, `fop-1`, `fop-2`, `fop-3`, `fop-zahalna`, `tov`, `tov-yedynyi`, `pdv`, `robotodavets`. Для кількох ролей зробіть кілька запитів або візьміть `all`.
Приклад для ФОП 3 групи на листопад 2026:
``` curl -H "Authorization: Bearer $INITASK_KEY" "https://dani.initask.com/v1/deadlines?role=fop-3&month=2026-11" ```
Поля відповіді
| Поле | Значення |
|---|---|
| role | роль |
| month | місяць |
| items | строки місяця за датою |
| items[].id | ідентифікатор строку |
| items[].date | дата строку |
| items[].title | назва |
| items[].kind | report (звітність), pay (сплата) або register (реєстрація) |
| items[].description | що зробити |
| items[].norm | норма закону |
| items[].normUrl | текст закону |
| items[].url | сторінка строку |
| items[].verify | true, якщо строк варто звірити з календарем ДПС |
У прикладі для ФОП 3 групи на листопад 2026 першим іде строк 2026-11-09: декларація платника єдиного податку 3 групи за III квартал 2026 з нормою «п. 296.3, пп. 49.18.2 ПКУ». Далі 2026-11-19: військовий збір ФОП 3 групи за III квартал 2026, вид `pay`.
Поле `kind` зручне для інтерфейсу: звітність, сплату і реєстрацію можна показувати різними позначками, а нагадування про сплату надсилати раніше, ніж про звіт.
Нагадування клієнтам бухгалтерської фірми
Найпоширеніший сценарій виглядає так. У базі фірми для кожного клієнта записана роль: ФОП третьої групи, ТОВ на загальній системі, роботодавець. На початку місяця система робить по одному запиту на кожну роль і отримує всі строки. Далі кожен клієнт отримує свій перелік: що подати, що сплатити і до якої дати. За кілька днів до строку йде нагадування, у день строку друге.
Опис з поля `description` підходить для тексту нагадування майже без змін: у ньому вже сказано, що саме зробити. Посилання на норму закону корисне бухгалтеру, а клієнту достатньо назви і дати.
Ще один корисний прийом: показувати клієнту календар на місяць одним повідомленням на початку місяця. Людина бачить усі свої строки разом і планує гроші заздалегідь, особливо коли в одному місяці збігаються декларація, єдиний податок і військовий збір. Для фірми це менше дзвінків з питанням «а що мені платити цього місяця».
Перенесення з вихідних і позначка verify
Строк, що припадає на суботу або неділю, переноситься на наступний робочий день за п. 49.20 ПКУ. Дата у відповіді вже перенесена, додатково рахувати нічого не треба.
Позначка `verify: true` стоїть на строку, який варто звірити з офіційним календарем ДПС. Наприклад, коли він припадає на свято під час воєнного стану. Такі строки варто показувати з окремою приміткою.
Помилки
| Код | Помилка | Коли |
|---|---|---|
| 400 | bad_request | невідома роль або місяць у форматі, відмінному від YYYY-MM |
| 404 | not_found | рік поза календарем (зараз 2026 і 2027) |
404 тут означає відповідь по суті: календаря на цей рік ще немає.
Джерело і ліміти
Джерело: Податковий кодекс України і Закон № 2464-VI, через kalendar.initask.com. Відповідь кешується на 360 хвилин.
| План | Запитів | Ціна, грн на місяць |
|---|---|---|
| Безкоштовний | 100 на добу | 0 |
| Старт | 10000 на місяць | 990 |
| Про | 100000 на місяць | 2990 |
Ключ передається заголовком `Authorization: Bearer КЛЮЧ` або параметром `key`. Календар на місяць досить запитати раз на кожну роль, тож безкоштовного ліміту вистачає навіть бухгалтерській фірмі з багатьма клієнтами.
Що робити
- Відкрийте документацію податкового календаря і запитайте строки для своєї ролі на поточний місяць.
- Для кожного клієнта збережіть роль і запитуйте календар раз на місяць на кожну роль.
- Налаштуйте нагадування за кілька днів до `date`, окремо для `pay` і `report`.
- Строки з `verify: true` показуйте з приміткою звірити з календарем ДПС.
- Для вибору групи ФОП за видом діяльності підключіть API КВЕД, для валютних операцій курс НБУ.
Питання і відповіді
Як отримати податковий календар через API?
Зробіть запит GET https://dani.initask.com/v1/deadlines з параметрами role і month у форматі YYYY-MM. Відповідь містить строки звітності і сплати з датою, назвою і нормою закону.
Чи враховано перенесення строку з вихідного?
Так, строк на суботу або неділю переноситься на наступний робочий день за п. 49.20 ПКУ, дата у відповіді вже перенесена.
Які ролі підтримує API податкового календаря?
Ролі all, fop-1, fop-2, fop-3, fop-zahalna, tov, tov-yedynyi, pdv, robotodavets. Для кількох ролей зробіть кілька запитів або візьміть all.