Описание поддержки YML формата (Яндекс.Маркет)

Все правила оформления и стандарты порядка следования элементов взяты от 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 Кольца  

 

 
Барахолка (Вещи) на Adensya.ru