Пример YML-файла и описание его элементов

Пример XML-файла

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" date="2010-04-01T17:00:00" version="1.0" xsi:noNamespaceSchemaLocation="VendorYML-1.0.xsd">
  <vendor name="Canon">
    <url>http://canon.ru/</url>
    <categories>
      <category id="1">Электроника</category>
      <category id="10" parentId="1">Фото</category>
      <category id="100" parentId="10">Компактные фотоаппараты</category>
      <category id="101" parentId="10">Зеркальные фотоаппараты</category>
      <category id="102" parentId="1">Видеокамеры</category>
      <category id="2">Хранение данных</category>
      <category id="11" parentId="2">Карты памяти</category>
      <category id="12" parentId="2">USB-flash накопители</category>
      <category id="13" parentId="2">Переносные жесткие диски</category>
    </categories>
    <models>
      <model id="34121" categoryId="10">
        <name>EOS 60D Body</name>
        <alias>EOS 60D W/O LENS</alias>
        <type>Цифровая фотокамера</type>
        <vendorCode>4460B007</vendorCode>
        <promoUrl>http://canon.ru/eos-60d</promoUrl>
        <pictureUrl type="main">http://canon.ru/eos-60d.jpg</pictureUrl>
        <pictureUrl>http://canon.ru/eos-60d-angle.jpg</pictureUrl>
        <pictureUrl type ="interior">http://canon.ru/eos-60d-table.jpg</pictureUrl>
        <instructionUrl>http://canon.ru/eos-60d.pdf</instructionUrl>
        <driversUrl>http://canon.ru/eos-60d.zip</driversUrl>
        <barcode>1234567890123</barcode>
        <barcode>1234657654321</barcode>
        <announceDate>2016-04-01</announceDate>
        <inStockDate>2016-05-01</inStockDate>
        <addDate>2016-03-01</addDate>
        <updateDate>2016-06-01</updateDate>
        <isActual>true</isActual>
        <recomendedPrice currency="RUR">55000</recomendedPrice>
        <description>Зеркальная фотокамера любительского уровня.</description>
        <param name="Вес" unit="г">750</param>
        <param name="Байонет">Canon EF/EF-S</param>
        <param name="Тип матрицы">CMOS</param>
        <param name="Кроп-фактор">1.6</param>
        <param name="Разрешение матрицы" unit="Мп">19</param>
        <param name="Подавление эффекта красных глаз">есть</param>
        <param name="GPS-приемник">отсутствует</param>
        <param name="Максимальное разрешение роликов">1920x1080</param>
        <rec type="component" isSupplement="true" innerId="167" marketId="7888908">Объектив Canon EF 50 mm f/1.8 STM</rec>
        <rec type="accessory" isSupplement="true" marketId="14210745">Сумка для фотокамеры Gadget Bag</rec>
        <rec type="consumable" isSupplement="true">Аккумулятор для Canon AcmePower AP-LP-E6</rec> 
      </model>
    </models>
  </vendor>
</yml_catalog>

Скачать пример в формате XML

Скачать XSD схему

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

Элементы необязательные, если не указано обратное.

Элемент

Описание

yml_catalog

XML-файл может содержать только один корневой элемент <yml_catalog>.

Атрибут date соответствует дате и времени генерации XML-файла на стороне производителя. Формат даты: YYYY-MM-DDThh:mm:ss.

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

Элементы, входящие в yml_catalog

vendor

Название производителя или бренда. Если нужно передать данные о нескольких производителях, описывайте каждого в отдельном элементе <vendor>.

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

Элементы, входящие в vendor

url

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

categories

Список категорий товаров.

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

models

Список моделей.

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

Элементы, входящие в categories

category

Описание одной категории. Атрибуты:

  • id — идентификатор категории (обязательный);
  • parentId — идентификатор категории более высокого уровня (обязательный только для подкатегорий).

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

Элементы, входящие в models

model

Описание одной модели. Атрибуты:

  • id — идентификатор модели (обязательный);
  • categoryId — идентификатор категории, к которой относится модель (обязательный).

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

Элементы, входящие в model

name

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

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

alias

Альтернативное название модели. Для одной модели можно указать несколько элементов alias (не больше 10)

type

Тип товара. Указывайте этот элемент, если в категории есть товары разных типов. Например, куклы и конструкторы в категории «Товары для детей».

vendorCode

Код товара (код, присвоенный производителем).

promoUrl

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

pictureUrl

Ссылка на изображение модели на сайте производителя. Один элемент должен содержать одну ссылку. Для одной модели можно указать несколько pictureUrl.

instructionUrl

Ссылка на инструкцию для данной модели на сайте производителя.

driversUrl

Ссылка на драйверы для данной модели на сайте производителя.

barcode

Штрих-код товара.

announceDate

Дата анонсирования модели.

Формат даты: yyyy-mm-dd.

inStockDate

Дата начала официальных продаж.

Формат даты: yyyy-mm-dd.

addDate

Дата добавления описания модели в каталог.

Формат даты: yyyy-mm-dd.

updateDate

Дата изменения спецификации модели.

Формат даты: yyyy-mm-dd.

isActual

Актуальность модели:

  • true — модель выпускается;

  • false — модель снята с производства.

recomendedPrice

Рекомендованная цена. Для корректного учета цены указывайте идентификатор валюты в атрибуте currency (возможные значения: RUR, RUB, USD, EUR, UAH, BYN, KZT).

description

Описание модели.

param

Параметры модели. Каждый параметр описывается в отдельном элементе <param>. Для одной модели можно указать несколько элементов <param>.

rec

Рекомендуемый или совместимый товар. Каждый товар описывается в отдельном элементе <rec>. Для одной модели можно указать несколько элементов <rec>.