Currency Rate Update: National Bank of the Republic of Belarus
This module allows automatic download of currency exchange rates from the National Bank of the Republic of Belarus (NBRB) using their official API.
The module provides daily exchange rates for 26+ currencies including USD, EUR, RUB, CNY, and others, directly from the central bank's official source.
auto_awesome What this module does
AI-generated from the code · Odoo 19.0Adds the National Bank of the Republic of Belarus (NBRB) as a source for automatic currency exchange rate downloads in Odoo, covering around 27 currencies including USD, EUR, RUB and CNY.
This module plugs the Belarusian central bank into Odoo's existing currency rate update feature. Once installed, users configuring a currency rate provider can pick "National Bank of the Republic of Belarus (NBRB)" as the service, and Odoo will fetch the official daily rates from the NBRB website instead of asking for them manually.
The provider declares which currencies it can supply: AUD, BGN, UAH, DKK, USD, EUR, PLN, IRR, ISK, JPY, CAD, CNY, KWD, MDL, NZD, NOK, RUB, XDR, SGD, KGS, KZT, TRY, GBP, CZK, SEK, CHF and BYN. When rates are downloaded, the Belarusian ruble (BYN) is treated as the reference currency; if the company's base currency is something else, the module converts the rates accordingly so they stay consistent with the company setup.
Business rules and automatic behaviour: - Rates are retrieved from the NBRB public service and stored per date, using the date published by the bank. - Currencies the bank does not publish are skipped with a warning rather than blocking the update. - If the connection fails or the returned data cannot be read, the user sees a clear error message instead of a silent failure.
The module does not add menus or screens of its own; it extends the currency rate provider configuration (res.currency.rate.provider) and relies on the scheduled update mechanism of the base currency rate update module to run the downloads.
Depends on
Models and fields (1)
- res.currency.rate.provider · extends an existing modelservice
Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 2 confirmed, 7 with no information of 9 versions.
Sources · Odoo 18.0
Confirmed on 2026-11-03 in branch 18.0 of OCA/l10n-belarus.
terminal Installation and usage
OCA documentation · Odoo 19.0Installation
Source · Odoo 19.0This module depends on currency_rate_update from the OCA/currency repository.
Make sure you have this module installed before installing currency_rate_update_nbrb.
No additional Python dependencies are required - the module uses only Python standard library.
Configuration
Source · Odoo 19.0To configure currency rate updates from NBRB:
- Go to Accounting → Configuration → Currency Rate Providers
- Click Create to create a new provider
- Select National Bank of Belarus (NBRB) as the service
- Choose which currencies you want to automatically update
- Configure the update schedule (e.g., daily at 9:00 AM)
- Save the configuration
The module will automatically fetch exchange rates from NBRB on the scheduled time.
You can also manually trigger an update by clicking the Update Now button on the provider record.
Usage
Source · Odoo 19.0After configuration, the module works automatically:
- Exchange rates are updated according to your configured schedule
- You can view update history in the provider's logs
- Manual updates can be triggered anytime
- All rates are official NBRB rates
Supported currencies: AUD, BGN, UAH, DKK, USD, EUR, PLN, IRR, ISK, JPY, CAD, CNY, KWD, MDL, NZD, NOK, RUB, XDR, SGD, KGS, KZT, TRY, GBP, CZK, SEK, CHF, BYN
Data source: https://www.nbrb.by/API/ExRates/Rates
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.