Правила заполнения фида для товарной категории 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 | Название компании, владеющей магазином. Может присутствовать только в единственном экземпляре | Желательно | Латиница, кириллица, цифры | ||||||||||||||||||||||||||||||||||||
| url | URL главной страницы магазина. Может присутствовать только в единственном экземпляре. Максимальная длина – 512 символов | Желательно | Только латиница и цифры. Кириллические символы и пробелы недопустимы | ||||||||||||||||||||||||||||||||||||
| currencies | Элемент с описанием валют, используемых в магазине. Каждая валюта описывается в отдельном элементе currency. У currency могут быть следующие атрибуты:
| Желательно |
| ||||||||||||||||||||||||||||||||||||
| categories |
| Обязательно |
| ||||||||||||||||||||||||||||||||||||
| shipment-options | Элемент с описанием параметров отгрузки офферов продавцом. Эти параметры будут применены ко всему ассортименту товаров. Содержит единственный элемент option. У option могут быть следующие атрибуты:
| Желательно |
| ||||||||||||||||||||||||||||||||||||
| offers | Список офферов магазина. Может присутствовать только в единственном экземпляре. Каждый оффер описывается в отдельном элементе offer. | Обязательно | Латиница | ||||||||||||||||||||||||||||||||||||
| Атрибуты элемента offer | |||||||||||||||||||||||||||||||||||||||
| id | Должен соответствовать артикулу оффера в системе учёта заказов продавца. Не должен содержать пробелов | Обязательно |
| ||||||||||||||||||||||||||||||||||||
| available | Показывает доступность конкретного оффера. Может быть true или false | Обязательно | True или false | ||||||||||||||||||||||||||||||||||||
| Элементы, входящие в offer | |||||||||||||||||||||||||||||||||||||||
| url | Ссылка на страницу оффера в магазине партнера | Желательно | Только латиница и цифры. Кириллические символы и пробелы недопустимы | ||||||||||||||||||||||||||||||||||||
| name | Название оффера. Может присутствовать только в единственном экземпляре | Обязательно | Латиница, кириллица, цифры | ||||||||||||||||||||||||||||||||||||
| price | Цена оффера. Может присутствовать только в единственном экземпляре | Обязательно | Целочисленное значение больше нуля. (не целочисленное значение будет автоматически округлено в меньшую сторону, разделитель -точка.) | ||||||||||||||||||||||||||||||||||||
| oldprice | Старая цена оффера | Обязательно | Целочисленное значение больше нуля. Главное требование к параметру oldprice - он должен быть минимум на 5% больше цены продажи. Например: если вы продаете футболку за 1000 рублей, то старая цена должна быть минимум 1050 рублей. | ||||||||||||||||||||||||||||||||||||
| categoryId | id категории продавца, в которую входит данный оффер. Может присутствовать только в единственном экземпляре | Обязательно | Целочисленное значение. Должно быть больше нуля | ||||||||||||||||||||||||||||||||||||
| picture | Ссылка на изображение оффера. Можно передавать несколько изображений, основным на витрине будет первое изображение. | Обязательно | Только латиница и цифры. Кириллические символы и пробелы недопустимы | ||||||||||||||||||||||||||||||||||||
| vat | Элемент содержит значение ставки НДС для товара:
| Обязательно для плательщиков НДС | Возможны только перечисленные значения. | ||||||||||||||||||||||||||||||||||||
| shipment-options | Элемент с описанием параметров отгрузки данного оффера. Содержит единственный элемент option. У option должны быть следующие атрибуты:
| Желательно |
| ||||||||||||||||||||||||||||||||||||
| vendor | Производитель/Бренд | Обязательно | Латиница, кириллица, цифры | ||||||||||||||||||||||||||||||||||||
| vendorCode | Код производителя | Обязательно | Целочисленное значение больше нуля | ||||||||||||||||||||||||||||||||||||
| model | Модель Чтобы произошло объедение в мультикарточку, у товаров разного размера и цвета/принта необходимо корректно указать Модель (одинаковая числовая/буквенная часть артикула без указания размера/цвета/материала) | Обязательно | Латиница, кириллица, цифры | ||||||||||||||||||||||||||||||||||||
| description | Описание | Желательно | Латиница, кириллица, цифры | ||||||||||||||||||||||||||||||||||||
| barcode | Штрих-код в формате EAN. Представлен с помощью цифр, имеет 8, 12 или 13 символов. Должен находиться за пределами диапазона 20xxxxxxxxxxxx (первые 2 цифры не должны быть равны 20 в случае 13 цифрового баркода) | Обязательно | Целочисленное значение больше нуля | ||||||||||||||||||||||||||||||||||||
| outlets | Элемент с данными по остатку оффера. Содержит вложенный элемент outlet. У outlet должны быть следующие атрибуты:
| Желательно |
| ||||||||||||||||||||||||||||||||||||
| param | Элемент со значением характеристики данного товара. Содержит атрибут name с наименованием данной характеристики. В зависимости от категории набор характеристик может отличаться: Категория одежда:
Для взрослых:
Для детей:
Категория Обувь:
Если вам не подходит стандартная таблица размеров, вы можете создать свою. Обратите внимание, обозначения размеров в документе с ассортиментом должны соответствовать обозначениям в таблице уникальных размеров, которую вы нам передали. Категория Аксессуары: Ювелирные изделия и бижутерия:
Головные уборы, перчатки, шарфы/снуды/палантины:
Часы:
Зонты:
Сумки, рюкзаки:
Косметички, кошельки/монетницы, ключницы, визитницы, обложки для документов:
Чемоданы:
Ремни:
Солнцезащитные очки:
Обязательные атрибуты для категорий, в которых они актуальны: | Обязательно | Латиница, кириллица, цифры | ||||||||||||||||||||||||||||||||||||
Пример XML-фида
