Подождите...
  • Выбрать другой регион
Подождите...
    Фильтры

    Требования к XML-файлу

    Для выставления товаров на сайте Светофор. Продавцу необходимо подготовить прайс с предложениями в формате XML. В процессе работы магазина адрес ссылки xml должен быть статичным и не меняться.

     

    Требования к файлу:

     

    • Стандарт XML не допускает использования непечатаемых символов с ASCII-кодами от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки).
    • Символы ", &, >, <, ' нужно заменять на эквивалентные коды:
    • Символ в тексте Код для XML-файла
      " &quot;
      & &amp;
      > &gt;
      < &lt;
      ' &apos;
    • 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. Название категории последнего уровня должно четко соответствовать конкретному виду товара. В одной категории магазина не должно быть товаров из двух разных категорий на нашем сайте.

    Например:
    <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. Каждое предложение должно иметь уникальный идентификатор. При внесении изменений в прайс offer id должен оставаться неизменным.

     
    <offer available="true" id="74279">
    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 будет основной в карточке товара.

    Пример оформления в прайсе:
    <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>
    <picture>http://myshop.ru/images/my-item-2-url-image-3.jpg</picture>
    <name>Диван-кровать Николетти</name> - название товара. Не должно содержать разделительных знаков (запятые, точки, тире, дефисы), кроме относящихся к наименованию модели. Не надо писать слова в названии капсом. Названия должны быть уникальными и не повторяться.
    <description><![CDATA[ ... ]]></description> - описание товара. Описание товара может быть однотипным для всей категории. В описании должна присутствовать информация только про сам товар. Описание не должно содержать ссылок, телефонов, адресов, предложений услуг, акций, цен, картинок, видеообзоров и т. д. Использование HTML-тегов недопускается. Раздел CDATA открывается как <![CDATA[ и закрывается ]]>.

    Пример:
    <description>
    	<![CDATA[
             Наполнение - пружинный блок, войлок, ППУ, синтепон.   
             Механизм раскладывания - венеция.   
             Ящики для белья: в угловой части, в кресельной части.   
             Спальное место - 1200*1900 мм.   
             В наличии и под заказ!   
             На всю мягкую мебель - цена зависит от категории ткани.
    	]]>
    </description>
    Отложенные