{
  "id": "dataset--tax-registers",
  "kind": "explainer",
  "title": "ДПС: реєстри платників та РРО",
  "jurisdiction": "UA",
  "language": "uk",
  "version": "0.8.0",
  "publication": "draft",
  "evidence": "unverified",
  "implementation": "not-assessed",
  "effective": {
    "from": null,
    "to": null,
    "checkedAt": null
  },
  "citations": [],
  "rights": {
    "status": "unknown",
    "note": "Original editorial reference material with source links; third-party artifact redistribution is not authorized by this release."
  },
  "content": {
    "legacyKind": "dataset",
    "id": "tax-registers",
    "name": "ДПС: реєстри платників та РРО",
    "group": "Реєстри",
    "kind": "Статуси на дату",
    "summary": "ПДВ, єдиний податок, неприбутковість, страхувальники, облік платників, акциз та РРО. Спосіб доступу залежить від реєстру.",
    "publisher": "Державна податкова служба",
    "sourceUrl": "https://cabinet.tax.gov.ua/help/api-registers.html",
    "links": [],
    "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 з документації. Завантаження не тестувалося; це не готове підключення у Ладі."
    },
    "reviewedAt": "2026-09-16"
  },
  "relationships": [],
  "history": [],
  "provenance": {
    "project": "oblik-map",
    "endpoint": "/api/export#dataCatalog",
    "originalId": "tax-registers",
    "sourceHash": "e2e0cba8d649431019979ec01fa707904af19a8b19cf324b56a6ff074f8889d5",
    "edition": {
      "version": "0.8.0",
      "updated": "2026-09-17",
      "jurisdiction": "UA",
      "language": "uk",
      "origin": "Codex",
      "review": "Редакційна версія. Фахову перевірку правил ще не завершено."
    }
  },
  "uncertainty": "AI-assisted editorial snapshot. Human review is not recorded; source links and legacy reviewedAt do not certify current law or applicability."
}