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 Market in rubles, hrivnas, 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 a particular currency that can be used in the YML file.

The rate attribute specifies the exchange rate between the selected currency and the main 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 — Rate of the Central Bank of the Russian Federation.

  • NBU — Rate of the National Bank of Ukraine.

  • NBK — Rate of the National Bank of Kazakhstan.

  • СВ — the exchange rate for the bank of the country where the store is located as determined by the region that is specified in the personal account.

Only the following currencies may be specified as the main currency (for which the parameter rate="1" is set): Russian ruble (RUB), Belarusian ruble (BYN), Ukrainian hryvnia (UAH) or Kazakh 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%, but 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. This rule does not apply if you publish prices in Belarusian rubles.
Attention.

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