Прайс-лист XML

Формат XML предоставляет больше возможностей и преимуществ, чем формат XLS.
XML прайс-лист - это документ (файл) который содержит данные, заключенные в теги,
где теги определяют структуру и смысл данных.

Требования к XML

1. Символы " & > < ' нужно заменять на эквивалентные коды:

Символ в тексте

Код для XML-файла

"

&quot;

&

&amp;

>

&gt;

<

&lt;

'

&apos;

2. Допустимые кодировки XML-файла UTF-8.


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

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

<?xml version= "1.0" encoding= "utf-8" ?>

<xml date="2017-03-15 13:00">

<shop>

<name>Санкт-Петербургский Машиностроительный Завод"</name>

<company>Санкт-Петербургский Машиностроительный Завод</company>

<url>http://mashzavod.su/</url>

<email>sbyt@mashzavod.su</email>

<offers>

<offer id="100">

<category_id>1225785917</category_id>

<name>Установка подъемная автомобильная на полуприцепе</name>

<model>УПА80</model>

<vendor>Санкт-Петербургский Машиностроительный Завод</vendor>

<barcode>4719512011041</barcode>

<country>Россия</country>

<price>12000000</price>

<oldprice>12500000</oldprice>

<currency_id>RUR</currency_id>

<parameter name="Нагрузка" unit="кН (тс)">максимальная 800</parameter>

<parameter name="Цвет">Синий</parameter>

<parameter name="Вес" unit="кг">5000</parameter>

<production_date>2020-11-22</production_date>

<expiry>1825</expiry>

<warranty days="365">true</warranty>

<warranty_notes>Дополнительная гарантия от магазина</warranty_notes>

<condition>new</condition>

<condition_notes>Товар новый, витринный образец</condition_notes>

<description>Многофункциональная машина для отрасли</description>

<picture>http://mashzavod.su/produktsiya/upa-80p/picture_1.png</picture>

<url>http://mashzavod.su/produktsiya/upa-80p/</url>

<available>true</available>

<delivery cost="500" days="12">true</delivery>

<delivery_notes>Доставка только по Санкт-Петербургу</delivery_notes>

<pickup days="7">true</pickup>

<pickup_notes>Самовывоз возможен со склада</pickup_notes>

<credit>true</credit>

<credit_notes>Кредит предоставляется банком партнером</credit_notes>

<sales_notes>Наличные, Visa/Mastercard, б/н расчет</sales_notes>

</offer>

</offers>

</shop>

</xml>

Описание элементов XML‑файла

Название
элемента

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

xml

XML-документ может содержать только один корневой элемент xml.
Элемент xml должен содержать атрибут date, в котором указывается
дата и время создания (генерации) XML-документа на стороне вашего сайта.
Дата должна иметь формат YYYY-MM-DD hh:mm.

Пример
<xml date="2017-03-15 13:00">

shop

Элемент содержит описание магазина и его предложений offers.

Пример
<shop>

name

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

Пример
<name>Санкт-Петербургский Машиностроительный Завод"</name>

company

Полное наименование компании, которой принадлежит магазин или сайт
с предложениями.

Пример
<company>Санкт-Петербургский Машиностроительный Завод</company>

url

URL главной страницы вашего магазина или сайта с предложениями.
URL‑адрес формируется на основе стандарта RFC 3986.

Пример
<url>http://mashzavod.su/</url>

email

Контактный адрес вашего магазина или ответственного лица. Адрес
необходим для покупателей, в случае возникновения вопросов по
характеристикам товара или покупке товара.

Пример
<email>sbyt@mashzavod.su</email>

offers

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

Пример
<offers>

offer

Предложение (товар) магазина. Каждый элемент offer должен содержать
атрибут id - идентификатор предложения.
Идентификатор предложения может состоять только из цифр и латинских
букв, идентификатор предложения должен быть уникальным для каждого
предложения

Пример
<offer id="100">

category_id

Идентификатор категории товара. Идентификатор категории из прайс-листа
используются для распределения товаров по категориям на Маркете.

Идентификатор категории товара необходимо использовать из списка
категорий товаров.

Пример
<category_id>1225785917</category_id>

name

Название предложения, тип и модель товара рекомендуется указывать
отдельно в элементе model.

Пример
<name>Установка подъемная автомобильная на полуприцепе</name>

model

Тип и модель товара,

Пример
<model>УПА80</model>

vendor

Название производителя.

Пример
<vendor>Санкт-Петербургский Машиностроительный Завод</vendor>

barcode

Штрихкод товара от производителя в одном из форматов:

  • EAN-13
  • EAN-8
  • UPC-A
  • UPC-E

Пример
<barcode>4719512011041</barcode>

country

Страна производства товара. Можно использовать страны из списка стран.

Пример
<country>Россия</country>

price

Актуальная цена товара.

Требования к цене

  • Формат цены - только целое или дробное число
  • Разделитель целой и дробной части - только точка
  • Нельзя использовать пробелы и запятую

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

