Данный документ без изменений взят с сайта http://partner.market.yandex.ru/ (компания «Яндекс»)

Технические требования

В соответствии с Общими условиями (http://partner.market.yandex.ru/legal/general/) в настоящем документе определены технические требования к структуре и иным характеристикам, в обязательном порядке предъявляемым к Материалам, размещаемым в базе данных Яндекс.Маркет.

Метод передачи данных

Размещаемые материалы должны быть опубликованы на сайте клиента по URL-адресу, согласованному с компанией «Яндекс», и доступны по протоколам HTTP или FTP. Допускается использование стандартной авторизации для автоматического скачивания файла роботом Яндекс.Маркета, при этом данные для авторизации должны также быть согласованы.

В случае изменения URL-адреса и/или авторизационных данных Клиент должен уведомить об этом Яндекс не менее чем за три рабочих дня до изменения.

Формат данных

Передаваемые данные должны соответствовать спецификации формата YML (см. ниже). Допускается публикация в упакованном виде с помощью алгоритма GNU ZIP (суффикс gz). http://www.gzip.org/

Требования к сайту клиента и ссылкам на страницы сайта

Ссылки на сайт Клиента, публикуемые в составе предложений, должны вести на соответствующие «страницы товара», т.е. на страницы, содержащие описание предлагаемого товара, его цену и кнопку «Купить» или «Заказать». Каждому размещаемому предложению должна соответствовать отдельная страница товара.

Сайт клиента в целом и все страницы товаров должны находиться в рабочем состоянии и быть доступными любому пользователю в течение всего срока размещения предложений о продаже на Яндекс.Маркете.

На страницах товара не должны использоваться элементы, приводящие к открытию дополнительных окон браузера (popup, popunder) или переходу на другую страницу (redirect) без разрешения пользователя.

Описание формата YML

YML (Yandex Market Language) – стандарт, разработанный «Яндексом» для принятия и публикации информации в базе данных Яндекс.Маркет. YML основан на стандарте XML (Extensible Markup Language).

XML документ должен соответствовать следующему формату (DTD):

<!ELEMENT yml_catalog (shop)> 
<!ATTLIST yml_catalog 
date CDATA
#REQUIRED> 
<!ELEMENT shop (name, company, phone?, url,
currencies, categories, deliveryIncluded?, offers)> 
<!ELEMENT company (#PCDATA)> 
<!ELEMENT phone (#PCDATA)> 
<!ELEMENT currencies (currency+)> 
<!ELEMENT currency EMPTY> 
<!ATTLIST currency 
id
(RUR|RUB|USD|DM|EUR) #REQUIRED 
rate CDATA
"1"
plus CDATA
"0"> 
<!ELEMENT categories (category+)> 
<!ELEMENT category (#PCDATA)> 
<!ATTLIST category
id CDATA
#REQUIRED
parentId CDATA
"0"
tid CDATA
#IMPLIED
yid CDATA
#IMPLIED> 
<!ELEMENT offers (offer+)> 
<!ELEMENT offer (url, buyurl?, price, wprice?, 
currencyId, xCategory?, categoryId+,
picture?, deliveryIncluded?,
orderingTime?, 
(
( typePrefix?,
vendor, vendorCode?, model, (provider, tarifplan?)?) 
| (author?, name, publisher?, series?, year?, ISBN?)
| (artist?, title, year?, media?, starring?, director?,
originalName?, country?)
| (worldRegion?, country?, region?,
days, dataTour*, name, hotel_stars?,
included, transport, price_min?, price_max?, options?)
| (name, place, hall?, hall_part?, date, is_premiere?, is_kids?)
| (name, vendor?,vendorCode?)
), 
aliases?, 
additional*, description?, sales_notes?
)> 
<!ATTLIST offer
id CDATA
#IMPLIED 
type (vendor.model
| book | artist.title | tour | ticket | event-ticket) #IMPLIED 
bid CDATA
#IMPLIED
cbid CDATA
#IMPLIED> 
<!ELEMENT url (#PCDATA)> 
<!ELEMENT buyurl (#PCDATA)> 
<!ELEMENT picture (#PCDATA)> 
<!ELEMENT deliveryIncluded EMPTY> 
<!ELEMENT orderingTime (onstock?,
ordering, deliveryTime?)> 
<!ELEMENT onstock EMPTY> 
<!ELEMENT ordering (#PCDATA)> 
<!ATTLIST ordering 
hours CDATA
#IMPLIED>
<!ELEMENT deliveryTime EMPTY> 
<!ELEMENT price (#PCDATA)> 
<!ELEMENT wprice (#PCDATA)> 
<!ELEMENT currencyId (#PCDATA)> 
<!ELEMENT categoryId (#PCDATA)> 
<!ATTLIST categoryId 
type (Yandex | Torg | Own)
"Own" > 
<!ELEMENT typePrefix (#PCDATA)> 
<!ELEMENT vendor (#PCDATA)> 
<!ELEMENT vendorCode (#PCDATA)> 
<!ELEMENT model (#PCDATA)> 
<!ELEMENT author (#PCDATA)> 
<!ELEMENT name (#PCDATA)> 
<!ELEMENT publisher (#PCDATA)> 
<!ELEMENT ISBN (#PCDATA)> 
<!ELEMENT series (#PCDATA)> 
<!ELEMENT year (#PCDATA)> 
<!ELEMENT artist (#PCDATA)> 
<!ELEMENT title (#PCDATA)> 
<!ELEMENT media (#PCDATA)> 
<!ELEMENT starring (#PCDATA)> 
<!ELEMENT director (#PCDATA)> 
<!ELEMENT originalName (#PCDATA)> 
<!ELEMENT country (#PCDATA)> 
<!ELEMENT description (#PCDATA)> 
<!ELEMENT sales_notes (#PCDATA)> 
<!ELEMENT aliases (#PCDATA)> 
<!ELEMENT provider (#PCDATA)> 
<!ELEMENT tarifplan (#PCDATA)> 
<!ELEMENT xCategory (#PCDATA)> 
<!ELEMENT additional (#PCDATA)> 
<!ELEMENT worldRegion (#PCDATA)> 
<!ELEMENT region (#PCDATA)> 
<!ELEMENT days (#PCDATA)> 
<!ELEMENT dataTour (#PCDATA)> 
<!ELEMENT hotel_stars (#PCDATA)> 
<!ELEMENT included (#PCDATA)> 
<!ELEMENT transport (#PCDATA)> 
<!ELEMENT price_min (#PCDATA)> 
<!ELEMENT price_max (#PCDATA)> 
<!ELEMENT options (#PCDATA)> 
<!ELEMENT place (#PCDATA)> 
<!ELEMENT hall (#PCDATA)> 
<!ATTLIST hall 
plan CDATA
#IMPLIED>
<!ELEMENT hall_part (#PCDATA)> 
<!ELEMENT is_premiere (#PCDATA)> 
<!ELEMENT is_kids (#PCDATA)> 
<!ELEMENT date (#PCDATA)> 

Общие замечания по формату (необходимо учитывать при создании файлов в стандарте YML)

Стандарт XML учитывает порядок следования элементов, поэтому важно соблюдать его в соответствии с прилагаемым DTD (см. приложение) или примерами, приведенными ниже.

Стандарт XML не допускает появления символов с ASCII-кодами в диапазоне значений от 0 до 31 (за исключением значений 9, 10, 13 – табуляция, перевод строки, возврат каретки) в текстовых полях. Также этот стандарт строго требует заменять в тексте все следующие символы.

Условия замены в текстовых полях

Описание формата полного списка товаров

Заголовок документа (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>

Описание магазина и товаров магазина включает в себя следующие поля:

Элемент currencies

<currencies>
<currency id="RUR" rate="1"/>
<currency id="USD" rate="31.5"/>
<currency id="EUR" rate="30.4"/>
…
</currencies>

Список курсов валют магазина. Параметр id обозначает код валюты, а параметр – курс валюты к рублю. В случае, если параметр rate, описанный в этом элементе, имеет значение ‘CBRF’, то Яндекс.Маркет будет воспринимать курс валюты магазина как курс ЦБ РФ.

<currencies>
<currency id="RUR" rate="1"/>
<currency id="USD" rate="CBRF"/>
<currency id="EUR" rate="CBRF"/>
…
</currencies>

или ЦБ РФ + %

<currencies>
<currency id="RUR" rate="1"/>
<currency id="USD" rate="CBRF" plus="3"/>
<currency id="EUR" rate="CBRF" plus="3"/>
…
</currencies>

(в таком случае Яндекс.Маркет будет пересчитывать по курсу ЦБ РФ +3%, для каждой из валют)

Внимание! В качестве разделителя целой и дробной частей стоимости независимо от региональных установок используется точка (не запятая!).

Элемент 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">
<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>
<orderingTime>
<ordering>В наличии</ordering>
</orderingTime>
<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”>
<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>
<orderingTime>
<ordering>В наличии</ordering>
</orderingTime>
<name>Принтер HP Laser Jet 1100</name>
<vendorCode>Q1861A<vendorCode>
<description>Лазерный принтер, А4, 8 стр. в минуту, разрешение 600х600</description>
</offer>

Описание товарного предложения магазина в результатах поиска:

Описание тэгов, входящих в элемент <offer>

В YML существуют еще несколько типов описаний предложений товаров: <vendor>, <model>, <book>, <artist> и <tour>. В зависимости от типа описания используется соответствующие поля, согласно прилагаемой схемой DTD (см. приложение).

Представление товарных предложений типа «книги» и «медиапродукция», описание которых может быть произведено посредством специализированных элементов:

Книги

<offer id="12342" type="book">
<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>
<orderingTime>
<ordering>в наличии</ordering>
</orderingTime>
<author>Александра Маринина</author>
<name>Мужские игры</name>
<publisher>ЭКСМО - Пресс</publisher>
<series>Детектив глазами женщины</series>
<year>1999</year>
<ISBN>32142143214</ISBN>
<description>
Кажется, невозможно подобрать ключ к новому, запутанному делу,
что предстоит расследовать сотруднику уголовного розыска Анастасии Каменской.
Крупный мафиози Эдуард Денисов дает сотруднику уголовного розыска Насте
Каменской нить к разгадке преступлений.
</description>
</offer>

Описание товарного предложения магазина в результатах поиска:

Описание музыкальной продукции

<offer id="12345" type="artist.title">
<url>http://best.seller.ru/product_page.asp?pid=12946</url>
<price>150</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>

В результатах поиска:

Описание видео продукции:

<offer id="12344" type="artist.title">
<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> 
&quot;Гадкий утенок&quot; из провинциального городка покидает свое гнездо, и в
компании своей подруги отправляется искать веселой жизни в большой и загадочный
город. Фильм о мечтах и реальности, дружбе и юности молодой девушки,
приключения которой повторяют судьбы Золушки и героини Джулии Робертс из
ставшего классикой фильма &quot;Красотка&quot;...
</description>
</offer>

В результатах поиска:

Яндекс оставляет за собой право поменять вид выдачи предложений, поэтому не гарантирует показ предложений в том виде, в котором они представлены в примерах.

Тэг picture

Для каждого товарного предложения в элементе <offer> можно указать URL-адрес картинки, соответствующей данному товарному предложению.

Пример:<picture>http://best.seller.ru/img/device12345.jpg</picture>

По указанному URL-адресу должна отдаваться картинка формата jpeg, gif или png не меньше чем 100х100. Картинки большего размера будут уменьшены автоматически. Ссылка на HTML с картинкой не допустима.

Для того чтобы рядом с товарным предложением показывалось изображение этого товара, необходимо чтобы на вашем сервере в файле robots.txt изображения были открыты для индексирования.

Правила индексации в поисковой системе «Яндекс» можно посмотреть по ссылке:

http://www.yandex.ru/info/webmaster2.html

Тэги description и name

В полях <description> или <name>, допускается вводить текст длиною не более 255 символов. Если длина описания выходит за пределы допустимого значения, то текст обрезается и в конце проставляется многоточие.

Условия отключения сайта от базы данных Яндекс.Маркет

Интернет-магазин отключается от базы данных Яндекс.Маркет при несоблюдении вышеизложенных требований и условий, описанных в договоре.