# Импорт товаров YML, CSV

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

  • Чтобы импортировать данные, откройте страницу Администрирование → Импорт данных → Импорт товаров.
  • Выберите подходящий способ загрузки файла импорта: по ссылке или загрузив файл в формате: yml, xml, csv с компьютера.
  • Ознакомьтесь с ограничениями и нажмите кнопку "Сохранить".
  • После завершения сопоставления категорий и настроек импорта нажмите кнопку "Запустить".

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

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

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

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

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

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

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

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

# Импорт характеристик

Используйте элемент param для передачи характеристик и параметров товара, например: цвета, размера, материала и т. д. Рекомендуем указывать параметры для всех товаров, чтобы они попадали в результаты фильтрации.

# YML

Один элемент <param> описывает одну характеристику, при этом элемент <offer> может содержать любое количество <param>.

Пример

<offer>
    <!-- элементы, входящие в offer -->
    <param name="Размер экрана" unit="дюйм">27</param>
    <param name="Материал">алюминий</param>
    <param name="Wi-Fi">есть</param>
</offer>
  • В атрибуте name укажите название параметра (обязательно).

  • В самом элементе <param>...</param> укажите значение параметра.

# Импорт вариаций

Если существует несколько предложений, которые являются цвето-размерными вариациями одного товара, то в YML-файле необходимо создавать описание каждого варианта в отдельном элементе <offer> — в одном размере и в одном цвете.

Чтобы все варианты попали на правильную карточку товара, в описании каждого предложения нужно использовать атрибут group_id. Значение атрибута должно быть целым числом, максимум 9 разрядов. Для всех предложений, относящихся к одному товару, должно быть указано одинаковое значение атрибута group_id. При этом недопустимо указывать такое же значение для предложений, не относящихся к этому товару. Например, если продаваемое вами платье доступно в 3 различных цветах и каждый цвет при этом доступен в 4 размерах, то вы должны составить описания 12 предложений, указывая в каждом из них одинаковый group_id.

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

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

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

  • Активный - импорт запущен и выполняется.
  • Валидация - проверка YML файла на соответствие правилам;
  • Обработка категорий - загрузка списка категорий из файла импорта для сопоставления;
  • Обработка товаров - этап загрузки товаров;
  • Обработка изображений - процесс загрузки основных и дополнительных изображений товаров;
  • Ошибка - в вашем файле импорта обнаружены ошибки.

# Настройки импорта

Указав дополнительные настройки импорта Вы можете изменить статус импортируемых товаров, задать период обновления файла импорта или изменить цену и количество товаров.

Настройки импорта

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

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

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

# Формат 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>
        <weight>3.6</weight>
        <dimensions>20.1/20.551/22.5</dimensions>
      </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>
        <weight>2.7</weight>
        <dimensions>22.1/20.551/22.5</dimensions>
      </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.

# Платная техническая поддержка

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