Правила заполнения фида для товарной категории Fashion

Описание товарного XML-фида

Мегамаркет XML - это формат данных, разработанный для описания товарных предложений продавца. Основан на формате Yandex Market XML (YML). Содержит как информацию о товарах, их свойствах, характеристиках, ценах, так и информацию о доступных для заказа остатках.
XML-документ с описанием товаров ("XML-фид") должен быть размещён на веб-сервере продавца. Система Мегамаркет будет периодически загружать из него информацию.
При разработке можно также ориентироваться на описание формата, подготовленное Яндексом.
При возникновении ошибок, связанных с обработкой фидов, весь ассортимент продавца будет заблокирован для продажи на megamarket.ruВА

Размещение XML-фида

Товарный фид должен быть размещен на отдельной странице http/https сайта продавца или на любом другом стороннем хосте.

Фид не должен находиться:

  • в облачных хранилищах (Яндекс.Диск, Google.Диск)
  • на ftp/sftp сервере

Общие требования

  • Максимальный объем файла Мегамаркет XML составляет 500 МБ
  • Файл Мегамаркет XML должен быть представлен в кодировке UTF-8 или Windows-1251
  • Файл Мегамаркет XML должен соответствовать общим требованиям стандарта XML.
  • XML-заголовок файла <?xml> должен начинаться с первой строки, с нулевого символа
  • Все атрибуты элементов файла должны быть указаны в двойных кавычках
  • Стандарт Мегамаркет XML не допускает использования непечатаемых символов с ASCII-кодами от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки)
  • Символы ", &, >, <, ' нужно заменять на эквивалентные коды:

Символ в тексте

Код для Мегамаркет XML-файла

"

"

&

&

>

>

<

<

'

'

Требования к элементам файла Мегамаркет XML

Название элементаОписаниеНаличие в файлеТип данных 
xml headerСтандартный XML-заголовок. Должен начинаться с первой строки, с нулевого символа. Может присутствовать только в единственном экземпляреОбязательноЛатиница, цифры
yml_catalogКорневой XML-элемент, описывающий структуру каталога офферов. Может присутствовать только в единственном экземпляре. Атрибут date элемента должен соответствовать дате и времени генерации YML-файла на стороне магазина. Дата должна иметь формат YYYY-MM-DD hh:mm (формат времени - 24 часа)ОбязательноЛатиница, цифры
Элементы, входящие в yml_catalog
shopСодержит описание магазина и его офферов. Может присутствовать только в единственном экземпляреОбязательноЛатиница
Элементы, входящие в shop
nameНазвание магазина. Может присутствовать только в единственном экземпляреОбязательноЛатиница, кириллица, цифры
companyНазвание компании, владеющей магазином. Может присутствовать только в единственном экземпляреЖелательноЛатиница, кириллица, цифры
urlURL главной страницы магазина. Может присутствовать только в единственном экземпляре. Максимальная длина – 512 символовЖелательноТолько латиница и цифры.  Кириллические символы и пробелы недопустимы
currencies

Элемент с описанием валют, используемых в магазине. Каждая валюта описывается в отдельном элементе currency. У currency могут быть следующие атрибуты:

  • id – содержит код валюты (rur, usd, eur и т.д.)
  • rate – курс обмена текущей валюты на рубли Блок может присутствовать только в единственном экземпляре.
Желательно
  • id – латиница
  • rate – цифры. В качестве разделителя используется точка
categories
  • Элемент с описанием категорий офферов. Может присутствовать только в единственном экземпляре. Каждая категория описывается в отдельном элементе category. У category могут быть следующие атрибуты:
     id – обязательный атрибут. Должен быть представлен уникальным значением в рамках всех категорий. Атрибут из системы продавца.
  •  Parentid – id родительской категории продавца. Используется в том случае, если категории делятся на подкатегории.
Обязательно
  • category – латиница, кириллица, цифры
  • id – целочисленное значение больше нуля parentid – целочисленное значение больше нуля
shipment-options

Элемент с описанием параметров отгрузки офферов продавцом. Эти параметры будут применены ко всему ассортименту товаров. Содержит единственный элемент option. У option могут быть следующие атрибуты:

  • order-before – время в часах, 24-часовой формат; час, до которого в этот день принимаются заказы для доставки за days дней
  • days – число в днях, количество рабочих дней для доставки заказа
  • id склада, с которого будет осуществлена отгрузка
Желательно
  • Order-before – целочисленное значение от 1 до 24
  • Days – целочисленное значение большее или равное нулю
offersСписок офферов магазина. Может присутствовать только в единственном экземпляре. Каждый оффер описывается в отдельном элементе offer.ОбязательноЛатиница
Атрибуты элемента offer
id

Должен соответствовать артикулу оффера в системе учёта заказов продавца. Не должен содержать пробелов

Обязательно
  • Строка
  • Допустима латиница, цифры, знаки "-" и "_"
  • Максимальная длина - 20 символов
  • Пробелы недопустимы
availableПоказывает доступность конкретного оффера. Может быть true или falseОбязательноTrue или false
Элементы, входящие в offer
urlСсылка на страницу оффера в магазине партнераЖелательноТолько латиница и цифры.  Кириллические символы и пробелы недопустимы
nameНазвание оффера. Может присутствовать только в единственном экземпляреОбязательноЛатиница, кириллица, цифры
priceЦена оффера. Может присутствовать только в единственном экземпляреОбязательноЦелочисленное значение больше нуля. (не целочисленное значение будет автоматически округлено в меньшую сторону, разделитель -точка.)
oldprice

