{
  "id": "dataset--ukrposhta-addresses",
  "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",
    "kind": "Зовнішній довідник",
    "links": [
      {
        "label": "Адресний класифікатор v3.21, 14.05.2026",
        "url": "https://dev.ukrposhta.ua/uploads/address-classifier-v3.21-14052026-ukr.pdf"
      },
      {
        "label": "Пошук відділень та індексів, 11.02.2026",
        "url": "https://dev.ukrposhta.ua/uploads/Search-offices-and-indexes-v3-11022026.pdf"
      }
    ],
    "formats": [
      "GET API",
      "JSON",
      "XML"
    ],
    "auth": "Bearer у заголовку Authorization; документація передбачає отримання в додатку до договору. Для JSON потрібен Accept: application/json.",
    "providerUpdates": "За змінами у видавця; гарантований інтервал у цій перевірці не встановлено.",
    "refreshAdvice": "Пропозиція: інтерактивний пошук із кешем; звірка індексу перед відправленням.",
    "verification": "Переглянуто документацію v3.21. Запитів із токеном не виконували.",
    "extract": [
      "Зберегти джерело, версію, умови використання та дату отримання.",
      "Зіставляти із внутрішніми записами через окремі відповідності."
    ],
    "conceptIds": [
      "contractor",
      "document"
    ],
    "relatedIds": [
      "nova-poshta",
      "katottg",
      "edra"
    ],
    "id": "ukrposhta-addresses",
    "name": "Укрпошта: адресний класифікатор та індекси",
    "group": "Адреси й доставка",
    "summary": "Пошук адресних компонентів і поштового індексу для доставки.",
    "publisher": "АТ «Укрпошта»",
    "sourceUrl": "https://dev.ukrposhta.ua/documentation",
    "access": "address-classifier-ws на www.ukrposhta.ua. Документація описує пошук області, району, населеного пункту, вулиці, номера будинку та індексу.",
    "keys": [
      "REGION_ID, DISTRICT_ID, CITY_ID, STREET_ID у просторі Укрпошти",
      "POSTCODE зберігати текстом; КАТОТТГ у відповіді звіряти з офіційним набором"
    ],
    "pitfalls": [
      "Поштовий індекс не є унікальним ID будинку.",
      "Порожня відповідь може бути наслідком обмеження навантаження або відсутності параметрів."
    ],
    "coverage": "Поштове обслуговування адрес; повноту всіх адрес України не перевірено.",
    "limits": "Документація орієнтує на інтерактивний пошук, кешування й повторні запити із затримкою. Масове вивантаження не тестувалося.",
    "reviewedAt": "2026-09-16"
  },
  "relationships": [],
  "history": [],
  "provenance": {
    "project": "oblik-map",
    "endpoint": "/api/export#dataCatalog",
    "originalId": "ukrposhta-addresses",
    "sourceHash": "d3a1863693462d2fdf91a6eccfc0a6b3cf863bf841921bd627e563c591aed3fc",
    "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."
}