[OCMOD] Автооновлення курсів валют України: НБУ, Monobank, PrivatBank для ocStore 3.0 / OpenCart 3.0

Сумісність: ocStore 3.0.x, OpenCart 3.0.x

Системні вимоги: PHP 7.1 – 8.2+, cURL

Ліцензія: Безкоштовно / Open Source

Про модуль

Стандартний механізм оновлення валют в OpenCart використовує сервери Європейського центрального банку (ЕЦБ), які або заблоковані, або видають неактуальні для українського e-commerce котирування гривні.

Модуль «Курси валют України» повністю вирішує цю проблему, інтегруючи магазин безпосередньо з API провідних банківських установ України. Ви самі обираєте, звідки отримувати актуальний курс — офіційний державний чи реальний комерційний.

Ключові можливості

• 3 незалежні джерела курсів в одному рішенні:

  • Національний банк України (НБУ) — офіційний курс для бухгалтерського обліку, первинних документів та фіскалізації (всі світові валюти).

  • Monobank API — актуальний курс одного з найпопулярніших банків України з автоматичною конвертацією кодів ISO 4217 та захистом від перевищення частоти запитів.

  • PrivatBank API — можливість вибору між курсом відділень (готівковий, coursid=5) та безготівковим курсом за картками (coursid=11).

• Гнучкий вибір типу котирування (для Mono та Privat):

  • Курс продажу (Sale) — рекомендовано для роздрібної торгівлі та імпортних товарів;

  • Курс купівлі (Buy);

  • Середній курс (Buy + Sale) / 2.

• Математична точність для будь-якої базової валюти:

  Коректний розрахунок внутрішнього значення Value за формулою OpenCart:

  $$\text{Value} = \frac{\text{Rate}(\text{Base})}{\text{Rate}(\text{Currency})}$$

  Працює однаково стабільно, якщо головною валютою магазину встановлено UAH, USD або EUR.

• Відсоткова корекція курсу: можливість закласти валютний буфер або маржу ризику (наприклад, +1.5% чи -0.5% до курсу банку).

• Вибіркове оновлення: оновлюйте лише ті валюти, які позначені галочками (наприклад, тільки USD та EUR, не змінюючи решту).

• Автоматизація через CRON: фонове оновлення за розкладом із захистом секретним ключем.

• Оновлення в 1 клік без перезавантаження: AJAX-кнопка в панелі керування миттєво оновлює курси в базі даних та відображає нові значення прямо в таблиці.

• Повна інтеграція в систему: модуль розміщується у рідному розділі «Курси валют» та додає швидкий перехід із розділу «Система → Локалізація → Валюти».

• Вбудований журнал (Debug Log): зручний перегляд історії та статусів синхронізації з можливістю очищення логу в один клік.

Встановлення за 1 хвилину

1. Завантажте архів модуля через адмінку: Модулі / Розширення → Встановлення розширень (Installer).

2. Перейдіть у Модулі / Розширення → Модифікатори (Modifications) та натисніть синю кнопку «Оновити».

3. У розділі Система → Користувачі → Групи користувачів надайте права на перегляд і редагування для вашої групи адміністраторів:

   • extension/currency/bank_ua

   • extension/extension/currency

4. Перейдіть у Модулі / Розширення → Курси валют, встановіть та увімкніть модуль.

Модуль також доступний напряму через бічне меню: Система → Локалізація → Автооновлення валют.