The multi-price datatype allows you to set prices in multiple currencies for each product. If you use for example five currencies then a product will always have five prices. However, you don't have to enter all these prices manually although it is possible. It is required that you specify at least one price per product which is called base custom price ( base price for short). The system will automatically convert it using the appropriate rates in order to calculate prices in other currencies (the rest four prices in our example). These are called auto prices. In contrast to these, prices that are specified manually are called custom prices.

Custom prices are fully independent of the currency rates. By saying "base custom price" we mean a special custom price that is used for calculating the auto prices. All other custom prices will be called non-base. Please note that non-base custom prices are independent of the base price. If you change the base price, the system will automatically update all the auto prices for this product but not the custom prices. If you change a non-base custom price, no automatic updates will be done.

The auto prices are usually marked as "(Auto)" in the object edit interface while the custom prices aren't. There is no special mark for a base custom price because this value usually comes right after the auto prices and right before the non-base custom prices (if there are any).

If you are not satisfied with the auto price value in some particular currency, you can set a non-base custom price instead. This value will be independent of the base price.

If you remove a non-base custom price, the system will create an auto price in this currency.

If you remove the base price, the system will do the following:

•  Set the earliest non-base custom price as a new base price.
•  Remove the old base price and create a new auto price instead.
•  Update all the auto prices in accordance with the new base price.

It is recommended that each product has at least one custom price. If you remove all the custom prices for a product, the system will use zero auto prices in all currencies for this product.

Example

Let's say that you use three currencies with the rates indicated in the following table.

If you specify for example 10€ as the base price, the system will automatically calculate two auto prices for this product (look at the next screenshot).

Product Multi Price

These auto prices are calculated by converting 10€ to USD and British Pound:

•  USD/EUR cross rate = 1.5 / 1 = 1.5
•  price in USD = 10*1.5=15
•  GBP/EUR cross rate = 1.35 / 1 = 1.35
•  price in GBP = 10*1.35=13.5

If you think that this product costs much more in some particular countries, for example in Brazil, you can set the desired price by creating a custom price in BRL. The result is shown in the following screenshot.
 

Setting Custom Price

 As you can see from the screenshot above, there are two custom prices (base 10€ and non-base 25BRL) and two auto prices (13.5GBP and 15USD). Please note that you can always remove non-base custom prices, so that the system will automatically set auto prices instead.

If you remove the base price (10€), the non-base custom price (25BRL) will become new base price, and the system will automatically update the auto prices.