Пример
<price>12000000</price>

oldprice

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

Пример
<oldprice>12500000</oldprice>

currency_id

Валюта, в которой указана цена товара: RUR, USD, EUR, UAH, KZT, BYN. Цена и валюта должны соответствовать друг другу.

Пример
<currency_id>RUR</currency_id>

parameter

В элементе parameter передаются все важные характеристики товара:
цвет, размер, объем, материал, вес. XML-документ может содержать
несколько элементов parameter, при этом один элемент parameter
описывает одну характеристику.

Элемент parameter может содержать атрибут name и атрибут unit.
В атрибуте name указывается название параметра, а в атрибуте unit
указывается единица измерения. В самом элементе parameter указывается
значение параметра.

Требований к наименованию параметров и их количеству нет. При этом, для параметров: цвет, материал, длина, ширина, высота, диаметр, вес, объем необходимо соблюдать правила указанные в списке параметров товара.

Пример
<parameter name="Нагрузка" unit="кН (тс)">максимальная 800</parameter>

production_date

Дата производства товара, дата указывается в соответствии
с международным стандартом представления даты и времени ISO 8601,
ГГГГ-ММ-ДД, ГГГГ — полный год, ММ — номер месяца, ДД — день.

Пример
<production_date>2020-11-22</production_date>

expiry

Срок годности товара или срок службы оборудования в днях.

Пример
<expiry>1825</expiry>

warranty

Официальная гарантия производителя или гарантия магазина.
Элемент warranty должен содержать атрибут days, в котором
указывается количество дней.
В самом элементе warranty указывается значение
true - есть гарантия или false - нет гарантии.

Пример
<warranty days="365">true</warranty>

warranty_notes

Примечание к гарантии товара.

Пример
<warranty_notes>Дополнительная гарантия от магазина</warranty_notes>

condition

Состояние товара, допускаются значения
new - новый, used - подержанный, discounted - уцененный.

Пример
<condition>new</condition>

condition_notes

Примечание по состоянию товара.

Пример
<condition_notes>Товар новый, витринный образец</condition_notes>

description

В элементе description передается подробное описание вашего товара.
Элемент description может содержать текст с xhtml-тегами, такой текст
допустим только в виде блока символьных данных - CDATA.

<description>
<![CDATA[
<h1>Многофункциональная машина для отрасли</h1>
<p>Особенности:</p>
<ul>
<li>высокая производительность</li>
<li>минимальный расход топлива</li>
</ul>
]]>
</description>

Пример
<description>Многофункциональная машина для отрасли</description>

picture

В элементе picture передается ссылка на изображение товара (URL‑адрес).
Для каждого предложения можно указать до 10 ссылок на изображения
товара. При этом первое изображение считается изображением
по умолчанию. Оно используется в качестве главного изображения товара.
Другие изображения товара доступны в режиме просмотра
увеличенных изображений.
URL‑адрес формируется на основе стандарта RFC 3986.

Пример
<picture>http://mashzavod.su/produktsiya/upa-80p/picture_1.png</picture>

url

URL страницы товара на сайте вашего магазина. Допускаются
кириллические ссылки. URL‑адрес формируется на основе
стандарта RFC 3986.

Пример
<url>http://mashzavod.su/produktsiya/upa-80p/</url>

available

Информация о доступности товара, допускаются значения
true - есть в наличии или false - нет в наличии.

Пример
<available>true</available>

delivery

Возможность курьерской доставки или доставки собственной службой
логистики. Элемент delivery должен содержать атрибут cost, в котором
указывается стоимость доставки товара, и атрибут days в котором
указывается количество дней доставки от продавца или производителя
до пункта отгрузки товара. В самом элементе delivery указывается значение
true - доставка есть или false - доставки нет.

Пример
<delivery cost="500" days="12">true</delivery>

delivery_notes

Примечание по доставке товара.

Пример
<delivery_notes>Доставка только по Санкт-Петербургу</delivery_notes>

pickup

Возможность самовывоза из пунктов выдачи. Элемент pickup должен
содержать атрибут days в котором указывается срок поставки товара
в пункт выдачи в рабочих днях. В самом элементе pickup указывается
значение true - самовывоз есть или false - самовывоза нет.

Пример
<pickup days="7">true</pickup>

pickup_notes

Примечание по самовывозу товара.

Пример
<pickup_notes>Самовывоз возможен со склада</pickup_notes>

credit

Возможность покупки товара в кредит или рассрочку. Допускаются значения
true - есть возможность покупки товара в кредит или в рассрочку или
false - нет возможности покупки товара в кредит или в рассрочку.

Пример
<credit>true</credit>

credit_notes

Примечание по покупке товара в кредит или в рассрочку.

Пример
<credit_notes>Кредит предоставляется банком партнером</credit_notes>

sales_notes

Элемент sales_notes передает условия продажи товара.
Можно указывать любые примечания по продаже и покупке товара.

Пример
<sales_notes>Наличные, Visa/Mastercard, б/н расчет</sales_notes>