Требования

Допустимые форматы прайс-листа:

Форматы XLS, CSV

Форматы XLS, CSV удобны при генерации прайс-листа из базы данных или редакторов электронных таблиц (например: Exсel, OpenOffice, Google Docs).

    Требования к прайс-листу в форматах XLS, CSV

    1. Одна строка файла должна содержать описание одного предложения.

    2. Первая строка файла должна содержать названия полей.

    3. Кодировка файла должна быть UTF-8.

    4. Нельзя использовать табуляцию и перенос строки внутри полей.

    5. Файл не должен содержать пустых столбцов.

    6. Порядок столбцов (полей) не задан строго, но в пределах одного файла порядок столбцов (полей) должен быть одинаковым.

    7. В CSV качестве разделителя полей используется запятая или точка с запятой.

    Формат YML

    Стандарт YML (Yandex Market Language) разработан Яндексом и основан на стандарте XML.

      Требования к YML-файлу

      1. В YML нельзя использовать непечатаемые символы с ASCII-кодами от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки).

      2. Символы " & > < ' нужно заменять на эквивалентные коды:

        Символ в тексте

        Код для YML-файла

        "
        &
        >
        <
        '
        &quot;
        &amp;
        &gt;
        &lt;
        &apos;
        Примечание. Вы можете использовать символы "&><'в блоке CDATA в english-description, description.
      3. Допустимые кодировки YML-файла: UTF-8, windows-1251.

      Структура YML-файла

      <?xml version="1.0" encoding="UTF-8"?>
      <yml_catalog date="2017-02-05 17:22">
        <shop>
          <name>...</name>
          <company>...</company>
          <url>...</url>
          <currencies>
            <currency id="..." rate="..."/>
          </currencies>
          <categories>
            <category type="..." id="...">...</category>
          </categories>
          <offers>
            <offer>...</offer>
          </offers>
        </shop>
      </yml_catalog>
      ЭлементОписаниеОбязатель-ность
      xml headerСтандартный XML-заголовок. Должен начинаться с первой строки, с нулевого символа.Обязательно
      yml_catalogЛюбой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент <yml_catalog>. Атрибут date элемента <yml_catalog> должен соответствовать дате и времени генерации YML-файла на стороне магазина. Дата должна иметь формат YYYY-MM-DD hh:mm.Обязательно
      shop

      Информация о магазине и товары.

      Обязательно

      name

      Короткое название магазина, не более 20 символов. В названии нельзя использовать слова, не имеющие отношения к наименованию магазина, например «лучший», «дешевый», указывать номер телефона и т. п.

      Обязательно

      company

      Полное наименование компании, владеющей магазином.

      Обязательно

      url

      URL главной страницы магазина. Максимум 50 символов.

      Необязательно

      platform

      Система управления контентом, на основе которой работает магазин (CMS).

      Необязательно

      version

      Версия CMS.

      Необязательно

      agency

      Наименование агентства, которое оказывает техническую поддержку магазину и отвечает за работоспособность сайта.

      Необязательно

      email

      Контактный адрес разработчиков CMS или агентства, осуществляющего техподдержку.

      Необязательно

      currencies

      Список курсов валют магазина.

      Обязательно
      categories

      Список категорий магазина.

      Обязательно
      offers

      Товары магазина. Описание элементов, входящих в offers

      Обязательно

      Пример прайс-листа в YML

      <?xml version="1.0" encoding="UTF-8"?>
      <yml_catalog date="2018-02-05 17:22">
        <shop>
          <name>BestSeller</name>
          <company>Tne Best inc.</company>
          <url>http://best.seller.com</url>
          <currencies>
            <currency id="RUR" rate="1"/>
            <currency id="USD" rate="60"/>
          </currencies>
          <categories>
            <category type="1" id="1">Beauty & Health</category>
            <category type="1" id="2" parentId="1">Hair Care & Styling</category>
            <category type="1" id="3" parentId="2">Styling Products</category>
            <category type="1" id="4" parentId="3">Braid Maintenance</category>
          </categories>
          <offers>
            <offer id="12346">
              <english-name>INK small blue female bag</english-name>
              <name>Сумочка женская голубая от INK</name>
              <categoryId>1012345</categoryId>
              <price>1490</price>
              <oldprice>1620</oldprice>
              <currencyId>RUR</currencyId>
              <weight>1.2</weight>
              <cargo-type>100</cargo-type>
              <dimensions>50.5/25/75.2</dimensions>
              <picture>http://best.seller.com/img/large_12348.jpg</picture>
              <main-picture>http://best.seller.com/img/large_12443.jpg</main-picture>
              <vendor>INK</vendor>
              <english-description>
              <![CDATA[
                <p>Delicate female bag with a golden shoulder chain</p>
              ]]>
              </english-description>
              <description>Утонченная дамская сумочка с золотым ремешком 
               через плечо</description>
              <hs-code>1234567</hs-code>
              <param unit="Color">blue</param>
              <param unit="Season">summer</param>
              <group-id>1234567</group-id>
              <adult>false</adult>
            </offer>
          </offers>
        </shop>
      </yml_catalog>