{
  "id": "dataset--nbu-rates",
  "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": "nbu-rates",
    "name": "НБУ: валютні курси та банківські метали",
    "group": "Гроші й показники",
    "kind": "Часовий ряд",
    "summary": "Офіційний курс або облікова ціна на дату. Є перевірена відповідь API та збережена копія за 2026-09-16.",
    "publisher": "Національний банк України",
    "sourceUrl": "https://bank.gov.ua/ua/open-data",
    "links": [
      {
        "label": "Документація валютних сервісів",
        "url": "https://finliteracy.bank.gov.ua/admin_uploads/article/Instr_API_KURS_VAL_Full_eng.pdf"
      }
    ],
    "formats": [
      "JSON",
      "XML",
      "CSV у Ладі"
    ],
    "access": "GET API за валютою й датою; різні сервіси НБУ мають різні схеми та масштаб значень.",
    "auth": "Перевірений GET працює без ключа.",
    "providerUpdates": "Сервіс повертає значення на запитану дату. Час публікації та правила дії курсів потрібно звіряти з методологією НБУ; дата запиту не замінює дату курсу.",
    "refreshAdvice": "Пропозиція для системи: отримувати дані щодня, перевіряти дату відповіді та повторювати запит за відсутності потрібного дня. Це не налаштований розклад Ладу.",
    "verification": "GET JSON виконано 2026-09-16. Відповідь на 2026-09-16 збережено; перевірено дати й додатні значення.",
    "extract": [
      "Запитати визначену дату. Перевірити HTTP-статус, формат, дату кожного запису та валютний код.",
      "Зберегти оригінальну відповідь, дату отримання та контрольну суму.",
      "Під час зміни сервісу врахувати поля Units/Amount або rate; не переносити масштаб між схемами автоматично."
    ],
    "keys": [
      "Код валюти або металу + дата курсу + сервіс"
    ],
    "pitfalls": [
      "Курс на дату не визначає, яку дату слід застосувати до конкретної операції.",
      "Список відповіді API не слід вважати повним світовим довідником валют."
    ],
    "conceptIds": [
      "parameter",
      "rule",
      "payment"
    ],
    "relatedIds": [
      "nbu-banks"
    ],
    "example": {
      "method": "GET",
      "url": "https://bank.gov.ua/NBUStatService/v1/statdirectory/exchange?valcode=USD&date=20260916&json",
      "note": "Перевірений приклад на фіксовану дату; для іншої дати змінити date у форматі YYYYMMDD."
    },
    "snapshot": true,
    "reviewedAt": "2026-09-16"
  },
  "relationships": [],
  "history": [],
  "provenance": {
    "project": "oblik-map",
    "endpoint": "/api/export#dataCatalog",
    "originalId": "nbu-rates",
    "sourceHash": "0a860ac7e949454ef1afb9178a8c497fe0d5c0bf2820723de50caef80528a70f",
    "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."
}