currencies
The currencies
element sets a list of the store's exchange rates. Each currency is described in a separate currency
element.
Pricing information can be displayed in Russian rubles (RUB), Ukrainian hryvnias (UAH), Belarusian rubles (BYN), Kazakh tenge (KZT), U.S. dollars (USD), and euros (EUR). Prices can be displayed on Yandex.Market in rubles, hryvnias, Belarusian rubles, and tenge, depending on the user's region.
If your YML file does not specify an exchange rate for the currency displayed to the buyer, then the exchange rate of the Central Bank of the country indicated in the store settings will be used. The current day's exchange rate is applied. The exchange rate is updated daily at 00:00.
- Example
-
<currencies> <currency id="RUR" rate="1"/> <currency id="USD" rate="23.98"/> <currency id="EUR" rate="CBRF"/> <currency id="UAH" rate="NBU"/> <currency id="KZT" rate="CB"/> </currencies>
The id
attribute of the currency
element specifies the code of one or more currencies that can be used in the YML file.
The rate
attribute specifies the exchange rate of the selected currency against the base currency taken as a unit (currency for which rate="1"
). The rate
parameter can have the following values:
Constant number: the internal exchange rate that you use.
CBRF: the rate of the Central Bank of the Russian Federation.
NBU: the rate of the National Bank of Ukraine.
NBK: the rate of the National Bank of Kazakhstan.
СВ: the exchange rate of the central bank of the country where the store is located as determined by the region specified in the personal account.
Only the following currencies can be specified as the base currency (for which rate="1"
is set): Russian ruble (RUB), Belarusian ruble (BYN), hryvnia (UAH), or tenge (KZT).
- Example
-
The USD and EUR exchange rates are the ones provided by the National Bank of Ukraine.
<currencies> <currency id="UAH" rate="1"/> <currency id="USD" rate="NBU"/> <currency id="EUR" rate="NBU"/> </currencies>
- Example
-
The rate for USD is the rate of the Central Bank of the Russian Federation + 3%.
<currencies> <currency id="RUR" rate="1"/> <currency id="USD" rate="CBRF" plus="3"/> <currency id="EUR" rate="CBRF" plus="3"/> ... </currencies>
- Example
-
The rate for USD is the rate of the National Bank of Ukraine + 1%, while the rate for EUR is the rate of the NBU + 3%.
<currencies> <currency id="UAH" rate="1"/> <currency id="USD" rate="NBU" plus="1"/> <currency id="EUR" rate="NBU" plus="3"/> ... </currencies>
All numbers in YML use the dot as the decimal separator, regardless of regional settings (never use the comma).