Все правила оформления и стандарты порядка следования элементов взяты от YML http://partner.market.yandex.ru/legal/tt/?print#id1166579157730
Пример корректного YML файла можно взять тут
Заголовок документа (XML header)
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE yml_catalog SYSTEM "shops.dtd">
на данный момент поддерживаемая кодировка utf-8
Стандартный XML-заголовок со ссылкой на файл описания формата (DTD). Заголовок должен начинаться с первой строки, с нулевого символа.
Вторая строка заголовка XML-документа определяет ссылку на файл описания формата данных (DTD). Здесь достаточно указать только имя файла shops.dtd. Точный путь к этому файлу указывать не надо, так как он расположен на стороне маркета Аденься.
Элемент yml_catalog
Любой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент yml_catalog. Атрибут date элемента yml_catalog должен соответствовать дате и времени генерации XML-файла на стороне магазина. Дата должна иметь формат YYYY-MM-DD HH:mm.
обязательный элемент!!
Элемент shop
В элементе shop содержится описание магазина и товаров магазина. Магазин описывается следующими полями:
|
name
|
Короткое название магазина (название, которое выводится в списке найденных на Яндекс.Маркете товаров. Не должно содержать более 20 символов). Нельзя использовать слова, не имеющие отношения к наименованию магазина ("лучший", "дешевый"), указывать номер телефона и т.п. Название магазина, должно совпадать с фактическим названием магазина, которое публикуется на сайте. При несоблюдении данного требования наименование может быть изменено Яндексом самостоятельно без уведомления Клиента.
|
|
company
|
Полное наименование компании, владеющей магазином. Не публикуется, используется для внутренней идентификации.
|
|
url
|
URL-адрес главной страницы магазина
|
не обязательный элемент
Элемент currencies
<currencies>
<currency id="RUR" rate="1"/>
</currencies>
Элемент currencies задает список курсов валют магазина.
На данный момент поддерживается только RUR
не обязательный элемент
Элемент categories
<categories>
<category id="1">Одежда</category>
<category id="2">Обувь</category>
<category id="3" parentId="1">Нижнее белье</category>
<category id="4" parentId="1">футболки</category>
<category id="5" parentId="2">валенки</category>
<category id="6">подарки</category>
<category id="7">Сумки</category>
</categories>
В элементе categories содержится список категорий магазина. Каждая категория описывается отдельным элементом category. Описание категории должно включать ее идентификатор (параметр id) для всех категорий и идентификатор категории более высокого уровня для подкатегорий. Идентификатор категории должен быть уникальным положительным целым числом. Ни у одной категории параметр id не может быть равен "0". Если элемент parentId не указан, то категория считается корневой.
Параметры:
id - идентификатор Вашей категории товаров
parentId - идентификатор предыдущей по иерархии категории товаров
Важно!!! Передаваемые категории после первичной загрузки будут связаны с категориями маркета аденься, поэтому необходимо в данном элементе описать реальные категории чтобы Вам вручную не пришлось проставлять категории в панели администирования магазина маркета Аденься.
обязательный элемент!!
Элемент offers
<offers>
<offer>...</offer>
...
</offers>
В элементе offers содержится список товарных предложений магазинов. Каждое товарное предложение описывается отдельным элементом offer.
обязательный элемент!!
Описание элемента offer
В YML существуют несколько типов описаний предложений товаров: "упрощенный", "vendor.model", "book", "audiobook", "artist.title", "tour" и "event-ticket".
маркет Аденься использует на данный момент vendor.model тип!
Пример элемента offer:
<offer id="12341" type="vendor.model" available="true">
<name>Кожанные таби</name>
<url>http://best.seller.ru/product_page.asp?pid=12344</url>
<price>700</price>
<currencyId>RUR</currencyId>
<categoryId>6</categoryId>
<picture>http://best.seller.ru/img/device12345.jpg</picture>
<delivery>true</delivery>
<local_delivery_cost>300</local_delivery_cost>
<typePrefix>Принтер</typePrefix>
<vendor>НP</vendor>
<vendorCode>CH366C</vendorCode>
<model>Deskjet D2663</model>
<description>
Серия принтеров для людей, которым нужен надежный, простой в использовании цветной принтер для повседневной печати.
Формат А4. Технология печати: 4-цветная термальная струйная. Разрешение при печати: 4800х1200 т/д.
</description>
<manufacturer_warranty>true</manufacturer_warranty>
<country_of_origin>Япония</country_of_origin>
<param name="season">Весна лето 2010</param>
<param name="images">
<image id="1">http://best.seller.ru/img/device12345_2.jpg</image>
<image id="2">http://best.seller.ru/img/device12345_3.jpg</image>
<image id="3">http://best.seller.ru/img/device12345_4.jpg</image>
</param>
<param name="colors">
<color id="1">57</color>
<color id="2">25</color>
</param>
<param name="discount">600</param>
<param name="size" group="11">36;36,5;37;40;40,5</param>
</offer>
Элементы отмеченные красным являются обязательными без которых невозможно или загрузка товарного предложения или его отображение на маркете Аденься и его партнерских площадках.
Элементы отмеченные болд`ом не являются обязательными, однако их наличие желательно
Элементы отмеченные курсивом на данный момент не обрабатываются роботом, однако их обработка будет включена в ближайшее время и они будут включены в список необязательных но желательных элементов.
Элемент ID необходимо указывать реальный ID вашего товара, т.к. в процессе импорта робот связывает данный товар с вашим товарным предложением YML для последующего обновления товара.
|
url
|
URL-адрес страницы товара
|
|
price
|
Цена, по которой данный товар можно приобрести.Цена товарного предложения округляеся и выводится в зависимости от настроек пользователя.
|
|
currencyId
|
Идентификатор валюты товара (RUR).
|
|
categoryId
|
Идентификатор категории товара (целое число не более 18 знаков). Товарное предложение может принадлежать только одной категории
|
|
picture
|
Ссылка на картинку соответствующего товарного предложения. Недопустимо давать ссылку на "заглушку", т.е. на картинку где написано "картинка отсутствует" или на логотип магазина
|
|
typePrefix
|
Группа товаров \ категория
|
|
vendor
|
Производитель
|
|
model
|
Модель (Артикул)
|
|
name
|
Наименование товарного предложения
|
|
delivery
|
Элемент, обозначающий возможность доставить соответствующий товар. "false" данный товар не может быть доставлен ("самовывоз").
"true" товар доставляется на условиях, которые указываются в партнерском интерфейсе на странице "редактирование".
|
|
description
|
Описание товарного предложения
|
|
vendorCode
|
Код товара (указывается код производителя)
|
|
local_delivery_cost
|
Стоимость доставки данного товара в Своем регионе
|
|
available
|
Статус доступности товара.
available="false" - товарное предложение закрыто, т.е. не будет отображаться на маркете Аденься.
available="true" - товарное предложение в наличии. Магазин готов сразу договариваться с покупателем о доставке товара
|
|
sales_notes
|
Элемент используется для отражения информации о минимальной сумме заказа, минимальной партии товара или необходимости предоплаты, а так же для описания акций магазина (кроме скидок).
Допустимая длина текста в элементе - 50 символов.
|
|
manufacturer_warranty
|
Элемент предназначен для отметки товаров, имеющих официальную гарантию производителя.
|
|
country_of_origin
|
Элемент предназначен для указания страны производства товара.
|
|
downloadable
|
Элемент предназначен для обозначения товара, который можно скачать.
|
|
param
|
Характеристики товара.
Для описания каждого параметра используется отдельный элемент param.
param name="images" - дополнительные изображения для товарного предложения.
param name="colors" - цвета для товарного предложения (обрабатывается не более 2-х цветов для каждого товарного предложения)
param name="discount" - скидка числовая, т.е. стоимость товара со скидкой. Будет отображаться товар с основной ценой перечеркнутой и указанной ценой со скидкой.
param name="size" - размеры(значения) разделитель точка с запятой ";" group="11" - группа размеров (приведено в таблице ниже)
param name="genders" - унисекс = 0, мужская = 1, женская = 2
|
Таблица групп размеров:
| ID |
|
|
| 1 |
Одежда мужская и женская |
Международная |
| 2 |
Одежда мужская и женская |
Российская |
| 3 |
Одежда мужская и женская |
Европейская |
| 4 |
Одежда мужская и женская |
Американская |
| 5 |
Мужские сорочки |
Россия и Европа |
| 8 |
Мужские сорочки |
США и Англия |
| 11 |
Обувь |
Россия и Европа |
| 12 |
Обувь |
США и Англия |
| 13 |
Перчатки |
1 вариант |
| 14 |
Перчатки |
2 вариант |
| 15 |
Бюстгалтеры |
обхват под грудью |
| 16 |
Бюстгалтеры |
размер чашечки 1 вариант |
| 17 |
Бюстгалтеры |
размер чашечки 2 вариант |
| 18 |
Кольца |
|