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