currencies

Note. This element is used only in the YML format.

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>
Attention. If the specified currency exchange rate exceeds the exchange rate of the Central Bank of the Russian Federation or the National Bank of Ukraine by a factor of two times, the data will be considered invalid.
Attention.

All numbers in YML use the dot as the decimal separator, regardless of regional settings (never use the comma).