Загрузить товары по ссылке на YML-файл

Как создать файл

• создать файл вручную;
• создать файл с помощью сервисов генерации YML-файлов;
• использовать готовый из другого маркетплейса;
• выгрузить файл из своей системы.

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

• Формат файла должен быть текстовый (не двоичный или бинарный).
• Допустимые кодировки YML-файла: UTF-8.
• Максимальный размер YML-файла — 256 МБ.
• Файл должен загружаться за 1 минуту.
• Элементы можно передавать по названию или как атрибут элемента <param>. Например, <name>…​</name> это то же самое, что <param name="…​">…​</param>.
• Во всех числовых значениях разделитель целой и дробной части — точка.
• Не используйте символы " & ' < >. Исключение — блок CDATA в элементе <description>. Вне блока CDATA используйте их HTML-коды.

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

<?xml version="1.0" encoding="utf-8"?>
<yml_catalog date="...">
    <shop>
      <categories>
        <!-- Категории -->
        <category id="..." parentId="...">...</category>
    ...
      </categories>
	    <offers>
		    <!-- Товары -->
		    <offer id="..." group_id="...">
          <!-- Информация о товаре -->
          <price>...</price>
          <discount_price>...</discount_price>
          <category_id>...</category_id>
          <picture>...</picture>
          <name>...</name>
          <description>...</description>
          <weight>...</weight>
          <length>...</length>
          <width>...</width>
          <height>...</height>
          <quantity>...</quantity>
          <param name="...">...</param>
          ...
          <!-- Для объединения вариаций -->
          <cus_skucolor>...</cus_skucolor>
          <size>...</size>
		  <sku_code>...</sku_code>
          <tnved>...</tnved>
          <okpd2>...</okpd2>
        </offer>
        <offer id="...">
        ...
		    </offer>
        ...
 	    </offers>
    </shop>
</yml_catalog>

Элементы

• Стандартный заголовок <?xml version="1.0" encoding="utf-8"?>, в нём содержится версия XML и кодировка.
• Элемент <yml_catalog>— в нём может быть дата формирования файла.
• Элемент <shop> — в нём содержится информация о магазине, товарах и другие данные.
• Элемент <offers> — в нём содержатся товары (<offer>).
• Элемент <categories> — в нём содержатся категории (<category>).

• Идентификатор (артикул) товара Атрибут id в элементе <offer>. Может содержать только цифры. Если в артикуле есть другие символы, укажите его в элементе <sku_code>.
• Цена <price>. Если у товара есть <old_price>/<oldprice>, то товар будет продаваться по цене, переданной в элементе <price>. Если указана цена <discount_price>, то она будет основной, а цена <price> будет зачёркнутой.
• Категория <category_id>. Идентификатор категории (<category>).
• Ссылки на изображения <picture>. До шести ссылок на изображения товара. Каждая ссылка должна быть в отдельном элементе. Если в файле будет больше шести — мы не добавим лишние. Ссылка должна вести на само изображение, а не на страницу с ним или архив. Обратите внимание, что главным изображением станет то, которое первым успешно загрузится. Требования к изображениям.
• Название товара <name>. До 128 символов. Если хотите передать название на нескольких языках, передайте несколько элементов <name> с указанием атрибута lang. Например, <name lang="TR">…​</name>. Возможные значения: TR, EN, RU, tr_TR, en_US, ru_RU. Если не указать название на русском или на английском, система подставит автоматический перевод. Как составить название товара.
• Описание <description>. Может содержать только текст. Если вы хотите использовать в описании xhtml-разметку, передавайте его в блоке CDATA. Если хотите передать описание на нескольких языках, передайте несколько элементов <description> с указанием атрибута lang. Например, <description lang="TR">…​</description>. Возможные значения: TR, EN, RU, tr_TR, en_US, ru_RU. Если не указать описание на русском или на английском, система подставит автоматический перевод. Как составить описание товара.

  <description lang="RU">
          <![CDATA[
          <h3>Городской велосипед 345 28 Z010 с корзиной</h3>
          <p>Рама:</p>
          <ul>
              <li>сталь</li>
              <li>20"</li>
          </ul>
          ]]>
  </description>

• Бренд <brand> или Производитель <vendor>. Бренд товара.
• HS коды <hs_codes>. HS коды нужны для таможни, их нужно заполнить только продавцам из Турции.
• Остаток <quantity>, <stock> или <instock>. Остаток товара на складе.
• Габариты <dimensions>. Элемент, в котором можно сразу передать вес, длину, ширину и высоту товара. Для этого в значении элемента укажите в следующем порядке числовые характеристики параметров: Вес (в кг)/Длина (в см)/Ширина (в см)/Высота (в см). Вес необязательный параметр. Требования к значениям длины, ширины и выосты указаны в пунктах ниже. В качестве разделителей можно использовать символы: /, x (латинская раскладка) и х (кириллическая раскладка). Не нужно указывать единицы измерения. Примеры значений для элемента:
  • 10.00 / 100.00 / 30 / 40
  • 10.00 x 100.00 x 30 x 40
  • 100 x 30 x 40
