ДПС: реєстри платників та РРО

Пояснення й структура

id

tax-registers

name

ДПС: реєстри платників та РРО

group

Реєстри

kind

Статуси на дату

summary

ПДВ, єдиний податок, неприбутковість, страхувальники, облік платників, акциз та РРО. Спосіб доступу залежить від реєстру.

publisher

Державна податкова служба

sourceUrl

https://cabinet.tax.gov.ua/help/api-registers.html

links

Поки немає / none recorded

formats

• CSV для окремих реєстрів
• JSON REST API

access

Документація описує повні CSV-вивантаження для частини реєстрів та окремі REST-запити.

auth

REST-запити потребують токена відкритої частини, який створюють у приватному кабінеті. Для перелічених CSV документація дає окремі посилання.

providerUpdates

Єдиного графіка для всіх реєстрів у переглянутій документації не встановлено. Для CSV перевіряти дату файла, для запиту зберігати час відповіді.

refreshAdvice

Пропозиція: перевіряти статус при створенні контрагента та перед залежною операцією; кешувати відповідь із датою.

verification

Документацію переглянуто. Токен не отримували, REST-запити й повні CSV не виконували.

extract

• Вибрати реєстр і режим: повний CSV або запит конкретного суб’єкта.
• Токен зберігати на сервері. За документацією понад 1000 запитів на день призводить до його скасування; ліміт звіряти перед запуском.
• Перевірити дати реєстрації й анулювання; зберегти відповідь, не зводити історію до одного прапорця.

keys

• Реєстр + ідентифікатор суб’єкта + дата стану

pitfalls

• Помилка або порожня відповідь не доводить відсутності реєстрації.
• API відкритих реєстрів та доступ до приватних даних платника мають різні повноваження.

conceptIds

• contractor
• report
• receipt

relatedIds

• edr
• report-forms
• tax-accounts

example

method

GET

url

https://cabinet.tax.gov.ua/ws/api/public/registers/export/pdv

note

Адреса CSV з документації. Завантаження не тестувалося; це не готове підключення у Ладі.