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

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

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

4 минуты на чтение

Формат YML разработан Яндексом на основе XML. Многие CMS позволяют выгрузить товары в этом формате. Вы можете использовать файл с другой торговой площадки или создать новый.

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

  • Кодировка — UTF-8 или Windows-1251.

  • Во всех числовых значениях разделитель целой и дробной части — точка.

  • Нельзя использовать символы > < & " ', замените их на эквивалентные: > < &amp; &quot; &apos;. Исключение — блок CDATA в элементе <description>.

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

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

<?xml version="1.0" encoding="utf-8"?>
<yml_catalog>
  <shop>
    <categories>
      <!-- Категории -->
      <category id="...">...</category>
    </categories>
    <offers>
      <!-- Товары -->
      <offer id="..." group_id="...">
        <!-- Информация о товаре -->
        <name>...</name>
        <vendor>...</vendor>
        <price>...</price>
        <categoryId>...</categoryId>
        <picture>...</picture>
        <description>...</description>
        <param name="...">...</param>
        ...
        <weight>...</weight>
        <length>...</length>
        <width>...</width>
        <height>...</height>
        <quantity>...</quantity>
      </offer>
      <offer id="..." group_id="...">
        ...
      </offer>
      ...
    </offers>
  </shop>
</yml_catalog>

Скачать полный пример YML-файла

Элементы

Общие

Внимание. Эти элементы обязательные.

Элемент

Описание

xml header

Пример:

<?xml version="1.0" encoding="utf-8"?>

Стандартный XML-заголовок. Начинается с начала первой строки.

<yml_catalog>

 <shop>...</shop>

</yml_catalog>

Элементы, внутри которых находится информация о категориях (<categories>) и товарах (<offers>).

Описание магазина (<shop>)

Внимание. Эти элементы обязательные.

Элемент

Описание

<categories>...</categories>

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

<category id="...">...</category>

Пример:

<category id="1212">Юбки</category>

Категория товаров, id — уникальный идентификатор категории.

<offers>...</offers>

Список товаров.

Описание товара (<offer>)

Атрибуты id и group_id

id  — уникальный идентификатор вариации товара.

group_id — идентификатор, одинаковый для всех вариаций одного товара.

Как создать вариации товара, чтобы они попали на одну карточку.

Характеристики и описание товара

Внимание. Эти элементы обязательные, но в вашем файле они могут называться по-другому.

Рекомендуем называть элементы так же, как в примерах, чтобы система автоматически сопоставила их с характеристиками на AliExpress.

Название

Название товара, которое увидят покупатели.

Пример:

<name>Клетчатая летняя женская юбка с высокой талией</name>

Как составить название товара.

Бренд

Название бренда. Должно быть одинаковым для товаров с одинаковым group_id. Пример:

<vendor>Big City Clothes</vendor>

Не забудьте добавить все бренды в личном кабинете.

Цена

Цена товара в рублях. Разделитель — точка. Пример:

<price>500.5</price>

Идентификатор категории

Должен совпадать с атрибутом id одной из категорий (<category>). Одинаковый для товаров с одинаковым group_id.

Пример:

<category id="1234">Юбки</category>

...

 <offer>

   <categoryId>1234</categoryId>

 </offer>

Должен быть одинаковым для товаров с одинаковым group_id.

Изображения

Одна или несколько ссылок на изображения товара. Каждая ссылка должна быть в отдельном элементе. Главное изображение укажите первым.

Пример:

<picture>https://ae01.alicdn.com/kf/H174a98384ce6439191895561d53db93dW/ICEbear-2019.jpg</picture>

Требования к изображениям.

Описание

Описание товара. Можно использовать HTML-разметку в блоке CDATA.

Пример:

<description><![CDATA[<p>Удобная юбка на каждый день.</p><p>Состав: 100% хлопок.</p>]]></description>

Как составить описание товара.

Характеристики

Можно указывать в элементе <param name="название">значение</param> или в отдельном элементе. Советуем указывать как можно больше характеристик, чтобы товар был привлекательнее для покупателей и выше в результатах поиска.

Примеры:

<param name="длина, см">70</param>

<dress_length>70</dress_length>

Вес

Вес товара без упаковки, в килограммах. Разделитель — точка. Если вы не укажете вес, система автоматически задаст значение 0,5 кг.

Пример:

<weight>0.7</weight>

Габариты

Длина, ширина и высота товара без упаковки, в сантиметрах. Разделитель — точка. Укажите каждую характеристику в отдельном параметре. Если вы не укажете габариты, система автоматически задаст значения 30 см, 20 см и 10 см.

Примеры:

<lenght>50</length>

<width>21.5</width>

<height>2.5</height>