Как мы можем вам помочь?

Регистрация на платформе

Как получить больше продаж

Логистика

Управление магазином

Работа с заказами

Работа с покупателями

Продвижение

Финансы и документооборот

Аналитика

Аккаунт

Интеграция

Решение проблем

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

13 минут на чтение
YML (Yandex Market Language) — это стандарт, разработанный Яндексом на основе XML, для передачи данных о товаре и размещения его на маркетплейсе или в CMS.
С помощью этого инструмента вы можете загружать товары, автоматизировать процесс обновления цен и остатков, обновлять основную информацию о товарах. Укажите ссылку на файл — остатки товаров, цены, характеристики и категории будут обновляться автоматически каждые 6 часов (с момента первой обработки файла), если вы выбрали соответствующие настройки.
Если вы раньше загружали товары другим способом (например, в XLS-файле или вручную), вы можете обновлять остатки или цены с помощью ссылки на YML-файл. Как это сделать.
Если вы работаете по модели FBA: Фулфилмент «Цайняо», после создания карточек товаров обязательно внесите штрихкод в системе управления поставками ASCP.
Внимание. Если вы раньше загружали товары другим способом (например, в XLS-файле или вручную), всё равно добавьте их в YML-файл и укажите остатки. Для всех товаров, которых нет в файле, система автоматически укажет остаток 0. Вы можете изменить эту настройку по умолчанию при загрузке YML-файла или в параметрах загруженных файлов.

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

Вы можете:
  • создать файл вручную;
  • создать файл с помощью сервисов генерации YML-файлов;
  • использовать готовый из другого маркетплейса;
  • выгрузить файл из своей системы.
Совет. Для генерации файл можно воспользоваться модулями интеграции: для 1С-Битрикс, для 1С:Управление торговлей, для InSales, для RetailCRM.

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

  • Допустимые кодировки YML-файла: UTF-8, windows-1251.
  • Во всех числовых значениях разделитель целой и дробной части — точка.
  • Нельзя использовать символы " & < > '. Замените их на эквиваленты " ' < > '. Исключение — блок CDATA в элементе <description>.

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

<?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>
          <categoryId>...</categoryId>
          <picture>...</picture>
          <name>...</name>
          <description>...</description>
          <weight>...</weight>
          <length>...</length>
          <width>...</width>
          <height>...</height>
          <quantity>...</quantity>
          <param name="...">...</param>
          ...
          <barcode>...</barcode>
          <!-- Для объединения вариаций -->
          <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>.
Для каждой категории (<category>): атрибут id — уникальный идентификатор. Можно указать parentId — идентификатор родительской категории.
Для каждого товара (без этих элементов товар не загрузится):
  • Идентификатор (артикул) товара <offer_id> или атрибут id в элементе <offer>. Может содержать только цифры. Если в артикуле есть другие символы, укажите его в элементе <sku_code>.
  • Цена <price>. Если у товара есть <old_price>/<oldprice>, то товар будет продаваться по цене <price>. Если есть <discount_price>, то она будет основной ценой, а цена <price> будет зачёркнутой.
  • Категория <categoryId>_. Идентификатор категории (<category>).
  • Ссылки на изображения <picture>. До шести ссылок на изображения товара. Каждая ссылка должна быть в отдельном элементе. Если в файле будет больше шести — мы не добавим лишние. Ссылка должна вести на само изображение, а не на страницу с ним или архив. Обратите внимание, что главным изображением станет то, которое первым успешно загрузится. Требования к изображениям.
  • Название товара <name>. До 128 символов. Как составить название товара.
  • Описание <description>. Может содержать только текст. Если вы хотите использовать в описании xhtml-разметку, передавайте его в блоке CDATA. Как составить описание товара.
    <description>
            <![CDATA[
            <h3>Городской велосипед 345 28 Z010 с корзиной</h3>
            <p>Рама:</p>
            <ul>
                <li>сталь</li>
                <li>20"</li>
            </ul>
            ]]>
    </description>
  • Длина <length>. Длина товара в упаковке в см. Не больше 700.
  • Ширина <width>. Ширина товара в упаковке в см. Не больше 700.
  • Высота <height>. Высота товара в упаковке в см. Не больше 700.
  • Вес <weight>. Вес товара в упаковке в килограммах. Не больше 500.
  • Остаток <quantity> или <instock>. Остаток товара на складе. Для продавцов, работающих по модели FBA: Продажа со склада AliExpress — 0.
  • Штрихкод <barcode>. Может содержать до 20 латинских символов или цифр. Обязательный, только если вы работаете по модели фулфилмента и отгружаете товары на склады «Цайняо». Понадобится для приёмки товара на складе.
