XML прайс–лист

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

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

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|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|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?, 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 sales_notes (#PCDATA)>

<!ELEMENT country_of_origin (#PCDATA)>

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

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

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

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

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

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

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

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

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