Требования к XML-файлу
Для выставления товаров на сайте Светофор. Продавцу необходимо подготовить прайс с предложениями в формате XML. В процессе работы магазина адрес ссылки xml должен быть статичным и не меняться.
Требования к файлу:
- Стандарт XML не допускает использования непечатаемых символов с ASCII-кодами от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки).
- Символы ", &, >, <, ' нужно заменять на эквивалентные коды:
-
Символ в тексте Код для XML-файла " " & & > > < < ' ' - URL-адрес товарного предложения на сайте магазина должен быть закодирован в соответствии со стандартом
- Допустимая кодировка XML-файла: UTF-8.
Структура YML-файла
<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE yml_catalog SYSTEM "shops.dtd"> <yml_catalog date="2019-02-26 12:49"> <shop> <name>Интернет-магазин</name> <company>Интернет-магазин описание</company> <url>http://myshop.ru/</url> <currencies> <currency id="RUR" rate="1"/> </currencies> <categories> <category id="2635">Мягкая мебель</category> <category id="2651" parentId="2651">Диван-кровати</category> <category id="2656" parentId="2651">Угловые диваны</category> <category id="2652" parentId="2651">Диваны прямые</category> <category id="2654" parentId="2651">Модульные диваны</category> </categories> <offers> <offer id="2" available="true"> <url>http://myshop.ru/my-item-2-url/</url> <price>15990</price> <currencyId>RUR</currencyId> <categoryId>2656</categoryId> <picture>http://myshop.ru/images/my-item-2-url-image-1.jpg</picture> <picture>http://myshop.ru/images/my-item-2-url-image-2.jpg</picture> <name>Диван угловой Виза с баром</name> <description> <![CDATA[
Наполнение - пружинный блок, войлок, ППУ, синтепон. Механизм раскладывания - венеция. Ящики для белья: в угловой части, в кресельной части. Спальное место - 1200*1900 мм. В наличии и под заказ! На всю мягкую мебель - цена зависит от категории ткани.]]> </description> </offer> </offers> </shop> </yml_catalog>
Описание элементов:
Элемент | Описание |
---|---|
yml_catalog | Любой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент <yml_catalog>. Атрибут date элемента <yml_catalog> должен соответствовать дате и времени генерации YML-файла на стороне магазина. Дата должна иметь формат YYYY-MM-DD hh:mm. |
shop | Элемент содержит описание магазина и его товарных предложений. Обязательный элемент. |
name | Короткое название магазина. Должно содержать не более 20 символов. В названии нельзя использовать слова, не имеющие отношения к наименованию магазина (например: «лучший», «дешевый»), указывать номер телефона и т. п. Название магазина должно совпадать с фактическим названием магазина, которое публикуется на сайте. Обязательный элемент. |
company | Полное наименование компании, владеющей магазином. Не публикуется, используется для внутренней идентификации. Обязательный элемент. |
url | URL главной страницы магазина. Обязательный элемент. |
platform | Система управления контентом, на основе которой работает магазин (CMS). Необязательный элемент. |
currencies | Список курсов валют магазина. Обязательный элемент. Основная валюта – российский рубль, присваивается единица. <currency id="RUR" rate="1"/> Только у рубля rate="1". Другие валюты на сайт не выводятся и главное, чтоб у них rate не был единицей. |
categories | Список категорий. Каждой категории должен присваиваться уникальный номер, нумерация – в соответствии со справочником. Принадлежность подкатегории к материнской категории передается через атрибут parentId. Название категории последнего уровня должно четко соответствовать конкретному виду товара. В одной категории магазина не должно быть товаров из двух разных категорий на нашем сайте. Например:
Обязательный элемент. |
offers | Список предложений магазина. Каждое предложение описывается в отдельном элементе offer. Каждое предложение должно иметь уникальный идентификатор. При внесении изменений в прайс offer id должен оставаться неизменным.
available="true" – наличие товара: true – товар в наличии; false – товар не в наличии. При первичном размещении товар должен быть в наличии и иметь статус true. Если товара нет в наличии, то его можно убрать из xml, так как при первичном размещении эти товары не будут выведены на сайт.id="74279" – уникальный идентификатор товара, присваивается продавцом и остается неизменным для данной позиции. <url>http://myshop.ru/my-item-2-url/</url> - ссылка на товар на сайте магазина
<price>4499</price> - цена товара
<currencyId>RUR</currencyId> - валюта товара
<categoryId>2656</categoryId> - конечная категория товара
<picture>http://myshop.ru/images/my-item-2-url-image-1.jpg</picture> - ссылка на фото товара. Рекомендуется добавлять несколько (до 8 фото). Первая фотография в выгрузке xml будет основной в карточке товара.
Пример оформления в прайсе:
<name>Диван-кровать Николетти</name> - название товара. Не должно содержать разделительных знаков (запятые, точки, тире, дефисы), кроме относящихся к наименованию модели. Не надо писать слова в названии капсом. Названия должны быть уникальными и не повторяться.
<description><![CDATA[ ... ]]></description> - описание товара. Описание товара может быть однотипным для всей категории. В описании должна присутствовать информация только про сам товар. Описание не должно содержать ссылок, телефонов, адресов, предложений услуг, акций, цен, картинок, видеообзоров и т. д. Использование HTML-тегов недопускается. Раздел CDATA открывается как <![CDATA[ и закрывается ]]>.
Пример:
|