Необязательные
Без этих полей файл загрузится, но мы рекомендуем их добавить.
  • Комплекты (лоты) <lot_num>. Способ продаж товаров комплектами. Значение от 1 до 100 000. Если поле отсутствует или значение равно 1 - создаётся штучный товар.
    Внимание. Вы можете настроить продажу товаров комплектами без использования поля <lot_num></lot_num>. Для этого отредактируйте товары вручную или с помощью XLS-файла и обязательно отключите опцию автоматического обновления атрибутов YML-файла.
  • Цена со скидкой <discount_price>. По этой цене будет продаваться товар. Не может быть больше, чем 90 процентов от исходной цены (<price>).
  • Цена до скидки <old_price>/<oldprice>. Эта цена будет зачёркнутой на карточке товара. Скидка не может быть больше, чем 90 процентов.
Нельзя для одного товара указывать <old_price>/<oldprice> и <discount_price> одновременно.
Для создания вариации товара
Чтобы объединить товары на одной карточке.
  • Идентификатор модели <group_id> или атрибут 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.
    An Image
  2. В открывшемся окне укажите ссылку на YML/XML файл.
    An Image
  3. Если для доступа к файлу требуется авторизация, отметьте соответствующую настройку и укажите логин и пароль.
  4. Выберите шаблон доставки, который нужно применить к товарам.
  5. Укажите время подготовки заказа в днях.
  6. Выберите, что обновлять автоматически: Обновлять атрибуты, Обновлять категории и атрибуты, Обновлять цены или Обновлять остатки. По умолчанию обновление отключено.
    Внимание. Не включайте обновление категорий из файла, если вы поменяли категорию вручную, иначе она снова поменяется на ту, которую мы присвоили автоматически.
  7. Укажите, что делать с остатками, если товаров нет в файле. Если нужно присваивать значение 0, оставьте переключатель Обнулять остатки, если товаров нет в файлах в положении Да. Чтобы не менять значение остатков — Нет.
  8. Нажмите Продолжить и дождитесь, пока мы проверим файл.

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

Если данных недостаточно, например, часть атрибутов отсутствует, мы попросим вас сопоставить атрибуты из файла с атрибутами AliExpress, но не более 10.
Для каждого обязательного атрибута AliExpress выберите соответствующий ему атрибут из YML-файла. Если подходящего атрибута нет, отредактируйте файл и начните загрузку заново. Также это можно сделать и для необязательных атрибутов. Нажмите Продолжить.
An Image
Если все пройдёт без ошибок и данных будет достаточно, вы перейдёте к выбору категорий.

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

Выберите Все товары, чтобы загрузить товары во всех категориях из файла, или По категориям, чтобы выбрать из выпадающего списка категории товаров, которые хотите загрузить. Нажмите Продолжить.
Внимание. После того, как вы укажете ссылку на файл, сопоставите атрибуты и выберете категории, остановить создание товаров уже не получится — вам придётся дождаться окончания загрузки и выключить файл, но товары на площадке уже создадутся. Если вы не уверены, что хотите создать или обновить все товары из файла, не нажимайте Продолжить.
An Image

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

Мы начнём создание товаров, это может занять от 10 минут до нескольких часов в зависимости от количества товаров. Дождитесь, пока файл перейдёт в статус Опубликован.
An Image
  • Если товар с таким артикулом уже был на площадке и настройки обновления выключены — мы ничего не делаем.
  • Если товар с таким артикулом уже был на площадке и настройки обновления включены — мы обновим параметры, помеченные к обновлению, например, атрибуты или цены и остатки.
  • Если товара с таким артикулом ещё нет на площадке — мы создадим его и подберём категорию автоматически.
Внимание. У созданных через этот инструмент товаров не будет характеристик, специфичных для категории, вы сможете добавить их позже вручную или через Excel. Также все товары по умолчанию создадутся без бренда (будет установлено значение «Нет»). Вы сможете изменить их позже вручную или через Excel.

Что дальше

