Маркет для магазинов

currencies

Элемент <currencies> задает список курсов валют магазина. Каждая из валют описывается отдельным элементом <currency>.

Данные о ценах принимаются в рублях (RUR, RUB), гривнах (UAH), белорусских рублях (BYN), тенге (KZT), долларах (USD) и евро (EUR). На Маркете цены могут отображаться в рублях, гривнах, белорусских рублях и тенге в зависимости от региона пользователя.

Примечание. 

Если вы передаете цены в белорусских рублях, используйте для них валюту BYN — новые белорусские рубли (один новый белорусский рубль равен 10 000 старых: 1 BYN = 10 000 BYR).

Если в вашем YML-файле не задан курс для отображаемой покупателю валюты, то используется курс Центрального Банка той страны, которая указана в настройках магазина. Применяется курс, установленный на текущий день. Курс обновляется ежедневно в 00.00.

Пример

<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>

Атрибут id элемента <currency> указывает код одной или нескольких валют, которые могут быть использованы в YML-файле.

Атрибут rate указывает курс валюты к курсу основной валюты, взятой за единицу (валюта, для которой rate="1"). Параметр rate может иметь следующие значения:

  • Постоянное число — внутренний курс, который вы используете.

  • CBRF — курс по Центральному банку РФ.

  • NBU — курс по Национальному банку Украины.

  • NBK — курс по Национальному банку Казахстана.

  • СВ — курс по банку той страны, к которой относится магазин по своему региону, указанному в личном кабинете.

В качестве основной валюты (для которой установлено rate="1") могут быть использованы только рубль (RUR, RUB), белорусский рубль (BYN
[no-highlight[

BYN — новые белорусские рубли. Один новый белорусский рубль равен 10 000 старых (1 BYN = 10 000 BYR).

]no-highlight]
), гривна (UAH) или тенге (KZT).
Пример

Курс USD и EUR соответствуют курсу Национального банка Украины.

<currencies>
    <currency id="UAH" rate="1"/>
    <currency id="USD" rate="NBU"/>
    <currency id="EUR" rate="NBU"/>
</currencies>

Пример

Курс USD соответствует курсу ЦБ РФ + 3%.

<currencies>
    <currency id="RUR" rate="1"/>
    <currency id="USD" rate="CBRF" plus="3"/>
    <currency id="EUR" rate="CBRF" plus="3"/>
    ...
</currencies>

Пример

Курс USD соответствует курсу НБУ + 1%, а курс EUR — курсу НБУ + 3%.

<currencies>
    <currency id="UAH" rate="1"/>
    <currency id="USD" rate="NBU" plus="1"/>
    <currency id="EUR" rate="NBU" plus="3"/>
    ...
</currencies>

Внимание! Если установленный курс валюты превышает курс ЦБ РФ или НБУ в 2 раза и более, данные считаются невалидными. Правило не применяется, если вы передаете цены в белорусских рублях.
Внимание! 

В качестве разделителя целой и дробной частей любых чисел в YML независимо от региональных установок используется точка (не запятая!).

Примеры YML:

Магазин передает цены в гривнах.

<?xml version="1.0" encoding="windows-1251"?>
<yml_catalog date="2009-05-19 16:02">
  <shop>
    <name>Магазин</name>
    <company>Магазин</company>
    <url>www.magazin.ua</url>
    <currencies>
      <currency id="UAH" rate="1"/>
    </currencies>
    <categories>
      <category id="1">Вентиляторы</category>
    </categories>
    <offers>
      <offer id="111" type="vendor.model" available="true" bid="10">
        <url>http://www.magazin.ua/price.php?id=88521</url>
        <price>811.00</price>
        <currencyId>UAH</currencyId>
        <categoryId>1</categoryId>
        <typePrefix>Вентилятор</typePrefix>
        <vendor>UFO</vendor>
        <vendorCode>12345</vendorCode>
        <model>ATTFI-02</model>
        <description>Отличный вентилятор для домашнего использования.</description>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Магазин передает цены в долларах и использует внутренний курс пересчета 25 гривен за доллар.

<?xml version="1.0" encoding="windows-1251"?>
<yml_catalog date="2009-05-19 16:02">
  <shop>
    <name>Магазин</name>
    <company>Магазин</company>
    <url>www.magazin.ua</url>
    <currencies>
      <currency id="UAH" rate="1"/>
      <currency id="USD" rate="25"/>
    </currencies>
    <categories>
      <category id="1">вентиляторы</category>
    </categories>
    <offers>
      <offer id="111" type="vendor.model" available="true" bid="10">
        <url>http://www.magazin.ua/price.php?id=88521</url>
         <price>115.85</price>
         <currencyId>USD</currencyId>
         <categoryId>1</categoryId>
         <typePrefix>Вентилятор</typePrefix>
         <vendor>UFO</vendor>
         <vendorCode>12345</vendorCode>
         <model>ATTFI-02</model>
         <description>Отличный вентилятор для домашнего использования.</description>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Оцініть статтю
Дякуємо за ваш відгук!