Данный документ взят с сайта http://partner.market.yandex.ru/ и изменен в примерах и объяснениях для Рынка Yottos
Заголовок документа (XML header)
<?xml version="1.0" encoding="windows-1251"?>
<!DOCTYPE yml_catalog SYSTEM "shops.dtd">
Стандартный XML-заголовок со ссылкой на файл описания формата (DTD). Заголовок должен начинаться с первой строки, с нулевого символа.
Путь к shops.dtd прописывать не нужно.
Элемент yml_catalog
<yml_catalog date="2000-11-16 20:17">
...
</yml_catalog>
Корневой элемент полного списка товаров магазина должен содержать один элемент, выделенный элементами <shop> ... </shop>. Формат даты YYYY-MM-DD HH:mm. Дата и время, указанные в файле, должны соответствовать дате и времени сгенерированного на стороне магазина файла.
Элемент shop
<shop>
<name>BestShop</name>
<company>Best online seller Inc.</company>
<url>http://best.seller.ru/</url>
<currencies> ... </currencies>
<categories> ... </categories>
<offers> ... </offers>
</shop>
Описание магазина и товаров магазина включает в себя следующие поля:
|
Поле
|
Описание
|
|
name
|
короткое название магазина.
|
|
company
|
полное наименование компании, владеющей магазином. Не публикуется, используется для внутренней идентификации.
|
|
url
|
url-адрес первой страницы магазина
|
Элемент currencies
<currencies>
<currency id="RUR" />
<currency id="USD" />
<currency id="EUR" />
...
</currencies>
Список курсов валют магазина. Параметр id обозначает код валюты.
Элемент 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>
Список категорий магазина. Описание категории должно включать ее идентификатор (параметр id) для всех категорий и идентификатор категории более высокого уровня для подкатегорий. Идентификатор категории должен быть уникальным положительным целым числом. Ни у одной категории параметр id не может быть равен "0". Если элемент parentId не указан, то категория считается корневой.
Параметры:
id - идентификатор Вашей категории товаров
parentId - идентификатор предыдущей по иерархии категории товаров
Элемент offers
<offers>
<offer>...</offer>
...
</offers>
Список товарных предложений магазинов. Содержит элементы типа offer.
Описание элемента offer
Ниже приведены несколько примеров.
Описание товарного предложения через "vendor.model"
<offer id="12341" type="vendor.model" available="true" bid="13">
<url>http://best.seller.ru/product_page.asp?pid=12344</url>
<price>1500</price>
<currencyId>USD</currencyId>
<categoryId>6</categoryId>
<picture>http://best.seller.ru/img/device12345.jpg</picture>
<typePrefix>Принтер</typePrefix>
<vendor>HP</vendor>
<vendorCode>Q1861A<vendorCode>
<model>Laser Jet 5100</model>
<description>
Принтер. Формат А4, А3. Технология печати: лазерная. Процессор: 300 МГц.
Память: 32 Мб. Разрешение при печати: 1200х1200 т/д. Скорость печати: А3 11
стр./мин., А4 22 стр./мин. Плотность бумаги: 60-199 г/м2. Нагрузка до 65000
страниц в месяц. Лоток 1: 100 листов. Лоток 2: 250 листов. Лоток 3: 500 листов.
</description>
</offer>
Описание товарного предложения магазина в результатах поиска:
Наиболее простое описание при поиске:
<offer id="12346" available="true" bid="21">
<url>http://best.seller.ru/product_page.asp?pid=12348</url>
<price>210.54</price>
<currencyId>EUR</currencyId>
<categoryId>6</categoryId>
<picture>http://best.seller.ru/img/device12345.jpg</picture>
<name>Принтер HP Laser Jet 1100</name>
<vendorCode>Q1861A<vendorCode>
<description>Лазерный принтер, А4, 8 стр. в минуту, разрешение 600х600</description>
</offer>
Описание товарного предложения магазина в результатах поиска:
Описание элементов, входящих в элемент <offer>
|
элементы
|
Описание
|
|
url
|
URL-адрес страницы товара
|
|
price
|
цена, по которой данный товар
можно приобрести
|
|
currencyId
|
идентификатор валюты товара (RUR,USD,...)
|
|
categoryId
|
идентификатор категории товара
(целое число не более 18 знаков). Товарное предложение может принадлежать
только одной категории
|
|
picture
|
ссылка на картинку
соответствующего товарного предложения. Недопустимо давать ссылку на
"заглушку", т.е. на картинку где написано "картинка отсутствует" или на
логотип магазина
|
|
typePrefix
|
Группа товаров \ категория
|
|
vendor
|
Производитель
|
|
model
|
Модель
|
|
name
|
наименование товарного
предложения
|
|
description
|
описание товарного предложения
|
|
vendorCode
|
код товара (указывается код производителя)
|
|
available
|
статус доступности товара - в наличии/на заказ
available="false" - товарное предложение на заказ. Магазин готов осуществить поставку товара на указанных условиях в течение месяца (срок может быть больше для товаров, которые всеми участниками рынка поставляются только на заказ).. Те товарные предложения, на которые заказы не принимаются, не должны выгружаться.
available="true" - товарное предложение в наличии. Магазин готов сразу договариваться с покупателем о доставке товара
|
|
sales_notes
|
элемент, предназначенный для того, чтобы показать пользователям чем отличается данный товар от других или для описания акций магазина (кроме скидок). Длина текста в элементе - 50 символов.
|
В YML существуют еще несколько типов описаний предложений
товаров: <vendor>, <model>,
<book>, <artist> и
<tour>. В зависимости от типа описания
используется соответствующие поля, согласно прилагаемой схемой DTD.
Представление товарных предложений типа "книги", "туры", "билеты" и "медиапродукция",
описание которых может быть произведено посредством специализированных элементов:
Книги
<offer id="12342" type="book" available="true" bid="17">
<url>http://best.seller.ru/product_page.asp?pid=14345</url>
<price>65</price>
<currencyId>RUR</currencyId>
<categoryId>3</categoryId>
<picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
<author>Александра Маринина</author>
<name>Мужские игры</name>
<publisher>ЭКСМО - Пресс</publisher>
<series>Детектив глазами женщины</series>
<year>1999</year>
<ISBN>32142143214</ISBN>
<description>
Кажется, невозможно подобрать ключ к новому, запутанному делу,
что предстоит расследовать сотруднику уголовного розыска Анастасии Каменской.
Крупный мафиози Эдуард Денисов дает сотруднику уголовного розыска Насте
Каменской нить к разгадке преступлений.
</description>
</offer>
Описание товарного предложения магазина в результатах поиска:
|
элемент
|
Описание
|
|
author
|
автор произведения
|
|
name
|
наименование
произведения
|
|
publisher
|
издательство
|
|
series
|
серия
|
|
year
|
год издания
|
|
ISBN
|
код книги
|
Описание музыкальной продукции
<offer id="12345" type="artist.title" available="true" bid="11">
<url>http://best.seller.ru/product_page.asp?pid=12946</url>
<price>15</price>
<currencyId>USD</currencyId>
<categoryId>2</categoryId>
<picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
<artist>Pink Floyd</artist>
<title>Dark Side Of The Moon, Platinum Disc</title>
<year>1999<year>
<media>CD</media>
</offer>
В результатах поиска:
|
элемент
|
Описание
|
|
artist
|
исполнитель
|
|
title
|
наименование
|
|
media
|
носитель
|
Описание видео продукции:
<offer id="12344" type="artist.title" available="true" bid="56">
<url>http://best.seller.ru/product_page.asp?pid=92347</url>
<price>93</price>
<currencyId>RUR</currencyId>
<categoryId>2</categoryId>
<picture>http://best.seller.ru/img/device92347.jpg</picture>
<title>Свадьба Мюриэл</title>
<year>1999<year>
<media>DVD<media>
<starring>Тони Колетт (Toni Collette), Рэйчел Грифитс (Rachel Griffiths)</starring>
<director>П Дж Хоген</director>
<originalName>Muriel's wedding</originalName>
<country>Австралия</country>
<description>
"Гадкий утенок" из провинциального городка покидает свое гнездо, и в
компании своей подруги отправляется искать веселой жизни в большой и загадочный
город. Фильм о мечтах и реальности, дружбе и юности молодой девушки,
приключения которой повторяют судьбы Золушки и героини Джулии Робертс из
ставшего классикой фильма "Красотка"...
</description>
</offer>
В результатах поиска:
|
элемент
|
Описание
|
|
title
|
название фильма
|
|
starring
|
актеры
|
|
director
|
режиссер
|
|
originalName
|
оригинальное
наименование
|
|
country
|
страна
|
|
year
|
год
|
|
media
|
носитель
|
Описание тура
<offer id="12341" type="tour" available="true" bid="71">
<url>http://best.seller.ru/product_page.asp?pid=12344</url>
<price>210</price>
<currencyId>USD</currencyId>
<categoryId>6</categoryId>
<picture>http://best.seller.ru/img/device12345.jpg</picture>
<worldRegion>Африка</worldRegion>
<country>Египет</country>
<region>Хургада</region>
<days>7</days>
<dataTour>01/01/07</dataTour>
<dataTour>08/01/07</dataTour>
<name>Hilton</name>
<hotel_stars>5*****</hotel_stars>
<room>SNG</room>
<meal>ALL</meal>
<included>авиаперелет, трансфер, проживание, питание, страховка</included>
<transport>Авиа</transport>
<description></description>
</offer>
В результатах поиска
|
элемент
|
Описание
|
worldRegion |
часть света |
country |
страна |
region |
курорт или город |
days |
количество дней тура |
dataTour |
даты заездов |
name |
название отеля (в некоторых случаях наименование тура) |
hotel_stars |
звезды S отеля 5***** |
room |
тип комнаты (SNG, DBL......) |
meal |
тип питания (All, HB......) |
included |
что включено в стоимость тура |
transport |
транспорт |
description |
описание тура |
Описание билетов на мероприятия
<offer type="event-ticket" available="true" bid="13">
<url>url товарного предложения</url>
<price>10000</price>
<currencyId>RUR</currencyId>
<categoryId>3</categoryId>
<picture>url картинки товарного предложения</picture>
<name>Дмитрий Хворостовский и Национальный филармонический
оркестр России. Дирижер - Владимир Спиваков.</name>
<place>Московский международный Дом музыки</place>
<hall plan="url плана зала">Большой зал<hall>
<hall_part>Партер р. 1-5<hall_part>
<date>31.12.2004 19:00</date>
<is_premiere>0<is_premiere>
<is_kids>0</is_kids>
<description>описание товарного предложения.</description>
</offer>
В результатах поиска
элемент |
Описание |
name |
название мероприятия |
place |
зал |
hall plan |
Ссылка на картинку версии зала |
date |
дата и время сеанса ISO 8601: YYYY-MM-DDThh:mm |
is_premiere |
признак премьерности мероприятия |
is_kids |
признак детского мероприятия |
элемент picture
Для каждого товарного предложения в элементе <offer> можно указать URL-адрес картинки, соответствующей данному товарному предложению.
Пример:<picture>http://best.seller.ru/img/device12345.jpg</picture>
По указанному URL-адресу должна отдаваться картинка формата jpeg, gif или png не меньше чем 100х100. Картинки большего размера будут уменьшены автоматически. Ссылка на HTML с
картинкой не допустима.
Для того чтобы рядом с товарным предложением показывалось изображение этого товара, необходимо чтобы на вашем сервере в файле robots.txt изображения были открыты для
индексирования.
элементы description и name
В полях <description> или <name>, допускается вводить
текст длиною не более 255 символов. Если длина описания выходит за пределы
допустимого значения, то текст обрезается и в конце проставляется многоточие.
Элементы, которые не были описаны в примерах, являются резервными и не обрабатываются.
Рынок Yottos оставляет за собой право поменять вид выдачи предложений, поэтому не гарантирует показ предложений в том виде, в котором они представлены в примерах.