You are browsing documentation for version 5.0 of OroCommerce, OroCRM, and OroPlatform, maintained until August 2024 and supported until March 2026. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.
See our Release Process documentation for more information on the currently supported and upcoming releases.
The multi-currency feature is available for the Enterprise Edition only. You can find a complete guide on multi-currency in multi-currency guide.
Currency configuration allows to track and record sales made in different currencies, specifically:
Create and manage the list of currencies available for selection in multi-currency fields, e.g., the opportunity budget.
Designate one base currency that serves as the default one for all multi-currency fields, in addition to being the currency to which values in other currencies are converted.
Manage exchange rate for all currencies to calculate opportunity budget, close revenue, etc., from the deal currency to the base currency.
Identify currencies in the system with a three-letter ISO code or a symbol.
At the organization level, it is possible only to remove unnecessary currencies, not add new ones.
To be able to manage currencies and change the rates:
Navigate to System > User Management > Organizations.
Select your organization and click Configuration in the top right corner.
In the left menu, click General Setup > Currency.
Unlock the currency grid by clearing the Use System checkbox.
Enter the numbers in the corresponding field of the Rate From/To columns.
In the following example, the base currency is US dollars, the currency format is set to Currency Symbol, and three deal currencies are set to Euro, British Pound, and Ukrainian Hryvnia.
These exchange rates to the base currency are used to calculate and convert the actual budget value, close revenue, the total number of orders (for OroCommerce), etc.
This is how the multi-currency feature is displayed in the Create Opportunity form:
You can select one of the enabled currencies in the currency selector for the Budget Amount field. They are represented by a currency symbol, as configured in the settings.
Note that you can specify the Close Revenue and the Budget Amount in different currencies.
As you can see from the screenshot, the budget amount entered in Euro (€15000) has been recalculated to the base currency ($16,350) according to the defined exchange rate.
The same budget amounts will be available in the grid view and Reports and Segments.
In dashboard widgets, only amounts in the base currency is displayed.
If you change the currency exchange rate, the changes will be displayed for all open opportunities. Rates for closed opportunities are fixed.
As you can see from the screenshots below, the rate of the Euro towards the US dollar was changed from 1.09 to 1.15. This consequently changed the value of the base currency for the budget amount from $16350 to $17250.
If you are not using the Opportunity Management Flow, you can edit the budget amount/close revenue for a closed opportunity.