Требования к методу передачи данных
ДиректСправочникМетрикаРекламная сетьМаркетБаянДеньги
маркет для магазинов
Войти

Требования к методу передачи данных

Версия для печати

Данный документ является действующим, если расположен по адресу http://partner.market.yandex.ru/legal/tt/.

Дата публикации: 08.10.2013 г.
Дата вступления в силу: 08.10.2013 г.

Содержание

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

Для передачи данных о товарных предложениях в Яндекс.Маркет можно воспользоваться двумя методами.

1. Ссылка на прайс-лист

Размещаемые материалы должны быть опубликованы на сайте Клиента по URL-адресу, согласованному с компанией "Яндекс", и доступны по протоколам HTTP или HTTPS. Использование протокола FTP и портов отличных от 80 и 443 запрещается.

Длина URL прайслиста не должна превышать 512 символов, в URL запрещено использование спецсимволов: \r, \n, \x00. Со стороны Яндекса прекращается поддержка http-редиректов.

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

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

2. Загрузка через Веб-интерфейс клиента

Размещаемые материалы загружаются на сервер Яндекс.Маркета через Веб-интерфейс клиента. Клиент обязуется загрузить актуальные материалы (товарные предложения) через Веб-интерфейс клиента не позднее 30 календарных дней с даты предыдущей загрузки материалов указанным способом.

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

Передаваемые данные должны соответствовать спецификации формата YML (см. Описание формата YML), текстового формата с разделителями (см. Описание текстового формата с разделителями) или формата Excel (см. Описание формата Excel). Допускается публикация в упакованном виде с помощью алгоритма сжатия GNU ZIP (суффикс gz) или упакованных алгоритмом ZIP, однако поддержка этого алгоритма (ZIP) Яндексом может быть отменена в любое время. Наименование архива не должно называться «yandex», а также не рекомендуется использовать заглавные буквы.

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

