Требования к YML- и XML-файлам
Фид должен содержать обязательные параметры: ID товара, название, изображение, описание и цену. Дополнительно можно указывать характеристики товара, состав, размеры и другие параметры.
Чтобы ускорить обработку данных, рекомендуется использовать только элементы, перечисленные ниже. Невалидные или нераспознанные теги система проигнорирует.
Общие элементы Описание товара Характеристики товара Доставка через СДЭК Подарочные сертификаты Необрабатываемые теги
Общие элементы
Элемент
Описание
Обязательность
xml header
Стандартный XML-заголовок. Должен находиться в первой строке файла (с нулевого символа)
Обязательно для формата XML
yml_catalog
Корневой элемент YML. Должен содержать дату в формате YYYY-MM-DD hh:mm (24-часовой формат)
Обязательно для формата YML
shop
Включает элементы: name (короткое наименование компании), company (официальное наименование), url (ссылка на главную страницу магазина)
Обязательно
offers
Список товаров магазина. Каждый товар описывается отдельным элементом offer или product
Обязательно
Описание товара
Элемент
Описание
Обязательность
offer или product
Элемент обозначения товара. Каждый товар описывается в отдельном элементе. Может включать атрибут available. Пример: <offer available="true">
Обязательно
id
Уникальный идентификатор предложения. Может состоять только из цифр и латинских букв. Максимальная длина — 20 символов
Обязательно
url
Ссылка на карточку товара. Максимальная длина — 2048 символов
Обязательно
categoryId / category_id
Категория товара (ID и название). Если категория не совпадает с доступной на платформе, нужно будет выбрать новую
Обязательно
name / model
Наименование товара. У каждого товара должно быть уникальное название. Оптимальная длина — от 60 до 120 символов
Обязательно
available
Доступность товара для заказа (иногда указаны в id или name). Возможные значения: true — товар активен, false — скрыт
Желательно
currencyId
Валюта, в которой указана цена товара: RUR, USD, EUR, UAH, KZT, BYN. Цена и валюта должны соответствовать друг другу
Желательно
price
Цена товара
Обязательно
oldprice
Предыдущая цена. Указывается, если нужно отобразить скидку на товар
Опционально
picture / image
Ссылка на фотографию. Можно добавить несколько изображений через отдельные теги. Первое отобразится на витрине
Обязательно
description
Подробное описание товара. Рекомендуем указать ключевые свойства и рекомендации по уходу
Обязательно
Характеристики товара
Элемент
Описание
Обязательность
<param name="ширина, мм">
Ширина товара в миллиметрах. Значение можно указывать целым или дробным числом
Обязательно (кроме категорий «Подарочные сертификаты», «Одежда», «Обувь»)
<param name="высота, мм">
Высота товара в миллиметрах. Значение можно указывать целым или дробным числом
Обязательно (кроме категорий «Подарочные сертификаты», «Одежда», «Обувь»)
<param name="длина, мм">
Длина товара в миллиметрах. Значение можно указывать целым или дробным числом
Опционально, но обязательно для доставки через СДЭК
<param name="размер">
Комплексное указание размеров (длина × ширина × высота). Может использоваться вместо отдельных параметров
Обязательно для категорий «Подарочные сертификаты», «Одежда», «Обувь»
consist
Состав товара. Пример: <consist name="хлопок" unit="шт">3</consist>: <consist name= — тег для обозначения состава, "хлопок" — название компонента, unit="шт">1 — количество компонента. Каждый элемент состава описывается отдельным тегом. Количество должно быть больше 0. Тег работает только для тех категорий, где каждый элемент состава указывается отдельной строкой с указанием количества или веса. Например, тег неактуален для категории «Кондитерские изделия»
Обязательно для категорий «Цветы» и «Вкусные наборы»
weight
Вес товара в килограммах. Значение можно указывать целым или дробным числом — с разделителем точкой или запятой. Допускается не более трёх знаков после разделителя
Обязательно для категорий «Кондитерские изделия», «Кофе», «Чай» и «Наборы чая и кофе»
qty / quantity / count / amount
Количество товара в наличии. По умолчанию — 1. Для товаров, у которых указывается время изготовления (например, для категории «Цветы»), параметр qty недопустим — количество таких товаров не задаётся вручную
Обязательно для категорий «Цветы поштучно» и «Подарочные сертификаты»
quantity_in_package
Количество в упаковке
Обязательно для категории «Цветы оптом»
minorder
Минимальное количество единиц в заказе
Опционально
delivery
Используется при доставке через СДЭК или по почте. При включенной доставке должны быть указаны размеры. Значения: true — доставка доступна, false — доставка недоступна
Опционально
adult
Указывает на товары из категории «Другое» и товары категории 18+. Значения: true — товар содержит контент 18+, false — не содержит
Обязательно для товаров категории 18+
Доставка через СДЭК
Для товаров, доступных к доставке через СДЭК, необходимо указать габариты и вес. Эти данные используются для расчёта стоимости и возможности доставки. Максимальный объем – 150000 куб. см. Вес не должен превышать 30000 г (30 кг).
Элемент
Описание
Обязательность
<delivery>
Указывает, доступна ли доставка. Возможные значения: true — доставка доступна, false — доставка недоступна
Обязательно при доставке через СДЭК
<param name="длина, мм">
Длина товара в миллиметрах. Значение можно указывать целым или дробным числом
Обязательно при доставке через СДЭК
<param name="ширина, мм">
Ширина товара в миллиметрах. Значение можно указывать целым или дробным числом
Обязательно при доставке через СДЭК
<param name="высота, мм">
Высота товара в миллиметрах. Значение можно указывать целым или дробным числом
Обязательно при доставке через СДЭК
<param name="вес, кг">
Вес товара в килограммах. Значение можно указывать целым или дробным числом — с разделителем точкой или запятой. Допускается не более трёх знаков после разделителя
Обязательно при доставке через СДЭК
Подарочные сертификаты
Для товаров из категории «Подарочные сертификаты» необходимо указать хотя бы один из элементов, определяющих тип доставки.
Элемент
Описание
Обязательность
<param name="Вид сертификата">На услугу или товары</param> <param name="Вид сертификата">На конкретную сумму</param>
<param name="Type of certificate">For services or goods</param> <param name="Type of certificate">For a specific amount</param>
Вид сертификата
Опционально. Применяется для категории «Подарочные сертификаты»
<param name="Вид поставки">материальный носитель</param> <param name="Вид поставки">электронный ключ</param> <param name="Type of delivery">material media</param> <param name="Type of delivery">material media</param>
Тип доставки:
материальный носитель/material media — физическая доставка (по почте, без курьера);
электронный ключ/electronic key — электронная доставка (по СМС или курьером)
Обязательно указание хотя бы одного тега. Указание дополнительных тегов, определяющих тип доставки, опционально
<downloadable>false</downloadable> или <downloadable>true</downloadable>
Тип доставки:
false — физическая доставка (по почте, без курьера);
true — электронная доставка (по СМС или курьером)
Обязательно указание хотя бы одного тега. Указание дополнительных тегов, определяющих тип доставки, опционально
Необрабатываемые теги
Элементы, не указанные выше (pickup, store, barcode и др.), система не распознает, и в карточках товаров они не отобразятся.
Кроме того, при обработке файла система не поддерживает и отбрасывает конструкции, которые могут вызывать ошибку импорта. Например, не допускается использование следующих конструкций:
'/<!DOCTYPE\b/i', '/<!ENTITY\b/i', '/\bENTITY\s+%/i', '/SYSTEM\s+["\'](?:file|https?|ftp):/i', '/PUBLIC\s+["\'][^"\']*["\']\s+["\'](?:file|https?|ftp):/i''/<!DOCTYPE\b/i', '/<!ENTITY\b/i', '/\bENTITY\s+%/i', '/SYSTEM\s+["\'](?:file|https?|ftp):/i', '/PUBLIC\s+["\'][^"\']*["\']\s+["\'](?:file|https?|ftp):/i'
Last updated