{
  "id": "dataset--nova-poshta",
  "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": "Документація розробника",
        "url": "https://developers.novaposhta.ua/documentation"
      }
    ],
    "formats": [
      "JSON API",
      "XML API"
    ],
    "auth": "Обидва пробні запити з порожнім apiKey повернули success=true. Для робочої інтеграції звірити вимоги методу; офіційна інструкція описує ключ бізнес-кабінету.",
    "providerUpdates": "За змінами у видавця; гарантований інтервал у цій перевірці не встановлено.",
    "refreshAdvice": "Пропозиція: кешувати потрібні довідники; статус, обмеження й доступність точки перевіряти перед оформленням доставки. Періодичну звірку узгодити з лімітами сервісу.",
    "verification": "2026-09-16 отримано по 2 записи. API повідомив totalCount=26770 для населених пунктів і 54530 для точок. Це заявлені числа, не перевірена повнота. Сторінка детальної документації повернула 403.",
    "extract": [
      "Запитати потрібний метод і сторінку; перевірити success, errors, data та info.totalCount.",
      "Для повного отримання опрацювати пагінацію, дублікати й зміни під час завантаження. Масове копіювання спочатку звірити з умовами сервісу.",
      "Зберігати тип точки, Ref, CityRef і SettlementRef окремо. Графік та активність мають дату перевірки."
    ],
    "conceptIds": [
      "contractor",
      "document"
    ],
    "relatedIds": [
      "katottg",
      "ukrposhta-addresses",
      "edra",
      "osm"
    ],
    "id": "nova-poshta",
    "name": "Нова пошта: населені пункти й точки доставки",
    "group": "Адреси й доставка",
    "summary": "Довідники перевізника для вибору місця доставки. Два методи перевірено живими запитами; повної копії в Ладі немає.",
    "publisher": "Нова пошта",
    "sourceUrl": "https://novaposhta.ua/en/for-business/cooperation/integration/",
    "access": "POST до https://api.novaposhta.ua/v2.0/json/. Перевірено Address.getSettlements і Address.getWarehouses з Page=1, Limit=2.",
    "keys": [
      "Провайдер + модель + Ref",
      "CityRef і SettlementRef є різними полями; не вважати їх КАТОТТГ"
    ],
    "pitfalls": [
      "Перелік точок доставки не є переліком усіх будинків України.",
      "Однакові назви населених пунктів не доводять відповідності; потрібні регіон та перевірка.",
      "WarehouseStatus, DenyToSelect, тип і обмеження точки впливають на можливість доставки."
    ],
    "coverage": "Перевірено населені пункти та точки обслуговування. Вулиці, будинки й повноту покриття окремо не перевірено.",
    "reuse": "API-доступ сам по собі не підтверджує право публікувати повну копію. Умови кешування й поширення треба погодити з документацією або договором.",
    "limits": "Ліміти запитів і гарантований графік оновлення не встановлені. Проби не є навантажувальним тестом.",
    "example": {
      "method": "POST",
      "url": "https://api.novaposhta.ua/v2.0/json/",
      "body": {
        "apiKey": "",
        "modelName": "Address",
        "calledMethod": "getSettlements",
        "methodProperties": {
          "Page": "1",
          "Limit": "2"
        }
      },
      "note": "Саме цей запит без ключа перевірено. Для інших методів режим доступу може відрізнятися. Результати перевірки: /data/access-checks.json."
    },
    "reviewedAt": "2026-09-16"
  },
  "relationships": [],
  "history": [],
  "provenance": {
    "project": "oblik-map",
    "endpoint": "/api/export#dataCatalog",
    "originalId": "nova-poshta",
    "sourceHash": "20a1ef43baafcf3b8cd6a7fd2d7d695a809e3fd8a4238b6d459b8a7bb23dc477",
    "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."
}