Старая цена оффера

Обязательно

Целочисленное значение больше нуля. 

Главное требование к параметру oldprice - он должен быть минимум на 5% больше цены продажи.

Например: если вы продаете футболку за 1000 рублей, то старая цена должна быть минимум 1050 рублей.

categoryIdid категории продавца, в которую входит данный оффер. Может присутствовать только в единственном экземпляреОбязательно

Целочисленное значение.

Должно быть больше нуля

picture

Ссылка на изображение оффера. Можно передавать несколько изображений, основным на витрине будет первое изображение.

Обязательно

Только латиница и цифры.

 Кириллические символы и пробелы недопустимы

vat

Элемент содержит значение ставки НДС для товара:

Обязательно  для плательщиков НДСВозможны только перечисленные значения.
shipment-options

Элемент с описанием параметров отгрузки данного оффера. Содержит единственный элемент option. У option должны быть следующие атрибуты:

  • order-before – время окончания операционного дня (обязательный параметр)
  • days – число в днях, количество рабочих дней для отгрузки заказа
Желательно
  • Order-before – целочисленное значение от 0 до 24
  • Days – целочисленное значение больше или равное нулю
  • Store-id – целочисленное значение больше нуля
vendorПроизводитель/БрендОбязательноЛатиница, кириллица, цифры
vendorCode

Код производителя

ОбязательноЦелочисленное значение больше нуля
modelМодель
Чтобы произошло объедение в мультикарточку, у товаров разного размера и цвета/принта необходимо корректно указать Модель (одинаковая числовая/буквенная часть артикула без указания размера/цвета/материала)
ОбязательноЛатиница, кириллица, цифры
descriptionОписаниеЖелательноЛатиница, кириллица, цифры
barcode

Штрих-код в формате EAN. Представлен с помощью цифр, имеет 8, 12 или 13 символов. 

Должен находиться за пределами диапазона 20xxxxxxxxxxxx (первые 2 цифры не должны быть равны 20 в случае 13 цифрового баркода)

ОбязательноЦелочисленное значение больше нуля
outlets

Элемент с данными по остатку оффера. Содержит вложенный элемент outlet. У outlet должны быть следующие атрибуты:

  • id – код склада, который указан в ЛКМ, раздел "Настройки" -"Склад и Доставка"
  • instock – количество товара на складе (шт.)
Желательно
  • id – целочисленное значение
  • instock – целочисленное значение больше или равное нулю
param

Элемент со значением характеристики данного товара. Содержит атрибут name с наименованием данной характеристики. В зависимости от категории набор характеристик может отличаться:

Категория одежда:

  • пол
  • размер производителя
  • состав ткани
  • цвет/ Цвет производителя
  • комплектность
  • размер одежды

Для взрослых:

Параметр

Формат

Правильно

Неправильно

Размер

одежды RU

Цифра или несколько цифр через косую черту (/)

42 или 42/44

RUS42,

42 РУС

Уникальный

размер бренда 

Не более 9 символов с пробелами

One size

42-48 Российский

Для детей:

Параметр

Формат

Правильно

Неправильно

Рост в сантиметрах

Цифра или несколько цифр через дефис (-)

46-50

46 см,

0,5 метра,

полметра

Уникальный

размер бренда 

Не более 9 символов с пробелами

One size

Один размер российский


Категория Обувь:

  • пол
  • размер производителя
  • материал верха
  • цвет/цвет производителя
  • сезон
  • материал подкладки 
  • комплектность
  • размер обуви


Параметр

Формат

Правильно

Неправильно

Размер

обуви RU

Целое или дробное число, которое кратно пяти.

Дробную часть пишите через запятую

36 или 36,5

36 РУС, 

36 и 5 

Уникальный

размер бренда 

Не более 9 символов

17

36,5 русский


Если вам не подходит стандартная таблица размеров, вы можете создать свою. Обратите внимание, обозначения размеров в документе с ассортиментом должны соответствовать обозначениям в таблице уникальных размеров, которую вы нам передали.

Категория Аксессуары:

Ювелирные изделия и бижутерия:

  • пол
  • размер
  • материал, вставка
  • цвет материала
  • проба (для ювелирных изделий)
  • количество карат (у изделий с бриллиантами)

Головные уборы, перчатки, шарфы/снуды/палантины:

  • пол
  • размер
  • состав
  • цвет/цвет производителя

Часы:

  • пол
  • материал корпуса
  • материал браслета
  • циферблат
  • класс водонепроницаемости
  • размер корпус

Зонты:

  • пол
  • механизм
  • материал каркаса
  • материал купола
  • цвет/цвет производителя

Сумки, рюкзаки:

  • пол
  • размер
  • материал
  • цвет/цвет производителя

Косметички, кошельки/монетницы, ключницы, визитницы, обложки для документов:

  • пол
  • размер
  • материал
  • цвет производителя

Чемоданы:

  • пол
  • размер
  • материал
  • цвет/цвет производителя

Ремни:

  • пол
  • размер, см
  • размер
  • материал
  • цвет/цвет производителя

Солнцезащитные очки:

  • пол
  • материал линзы
  • материал оправы
  • чехол в комплекте
  • вид линзы
  • цвет/цвет производителя

Обязательные атрибуты для категорий, в которых они актуальны:

ОбязательноЛатиница, кириллица, цифры


Пример XML-фида