Импорт товаров YML

Загрузка файла импорта

  • Чтобы импортировать или экспортировать данные, откройте страницу Администрирование → Импорт данных → Товары.
  • Нажмите на кнопку +, чтобы добавить новый файл импорта.
  • Введите название импорта (по нему вы потом сможете находить этот импорт среди других) и нажмите кнопку "Сохранить".

Импорт товаров YML

Вы можете:

  • Загрузить файл импорта в формате: yml, xml, csv;
  • Указать ссылку на файл импорта.

Сопоставление категорий

После загрузки категорий вам необходимо сопоставить категории из вашего файла импорта с категориями СДЭК.МАРКЕТ. Функционал сопоставления категорий и характеристик невероятно удобный механизм для обработки тысячи товаров одним пользователем за короткий промежуток времени.

После того, как Вы загрузили прайс - листы поставщиков, Вам необходимо сопоставить категории Вашего интернет магазина или прайса поставщика с категориями СДЭК.МАРКЕТ.

Сопоставление категорий

Сделать это просто:

  1. Выберите релевантную категорию на маркетплейсе.
    Наша система подбирает категории в автоматическом режиме по однокоренным словам или словосочетаниям и подставляет значение без Вашего участия, но Вам необходимо проверить, правильно ли сработало автоматическое сопоставление, так как наш бот может ошибиться.
  2. После сопоставления всех категорий нажмите кнопку "Сохранить", после чего запуститься процесс сопоставления категорий.

Если вы не укажите категории при сопоставлении, то все товары попадут в общую категорию Products и покупатели не смогут увидеть ваши товары.

Статусы импорта

После того, как вы добавите новый импорт запуститься процесс импорта ваших товаров.

  • Валидация - проверка YML файла на соответствие правилам;
  • Загрузка категорий - загрузка списка категорий из файла импорта для сопоставления;
  • Импорт товаров - этап загрузки товаров;
  • Сопоставление категорий - процесс сопоставление категорий из вашего файла с категориями СДЭК.МАРКЕТ.
  • Загрузка изображений - процесс загрузки основных и дополнительных изображенй товаров.

Ошибки при импорте товаров

Прайс-лист с данными, размещенный на сайте магазина, при загрузке автоматически проверяется на предмет соответствия техническим требованиям. Если на этапе Валидации в файле импорта будут обноружены ошибки, то появится отдельная вкладка с списком ошибок.

Допускается наличие до 20 ошибок в файле импорта. Товары с ошибками будут пропущены автоматически.

Обновление файла импорта с товарами на СДЭК.МАРКЕТ происходит во время обновления файла импорта (но не чаще 1 раза в час). При проведении технических работ время индексации может увеличиться. Индексация производится не по расписанию.

Формат YML

Стандарт YML (Yandex Market Language) разработан Яндексом и основан на стандарте XML. Формат YML предоставляет больше возможностей и преимуществ, чем форматы XLS, CSV.

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

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

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

Символ в тексте Код для YML-файла
" &quot;
& &amp;
> &gt;
< &lt;
' &apos;
  1. Допустимые кодировки YML-файла: UTF-8, windows-1251.

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

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2019-10-31 17:22">
  <shop>
    ...
    <offers>
      ...     
    </offers>
    <gifts>
      ...
    </gifts>
    <promos>
      ...
    </promos>
  </shop>
</yml_catalog>
Посмотреть пример полного YML
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2017-02-05 17:22">
    <shop>
    <name>BestSeller</name>
    <company>Tne Best inc.</company>
    <url>http://best.seller.ru</url>
    <currencies>
      <currency id="RUR" rate="1"/>
      <currency id="USD" rate="60"/>
    </currencies>
    <categories>
      <category id="1">Бытовая техника</category>
      <category id="10" parentId="1">Мелкая техника для кухни</category>
      <category id="101" parentId="10">Сэндвичницы и приборы для выпечки</category>
      <category id="102" parentId="10">Мороженицы</category>
    </categories>
    <delivery-options>
      <option cost="300" days="0" order-before="12"/>
    </delivery-options>
    <offers>
      <offer id="12346" bid="80">
        <name>Вафельница First FA-5300</name>
        <vendor>First</vendor>
        <vendorCode>A1234567B</vendorCode>
        <url>http://best.seller.ru/product_page.asp?pid=12348</url>
        <price>1490</price>
        <oldprice>1620</oldprice>
        <currencyId>RUR</currencyId>
        <categoryId>101</categoryId>
        <picture>http://best.seller.ru/img/large_12348.jpg</picture>
        <store>false</store>
        <pickup>true</pickup>
        <delivery>true</delivery>
        <delivery-options>
          <option cost="300" days="0" order-before="12"/>
        </delivery-options>
        <description>
        <![CDATA[
          <p>Отличный подарок для любителей венских вафель.</p>
        ]]>
        </description>
        <sales_notes>Необходима предоплата.</sales_notes>
        <manufacturer_warranty>true</manufacturer_warranty>
        <country_of_origin>Россия</country_of_origin>
        <barcode>0156789012</barcode>
      </offer>
      <offer id="9012" type="vendor.model" bid="80">
        <typePrefix>Мороженица</typePrefix>
        <vendor>Brand</vendor>
        <model>3811</model>
        <url>http://best.seller.ru/product_page.asp?pid=12345</url>
        <price>8990</price>
        <oldprice>9900</oldprice>
        <currencyId>RUR</currencyId>
        <categoryId>102</categoryId>
        <picture>http://best.seller.ru/img/model_12345.jpg</picture>
        <store>false</store>
        <pickup>false</pickup>
        <delivery>true</delivery>
        <delivery-options>
          <option cost="300" days="1" order-before="18"/>
        </delivery-options>
        <description>
        <![CDATA[
          <h3>Мороженица Brand 3811</h3>
          <p>Это прибор, который придётся по вкусу всем любителям десертов и сладостей, ведь с его помощью вы сможете делать вкусное домашнее мороженое из натуральных ингредиентов.</p>
        ]]>
        </description>
        <param name="Цвет">белый</param>
        <sales_notes>Необходима предоплата.</sales_notes>
        <manufacturer_warranty>true</manufacturer_warranty>
        <country_of_origin>Китай</country_of_origin>
        <barcode>0123456789379</barcode>
      </offer>
    </offers>
  </shop>
</yml_catalog> 

Скачать пример полностью заполненного прайс-листа yml

Дополнительные поля импорта YML и CSV

Для указания количества товара в YML файле вы можете использовать тег amount который должен находиться внутри тега offer. Пример: <amount>10</amount> Для указания количества в CSV файле у вас должен быть указан столбец с названием amount.

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

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

  1. Одна строка файла должна соответствовать одной строке электронной таблицы.

  2. В качестве разделителя полей используется запятая или точка с запятой (CSV) либо символ табуляции (TSV).

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

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

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

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

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

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

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

Скачать пример с предложениями упрощенного типа

Скачать пример с предложениями произвольного типа

Подробнее о форматах YML вы можете ознакомиться по ссылке: Форматы YML и CSV.