Ссылки на сайт Клиента, публикуемые в составе товарных предложений, в рамках которых осуществляется реализация товара дистанционным способом, должны вести на соответствующие "страницы товара", т.е. на страницы, содержащие описание предлагаемого товара, его цену и кнопку "Купить" или "Заказать". Каждому размещаемому предложению, в котором опубликована ссылка на сайт Клиента, должна соответствовать отдельная страница товара.
Пользователь должен иметь возможность сделать заказ через сайт магазина, реализующего указанный в товарном предложении товар дистанционным способом. Об оформлении заказа пользователь должен получить подтверждение от Клиента (посредством телефонного звонка и/или электронной почты) в течение 4 рабочих часов с момента его оформления. Автоматически сформированные подтверждения не учитываются.
Сайт Клиента в целом и все страницы товаров должны находиться в рабочем состоянии и быть доступными любому пользователю в течение всего срока размещения предложений о продаже на Яндекс.Маркете.
На страницах товара не должны использоваться элементы, приводящие к открытию дополнительных окон браузера (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, url, phone?, platform?, version?, agency?, email*, currencies, categories, store?, pickup?, delivery?, deliveryIncluded?, local_delivery_cost?, adult?, cpa?, 
fee?, offers)>
<!ELEMENT company (#PCDATA)>
<!ELEMENT phone (#PCDATA)>

<!ELEMENT currencies (currency+)>
<!ELEMENT currency EMPTY>
<!ATTLIST currency
    id (RUR|RUB|USD|BYR|KZT|EUR|UAH) #REQUIRED
    rate CDATA "1"
    plus CDATA "0">


<!ELEMENT categories (category+)>
<!ELEMENT category (#PCDATA)>
<!ATTLIST category
    id CDATA #REQUIRED
    parentId CDATA #IMPLIED
    tid CDATA #IMPLIED
    yid CDATA #IMPLIED>

<!ELEMENT offers (offer+)>
<!ELEMENT offer (url?, buyurl?, price, wprice?, currencyId, xCategory?, categoryId+, market_category?,
                 picture*, store?, pickup?, delivery?, deliveryIncluded?, local_delivery_cost?, orderingTime?,
                 ((typePrefix?, vendor, vendorCode?, model, (provider, tarifplan?)?) |
                  (author?, name, publisher?, series?, year?, ISBN?, volume?, part?, language?, binding?, page_extent?, table_of_contents?) |
                  (author?, name, publisher?, series?, year?, ISBN?, volume?, part?, language?, table_of_contents?, performed_by?, performance_type?, storage?, format?, recording_length?) |
                  (artist?, title, year?, media?, starring?, director?, originalName?, country?) |
                  (worldRegion?, country?, region?, days, dataTour*, name, hotel_stars?, room?, meal?, 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?, promo?,
                 manufacturer_warranty?, seller_warranty?, country_of_origin?, downloadable?, adult?,
                 age?,
                 barcode*,
                 cpa?,
                 fee?,
                 rec?,
                 expiry?,
                 weight?,
                 dimensions?,
                 param*,
                 related_offer*
                )>
<!ATTLIST offer
    id CDATA #IMPLIED
    group_id CDATA #IMPLIED
    type (vendor.model | book | audiobook | artist.title | tour | ticket | event-ticket) #IMPLIED
    available (true | false) #IMPLIED
    bid CDATA #IMPLIED
    cbid CDATA #IMPLIED>

<!ELEMENT url (#PCDATA)>
<!ELEMENT store (#PCDATA)>
<!ELEMENT email (#PCDATA)>
<!ELEMENT platform (#PCDATA)>
<!ELEMENT version (#PCDATA)>
<!ELEMENT agency (#PCDATA)>
<!ELEMENT buyurl (#PCDATA)>
<!ELEMENT picture (#PCDATA)>
<!ELEMENT pickup (#PCDATA)>
<!ELEMENT delivery (#PCDATA)>
<!ELEMENT deliveryIncluded EMPTY>
<!ELEMENT local_delivery_cost (#PCDATA)>
<!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 market_category (#PCDATA)>
<!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 volume (#PCDATA)>
<!ELEMENT part (#PCDATA)>
<!ELEMENT language (#PCDATA)>
<!ELEMENT binding (#PCDATA)>
<!ELEMENT page_extent (#PCDATA)>
<!ELEMENT table_of_contents (#PCDATA)>
<!ELEMENT performed_by (#PCDATA)>
<!ELEMENT performance_type (#PCDATA)>
<!ELEMENT storage (#PCDATA)>
<!ELEMENT format (#PCDATA)>
<!ELEMENT recording_length (#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 promo (#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 room (#PCDATA)>
<!ELEMENT meal (#PCDATA)>
<!ELEMENT included (#PCDATA)>
<!ELEMENT transport (#PCDATA)>
<!ELEMENT price_min (#PCDATA)>
<!ELEMENT price_max (#PCDATA)>
<!ELEMENT options (#PCDATA)>
<!ELEMENT manufacturer_warranty (#PCDATA)>
<!ELEMENT seller_warranty (#PCDATA)>
<!ELEMENT country_of_origin (#PCDATA)>
<!ELEMENT downloadable (#PCDATA)>
<!ELEMENT adult (#PCDATA)>
<!ELEMENT age (#PCDATA)>
<!ELEMENT barcode (#PCDATA)>
<!ELEMENT cpa (#PCDATA)>
<!ELEMENT fee (#PCDATA)>
<!ELEMENT rec (#PCDATA)>
<!ELEMENT expiry (#PCDATA)>
<!ELEMENT weight (#PCDATA)>
<!ELEMENT dimensions (#PCDATA)>
<!ELEMENT param (#PCDATA)>
<!ATTLIST param
    name CDATA #REQUIRED
    unit CDATA #IMPLIED>
<!ELEMENT related_offer (#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 — табуляция, перевод строки, возврат каретки). Также этот стандарт требует обязательной замены некоторых символов (см. таблицу) на эквивалентные им символьные примитивы.

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

Текстовый символ Замена(символьный примитив)

"

&quot;

&

&amp;

>

&gt;

<

&lt;

'

&apos;

Заголовок документа (XML header)

<?xml version="1.0" encoding="windows-1251"?>
<!DOCTYPE yml_catalog SYSTEM "shops.dtd">

Стандартный XML-заголовок со ссылкой на файл описания формата (DTD). Заголовок должен начинаться с первой строки, с нулевого символа.

Вторая строка заголовка XML-документа определяет ссылку на файл описания формата данных (DTD). Здесь достаточно указать только имя файла shops.dtd. Точный путь к этому файлу указывать не надо, так как он расположен на стороне Яндекс.Маркета.

Элемент yml_catalog

<yml_catalog date="2000-11-16 20:17">
<shop>
  ...
  </shop>
  </yml_catalog>

Любой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент yml_catalog. Атрибут date элемента yml_catalog должен соответствовать дате и времени генерации XML-файла на стороне магазина. Дата должна иметь формат YYYY-MM-DD HH:mm.

Элемент shop

<shop>
  <name>BestShop</name>
  <company>Best online seller Inc.</company>
  <url>http://best.seller.ru/</url>
  <platform>CMS</platform>
  <version>2.3</version>
  <agency>Agency</agency>
  <email>CMS@CMS.ru</email>

  <currencies> ... </currencies>
  <categories> ... </categories>
  <cpa> ... </cpa>
  <fee> ... </fee>
  <offers> ... </offers>


</shop>

В элементе shop содержится описание магазина и товаров магазина. Магазин описывается следующими полями:

Поле Описание

name

Короткое название магазина (название, которое выводится в списке найденных на Яндекс.Маркете товаров). Не должно содержать более 20 символов. Нельзя использовать слова, не имеющие отношения к наименованию магазина ("лучший", "дешевый"), указывать номер телефона и т.п. Название магазина, должно совпадать с фактическим названием магазина, которое публикуется на сайте. При несоблюдении данного требования наименование может быть изменено Яндексом самостоятельно без уведомления Клиента.

Обязательное поле.

company

Полное наименование компании, владеющей магазином. Не публикуется, используется для внутренней идентификации.

Обязательное поле.

url

URL-адрес главной страницы магазина.

Обязательное поле.

platform

Система управления контентом, на основе которой работает магазин (CMS).

Необязательное поле.

version

Версия CMS.

Необязательное поле.

agency

Наименование агентства, которое оказывает техническую поддержку интернет-магазину и отвечает за работоспособность сайта.

Необязательное поле.

email

Контактный адрес разработчиков CMS или агентства, осуществляющего техподдержку.

Необязательное поле.

cpa

Элемент предназначен для управления участием товарных предложений в программе «Покупка на Маркете».

Необязательное поле.

Элемент cpa

Указанный элемент предназначен для возможности управления участием всего магазина (всех товарных предложений магазина) в проекте «Покупка на Маркете». Значение элемента cpa учитывается только в том случае, если в Веб-интерфейсе Магазин подтвердил свое желание размещать Товарные предложения в проекте «Покупка на Маркете».

Элемент может принимать следующие значения:

  • «0» — товар/YML-файл не участвует в проекте «Покупке на Маркете»;
  • «1» — товар/YML-файл участвует в проекте «Покупке на Маркете».

Значение по умолчанию для всех товарных предложений магазина — «1».

Если указано другое значение, то оно автоматически принимается равным «0».

Элемент currencies


<currencies>
  <currency id="RUR" rate="1"/>

  <currency id="USD" rate="23.98"/>
  <currency id="EUR" rate="36.25"/>
  <currency id="UAH" rate="5.6"/>
  <currency id="KZT" rate="0.19"/>
</currencies>

Элемент currencies задает список курсов валют магазина. Каждая из валют описывается отдельным элементом currency. Параметр id элемента currency указывает код валюты, а параметр rate — курс этой валюты к валюте, взятой за единицу. Параметр rate может иметь так же следующие значения: CBRF, NBU, NBK и CB.

CBRF — курс по Центральному банку РФ.

NBU — курс по Национальному банку Украины.

NBK — курс по Национальному банку Казахстана.

СВ — курс по банку той страны, к которой относится магазин по Своему региону, указанному в Партнерском интерфейсе Яндекс.Маркета.

Данные о ценах принимаются в рублях (RUR, RUB), гривнах (UAH), белорусских рублях (BYR), тенге (KZT), долларах (USD) и евро (EUR). На Яндекс.Маркете цены могут отображаться в рублях, гривнах, белорусских рублях и тенге в зависимости от региона пользователя. Если в вашем YML-файле не задан курс для отображаемой валюты, то используется курс Центрального Банка страны, к которой относится регион пользователя. Применяется курс, установленный на текущий день. Курс обновляется ежедневно в 00.00.

Примеры:
Курс USD и EUR соответствуют курсу ЦБ РФ:

<currencies>

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


</currencies>

курс USD соответствует курсу ЦБ РФ + 3%:

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

Курс USD для Украинского магазина

<currencies>
  <currency id="UAH" rate="1"/>
  <currency id="USD" rate="NBU" plus="1"/>
  <currency id="EUR" rate="NBU" plus="3"/>
  ...
</currencies>

Внимание! В качестве разделителя целой и дробной частей любых чисел в YML, независимо от региональных установок, используется точка (не запятая!). При слишком значительном (больше 30%) отличии значения курса валюты от курса ЦБ РФ или НБУ информационные материалы считаются невалидными.

Элемент 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 — идентификатор предыдущей по иерархии категории товаров

Элемент local_delivery_cost

<local_delivery_cost>300</local_delivery_cost>
В элементе local_delivery_cost указывается стоимость доставки для своего региона.

Элемент offers

<offers>
  <offer>...</offer>
  ...

</offers>

В элементе offers содержится список товарных предложений магазинов. Каждое товарное предложение описывается отдельным элементом offer.

Описание элемента offer

У элемента offer могут быть следующие атрибуты: id, type, available, bid, cbid.

В атрибуте id указывается идентификатор товарного предложения. Атрибут может содержать только цифры и латинские буквы. Максимальная длина id — 20 символов. Идентификатор предложения должен быть уникальным среди всех товарных предложений одного прайс-листа. Если у двух и более товарных предложений указать одинаковые атрибуты id, то идентификатор будет присвоен только первому из этих предложений. Для остальных будет выводиться предупреждающее сообщение об отсутствии идентификатора.

В атрибуте type указывается тип описания.

В атрибуте available указывается статус доступности товара:

  • «false» — товарное предложение на заказ. Магазин готов принять заказ и осуществить поставку товара в течение согласованного с покупателем срока, не превышающего двух месяцев (за исключением товаров, изготавливаемых на заказ, ориентировочный срок поставки которых оговаривается с покупателем во время заказа).
  • «true» — товарное предложение в наличии. Магазин готов сразу договариваться с покупателем о доставке/покупке товара.

В атрибуте bid указывается основная ставка товарного предложения, а в атрибуте cbid — ставка для карточки модели.

В YML существуют несколько типов описаний предложений товаров: "упрощенный", "vendor.model", "book", "audiobook", "artist.title", "tour" и "event-ticket". В зависимости от типа описания используются соответствующие поля, согласно прилагаемой схеме DTD (см. приложение). Товарные предложения, описанные не в соответствии со своим типом, могут не приниматься к публикации.

Описание товарного предложения может быть представлено разными способами. Ниже приведено несколько примеров.

Упрощенное описание:


<offer id="12346" available="true" bid="21">
  <url>http://best.seller.ru/product_page.asp?pid=12348</url>

  <price>699.54</price>
  <currencyId>USD</currencyId>
  <categoryId>6</categoryId>
  <picture>http://best.seller.ru/img/device12345.jpg</picture>
  <store>true</store>
  <pickup>true</pickup>
  <delivery>false</delivery>
  <local_delivery_cost>300</local_delivery_cost>
  <name> Золотые наручные часы </name>
  <vendor> Longines </vendor>
  <vendorCode> A1234567B </vendorCode>
  <description> Изящные золотые часы.</description>
  <sales_notes> Необходима предоплата.</sales_notes>
  <country_of_origin> Швейцария </country_of_origin>

  <barcode>0012345678901</barcode>

</offer>

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



picture
Подарки, сувениры, цветы / Наручные часы
Золотые наручные часы
Цены: 16800р. ($700) в наличии BestShop
Часы можно упаковать в подарочную упаковку.
Доставка: Самовывоз
Код производителя: A1234567B
Страна производства: Швейцария; производитель: Longines. Изящные золотые часы.

Описание товарного предложения типа "vendor.model" (наиболее удобный вариант с точки зрения Яндекс.Маркета):


<offer id="12341" type="vendor.model" available="true" bid="13">

  <url>http://best.seller.ru/product_page.asp?pid=12344</url>
  <price>700</price>
  <currencyId>USD</currencyId>
  <categoryId> 6 </categoryId >
  <picture>http://best.seller.ru/img/device12345.jpg</picture>
  <store>false</store>
  <pickup>false</pickup>
  <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>
  <sales_notes> Необходима предоплата.</sales_notes>
  <manufacturer_warranty>true</manufacturer_warranty>
  <seller_waranty>P3Y</seller_waranty>
  <country_of_origin>Япония</country_of_origin>
  
  <barcode>0123456789012</barcode>

  <cpa>1</cpa>  
  <rec>123123,1214,243</recv 
  <expiry>P5Y</expiry>;   
  <weight>2.07</weight>   
  <dimensions>100/25.45/11.112</dimensions>

  <param name="Максимальный формат">А4</param>
  <param name="Технология печати">термическая струйная</param>
  <param name="Тип печати">Цветная</param>
  <param name="Количество страниц в месяц" unit="стр">1000</param>
  <param name="Потребляемая мощность" unit="Вт">20</param>

</offer>

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



picture
Компьютеры / Принтеры
Принтер НP Deskjet D2663
Цены: 16800 р. ($700) в наличии BestShop
Необходима предоплата.
Доставка: Москва 300 р.
Код производителя: CH366C
Серия принтеров для людей, которым нужен надежный, простой в использовании цветной принтер для повседневной печати. Формат А4. Технология печати: 4-цветная термальная струйная. Разрешение при печати: 4800х1200 т/д.

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

Элементы

Описание

url

URL страницы товара. Максимальная длина URL — 512 символов.

Необязательный элемент для магазинов-салонов.

price

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

Обязательный элемент.

currencyId

Идентификатор валюты товара (RUR, USD, UAH, KZT). Для корректного отображения цены в национальной валюте необходимо использовать идентификатор (например, UAH) с соответствующим значением цены.

Обязательный элемент.

categoryId

Идентификатор категории товара (целое число не более 18 знаков). Товарное предложение может принадлежать только одной категории.

Обязательный элемент. Элемент offer может содержать только один элемент categoryId.

picture

Ссылка на картинку соответствующего товарного предложения. Недопустимо давать ссылку на "заглушку", т.е. на картинку где написано "картинка отсутствует", или на логотип магазина. Максимальная длина URL — 512 символов.

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

store

Элемент позволяет указать возможность купить соответствующий товар в розничном магазине.

Возможные значения:

1) false — возможность покупки в розничном магазине отсутствует;

2) true — товар можно купить в розничном магазине.

Необязательный элемент.

pickup

Элемент позволяет указать возможность зарезервировать выбранный товар и забрать его самостоятельно.

Возможные значения:

1) false — возможность «самовывоза» отсутствует;

2) true — товар можно забрать самостоятельно.

Необязательный элемент.

delivery

Элемент позволяет указать возможность доставки соответствующего товара.

Возможные значения:

1) false — товар не может быть доставлен;

2) true — товар доставляется на условиях, которые описываются в партнерском интерфейсе в разделе Параметры размещения.

Необязательный элемент.

local_delivery_cost

Стоимость доставки данного товара в своем регионе.

Необязательный элемент.

typePrefix

Группа товаров \ категория.

Необязательный элемент.

vendor

Производитель.

Обязательный элемент.

vendorCode

Код товара (указывается код производителя).

Необязательный элемент.

model

Модель.

Обязательный элемент.

description

Описание товарного предложения.

Необязательный элемент.

sales_notes

Элемент используется для отражения информации о минимальной сумме заказа, минимальной партии товара или необходимости предоплаты, а так же для описания акций, скидок и распродаж.

Допустимая длина текста в элементе — 50 символов.

Необязательный элемент.

manufacturer_warranty

Элемент предназначен для отметки товаров, имеющих официальную гарантию производителя.

Возможные значения:

1) false — товар не имеет официальной гарантии;

2) true — товар имеет официальную гарантию;

3) указание срока гарантии. Формат должен соответствовать ISO 8601, например: P1Y2M10DT2H30M. Расшифровка — 1 год, 2 месяца, 10 дней, 2 часа и 30 минут.

Необязательный элемент.

seller_warranty

Элемент предназначен для отметки товаров, имеющих гарантию продавца.

Необязательный элемент.

Возможные значения:

1) false — товар не имеет гарантию продавца;

2) true — товар имеет гарантию продавца;

3) указание срока гарантии. Формат должен соответствовать ISO 8601, например: P3Y. Расшифровка — 3 года.

country_of_origin

Элемент предназначен для указания страны производства товара. Список стран, которые могут быть указаны в этом элементе, доступен по адресу: http://partner.market.yandex.ru/pages/help/Countries.pdf.

Если вы хотите участвовать в Покупке на Маркете, то желательно указывать данный элемент в YML-файле.

Необязательный элемент.

downloadable

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

Необязательный элемент.

adult

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

Необязательный элемент.

age

Возрастная категория товара. Допустимые значения: 0, 6, 12, 16, 18.

Необязательный элемент.

barcode

Штрихкод товара, указанный производителем.

Необязательный элемент. Элемент offer может содержать несколько элементов barcode.

cpa

Элемент предназначен для управления участием товарных предложений в программе «Покупка на Маркете».

Необязательный элемент.

rec

Элемент обозначает товары, рекомендуемые для покупки вместе с текущим.

Необязательный элемент.

expiry

Элемент предназначен для указания срока годности/срока службы либо для указания даты истечения срока годности \ срока службы.

Значение элемента должно быть в формате ISO8601:

для срока годности \ срока службы: P1Y2M10DT2H30M. Расшифровка примера — 1 год, 2 месяца, 10 дней, 2 часа и 30 минут;

для даты истечения срока годности \ срока службы: YYYY-MM-DDThh:mm.

Необязательный элемент.

weight

Элемент предназначен для указания веса товара. Вес указывается в килограммах с учетом упаковки.

Формат элемента: положительное число с точностью 0.001, разделитель целой и дробной части — точка.

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

если 4-ый знак после разделителя меньше 5, то 3-й знак сохраняется, а все последующие обнуляются;

если 4-ый знак после разделителя больше или равен 5, то 3-й знак увеличивается на единицу, а все последующие обнуляются.

Необязательный элемент.

dimensions

Элемент предназначен для указания габаритов товара (длина, ширина, высота) в упаковке. Размеры указываются в сантиметрах.

Формат элемента: три положительных числа с точностью 0.001, разделитель целой и дробной части — точка. Числа должны быть разделены символом «/» без пробелов.

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

если 4-ый знак после разделителя меньше 5, то 3-й знак сохраняется, а все последующие обнуляются;

если 4-ый знак после разделителя больше или равен 5, то 3-й знак увеличивается на единицу, а все последующие обнуляются.

Необязательный элемент.

param

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

Необязательный элемент. Элемент offer может содержать несколько элементов param.

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

Книги

  <offer id="12342" type="book" available="true" bid="17">
  <url>http://best.seller.ru/product_page.asp?pid=14345</url>
  <price>80</price>
  <currencyId>RUR</currencyId>

  <categoryId>3</categoryId>
  <picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
  <store>true</store>
  <pickup>false</pickup>
  <delivery>true</delivery>
  <local_delivery_cost>300</local_delivery_cost>
  <author>Александра Маринина</author>
  <name>Все не так. В 2 томах. Том 1</name>

  <publisher>ЭКСМО — Пресс</publisher>
  <series>А. Маринина — королева детектива</series>
  <year>2007</year>
  <ISBN>978-5-699-23647-3</ISBN>
  <volume>2</volume>
  <part>1</part>
  <language>rus </language>
  <binding>70x90/32</binding>
  <page_extent>288</page_extent>

  <description>
Все прекрасно в большом патриархальном семействе Руденко. Но — увы! — 
впечатление это обманчиво: каждого из многочисленных (еще)Все прекрасно в 
большом патриархальном семействе Руденко. Но — увы! — впечатление это обманчиво:
 каждого из многочисленных представителей семьи обуревают свои потаенные страсти
 и запретные желания. И потому, когда погибает, причем явно.
  </description>

  <downloadable>false</downloadable>


</offer>

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



picture
Книги / Художественная литература / Детективы
Александра Маринина "Все не так. В 2 томах. Том 1"
80 р. в наличии BestShop
Доставка: Москва 300 руб.
Издательство: Эксмо
Год издания: 2007
Автор: Александра Маринина
Серия: А. Маринина — королева детектива
ISBN: 978-5-699-23647-3
Все прекрасно в большом патриархальном семействе Руденко. Но — увы! — впечатление это обманчиво: каждого из многочисленных Все прекрасно в большом патриархальном семействе Руденко. Но — увы! — впечатление это обманчиво: каждого из многочисленных представителей семьи обуревают свои потаенные страсти и запретные желания. И потому, когда погибает, причем явно.

элемент

Описание

author

Автор произведения

name

Наименование произведения

publisher

Издательство

series

Серия

year

Год издания

ISBN

Код книги, если их несколько, то указываются через запятую.

description

Аннотация к книге.

volume

Количество томов.

part

Номер тома.

language

Язык произведения.

binding

Переплет.

page_extent

Количествово страниц в книге, должно быть целым положиельным числом.

table_of_contents

Оглавление. Выводится информация о наименованиях произведений, если это сборник рассказов или стихов.

age

Возрастная категория товара. Допустимые значения: 0, 6, 12, 16, 18.

Аудиокниги


  <offer id="12342" type="audiobook" available="true" bid="17">
  <url>http://best.seller.ru/product_page.asp?pid=14345</url>
  <price>200</price>
  <currencyId>RUR</currencyId>
  <categoryId>3</categoryId>
  <picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
  <store>true</store>
  <pickup>true</pickup>
  <delivery>true</delivery>
  <author> Владимир Кунин </author>
  <name> Иваnов и Rабинович, или Аj'гоу ту 'Хаjфа!</name>
  <publisher>1С-Паблишинг, Союз</publisher>
  <year>2008</year>
  <ISBN>978-5-9677-0757-5</ISBN>
  <language>ru </language>
  <performed_by> Николай Фоменко </performed_by>
  <performance_type>начитана </performance_type>
..<storage>CD </storage>
..<format>mp3 </format>
..<recording_length>45m23s</recording_length>

  <description> Перу Владимира Кунина принадлежат десятки сценариев к
 кинофильмам, серия книг про КЫСЮ и многое, многое другое.

</description>
  <downloadable>true</downloadable>

</offer>

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



picture
Книги / Аудиокниги
Владимир Кунин "Иваnов и Rабинович, или Аj'гоу ту 'Хаjфа!"
200р. в наличии BestShop
Товар можно скачать
Доставка: Москва 300 руб.
Издательство: 1С-Паблишинг, Союз
Год издания: 2008
Автор: Владимир Кунин
ISBN: 978-5-9677-0757-5
Формат: начитан
Язык: руский
Исполнитель: Николай Фоменко
Носитель: CD
Формат:mp3
Время звучания: 4 часа 35 минут
Перу Владимира Кунина принадлежат десятки сценариев к кинофильмам, серия книг про КЫСЮ и многое, многое другое.
элемент Описание

author

Автор произведения

name

Наименование произведения

publisher

Издательство

series

Серия

year

Год издания

ISBN

Код книги, если их несколько, то указываются через запятую.

description

Аннотация к книге.

performed_by

Исполнитель. Если их несколько, перечисляются через запятую

performance_type

Тип аудиокниги (радиоспектакль, произведение начитано, ...)

language

Язык произведения.

volume

Номер тома.

part

Номер части.

format

Формат аудиокниги.

storage

Носитель, на котором поставляется аудиокнига.

recording_length

Время звучания задается в формате mm.ss (минуты.секунды).

table_of_contents

Оглавление. Выводится информация о наименованиях произведений, если это сборник рассказов или стихов.

age

Возрастная категория товара. Допустимые значения: 0, 6, 12, 16, 18.

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

<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>
  <store>true</store>
  <pickup>true</pickup>
  <delivery>false</delivery>
  <artist>Pink Floyd</artist>
  <title>Dark Side Of The Moon, Platinum Disc</title>
  <year>1999<year>

  <media>CD</media>
  
  <barcode>1234567890123</barcode>


<description> Dark Side Of The Moon, поставивший мир на уши
 невиданным сочетанием звуков, — это всего-навсего девять 
треков, и даже не все они писались специально для альбома. 
Порывшись по сусекам, участники Pink Floyd мудро сделали 
новое из хорошо забытого старого — песен, которые 
почему-либо не пошли в дело или остались незаконченными. 
Одним из источников вдохновения стали саундтреки 
для кинофильмов, которые группа производила в больших количествах.

</description>


</offer>

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



picture
Музыка
Pink Floyd "Dark Side Of The Moon, Platinum Disc"
Цены: 450 р. ($15)в наличии BestShop
Доставка: Москва 300 руб.
Год издания: 1999
Носитель: CD
"Dark Side Of The Moon", поставивший мир на уши невиданным сочетанием звуков, — это всего-навсего девять треков, и даже не все они писались специально для альбома. Порывшись по сусекам, участники Pink Floyd мудро сделали новое из хорошо забытого старого — песен, которые почему-либо не пошли в дело или остались незаконченными. Одним из источников вдохновения стали саундтреки для кинофильмов, которые группа производила в больших количествах.

элемент

Описание

artist

Исполнитель

title

Наименование

year

Год

media

Носитель

age

Возрастная категория товара. Допустимые значения: 0, 6, 12, 16, 18.

barcode

Штрихкод товара, указанный производителем.

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

<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>
  <store>true</store>
  <pickup>true</pickup>
  <delivery>true</delivery>
  <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>
  
  <barcode>2345678901234</barcode>


</offer>

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



picture
Фильмы
Свадьба Мюриэл
Цены: 93 р. BestShop
Доступность: в наличии
Доставка: Россия
Носитель: DVD
Год издания: 1999
Режиссер: П. Д. Хоган
Страна: Австралия
Оригинальное название: Muriel's Wedding
Главные роли: Тони Колетт (Toni Collette), Рэйчел Грифитс (Rachel Griffiths)
"Гадкий утенок" из провинциального городка покидает свое гнездо, и в компании своей подруги отправляется искать веселой жизни в большой и загадочный город. Фильм о мечтах и реальности, дружбе и юности молодой девушки, приключения которой повторяют судьбы Золушки и героини Джулии Робертс из ставшего классикой фильма "Красотка"...

элемент

Описание

title

Название фильма

starring

Актеры

director

Режиссер

originalName

Оригинальное наименование

country

Страна

year

Год

media

Носитель

adult

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

age

Возрастная категория товара. Допустимые значения: 0, 6, 12, 16, 18.

barcode

Штрихкод товара, указанный производителем.

Описание тура

<offer id="12341" type="tour" available="true" bid="71">
  <url>http://best.seller.ru/product_page.asp?pid=12344</url>
  <price>958</price>

  <currencyId>USD</currencyId>
  <categoryId>6</categoryId>
  <picture>http://best.seller.ru/img/device12345.jpg</picture>
  <store>true</store>
  <pickup>false</pickup>
  <delivery>false</delivery>
  <local_delivery_cost>300</local_delivery_cost>
  <worldRegion>Африка</worldRegion>

  <country>Египет</country>
  <region>Хургада</region>
  <days>7</days>
  <dataTour>01/01/03</dataTour>

  <dataTour>08/01/03</dataTour>
  <name>Hilton</name>
  <hotel_stars>5*****</hotel_stars>
  <room>SNG</room>

  <meal>ALL</meal>
  <included>авиаперелет, трансфер, проживание, питание, страховка</included>
  <transport>Авиа</transport>
  <description></description>


</offer>

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



picture
Тур Африка Египет Хургада Hilton 5***** SNG ALL на 7 дн.
Цена: 24 129р. ($958) в наличии BestShop
Доставка: Самовывоз
Даты заездов: 26.11
Транспорт: авиа
Включено: авиаперелет, трансфер, проживание, питание, страховка
Транспорт: Авиа.
Отель: 5*

элемент

Описание

worldRegion

Часть света

country

Страна

region

Курорт или город

days

Количество дней тура

dataTour

Даты заездов

name

Название отеля (в некоторых случаях наименование тура)

hotel_stars

Звезды S отеля 5*****

room

Тип комнаты (SNG, DBL......)

meal

Тип питания (All, HB......)

included

Что включено в стоимость тура

transport

Транспорт

description

Описание тура

age

Возрастная категория товара. Допустимые значения: 0, 6, 12, 16, 18.

Описание билетов на мероприятия


 <offer id="1234" type="event-ticket"  available="true" bid="13"> 
 <url>url товарного предложения</url>
 <price>100000</price>
 <currencyId>RUR</currencyId>
 <categoryId>3</categoryId> 
 <picture>url картинки товарного предложения</picture>
 <store>true</store>
 <pickup>false</pickup>
 <delivery>true</delivery>
 <local_delivery_cost>300</local_delivery_cost>
 <name>Дмитрий Хворостовский и Национальный филармонический
 оркестр России. Дирижер — Владимир Спиваков.</name>
 <place>Московский  международный Дом музыки</place>
 <hall plan="url плана зала">Большой  зал<hall>
 <hall_part>Партер р. 1-5<hall_part>

 <date>2004-12-31T19:00</date> 
 <is_premiere>0<is_premiere>
 <is_kids>0</is_kids>
 <description>описание товарного предложения.</description>


</offer>

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



picture
Дмитрий Хворостовский и Национальный филармонический оркестр России. Дирижер — Владимир Спиваков 31.12
Цена: 1000р. ($958) в наличии BestShop
Доставка: Москва 300 руб.
Места: Партер р.1-5
Где: Московский Международный Дом музыки

элемент

Описание

name

Название мероприятия

place

Зал

hall plan

Ссылка на картинку версии зала

date

Дата и время сеанса. Указываются в формате ISO 8601: YYYY-MM-DDThh:mm

is_premiere

Признак премьерности мероприятия

is_kids

Признак детского мероприятия

age

Возрастная категория товара. Допустимые значения: 0, 6, 12, 16, 18.


Элементы, которые не были описаны в примерах, являются резервными и не обрабатываются.

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

Условия предоставления информации о товаре/услуги, участвующих в проекте «Покупка на Маркете»

При предоставлении информации о товаре/услуге, необходимой для проекта «Покупка на Маркете» (функциональность сервиса Яндекс.Маркет, позволяющая Пользователям оформлять заказ товаров/услуг непосредственно на сервисе Яндекс.Маркет, без перехода на сайт магазина), дополнительно к требованиям к элементам shop и offers, описанным в настоящем документе, применяются нижеописанные условия.

В элементе offers обязательно должен быть указан элемент id в описании Товарного предложения. При этом элементы cpa, country_of_origin, manufacturer_warranty, seller_warranty, rec, expiry, weight, dimensions в элементе offers могут быть предоставлены.

Элемент id

Для Товарных предложений, участвующих в проекте «Покупка на Маркете» в элементе offer элемент id должен быть указан обязательно. В случае, если элемент id не указан для Товарного предложения, то независимо от значение, установленного для элемента cpa, товарное предложение не участвует в проекте «Покупка на Маркете».

В элементе id указывается идентификатор Товарного предложения. Элемент может содержать только цифры и латинские буквы. Максимальная длина id — 20 символов.

Пример:

<offer id="123" type="vendor.model" available="true">
<url>...</url>
...
</offer>

Элемент cpa (признак участия товарного предложение в проекте «Покупка на Маркете»)

Указанный элемент предназначен для возможности управления участием всех товарных предложений магазина или отдельных товарных предложений в проекте «Покупка на Маркете». Значение элемента cpa учитывается только в том случае, если «Магазин» в Веб-интерфейсе подтвердил свое желание размещать Товарные предложения в проекте «Покупка на Маркете».

Если элемент не указан на уровне элемента shop то по умолчанию все товарные предложения имеют значение cpa = 1 и участвуют в данной программе.

Если элемент не указан на уровне элемента offer, то Товарное предложение наследует значение cpa, установленное для элемента shop.

Описание вариантов использования элемента cpa:

1. Исключение несколько товарных предложений из проекта «Покупка на Маркете»

Для того чтобы исключить некоторые товарные предложения из проекта «Покупки на Маркете» в YML-файле для данных товарных предложение в элементе offer нужно установить cpa равный 0. Пример:

<shop> 
    <name>BestShop</name> 
    <company>Best online seller Inc.</company> 
    <url>http://best.seller.ru/</url>
    <platform>CMS</platform> 
    <version>2.3</version> 
    <agency>Agency<a/gency> 
    ...
   <offers> 
<offer id=”12346” available=” true” bid=”21”> 
    <url>http://best.seller.ru/product_page.asp?pid=12348</url>
    <price>699.54</price> 
    <currencyId>USD</currencyId> 
    <categoryId>6</categoryId>
…
    <cpa>0</cpa>
</offer>
<offer id=”12348” available=” true” bid=”24”> 
    <url>http://best.seller.ru/product_page.asp?pid=12344</url>
    <price>699.54</price> 
    <currencyId>USD</currencyId> 
    <categoryId>8</categoryId>
…
    <cpa>0</cpa>
</offer>
 </offers> 
</shop>

2. Размещение нескольких товарных предложений в проекте «Покупка на Маркете»

Для того чтобы разместить только несколько товарных предложений в проекте «Покупки на Маркете» в YML-файле в элемент shop необходимо добавить элемент cpa равный 0, для выбранных вами товарных предложение в элементе offer нужно установить cpa равный 1. Пример:

<shop> 
    <name>BestShop</name> 
    <company>Best online seller Inc.</ company> 
    <url>http://best.seller.ru/</url>
    <platform>CMS</platform> 
    <version>2.3</version> 
    <agency>Agency<a/gency> 
    ...
    <cpa>0</cpa>
    <offers> 
<offer id=”12346” available=” true” bid=”21”> 
    <url>http://best.seller.ru/product_page.asp?pid=12348</url>
    <price>699.54</price> 
    <currencyId>USD</currencyId> 
    <categoryId>6</categoryId>
…
    <cpa>1</cpa>
</offer>
<offer id=”12348” available=” true” bid=”24”> 
    <url>http://best.seller.ru/product_page.asp?pid=12344</url>
    <price>699.54</price> 
    <currencyId>USD</currencyId> 
    <categoryId>8</categoryId>
…
    <cpa>1</cpa>
</offer>
</offers> 
</shop>

3. Исключение всех товарных предложений, включенных в один YML-файл, из проекта «Покупка на Маркете»

Для того чтобы исключить все товарные предложения, включенные в отдельный YML-файл, из проекта «Покупки на Маркете» в YML-файле в элементе shop нужно установить cpa равный 0. Пример:

<shop> 
    <name>BestShop</name> 
    <company>Best online seller Inc.</ company> 
    <url>http://best.seller.ru/</url>
    <platform>CMS</platform> 
    <version>2.3</version> 
    <agency>Agency<a/gency> 
    ...
    <cpa>0</cpa>
   <offers> 
<offer id=”12346” available=” true” bid=”21”> 
…
</offer>
<offer id=”12348” available=” true” bid=”24”> 
…
</offer>
</offers> 
</shop>

Элемент country_of_origin

Для целей размещения информации о Товарном предложении, участвующем в проекте «Покупка на Маркете», элемент country_of_origin желательно указывать в описании Товарного предложения.

Элемент country_of_origin предназначен для указания страны производства товара. Список стран, которые могут быть указаны в этом элементе, доступен по адресу: http://partner.market.yandex.ru/pages/help/Countries.pdf.

Элементы manufacturer_warranty и seller_warranty

Для целей размещения информации о Товарных предложениях, участвующих в проекте «Покупка на Маркете», элементы manufacturer_warranty или seller_warranty желательно указывать в описании Товарного предложения.

Элемент manufacturer_warranty предназначен для указания товаров, имеющих гарантию производителя.

Возможные значения:

1) false — товар не имеет гарантии производителя;

2) true — товар имеет гарантию производителя;

3) указание срока гарантии. Формат должен соответствовать ISO 8601, например: P1Y2M10DT2H30M. Расшифровка — 1 год, 2 месяца, 10 дней, 2 часа и 30 минут.

Формат параметра «срок гарантии» должен соответствовать ISO 8601: P1Y2M10DT2H30M. В данном примере гарантийный срок: 1 год, 2 месяца, 10 дней, 2 часа и 30 минут.

Элемент seller_warranty предназначен для указания товаров, имеющих гарантию, установленную продавцом.

Возможные значения:

1) false — товар не имеет гарантии, предоставляемой продавцом;

2) true — товар имеет гарантию, предоставляемую продавцом;

3) Формат параметра в случае указания срока должен соответствовать ISO 8601:P1Y2M10DT2H30M. В данном примере гарантийный срок: 1 год, 2 месяца, 10 дней, 2 часа и 30 минут.

В примере ниже гарантийный срок производителя – 2 года, гарантийный срок продавца - 3 года:

    <offer id="12346" available="true" bid="21">
    <url>http://best.seller.ru/product_page.asp?pid=12348</url>
    <price>699.54</price>
    <currencyId>USD</currencyId>
    <categoryId>6</categoryId>
    <picture>http://best.seller.ru/img/device12345.jpg</picture>
    <store>false</store>
    <pickup>true</pickup>
    <delivery>false</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <name>Золотые наручные часы </name>
    <vendorCode>A1234567B</vendorCode>
    <description>Изящные золотые часы.</description>
    <sales_notes>Необходима предоплата.</sales_notes>
    <manufacturer_warranty> P2Y </manufacturer_warranty>
    <seller_warranty> P3Y </seller_warranty>
    <country_of_origin>Швейцария</country_of_origin>
    <barcode>0123456789012</barcode>
    </offer>

Элемент rec

С помощью элемента rec задаются товары, рекомендуемые для покупки вместе с текущим, например, аксессуары. Параметр является необязательным.

В элементе rec указываются идентификаторы товарных предложений (атрибут id элемента offer) через запятую без пробелов. Атрибут id может содержать цифры и латинские буквы; максимальная длина каждого id — 20 символов.

Если rec отсутствует, то у магазина нет рекомендованных товаров для данного товарного предложения.

Если в rec указать несуществующий id, или id, которого нет в текущем прайс-листе, то элемент будет считаться пустым.

Пример:

<offer id="12346" available="true" bid="21">
    <url>http://best.seller.ru/product_page.asp?pid=12348</url>
    <price>699.54</price>
    <currencyId>USD</currencyId>
    <categoryId>6</categoryId>
    <picture>http://best.seller.ru/img/device12345.jpg</picture>
    <store>false</store>
    <pickup>true</pickup>
    <delivery>true</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <name>Наручные часы</name>
    <vendorCode>A1234567B</vendorCode>
    <description>Изящные наручные часы.</description>
    <sales_notes>Необходима предоплата.</sales_notes>
    <manufacturer_warranty>true</manufacturer_warranty>
    <country_of_origin>Швейцария</country_of_origin>
    <barcode>0123456789012</barcode>
    <cpa>1</cpa>
   <rec>123123,1214,243</rec>
    <param>...</param>
  </offer>

Элемент expiry

Элемент expiry - срок годности товара.

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

Формат элемента в случае указания даты истечения срока годности/службы: указывается в формате ISO 8601: YYYY-MM-DDThh:mm.

Формат элемента в случае указания продолжительности срока годности/службы: указывается в формате ISO 8601:P1Y2M10DT2H30M. В данном примере срок годности: 1 год, 2 месяца, 10 дней, 2 часа и 30 минут.

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

Пример:

<offer id="12346" available="true" bid="21"> 
 <url>http://best.seller.ru/product_page.asp?pid=12348</url> 
 <price>699.54</price> 
 <currencyId>USD</currencyId> 
 <categoryId>6</categoryId> 
 <picture>http://best.seller.ru/img/device12345.jpg</picture> 
 <store>false</store> 
 <pickup>true</pickup> 
 <delivery>true</delivery> 
 <local_delivery_cost>300</local_delivery_cost> 
 <name>Наручные часы</name> 
 <vendorCode>A1234567B</vendorCode> 
 <description>Изящные наручные часы.</description> 
 <sales_notes>Необходима предоплата.</sales_notes> 
 <manufacturer_warranty>true</manufacturer_warranty> 
 <country_of_origin>Швейцария</country_of_origin> 
 <barcode>0123456789012</barcode> 
 <cpa>1</cpa> 
 <fee>0.07</fee> 
 <rec>123123,1214,243</rec> 
 <expiry>P5Y<expiry>
 <param>…</param> 
</offer>

Элемент weight

Элемент weight - вес товара.

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

Формат элемента: положительное число с точностью 0.001. Разделитель целой и дробной части - точка. Если указана более высокая точность, то округляется по математическим правилам до тысячных:

- если 4-й знак после разделителя точки < 5, то 3-й знак сохраняется, а 4-й и все последующие обнуляются;

- если 4-й знак после разделителя точки ≥ 5, то 3-й знак увеличивается на единицу, а 4-й и все последующие обнуляются.

Элемент необязательный.

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

Пример:

<offer id="12346" available="true" bid="21"> 
 <url>http://best.seller.ru/product_page.asp?pid=12348</url> 
 <price>699.54</price> 
 <currencyId>USD</currencyId> 
 <categoryId>6</categoryId> 
 <picture>http://best.seller.ru/img/device12345.jpg</picture> 
 <store>false</store> 
 <pickup>true</pickup> 
 <delivery>true</delivery> 
 <local_delivery_cost>300</local_delivery_cost> 
 <name>Наручные часы</name> 
 <vendorCode>A1234567B</vendorCode> 
 <description>Изящные наручные часы.</description> 
 <sales_notes>Необходима предоплата.</sales_notes> 
 <manufacturer_warranty>true</manufacturer_warranty> 
 <country_of_origin>Швейцария</country_of_origin> 
 <barcode>0123456789012</barcode> 
 <cpa>1</cpa> 
 <fee>0.07</fee> 
 <expiry>P5Y<expiry>
 <weight>2.07</weight> 
 <param>…</param> 
</offer>

Элемент dimensions

Элемент dimensions - габариты товара.

В элементе dimensions можно указать габариты товара (длина, ширина, высота) в упаковке, где единица измерения по каждой стороне - сантиметры.

Формат элемента: положительное число с точностью 0.001, разделенные знаком «/». Разделитель целой и дробной части у каждого измерения - точка. Если указана более высокая точность, то округляется по математическим правилам до тысячных:

- если 4-й знак после разделителя точки < 5, то 3-й знак сохраняется, а 4 и все последующие обнуляются.

- если 4-й знак после разделителя точки ≥ 5, то 3-й знак увеличивается на единицу, а 4-й и все последующие обнуляются.

Элемент необязательный.

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

Пример:

<offer id="12346" available="true" bid="21"> 
 <url>http://best.seller.ru/product_page.asp?pid=12348</url> 
 <price>699.54</price> 
 <currencyId>USD</currencyId> 
 <categoryId>6</categoryId> 
 <picture>http://best.seller.ru/img/device12345.jpg</picture> 
 <store>false</store> 
 <pickup>true</pickup> 
 <delivery>true</delivery> 
 <local_delivery_cost>300</local_delivery_cost> 
 <name>Наручные часы</name> 
 <vendorCode>A1234567B</vendorCode> 
 <description>Изящные наручные часы.</description> 
 <sales_notes>Необходима предоплата.</sales_notes> 
 <manufacturer_warranty>true</manufacturer_warranty> 
 <country_of_origin>Швейцария</country_of_origin> 
 <barcode>0123456789012</barcode> 
 <cpa>1</cpa> 
 <fee>0.07</fee> 
 <expiry>P5Y<expiry>
 <weight>2.07</weight> 
 <dimensions>100/25.45/11.112</weight> 
 <param>…</param> 
</offer>

Элемент picture

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

Пример:

<picture>http://best.seller.ru/img/device12345.jpg</picture>
<picture>http://best.seller.ru/img/device123456.jpg</picture>
<picture>http://best.seller.ru/img/device123457.jpg</picture>

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

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

Ссылка на HTML с изображением не допустима.

Элементы description, name и sales_notes

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

В элементах <description>, <name> и <sales_notes> запрещено указывать информацию о доставке, гарантии, месте производства (данная информация указывается при заполнении соответствующих ей элементов).

Элемент adult

Элемент <adult> обязателен для обозначения товара, имеющего отношение к удовлетворению сексуальных потребностей, либо иным образом эксплуатирующего интерес к сексу.

Предложения магазина, помеченные тегом <adult>, будут отображаться на странице выдачи результатов поиска Яндекса в блоке Маркета только при выключенном семейном фильтре и по строго определенным запросам. На поиске Маркета данные предложения будут отображаться только после подтверждения пользователем достижения возраста 18 лет.

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

Например:

<adult>true</adult>
<offers>
    <offers>...</offers>
    ...
</offers>

Например:

<offer>
    ...
    <typePrefix>Вибратор гелевый</typePrefix>
    <vendor>Robotic</vendor>
    <model>Реалистик 9</model>
    ...
    <adult>true</adult>
    ...
<offer>

Элемент barcode

Элемент <barcode> предназначен для передачи численных штрихкодов (баркодов) товара. В теге <barcode> необходимо передавать штрихкоды производителя. Если ваш магазин использует свою внутреннюю систему штрихкодов, отличных от штрихкодов производителей, передавать такие внутренние штрихкоды не нужно.

Один элемент <barcode> должен содержать один штрихкод, при этом в элемент <offer> может быть включено любое количество элементов <barcode>, так как одному товару может соответствовать несколько штрихкодов производителя, указанных в разных системах.

В теге <barcode> могут быть указаны только цифры. Пробелы, символы и буквы при проверке YML-файла будут восприниматься как ошибка.

Штрихкоды могут содержать 8, 12 и 13 цифр. Штрихкоды, содержащие более 13 цифр, используются для маркировки траспортной упаковки товара и для обмена данными между предприятиями. Такие штрихкоды передавать не нужно.

Например:

<offer>
    ...
    <typePrefix>Корпус</typePrefix>
    <vendor>Cooler Master</vendor>
    <model>RС-1100 (Cosmos S)</model>
    ...
    <barcode>4719512011041</barcode>
    <barcode>884102000539</barcode>
    ...
<offer>

Использование элемента <barcode> является опциональным.

Элемент param

Элемент param предназначен для передачи информации о характеристиках товара. Для каждого товарного предложения можно указать несколько элементов param, каждый из которых содержит одну характеристику товара.

Элемент описывается как <param name="NAME" unit="UNIT">VALUE</param> где:

NAME — название параметра;
UNIT — единица измерения (необязательный атрибут);
VALUE — значение параметра.

Например:

<offer>
   ...
   <param name="Тип процессора">Atom</param>
   <param name="Размер оперативной памяти" unit="Мб">2048</param>
   <param name="Типоразмер корпуса">Micro-Tower</param>
   <param name="Объём жесткого диска" unit="Гб">500</param>
  </offer>

Управление расценками (ставками) через XML

Управление ставками приоритета может осуществляться двумя способами — путем указания расценок в YML-файле и при помощи правил, задаваемых в Партнерском интерфейсе. Выбор варианта управления расценками (ставками) производится в Партнерском интерфейсе http://partner.market.yandex.ru в разделе "Управление ставками".

Для указания расценок (ставок) в YML-файле используются следующие атрибуты элемента offer:

bid (oсновная ставка) — действует для всех мест приоритетного размещения предложений, если не указана ставка для отдельного места;
cbid (cтавка для карточек) — действует только для страниц "Карточка модели" и "Все предложения модели".

Если ни один из атрибутов не задан, — для определения цены клика используются фиксированные цены, согласно описанию в "Общих условиях". Если задан bid, но не задан cbid, то считается, что cbid=bid. Если задан cbid, но не задан bid, то bid равен фиксированной цене за клик.

Например:

  <offer id="107" type="vendor.model" bid="23" cbid="43" available="true">
   <url>http://</url>
   <price>55</price>
   <currencyId>USD</currencyId>

   <categoryId>35</categoryId>
   <picture>http://</picture>
   <delivery>false</delivery>   
   <typePrefix>Наушники</typePrefix>
   <vendor>SONY</vendor>

   <model>MDR-CD480</model>
   <description> </description>
  </offer>

В приведенном выше примере цена перехода с "Блока Маркета" на основном поиске Яндекса будет равна 0.23 у.е. (bid="23") и со страницы "Все предложения модели" по 0.43 у.е. (cbid="43"). Если пользователь на странице "Все предложения модели" использовал сортировку, отличную от сортировки по умолчанию, то в этом случае цена перехода равна 0.1 у.е. (фиксированной стоимости размещения).

Примеры и рекомендации

Для аукционного размещения в выдаче основного поиска Яндекса блок offer может выглядеть, например, следующим образом (bid="15" — ставка равна 0.15 у.е.):


  <offer id="107" type="vendor.model" bid="15" available="true">
   <url>http://</url>

   <price>55</price>
   <currencyId>USD</currencyId>
   <categoryId>35</categoryId>
   <picture>http://</picture>
   <delivery>true</delivery>
   <typePrefix>Наушники</typePrefix>
   <vendor>SONY</vendor>
   <model>MDR-CD480</model>
   <description> </description>

  </offer>

В приведенном выше примере цена перехода с мест с возможностью приоритетного размещения будет 0.15 у.е. (переходы с карточек моделей, со страницы "все предложения" модели, с "Блока Маркета" в основном поиске Яндекса и с "Блока Маркета" на сайтах партнеров рекламной сети Яндекса).

Если вы хотите использовать аукционное размещение только в карточке модели, тогда используйте параметр cbid:

  <offer id="107" type="vendor.model" cbid="25" available="true">
   <url>http://</url>

   <price>55</price>
   <currencyId>USD</currencyId>
   <categoryId>35</categoryId>
   <picture>http://</picture>
   <delivery>true</delivery>   
   <typePrefix>Наушники</typePrefix>
   <vendor>SONY</vendor>
   <model>MDR-CD480</model>
   <description> </description>

  </offer>

В приведенном выше примере цена перехода будет 0.25 у.е. (переходы с карточек моделей и страницы "все предложения модели").

Еще раз обращаем ваше внимание на то, что значение bid, cbid — это размер расценки. Ее значение должно быть целым положительным числом. Например 21, или 42, или 65.

Подключение услуги "Приоритет" может быть произведено одним из двух способов: через YML-файл или через Партнерский интерфейс. Выбор способа указания ставок для участия в приоритетном размещении производится в Партнерском интерфейсе магазина (http://partner.market.yandex.ru).

Внимание: прежде чем отправить в Яндекс.Маркет новый YML-файл с установленными размерами ставок, рекомендуется проверить его на валидность в Партнерском интерфейсе в разделе «Проверка YML файла».

Проверка статистики

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

Поэтому, для получения реальной картины эффективности рекламной компании, кроме данных, предоставляемых Яндекс.Маркетом, необходимо учитывать еще и переходы с этих дополнительных источников трафика.

Организовать сбор данных обо всех переходах достаточно просто. Для этого необходимо в URL товарного предложения, подготовленного для показа на Яндекс.Маркете, добавить метку "from=ya" или "from=market" и затем проанализировать логи web-сервера на предмет наличия этого параметра в URL переходов. Таким образом, откуда бы переход ни был совершен, наличие этого параметра в URL позволит однозначно определить пользователей, перешедших по рекламному объявлению.

Пример:

<url>http://www.xxx.ru/product_page.asp?pid=12345&from=ya</url>

Кроме точных данных о рекламных заходах, анализ логов может дать еще много полезной информации. Например, можно выяснить, на какие товарные предложения часто кликают, но не покупают — их можно убрать с Маркета и таким образом подкорректировать рекламную кампанию. Также возможны и другие варианты анализа.

Примечание

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

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

Текстовый формат с разделителями (например: CSV, TSV) является универсальным форматом при генерации прайс-листа из баз данных или редакторов электронных таблиц (например: Exсel, OpenOffice, Google Docs).

Общие требования к формату

Одна строка текстового файла с разделителями соответствует одной строке электронной таблицы.

В качестве разделителя столбцов используются запятая или точка с запятой (CSV), а также символ табуляции (TSV).

Одна строка файла должна содержать описание одного товарного предложения.

Первая строка файла (заголовок) должна содержать названия элементов, описывающих товарные предложения.

Кодировка файла должна быть UTF-8.

Текстовый формат с разделителями не допускает использование символов переноса и табуляции внутри полей.

Файл не должен содержать пустых столбцов.

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

При чтении заголовка файла проверяются следующие условия: все элементы являются корректными; присутствуют все обязательные элементы; каждый элемент присутствует не более одного раза. При невыполнении одного из этих условий файл отклоняется.

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

Описание элементов

В текстовом формате с разделителями можно использовать следующие элементы: все элементы, входящие в элемент <offer> (см. Элемент offers), кроме элементов categoryID и param; элементы, соответствующие следующим атрибутам элемента <offer>: id, type, available, bid и cbid; элемент category, содержащий имя категории товарного предложения (этот элемент используется вместо элемента categoryId, входящего в <offer>).

Описания элементов совпадают с описаниями соответствующих элементов, входящих в <offer>. Элемент category — категория товарного предложения.

Обязательные элементы

Список обязательных элементов для текстового формата с разделителями совпадает со списком обязательных элементов для <offer> соответствующего типа описания за исключением элемента categoryId, вместо которого используется элемент category.

Необязательные элементы

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

Отличия текстового формата с разделителями от YML-формата

В текстовом формате с разделителями отсутствует возможность передачи характеристик товара, используемых специально для фильтрации товарных предложений в результатах поиска Яндекс.Маркета. В текстовом формате с разделителями нельзя указать свои условия конвертации валют. В YML-формате категории выгружаются в виде "дерева", в текстовом формате с разделителями — "плоским" списком.

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

Формат Excel предназначен для упрощения передачи данных для магазинов, у которых информация об ассортименте хранится в редакторе электронных таблиц Exсel.

Общие требования к формату

Первая строка электронной таблицы должна содержать названия элементов, описывающих товарные предложения.

Одна строка файла должна содержать описание одного товарного предложения.

Файл не должен содержать пустых столбцов.

При чтении заголовка проверяются следующие условия: все элементы являются корректными; присутствуют все обязательные элементы; каждый элемент присутствует не более одного раза. При невыполнении одного из этих условий файл отклоняется.

При передаче данных по ассортименту в формате Excel в партнерском интерфейсе необходимо указать URL главной страницы магазина, а также короткое название магазина, используемое в списке найденных на Яндекс.Маркете.

Описание элементов

В формате Excel можно использовать следующие элементы: все элементы, входящие в элемент <offer> (см. Элемент offers), кроме элементов categoryID и param; элементы, соответствующие следующим атрибутам элемента <offer>: id, type, available, bid и cbid; элемент category, содержащий имя категории товарного предложения (этот элемент используется вместо элемента categoryId, входящего в <offer>).

Описания элементов совпадают с описаниями соответствующих элементов, входящих в <offer>. Элемент category — категория товарного предложения.

Обязательные элементы

Список обязательных элементов для формата Excel совпадает со списком обязательных элементов для <offer> соответствующего типа описания за исключением элемента categoryId, вместо которого используется элемент category.

Необязательные элементы

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


Предыдущая версия технических требований, действовавшая с 16.07.2013 до 07.10.2013
Предыдущая версия технических требований, действовавшая с 11.02.2013 до 15.07.2013
Предыдущая версия технических требований, действовавшая с 10.12.2012 до 10.02.2013
Предыдущая версия технических требований, действовавшая с 02.05.2012 до 09.12.2012
Предыдущая версия технических требований, действовавшая с 16.11.2011 до 01.05.2012
Предыдущая версия технических требований, действовавшая с 30.08.2011 до 15.11.2011
Предыдущая версия технических требований, действовавшая с 31.05.2011 до 29.08.2011
Предыдущая версия технических требований, действовавшая с 20.04.2011 до 31.05.2011
Предыдущая версия технических требований, действовавшая с 29.03.2011 до 19.04.2011
Предыдущая версия технических требований, действовавшая с 09.02.2011 до 28.03.2011
Предыдущая версия технических требований, действовавшая с 24.08.2010 до 08.02.2011
Предыдущая версия технических требований, действовавшая с 20.05.2010 до 23.08.2010
Предыдущая версия технических требований, действовавшая с 20.11.2008 до 19.05.2010
Предыдущая версия технических требований, действовавшая с 16.06.2008 до 19.11.2008
Предыдущая версия технических требований, действовавшая с 04.03.2008 до 15.06.2008
Предыдущая версия технических требований, действовавшая с 25.10.2007 до 03.03.2008
Предыдущая версия технических требований, действовавшая с 28.03.2007 до 24.10.2007
Предыдущая версия технических требований, действовавшая с 20.09.2006 до 27.03.2007
Служба поддержки Яндекс.Маркета
Обратная связь