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

Формат і доступ

Формати

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

Спосіб отримання

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

Авторизація

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

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

Як часто оновлюється

У джерелі

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

Як перевіряти у своїй системі

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

Рекомендація щодо перевірки не є гарантією видавця або активним розкладом Ладу.

Як отримати дані

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

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

Як зберігати та пов’язувати

Ключі записів

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

Межі й типові помилки

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

Перед повторним поширенням перевірте умови використання конкретного ресурсу та збережіть атрибуцію. Відкритий перегляд і права на повторне використання описуються окремо.

Зв’язки зі словником та іншими даними