XML прайс–лист

Описание формата XML прайс–листа

Формат XML прайс-листа
Описание элементов, входящих в элемент <category>
Описание элементов, входящих в элемент <offer>
Единицы измерения
Период обновления
Примеры

1. Формат XML прайс-листа

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

<!ELEMENT elec_market (currencies?, categories, offers)>
<!ATTLIST elec_market date CDATA #REQUIRED>

<!ELEMENT currencies (currency+)>

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

<!ELEMENT categories (category+)>

<!ELEMENT category (#PCDATA)>
<!ATTLIST category
        id CDATA #REQUIRED
        rubricaId CDATA #IMPLIED
        parentId CDATA #IMPLIED
        currencyId (RUR|RUB|USD|EUR|CNY|BYN|KZT|UAH) "RUR"
        unit (PCE|SET|NMP|LEF|NPL|NCL|MTR|KMT|GRM|KGM|TNE|MMK|MTK|LTR|MTQ) "PCE"
        vat (yes|no) #FIXED "yes">

<!ELEMENT offers (offer+)>

<!ELEMENT offer (categoryId, keyword?, title, url,
        price, artno?, currencyId?, unit?, quantity?,
        picture*, okp?, (vendor, vendorCode?)?,
        tizer?, description?, video?, sales_notes?,
        country_of_origin? )>

<!ATTLIST offer
        id CDATA #REQUIRED
        available (true|false) "false">

<!ELEMENT categoryId (#PCDATA)>

<!ELEMENT keyword (#PCDATA)>

<!ELEMENT title (#PCDATA)>

<!ELEMENT url (#PCDATA)>

<!ELEMENT price (#PCDATA)>

<!ELEMENT artno (#PCDATA)>

<!ELEMENT currencyId (#PCDATA)>

<!ELEMENT unit (#PCDATA)>

<!ELEMENT quantity (#PCDATA)>

<!ELEMENT picture (#PCDATA)>

<!ELEMENT okp (#PCDATA)>

<!ELEMENT vendor (#PCDATA)>

<!ELEMENT vendorCode (#PCDATA)>

<!ELEMENT tizer (#PCDATA)>

<!ELEMENT description (#PCDATA)>
<!ATTLIST description format (text|html) "text">

<!ELEMENT video (#PCDATA)>

<!ELEMENT sales_notes (#PCDATA)>

<!ELEMENT country_of_origin (#PCDATA)>

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

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

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

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

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

Элементы	Описание
id	Уникальный идентификатор группы товаров (целое число от 1 до 4294967295).
rubricaId	Код рубрики размещения товара на портале. Список кодов
currencyId	Идентификатор валюты товара (RUB, USD, EUR, CNY, KZT, BYN)
unit	Идентификатор Единицы измерения товара

Примечание: Жирным шрифтом выделены обязательные поля.

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

Элементы	Описание
id	Уникальный идентификатор товара в вашей системе, который содержит ваш SKU товара. До 30-ти знаков.
categoryId	Идентификатор группы товара входящих в элемент <category>. Товарное предложение может принадлежать только одной группе.
title	Наименование товарного предложения
url	URL-адрес страницы товара
price	Цена (с НДС), по которой данный товар можно приобрести. Целые должны разделяться '.' (точкой)
artno	Артикул товара
currencyId	Идентификатор валюты товара (RUB, USD, EUR, CNY, KZT, BYN)
unit	Идентификатор Единицы измерения товара
quantity	Количество единиц товара в наличии \ на складе
picture	Ссылка на картинку соответствующего товарного предложения. Допустимые форматы: JPG, GIF, PNG. Недопустимо давать ссылку на "заглушку", т.е. на картинку где написано "картинка отсутствует" или на логотип магазина. Поле может дублироваться при необходимости добавления нескольких картинок.
okp	Код ОКП
vendor	Производитель
vendorCode	Код товара (указывается код производителя)
tizer	Краткое описание товарного предложения
description	Подробное описание товарного предложения
video	Ссылка на видео, демонстрирующее товарное предложение. Допустимые форматы: MP4, AVI, MKV, FLV, MOV. Поле не может дублироваться, для одного товарного предложения допустимо указание только одного видео.
sales_notes	Элемент, предназначенный для того, чтобы показать пользователям, чем отличается данный товар от других, или для описания акций магазина (кроме скидок). Допустимая длина текста в элементе - 50 символов
country_of_origin	Элемент предназначен для указания страны производства товара

Примечание: Жирным шрифтом выделены обязательные поля.

4. Единицы измерения

Экономические единицы

PCE — Штука
SET — Комплект
NMP — Упаковка
LEF — Лист
NPL — Рулон
NCL — Элемент

Единицы длины

CMT — Сантиметр
MTR — Метр
KMT — Километр

Единицы массы

GRM — Грамм
KGM — Килограмм
TNE — Тонна

Единицы площади

MMK — Квадратный миллиметр
CMK — Квадратный сантиметр
MTK — Квадратный метр

Единицы объема

LTR — Литр
MTQ — Кубический метр

5. Период обновления

Установлено следующее расписания для проверки обновления XML прайс-листов:

Размещенных по бесплатному варианту – раз в неделю, по пятницам, после 18:00;
Размещенных по варианту «ИНФО» – раз в 3 дня;
Размещенных по варианту «ПРОМО» – раз в день;
Размещенных по варианту «БИЗНЕС» – раз в 8 часов;

6. Примеры

Небольшой примерный XML прайс–лист, вы можете посмотреть по этой ссылке: pricelist.xml.