Files
tryton/doc/usage.rst
T
2020-12-15 12:27:38 +00:00

38 lines
1.3 KiB
ReStructuredText

*****
Usage
*****
In order to perform conversions between currencies exchange rates must be
defined.
.. _Setting currency exchange rates:
Setting currency exchange rates
===============================
All the `Currency <model-currency.currency>` values are relative.
Best practice is to define which currency you want to use as the base currency
by setting its exchange `Rate <model-currency.currency.rate>` to 1 for the
date when it is first used.
Then the rates of all other currencies are set as a multiplier of the base
currency.
In order to set an exchange rate of ``1.0 EUR = 1.1222 USD`` for the 1st of
January the following records should be created:
* A rate of ``1.0`` for the :abbr:`EUR (Euro)` currency with the 1st of
January as the date.
* A rate of ``1.1222`` for the :abbr:`USD (US Dollar)` currency with the 1st
of January as the date.
If you then wanted to update the exchange rate to ``1.0 EUR = 1.1034 USD`` for
the 15th of January you just need to set the rate on the USD currency to
``1.1034`` for that date.
.. note::
In this example, as there isn't any rate set for the dates between the 2nd
and 14th of January the last available rate will be used.
Here this rate would be ``1.1222`` as this was the rate set for the 1st of
January.