diff --git a/content/applications/sales/sales/products_prices/prices/currencies.rst b/content/applications/sales/sales/products_prices/prices/currencies.rst index 18ef334a0..0d18e51a4 100644 --- a/content/applications/sales/sales/products_prices/prices/currencies.rst +++ b/content/applications/sales/sales/products_prices/prices/currencies.rst @@ -1,49 +1,236 @@ -================================= -How to sell in foreign currencies -================================= +================== +Foreign currencies +================== -Pricelists can also be used to manage prices in foreign currencies. +With Odoo, pricelists can be used to manage prices in a number of foreign currencies. Specifically, +Odoo has the ability to work with 167 total currencies. -* Check *Allow multi currencies* in :menuselection:`Invoicing/Accounting --> Settings`. - As admin, you need *Adviser* access rights on Invoicing/Accounting apps. +.. note:: + In order to use multiple currencies in Odoo *Sales*, the *Accounting* application **must** be + installed. -* Create one pricelist per currency. A new *Currency* field shows up in pricelist setup form. +Settings +======== + +Once the *Accounting* app has been installed, foreign currencies can be added to the database. +Navigate to :menuselection:`Accounting app --> Configuration --> Settings`, scroll to the +:guilabel:`Currencies` section, and locate the :guilabel:`Main Currency` setting. + +.. image:: currencies/main-currency-setting-page.png + :align: center + :alt: How the main currency feature appears on settings page in Odoo Accounting. + +Odoo automatically sets the main currency as the currency of the country the company is based in. + +To change the main currency of the company, select the drop-down menu in the :guilabel:`Currency` +field, select the desired currency, and be sure to :guilabel:`Save` the changes. .. tip:: - To activate a new currency, go to :menuselection:`Accounting --> Configuration --> Currencies`, - select it in the list and press *Activate* in the top-right corner. Now it will show up in - currencies drop-down lists. + To ensure currency rates are updated automatically, enable the *automatic currency rates* feature + on the *Accounting* settings page (:menuselection:`Accounting app --> Configuration --> Settings + --> Currencies section`). -Prices in foreign currencies can be defined in two fashions. + .. image:: currencies/automatic-currency-rates.png + :align: center + :alt: How the main currency feature appears on settings page in Odoo Accounting. -Automatic conversion from public price -====================================== + Click the checkbox beside the :guilabel:`Automatic Currency Rates` feature, choose a designated + bank to get the currency rates from in the :guilabel:`Service` field drop-down menu, and select + an :guilabel:`Interval` of time for the updates to take place. Then determine when the date of + the :guilabel:`Next Run` should be. -The public price is in your company's main currency (see -:menuselection:`Accounting --> Settings`) and is set in product detail form. + To instantly update the currency rates, click the :guilabel:`🔁 (circular arrows)` icon, located + to the right of the :guilabel:`Next Run` field. -.. image:: currencies/public_price.png + When all configurations are complete, be sure to :guilabel:`Save` all changes. + +.. note:: + All payment methods **must** be in the same currency as the sales journal, or the company + currency, if the company currency is not set. If it is not the same, a :guilabel:`Validation + Error` message appears. + +View, edit, and add currencies +============================== + +To view, edit, and add currencies to the database, making them available on pricelists and on the +:guilabel:`Main Currency` drop-down menu, click the :guilabel:`Currencies` link, located beneath the +:guilabel:`Currency` field on the :menuselection:`Accounting app --> Settings` page. + +When the :guilabel:`Currencies` link is clicked, a separate :guilabel:`Currencies` page is revealed. + +.. image:: currencies/main-currencies-page.png :align: center + :alt: How the main currencies page appears in Odoo Accounting. -The conversion rates can be found in -:menuselection:`Accounting --> Configuration --> Currencies`. They can be updated -from Yahoo or the European Central Bank at your convenience: manually, daily, weekly, -etc. See :menuselection:`Accounting --> Settings`. +On this page, Odoo provides a master list of 167 global currencies. Each row shows the corresponding +:guilabel:`Currency`, :guilabel:`Symbol`, :guilabel:`Name`, date of the :guilabel:`Last Update`, and +:guilabel:`Current Rate` (compared to the default currency of the country in which the company is +based). -.. image:: currencies/currency_rate.png +To the far right, there are two columns, which can be toggled on or off: + +- :guilabel:`Use on eBay`: this currency can be used with the connected eBay account (if + applicable). +- :guilabel:`Active`: this currency is activated, which means it can be added to a pricelist, or + used as the main currency of the company, if desired (via :menuselection:`Accounting app --> + Configuration --> Settings --> Currencies section`). + +.. note:: + By default, all the :guilabel:`Active` currency options are at the top of the list. + +.. tip:: + It is recommended that *at least* one pricelist is created per :guilabel:`Active` currency. See + :doc:`./pricing` to learn more about pricelist configuration. + +To toggle options on/off, click the toggle switch in the row for the corresponding column. When *on* +the color of the switch is green. When *off*, the color of the switch is grey. + +Currency detail form +-------------------- + +To edit any currency on the :guilabel:`Currencies` page, click the desired currency to reveal the +detail form for that specific currency, and proceed to make any necessary changes. + +.. image:: currencies/currency-detail-form.png :align: center + :alt: How a currency detail form looks in Odoo Accounting. -.. image:: currencies/prices_conversion.png +On the currency detail form, the relevant currency code appears in the :guilabel:`Currency` field. +Beneath that, the name for the currency is in the :guilabel:`Name` field. + +Then, toggle the currency's availability with the :guilabel:`Active` toggle: *on* is indicated with +a green switch, and *off* is indicated with a grey switch. + +On the right of the currency detail form, the appropriate :guilabel:`Currency Unit` (e.g. `Dollars`) +and :guilabel:`Currency Subunit` (e.g. `Cents`) can be found. + +If the currency is meant to be used for eBay purposes, toggle the :guilabel:`Use on eBay` option to +the desired activation. + +Next, under the :guilabel:`Rates` tab, the various conversion rates can be viewed, added, or +deleted. Each row shows the :guilabel:`Date` of that specific rate, the :guilabel:`Company` to which +it is connected, followed by the :guilabel:`Unit per...` and :guilabel:`...per Unit`. + +.. note:: + The *...* in each of the last two columns represents the main currency set for the company. For + example, if the main currency is set to `USD`, the columns are titled :guilabel:`Unit per USD` + and :guilabel:`USD per Unit`. + +To add a new rate, click :guilabel:`Add a line` in the :guilabel:`Rates` tab, and proceed to fill in +the necessary information in the aforementioned columns. + +Main currency detail form +------------------------- + +If the selected currency is the main currency of the company, a blue banner appears at the top of +the currency detail form with the message: :guilabel:`This is your company's currency.`. + +.. image:: currencies/main-currency-detail-form.png :align: center + :alt: How a main currency detail form looks in Odoo Accounting. -Set your own prices +All the fields are the same as a typical currency detail form, but there will **not** be a +:guilabel:`Rates` tab because all other currency rates are based off the main currency of the +company. + +Create new currency =================== -This is advised if you don't want your pricing to change along with currency rates. +If a desired currency isn't on the :guilabel:`Currencies` page, click the :guilabel:`New` button to +open a blank currency template form. -.. image:: currencies/pricing_currency.png +.. tip:: + The same :guilabel:`New` button is located in the upper-right corner of any currency detail form. + +.. image:: currencies/blank-currency-detail-form.png :align: center + :alt: How a blank currency detail form looks in Odoo Accounting. + +On the blank currency detail form, proceed to enter the desired currency code in the +:guilabel:`Currency` field. Beneath that, enter the name for the currency in the :guilabel:`Name` +field. + +Then, toggle the currency's availability with the :guilabel:`Active` toggle switch. + +On the right of the currency detail form, enter the appropriate :guilabel:`Currency Unit` (e.g. +`Dollars`) and appropriate :guilabel:`Currency Subunit` (e.g. `Cents`). + +If the currency is meant to be used for eBay purposes, toggle the :guilabel:`Use on eBay` to the +desired activation. + +Next, under the :guilabel:`Rates` tab, add a new rate by clicking :guilabel:`Add a line`. Then, +proceed to confirm and adjust the :guilabel:`Date`, :guilabel:`Company`, :guilabel:`Unit per...`, +and :guilabel:`...per Unit` fields to ensure all the auto-populated information is accurate. + +.. note:: + The *...* in each of the last two columns represents the main currency set for the company. For + example, if the main currency is set to `USD`, the columns are titled :guilabel:`Unit per USD` + and :guilabel:`USD per Unit`. + +Currency-specific pricelists +============================ + +It is recommended that *at least* one pricelist is created per active currency in the database. To +create (or assign) a pricelist to a specific currency, start by navigating to :menuselection:`Sales +app --> Products --> Pricelists`. + +From the :guilabel:`Pricelists` page, either select an existing pricelist to edit, or click +:guilabel:`New` to create a new pricelist. + +On the pricelist detail form, for either a new or existing pricelist, adjust the +:guilabel:`Currency` field as desired. .. seealso:: + :doc:`./pricing` to learn more about pricelist configuration. - * :doc:`pricing` +Auto-conversion from public price +================================= + +It should be noted that the public price seen on products is directly related to the main currency +the company has set, which is configured by navigating to :menuselection:`Accounting app --> +Configuration --> Settings --> Currencies section --> Main Currency --> Currency drop-down menu`. + +The sales price automatically updates if the pricelist is changed to a different pricelist that has +a different currency than the company's main currency. The change in price is directly related to +the updated conversion rate for that currency. + +Set product prices +================== + +In order to have product prices set in place to avoid any changes in currency rates, start by +navigating to :menuselection:`Sales app --> Products --> Products`. + +From the :guilabel:`Products` page, select the desired product to modify. Or, create a new product +by clicking the :guilabel:`New` button. + +Then, on the product detail form, click the :guilabel:`Extra Prices` smart button, located in the +upper-left corner. Doing so reveals a separate :guilabel:`Price Rules` page, specific to that +particular product. + +.. image:: currencies/price-rules-currencies.png + :align: center + :alt: How to set product prices based on foreign currency pricelists in Odoo Sales. + +Click :guilabel:`New`, and select the desired pricelist from the drop-down menu in the +:guilabel:`Pricelist` column. + +The :guilabel:`Applied On` field is auto-populated with the product, so proceed to enter in the +desired figures in the :guilabel:`Min. Quantity` and :guilabel:`Price` fields. + +.. note:: + The figure in the :guilabel:`Min. Quantity` field means the :guilabel:`Price` being set will + **only** trigger if at least that amount of product is purchased. + +If necessary, configure a :guilabel:`Start Date` and :guilabel:`End Date` for the set prices. +Leaving those columns blank ensures the set price will remain valid, regardless of the date of sale. + +If working in a multi-company environment, designate to which company this price rule should be +applied in the :guilabel:`Company` field. Leaving that field blank ensures the price rule applies to +all companies in the database. + +With those configurations complete, regardless of any changes/updates in conversion, whenever those +designated pricelists are applied to a customer trying to purchase this specific product, these +pre-determined set prices appear. + +.. seealso:: + :doc:`./pricing` diff --git a/content/applications/sales/sales/products_prices/prices/currencies/automatic-currency-rates.png b/content/applications/sales/sales/products_prices/prices/currencies/automatic-currency-rates.png new file mode 100644 index 000000000..c512686e8 Binary files /dev/null and b/content/applications/sales/sales/products_prices/prices/currencies/automatic-currency-rates.png differ diff --git a/content/applications/sales/sales/products_prices/prices/currencies/blank-currency-detail-form.png b/content/applications/sales/sales/products_prices/prices/currencies/blank-currency-detail-form.png new file mode 100644 index 000000000..92bf9d7b4 Binary files /dev/null and b/content/applications/sales/sales/products_prices/prices/currencies/blank-currency-detail-form.png differ diff --git a/content/applications/sales/sales/products_prices/prices/currencies/currency-detail-form.png b/content/applications/sales/sales/products_prices/prices/currencies/currency-detail-form.png new file mode 100644 index 000000000..1b1281fd5 Binary files /dev/null and b/content/applications/sales/sales/products_prices/prices/currencies/currency-detail-form.png differ diff --git a/content/applications/sales/sales/products_prices/prices/currencies/currency_rate.png b/content/applications/sales/sales/products_prices/prices/currencies/currency_rate.png deleted file mode 100644 index e8cc32bf8..000000000 Binary files a/content/applications/sales/sales/products_prices/prices/currencies/currency_rate.png and /dev/null differ diff --git a/content/applications/sales/sales/products_prices/prices/currencies/main-currencies-page.png b/content/applications/sales/sales/products_prices/prices/currencies/main-currencies-page.png new file mode 100644 index 000000000..43dce08e2 Binary files /dev/null and b/content/applications/sales/sales/products_prices/prices/currencies/main-currencies-page.png differ diff --git a/content/applications/sales/sales/products_prices/prices/currencies/main-currency-detail-form.png b/content/applications/sales/sales/products_prices/prices/currencies/main-currency-detail-form.png new file mode 100644 index 000000000..ca5f212b9 Binary files /dev/null and b/content/applications/sales/sales/products_prices/prices/currencies/main-currency-detail-form.png differ diff --git a/content/applications/sales/sales/products_prices/prices/currencies/main-currency-setting-page.png b/content/applications/sales/sales/products_prices/prices/currencies/main-currency-setting-page.png new file mode 100644 index 000000000..00be2f58e Binary files /dev/null and b/content/applications/sales/sales/products_prices/prices/currencies/main-currency-setting-page.png differ diff --git a/content/applications/sales/sales/products_prices/prices/currencies/price-rules-currencies.png b/content/applications/sales/sales/products_prices/prices/currencies/price-rules-currencies.png new file mode 100644 index 000000000..c20db4210 Binary files /dev/null and b/content/applications/sales/sales/products_prices/prices/currencies/price-rules-currencies.png differ diff --git a/content/applications/sales/sales/products_prices/prices/currencies/prices_conversion.png b/content/applications/sales/sales/products_prices/prices/currencies/prices_conversion.png deleted file mode 100644 index df546c853..000000000 Binary files a/content/applications/sales/sales/products_prices/prices/currencies/prices_conversion.png and /dev/null differ diff --git a/content/applications/sales/sales/products_prices/prices/currencies/pricing_currency.png b/content/applications/sales/sales/products_prices/prices/currencies/pricing_currency.png deleted file mode 100644 index 4f9ffffec..000000000 Binary files a/content/applications/sales/sales/products_prices/prices/currencies/pricing_currency.png and /dev/null differ diff --git a/content/applications/sales/sales/products_prices/prices/currencies/public_price.png b/content/applications/sales/sales/products_prices/prices/currencies/public_price.png deleted file mode 100644 index d4ff4f068..000000000 Binary files a/content/applications/sales/sales/products_prices/prices/currencies/public_price.png and /dev/null differ