Необходимо подготовить прайс в формате XML/YMLдля выгрузки наших товаров на сайт интернет-магазина Rozetka.
Сайт: shkafmann.com.ua
Для выставления товаров на Rozetka.ua продавцу необходимо подготовить прайс с предложениями в формате YML.
Требования к YML-файлу
Стандарт YML не допускает использования непечатаемых символов с ASCII-кодами от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки).
Символы ", &, >, <, ' нужно заменять на эквивалентные коды:
Символ в тексте
| Код для YML-файла
|
"
&
>
<
'
| "
&
>
<
'
|
URL-адрес товарного предложения на сайте магазина должен быть закодирован в соответствии со стандартом RFC-1738.
Допустимые кодировки YML-файла: UTF-8, windows-1251.
Пример XML-файла
<?xml version="1.0" encoding="windows-1251"?>
<!DOCTYPE yml_catalog SYSTEM "shops.dtd">
<yml_catalog date="2011-07-20 14:58">
<shop>
<name>ABC</name>
<company>ABC inc.</company>
<url>http://www.abc.ua/</url>
<currencies>
<currency id="UAH" rate="1"/>
</currencies>
<categories>
<category id="2">Женская одежда</category>
<category id="261" parentId="2">Платья</category>
<category id="3">Мужская одежда</category>
<category id="391" parentId="3">Куртки</category>
</categories>
<offers>
<offer id="19305" аvailable="true">
<url>http://abc.ua/catalog/muzhskaya_odezhda/kurtki/kurtkabx.html</url>
<price>4499</price>
<currencyId>UAH</currencyId>
<categoryId>391</categoryId>
<picture>http://abc.ua/upload/iblock/a53/a5391cddb40be91705.jpg</picture>
<picture>http://abc.ua/upload/iblock/9d0/9d06805d219fb525fc.jpg</picture>
<picture>http://abc.ua/upload/iblock/93d/93de38537e1cc1f8f2.jpg</picture>
<vendor>Abc clothes</vendor>
<name>Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900)</name>
<description><![CDATA[<p>Одежда <b>Abc clothes</b> способствует развитию функций головного мозга за счет поощрения мелкой моторики.</p><p>В Abc <b>New Collection</b> будет особенно удобно лазать, прыгать, бегать.</p><p>За счет своей универсальноcти и многофункциональности, <b>Abc clothes</b> отлично подходит:</p><ul><li><b>Для весны</b></li><li><b>Для лета</b></li><li><b>Для ранней осени</b> </li></ul><br><p><b>Состав:</b><br>• 92% полиэстер, 8% эластан, нетоксичность подтверждена лабораторно.</p><p><b>Вес:</b> 305 г</p>]]></description>
<param name="Вид">Куртка</param>
<param name="Размер">XL</param>
<param name="Сезон">Весна-Осень</param>
<param name="Категория">Мужская</param>
<param name="Цвет">Черный</param>
<param name="Длина">Средней длины</param>
<param name="Стиль">Повседневний (casual)</param>
<param name="Особенности">Модель с капюшоном</param>
<param name="Состав"> 92% полиэстер, 8% эластан</param>
<param name="Артикул">58265468</param>
</offer>
</offers>
</shop>
</yml_catalog>
Описание элементов
Элемент | Описание |
|
|
yml_catalog
| Любой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент <yml_catalog>. Атрибут date элемента <yml_catalog> должен соответствовать дате и времени генерации YML-файла на стороне магазина. Дата должна иметь формат YYYY-MM-DD hh:mm.
|
Элементы, входящие в yml_catalog |
shop
| Элемент содержит описание магазина и его товарных предложений.
Обязательный элемент.
|
Элементы, входящие в shop |
name
| Короткое название магазина, должно содержать не более 20 символов. В названии нельзя использовать слова, не имеющие отношения к наименованию магазина, например «лучший», «дешевый», указывать номер телефона и т. п.
Название магазина должно совпадать с фактическим названием магазина, которое публикуется на сайте. Обязательный элемент.
|
company
| Полное наименование компании, владеющей магазином. Не публикуется, используется для внутренней идентификации.
Обязательный элемент.
|
url
| URL главной страницы магазина.
Обязательный элемент.
|
platform
| Система управления контентом, на основе которой работает магазин (CMS).
Необязательный элемент.
|
|
|
|
|
|
|
currencies
| Список курсов валют магазина.
Обязательный элемент. Основная валюта гривна, присваивается единица.
<currency id="UAH" rate="1"/>
|
categories
| Список категорий магазина. Каждой категории должен присваиваться уникальный номер, нумерация – на усмотрение магазина. Принадлежность подкатегории к материнской категории передается через атрибут parentId. При любых изменениях в прайсе id категорий должны оставаться неизменными.
Название категории последнего уровня должно четко соответствовать конкретному виду товара. Например:
Мебель>Диваны>Угловые диваны
<categories> <category id="5">Мебель</category>
<category id="54" parentId="5">Диваны</category>
<category id="542" parentId="54">Угловые диваны</category>
</categories> Обязательный элемент.
|
|
|
offers
| Список предложений магазина. Каждое предложение описывается в отдельном элементе offer. Каждое предложение должно иметь уникальный идентификатор, при изменениях в прайсе offer id должен оставаться неизменным.
На каждую модификацию товара - цвет, размер, объем, комплектацию и т.д. - должен быть создан отдельный уникальный offer id в прайсе, после загрузки товары будут сгруппированы контент-отделом Розетки.
<offer available="true" id="74279">
available="true" – наличие товара: true – товар в наличии; false – товар не в наличии
id="74279" – уникальный идентификатор товара, присваивается продавцом и остается неизменным для данной позиции
<url>http://abc.ua/catalog/muzhskaya_odezhda/kurtki/kurtkabx.html</url> - ссылка на товар на сайте магазина <price>4499</price> - цена товара <currencyId>UAH</currencyId> - валюта товара <categoryId>391</categoryId> - конечная категория товара <picture>http://abc.ua/upload/iblock/a53/a5391cddb40be91705.jpg</picture> - ссылка на фото товара. Рекомендуется добавлять несколько (до 10 фото). Пример оформления в прайсе: <picture>http://abc.ua/upload/iblock/a53/a5391cddb40be91705-1.jpg</picture> <picture>http://abc.ua/upload/iblock/a53/a5391cddb40be91705-2.jpg</picture> <picture>http://abc.ua/upload/iblock/a53/a5391cddb40be91703-3.jpg</picture> <vendor>Abc clothes</vendor> - бренд-производитель товара должен указываться так, как прописано производителем и как бренд зарегистрирован документально. При наличии созданного бренда на Розетке - в прайсе указывается аналогично. <name>Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900)</name> - название товара. Не должно содержать разделительных знаков (запятые, точки, тире, дефисы (кроме относящихся к наименованию модели)). <description> <p>Одежда <b>Abc clothes</b> способствует развитию…</p><p>Производитель: Украина.</p></description> - описание товара. Если описание больше одного абзаца, необходимо отформатировать его с использованием html-тегов: <p></p>, <br>, <b></b>, <ul><li></ul> и т.д., и завернуть в CDATA. Раздел CDATA открывается как <![CDATA[ и закрывается ]]>. Пример: <description><![CDATA[<p>Одежда <b>Abc clothes</b> способствует развитию…</p><p>Производитель: Украина.</p>]]></description> <param name="Артикул">58265468</param> - не обязательны элемент, в данном поле указывается артикул, EAN производителя. В случае если он есть, мы привязываем данное предложение к более популярной карточке товара на Розетке и сразу ваши товары будут ранжироваться выше. <param name="Цвет">Черный</param> <param name="Вид">Куртка</param> <param name="Категория">Мужская</param> <param name="Дополнительные характеристики">
<![CDATA[Чемодан закрывается на молнию<br/>
Оснащен прочной и удобной выдвижной ручкой<br/>
На фасадной части находится большой карман<br/>
Количество колес: 2]]></param> - параметры товара. В многозначном параметре значения перечисляются через <br/> разделитель и заворачиваются в CDATA.
В случае, если условия оплаты и доставки в определенных товарах отличаются от основного ассортимента, в offer добавляется параметр через <param name="Доставка/Оплата">. Текст (значение) параметра согласовывается с менеджером. Пример заполнения параметра: <param name="Доставка/Оплата">Товар под заказ. Срок доставки до 7 дней. Предоплата 10%</param>.
Если в прайс были добавлены новые параметры - необходимо связаться с менеджером по поддержке и сообщить об этом. Данные параметры будут добавлены в товары и проверены на корректность заполнения контент-отделом. Обязательный элемент.
*Примечание: Перечень характеристик, которые должны быть выведены через param name, смотрите на карточке товара на сайте Rozetka.ua во вкладке Все характеристики и в фильтрах категории.
|
У нашего товара есть определенная специфика, так как под одним артикулом есть товары, которым можно выбрать разный цвет, разные параметры размеров и наполнение.
