Курс НБУ та Курс ЦБ
Служба, що наповнює Курси валют офіційними курсами Нацбанку — з відкритого API bank.gov.ua, без ручного передруку. Проганяється за день чи за період, по одній валюті чи по всіх одразу.
Де шукати: Модулі → Фінанси → Служби → Курс НБУ та Курс ЦБ
Розбір на прикладі
| Поле | Що робить |
|---|---|
| З / По | Період: курс тягнеться на кожну дату діапазону; одна дата — заповніть лише «З»; обидва порожні — курс на сьогодні |
| Курс джерела вказано до | До скількох одиниць валюти джерело дає курс: 1 — звичайні валюти; 10/100 — єна, форинт тощо. Записана пара масштабується відповідно |
| Валюта | Один код — тягнути лише його; порожньо — всі валюти довідника, крім базової |
«Виконати» — разовий прогін; «За розкладом» — автоматичне наповнення з тією частотою, яку задали в розкладі (зазвичай щодня), і курси з'являються без людини. Дати «З» / «По» розклад не повторює: кожен запуск бере курс на свій день; валюта й «Курс джерела вказано до» зберігаються.
Служба працює лише в компанії, де базова валюта — гривня: НБУ дає курс у гривнях, тож з іншою базовою валютою служба не запише жодного курсу й відмовить «НБУ публікує курси в гривнях, а базова валюта — …: курси були б хибними, тому їх не завантажено».
Що робить прогін
На кожну дату й валюту служба питає API НБУ і створює запис у Курсах валют парою «N : офіційний курс × N» (N — «курс джерела вказано до»). Разом із прапорцем «Курс НБУ» у валюти це дає повністю офіційний курсовий контур: ручні правки, що розходяться з НБУ, блокуються.
Часті ситуації
Курс на вихідний чи святковий день. НБУ віддає курс і на ці дати — той, що діє з останнього робочого дня, — і служба записує його окремим записом на кожну дату періоду, субота й неділя теж. Якщо курсу на дату документа все ж немає, документ візьме останній попередній курс.
Продубльований запуск. Безпечний: пара «валюта + дата» унікальна, повторний прогін не плодить дублів. Валюту, курс якої на дату вже є, служба пропускає й завантажує решту — і на період, і на одну дату. Відмовить лише запуск на одну дату з вибраною валютою, курс якої вже є: «Курс USD на 17.10.2026 уже є: 41.2519!».
Потрібен курс не НБУ. Ця служба працює лише з офіційним джерелом; курс іншого банку заводьте руками у Курсах валют (і не вмикайте валюті прапорець «Курс НБУ»). Запуск без вибору валюти бере всі небазові валюти довідника, прапорець «Курс НБУ» тут ролі не грає, — тож за розкладом служба запише курс НБУ і цій валюті на кожну дату, де вашого курсу ще немає. Тоді решту валют вантажте запусками з вибраною валютою — і разовими, і за розкладом — замість запуску по всіх.