Спустя некоторое время ваши товары загрузятся на AliExpress и отправятся на модерацию. Модерация может занять до 48 часов. Как только товары будут проверены, они появятся на вкладке В продаже в разделе Список товаров. При этом товар можно будет купить по прямой ссылке.
Иногда после создания товары отправляются на дополнительную проверку специалистом, это зависит от категории и того, как вы заполнили атрибуты. Дополнительная проверка займёт до семи дней. В это время товары будут находиться на вкладке На рассмотрении в разделе Список товаров.
Если дополнительная проверка не потребовалась, товар появится на витрине магазина и в поиске в течение 72 часов (с момента публикации товара).

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

В разделе Товары → Массовые операции YML вы увидите статусы загруженных и обновлённых файлов и сможете отфильтровать их по дате загрузки или статусу. Если при загрузке произошла ошибка, это будет написано в столбце Статус.
An Image
Если получилось создать хотя бы один товар, статус будет «Успешно». Нажмите на строку с файлом, чтобы узнать, есть ли ошибки в каких-то товарах. Откроется окно с историей загрузок YML-файлов за последние 30 дней. Нажмите в окне на количество товаров с ошибками при загрузке или обновлении, чтобы посмотреть подробности.
Внимание. В столбце Всего вы видите количество <offer> в YML-файле, поэтому фактическое количество загруженных товаров может быть меньше, так как <offer> может быть вариацией товара. В столбце Не распознано вы видите количество <offer>, которые не загрузились из YML-файла.
An Image
Откроется окно с SKU товаров и ошибками в них:
An Image
Если ошибок немного, вы можете посмотреть их прямо тут. Если файл большой и ошибок много, нажмите Выгрузить в Excel. Дождитесь пока отчёт создастся, затем нажмите Скачать Excel. К вам на компьютер загрузится файл в формате XLS.
Исправьте YML-файл по ссылке. Система применит изменения при следующем обновлении.

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

Вы можете поменять некоторые параметры загрузки. Нажмите кнопку с тремя точками и выберите Изменить параметры. Это нельзя сделать, если файл ещё обрабатывается.
An Image
Откроется окно редактирования, в котором вы можете поменять название, шаблон доставки, время на подготовку заказа, указать, нужно ли обновлять атрибуты, категории и атрибуты, цены и остатки, а также что делать с остатками, если товаров нет в файлах.
An Image
На следующем шаге выберите категорию товаров, для которых нужно применить указанные изменения. Система проверит товары из выбранных категорий — досоздаст новые.
An Image
Ссылку на файл и логин и пароль для доступа к нему изменить нельзя. Если вам нужно это сделать, отключите обновление этого файла и создайте новый.

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

Если вы хотите прекратить загрузку или обновление остатков и цен, нажмите кнопку с тремя точками и выберите Выключить фид. Загрузка перейдёт в статус «Пауза». Вы сможете снова включить обновление в этом же меню.
An Image
Чтобы обновить остатки и цены или загрузить товары из YML-файла в любое время, нажмите кнопку с тремя точками и выберите Перезапустить. Это действие доступно для файлов загрузки в статусе «Опубликован».
Мы рекомендуем не перезапускать YML-файл для передачи данных о товаре более трёх раз в день.

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

Как система определяет категории?
Мы используем сервис автоподбора категорий. При необходимости вы сможете поменять категорию вручную в разделе Мой список товаров.
Как объединить вариации товара на одной карточке?
Чтобы загрузить несколько вариаций одного товара (например, по цвету или размеру), укажите для каждой вариации одинаковое значение в элементе <group_id> или в атрибуте group_id элемента <offer>, но разные значения цвета или размера.
Почему у некоторых товаров обнулились остатки после загрузки или обновления YML-файла?
Так происходит, если вы раньше загружали товары другим способом, а потом не добавили их в YML-файл или не указали остатки. В таком случае система автоматически указывает остаток 0. Вы можете изменить эту настройку по умолчанию при загрузке YML-файла или в параметрах загруженных файлов.
Почему остановилось автоматическое обновление YML-файла?
Так происходит, если вы не изменяете YML-файл в течение 14 дней. Регулярное автоматическое обновление остатков товаров, цен, характеристик и категорий отключается, и файл переходит в статус «Отключён системой».
An Image
Чтобы возобновить регулярные обновления, нажмите кнопку с тремя точками и выберите Включить, затем отредактируйте файл загрузки.