• Длина <length>. Длина товара в упаковке в см. Не больше 700.
• Ширина <width>. Ширина товара в упаковке в см. Не больше 700.
• Высота <height>. Высота товара в упаковке в см. Не больше 700.
• Вес <weight>. Вес товара в упаковке в килограммах. Не больше 500.
• Остаток <quantity> или <instock>. Остаток товара на складе.

• Комплекты (лоты) <lot_num>. Способ продаж товаров комплектами. Значение от 1 до 100 000. Если поле отсутствует или значение равно 1 - создаётся штучный товар.
  Внимание. Вы можете настроить продажу товаров комплектами без использования поля <lot_num></lot_num>. Для этого отредактируйте товары вручную или с помощью XLS-файла и обязательно отключите опцию автоматического обновления атрибутов YML-файла.
• Валюта <currency_id> или <currency>. Код валюты, в которой задана цена товара. Укажите RUB.
• Цена со скидкой <discount_price>. По этой цене будет продаваться товар. Не может быть больше, чем 90 процентов от исходной цены (<price>).
• Цена до скидки <old_price> или <oldprice>. Эта цена будет зачёркнутой на карточке товара. Скидка не может быть больше, чем 90 процентов.

• Идентификатор группы Атрибут group_id в элементе <offer>. Поле для объединения вариаций.
• Цвет <cus_skucolor>. Цвет вариации в системе продавца.
• Размер <size>. Размер в системе продавца.
• Ссылка на изображение вариации <sku_picture>. Может быть только одна ссылка на изображение вариации. В рамках одного товара изображения для каждой вариации должны быть уникальны.
• Артикул товара (SKU) <sku_code>. Используется, чтобы сопоставить и досоздать недостающие вариации товара. Если в файле есть <sku_code>, то мы считаем артикулом его, а если нет — <offer_id>.

• Номер GTIN <gtin>. Если вы укажете этот код и товар относится к категории с маркируемыми товарами, система автоматически найдёт по нему коды ОКПД2 и ТН ВЭД ЕАЭС.
• Коды ОКПД2 и ТН ВЭД ЕАЭС: <okpd2> и <tnved>. Обязательные для маркируемых товаров и в категориях, где могут быть такие товары (нужно указать хотя бы один из этих кодов). Рекомендуем указывать один из кодов для всех товаров. Каждый код должен быть в отдельном элементе.

Пример файла

Как указать ссылку на файл

Шаг 1. Укажите ссылку

1. Перейдите в раздел Товары → Массовые операции YML и нажмите Загрузить YML.
   
2. В открывшемся окне укажите ссылку на YML/XML файл.

   Ссылка на файл должна начинаться на http или https (ссылка на FTP-ресурс не поддерживается).
   
3. Если для доступа к файлу требуется авторизация, отметьте соответствующую настройку и укажите логин и пароль.
4. Выберите шаблон доставки, который нужно применить к товарам.
5. Укажите время подготовки заказа в днях.
6. Выберите, что обновлять автоматически: атрибуты, категории и атрибуты, цены, остатки или добавить товары и SKU. По умолчанию обновление отключено.
   Внимание. Не включайте обновление категорий из файла, если вы поменяли категорию вручную, иначе она снова поменяется на ту, которую мы присвоили автоматически.
7. Укажите, что делать с остатками, если товаров нет в файле. Если нужно присваивать значение 0, оставьте переключатель Обнулять остатки, если товаров нет в файлах в положении Да. Чтобы не менять значение остатков — Нет.
8. Нажмите Продолжить и дождитесь, пока мы проверим файл.

Шаг 2. Сопоставьте характеристики

Шаг 3. Выберите категории

Шаг 4. Дождитесь создания товаров

• Если товар с таким артикулом уже был на площадке и настройки обновления выключены — мы ничего не делаем.
• Если товар с таким артикулом уже был на площадке и настройки обновления включены — мы обновим параметры, помеченные к обновлению, например, атрибуты или цены и остатки.
• Если товара с таким артикулом ещё нет на площадке — мы создадим его и подберём категорию автоматически.

Что дальше

Результат и история загрузок

Изменить параметры

Остановить/включить загрузку или обновление

Частые вопросы