# Импорт товаров 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
Стандартные элементы Описание Обязательность
vendor Название производителя. (Бренд) Необязательно
vendorCode Код производителя для данного товара. Необязательно
id Идентификатор предложения. Может состоять только из цифр и латинских букв. Максимальная длина — 20 символов. Должен быть уникальным для каждого предложения. В YML является атрибутом для offer. Подробное описание элемента. Обязательно
name Полное название предложения, в которое входит: тип товара, производитель, модель и название товара, важные характеристики. Составляйте по схеме: что (тип товара) + кто (производитель) + товар (модель, название) + важные характеристики. Обязательно
price Актуальная цена товара. Формат: целое или дробное число. Разделитель целой и дробной части — точка. Цена должна соответствовать стоимости товара, иначе магазин при проверке получит ошибку. Примечание. Если товар продается по весу, метражу и т. п. (не штуками), указывайте цену за вашу единицу продажи. Например, если вы продаете кабель бухтами, указывайте цену за бухту. Пример: 2000 Обязательно
oldprice Старая цена товара (Рекомендуемая цена), должна быть выше текущей. Маркет автоматически рассчитывает разницу и показывает пользователям скидку. Необязательно
categoryId Идентификатор категории товара, присвоенный магазином (целое число, не более 18 знаков). Обязательно
picture URL-ссылка на картинку товара. Рекомендуем ознакомиться с требованиями к ссылке и изображению. Обязательно
description Описание предложения. Длина текста не более 3000 символов (включая знаки препинания). В описании запрещено указывать: В формате YML допустимо использовать некоторые xhtml-теги при условии, что они заключены в блок CDATA и соблюдены общие правила стандарта XHTML. Подробное описание элемента. Необязательно
param Все важные характеристики товара — цвет, размер, объем, материал, вес, возраст, пол, и т. д. В YML элемент offer может содержать несколько элементов param (один элемент param — одна характеристика). Подробное описание элемента. Необязательно (не импортируется)
amount Количество товара Пример: 10 Необязательно
weight Вес товара в килограммах с учетом упаковки. Пример: 3.6 Необязательно
dimensions Габариты товара (длина, ширина, высота) в упаковке. Размеры укажите в сантиметрах.Формат: три положительных числа. Числа должны быть разделены символом «/» без пробелов. Пример: 20.1/20.551/22.5 Необязательно

Скачать пример полностью заполненного прайс-листа 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. Порядок столбцов (полей) не задан строго, но в пределах одного файла порядок столбцов (полей) должен быть одинаковым.
Описание полей формата CSV
Стандартные элементы Описание Обязательность
vendor Название производителя. (Бренд) Необязательно
vendorCode Код производителя для данного товара. Необязательно
id Идентификатор предложения. Может состоять только из цифр и латинских букв. Максимальная длина — 20 символов. Должен быть уникальным для каждого предложения.В YML является атрибутом для offer.Подробное описание элемента. Обязательно
name Полное название предложения, в которое входит: тип товара, производитель, модель и название товара, важные характеристики. Составляйте по схеме: что (тип товара) + кто (производитель) + товар (модель, название) + важные характеристики. Обязательно
price Актуальная цена товара.Формат: целое или дробное число.Разделитель целой и дробной части — точка.Цена должна соответствовать стоимости товара, иначе магазин при проверке получит ошибку.Примечание. Если товар продается по весу, метражу и т. п. (не штуками), указывайте цену за вашу единицу продажи. Например, если вы продаете кабель бухтами, указывайте цену за бухту.Пример: 2000 Обязательно
oldprice Старая цена товара (Рекомендуемая цена), должна быть выше текущей. Маркет автоматически рассчитывает разницу и показывает пользователям скидку. Необязательно
categoryId Идентификатор категории товара, присвоенный магазином (целое число, не более 18 знаков). Обязательно
picture URL-ссылка на картинку товара.Рекомендуем ознакомиться с требованиями к ссылке и изображению. Обязательно
description Описание предложения. Длина текста не более 3000 символов (включая знаки препинания).В описании запрещено указывать:В формате YML допустимо использовать некоторые xhtml-теги при условии, что они заключены в блок CDATA и соблюдены общие правила стандарта XHTML.Подробное описание элемента. Необязательно
param Все важные характеристики товара — цвет, размер, объем, материал, вес, возраст, пол, и т. д.В YML элемент offer может содержать несколько элементов param (один элемент param — одна характеристика).Подробное описание элемента. Необязательно
amount Количество товара Необязательно
weight Вес товара в килограммах с учетом упаковки. Необязательно
dimensions Габариты товара (длина, ширина, высота) в упаковке. Размеры укажите в сантиметрах.Формат: три положительных числа. Числа должны быть разделены символом «/» без пробелов. Необязательно

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

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

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

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

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

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