Яндекс маркет или wikimart

Требования к методу передачи данных. Описание формата данных XML.
Метод передачи данных
Размещаемые материалы должны быть опубликованы на сайте Клиента по URL-адресу, согласованному с компанией "Викимарт", и доступны по протоколам HTTP или FTP. Допускается использование стандартной авторизации для автоматического скачивания файла роботом Викимарта, при этом данные для авторизации должны также быть согласованы.
В случае изменения URL-адреса и/или авторизационных данных Клиент должен известить Службу поддержки магазинов Викимарта, написав письмо на spm@wikimart.ru.

Описание формата XML
XML документ должен соответствовать следующему формату (DTD):
<!ELEMENT yml_catalog (shop)>
<!ATTLIST yml_catalog
          date CDATA
          #REQUIRED>

<!ELEMENT shop (name, company, phone?, url,
          currencies, categories, deliveryIncluded?, local_delivery_cost?,  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
          "0"
          tid CDATA
          #IMPLIED
          yid CDATA
          #IMPLIED>

<!ELEMENT offers (offer+)>

<!ELEMENT offer (url, buyurl?, price, wprice?,
          currencyId, xCategory?, categoryId+,
          picture?, 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?, performace_type?, storage?, format?, recording_lenght?)
              | (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?, country_of_origin?, downloadable?
          )>

<!ATTLIST offer
          id CDATA
          #IMPLIED
          type (vendor.model
          | book | artist.title | tour | ticket | event-ticket) #IMPLIED
          available (true | false) #IMPLIED
          bid CDATA
          #IMPLIED
          cbid CDATA
          #IMPLIED>

<!ELEMENT url (#PCDATA)>

<!ELEMENT buyurl (#PCDATA)>

<!ELEMENT picture (#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 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_lenght (#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 country_of_origin (#PCDATA)>

<!ELEMENT downloadable (#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)>


Общие замечания по формату, которые необходимо учитывать при создании файлов в стандарте XML для Викимарта
Стандарт 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>

  <currencies> ... </currencies>
  <categories> ... </categories>
  <offers> ... </offers>


</shop>
В элементе shop содержится описание магазина и товаров магазина. Магазин описывается следующими полями:
Поле Описание
name Короткое название магазина. Нельзя использовать слова, не имеющие отношения к наименованию магазина ("лучший", "дешевый"), указывать номер телефона и т.п. Название магазина, должно совпадать с фактическим названием магазина, которое публикуется на сайте. При несоблюдении данного требования наименование может быть изменено Викимартом самостоятельно без уведомления Клиента.
company Полное наименование компании, владеющей магазином. Не публикуется, используется для внутренней идентификации.
url URL-адрес главной страницы магазина
Элемент 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 - курс по Национальному банку Казахстана.
СВ - курс по банку той страны, к которой относится интернет-магазин по Своему региону, указанному при регистрации на сайте Викимарта.
Примеры:
Курс 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>
Внимание! В качестве разделителя целой и дробной частей любых чисел в XML, независимо от региональных установок, используется точка (не запятая!). При слишком значительном (больше 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
Описание товарного предложения типа "vendor.model" (наиболее удобный вариант с точки зрения Викимарта):

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

  <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>
  <delivery> true </delivery>
  <local_delivery_cost>300</local_delivery_cost>
  <typePrefix> Принтер </typePrefix>
  <vendor> НP </vendor>
  <vendorCode> Q7533A </vendorCode>
  <model> Color LaserJet 3000</model>
  <description>
    Фотоцентр НP Color LaserJet 3000 Q7533A для тех, кто выбирает самое лучшее. Это самое полное решение для фотолюбителей, которое включает в себя фотопринтер, сканер, копир и факс с автоподатчиком. НP Color LaserJet 3000 Q7533A можно поставить в любом уголке. Данную модель отличает высокое качество печати фотографий, на которых изображена местность, фото пейзажей и др. Вы обязательно полюбите этот принтер HP.
  </description>
  <manufacturer_warranty>true</manufacturer_warranty>
  <country_of_origin>Япония</country_of_origin>


</offer>

Наиболее простое описание:
<offer id="3988" available="true">
<url> http://best.seller.ru/index.php?productID=3988</url>
<price>37900</price>
<currencyId>RUR</currencyId>
<categoryId>2</categoryId>
<picture> http://best.seller.ru/products_pictures/kettler_s_x3.jpg</picture>
<delivery>false</delivery>
<name>Велоэргометр Kettler X3 7683-100</name>
<description>
    Модель 2009
    Техническая характеристика:
Система нагружения: электромагнитный индукционный тормоз
Нагрузка: 25 - 400 Вт. (с шагом 5 Вт.)
нагружение не зависит от чатоты вращения педалей
Маховик: 8 кг
Передаточное отношение: 1:8
    Тренировочный компьютер:
Отображение: время, дистанция, cкорость, Вт., калории, пульс
Отображение тренировочного профиля на ЖКД
Всего тренировочных программ: 8из этих  пульсозависимые: 1
    Возможности:
Измерение пульса: Датчик-клипса + нагрудный кардиопередатчик (opt.)
Нагрудный кардиопередатчик для измерения пульса приобретается отдельно
Комплектуется ПК-интерфейсом
Электроснабжение: подключение к сети
Педали с ремешком
Регулировка седла: по вертикали, по горизонтали
Регулировка руля: по углу наклона
Особенности: транспортировочные ролики
</description>
</offer>



Элементы Описания
url URL-адрес страницы товара
price Цена, по которой данный товар можно приобрести.Цена товарного предложения округляеся и выводится в зависимости от настроек пользователя.
currencyId Идентификатор валюты товара (RUR, USD, UAH, KZT). Для корректного отображения цены в национальной валюте, необходимо использовать идентификатор (например, UAH) с соответствующим значением цены.
categoryId Идентификатор категории товара (целое число не более 18 знаков). Товарное предложение может принадлежать только одной категории
picture Ссылка на картинку соответствующего товарного предложения. Недопустимо давать ссылку на "заглушку", т.е. на картинку где написано "картинка отсутствует" или на логотип магазина
typePrefix Группа товаров \ категория
vendor Производитель
model Модель
name Наименование товарного предложения
delivery Элемент, обозначающий возможность доставить соответствующий товар. "false" данный товар не может быть доставлен ("самовывоз").
"true" товар доставляется на условиях, которые указываются в личном кабинете магазина в разделе "Условия доставки".
description Описание товарного предложения
vendorCode Код товара (указывается код производителя)
local_delivery_cost Стоимость доставки данного товара в Своем регионе
available Статус доступности товара - в наличии/на заказ
available="false" - товарное предложение на заказ или отсутствует в продаже.
available="true" - товарное предложение в наличии. Магазин готов сразу договариваться с покупателем о доставке товара
sales_notes Элемент, предназначенный для того, чтобы показать пользователям, чем отличается данный товар от других, или для описания акций магазина (кроме скидок). Допустимая длина текста в элементе - 50 символов.
manufacturer_warranty Элемент предназначен для отметки товаров, имеющих официальную гарантию производителя.
country_of_origin Элемент предназначен для указания страны производства товара.

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

Элемент picture
Для каждого товарного предложения в элементе <offer> необходимо указать URL-адрес картинки, соответствующей данному товарному предложению.
Пример: <picture>http://best.seller.ru/img/device12345.jpg</picture>
По указанному URL-адресу должна находиться картинка формата jpeg, gif или png и размером не меньше чем 300х300. Картинки большего размера будут уменьшены автоматически. Ссылка на HTML с картинкой не допустима. Возможна загрузка нескольких картинок. В этом случае элементы picture указываются последовательно:
<offer…>
…<picture>http://best.seller.ru/img/device12345.jpg</picture>
<picture>http://best.seller.ru/img/device12345.jpg</picture>…
</offer>
Элемент name
Элемент <name> может содержать текст длиной не более 255 символов. Если длина наименования выходит за пределы допустимого значения, то текст обрезается и в конце ставится многоточие.
Элемент description
Элемент <description> должен содержать текст неограниченной длины, желательно 500-1000. Раскрытое описание товарных предложений поможет Викимарту продвинуть Ваши товары в поисковой выдаче Яндекса, Google, Рамблер и других поисковых систем.
Пример заполнения описания товара http://electronics.wikimart.ru/audio_equipment/radio/model/1108426/