Прайс-листы принимаются в формате CSV (TSV) и XML Yandex (YML)
Файл с прайс-листом должен быть размещен на сайте вашего магазина по URL, который указывается в настройках магазина после регистрации. Данный файл регулярно скачивается роботом и обновленные данные импортируются в базу данных ТехноПортала, поэтому прайс-лист должен поддерживаться магазином в актуальном состоянии.
1) Описание CSV-файла
Общие требования к CSV (TSV)-формату:
- Одна строка файла должна содержать описание одного товарного предложения.
- В качестве разделителя столбцов (полей) используется запятая или точка с запятой (CSV), либо символ табуляции (TSV).
- Не допускается использование символов табуляции и переноса строки внутри полей.
- Если файл содержит пустые поля, то для них ставить разделители все-равно обязательно.
- Порядок следования элементов (полей) не важен, но в пределах одного файла порядок элементов должен быть одинаковым.
- Цена на все позиции в прайс-листе должна быть больше нуля.
Описание полей CSV (TSV)-файла
Поле |
Описание |
Группа товаров |
Название категории товарного предложения. Каждый товар (товарное предложение) должен принадлежать только одной категории. Обязательный элемент. |
Брэнд |
Название производителя. Не должен содержаться в в названии товара (поле «модель»). Обязательный элемент. |
Модел |
Название товарного предложения. Если у товара есть «номер продукта» (Product number), то нужно, чтобы он присутствовал в названии товара (например, ноутбук Lenovo модели IdeaPad Z370-323ABK-1 (59-312484), где «59-312484» - это номер продукта). Обязательный элемент. |
Описание |
Краткое текстовое описание товарного предложения. Необязательный элемент. |
Цена |
Цена, по которой данный товар можно приобрести в магазине. Цена товарного предложения при отображении посетителю округляется, а формат, в котором она отображается, зависит от настроек пользователя. Все товарные предложения в прайс-листе должны быть указаны в одной валюте. Если данное поле не является числом, такая строка прайса будет пропущена. Обязательный элемент. |
Ссылка на товарную позицию на сайте магазина |
URL страницы товара, на которую перенаправляется посетитель ТехноПортала при нажатии кнопки «Купить» в товарном каталоге. Максимальная длина URL – 255 символов. Обязательный элемент. |
Ссылка на изображение товара |
При выводе товаров в режиме прайс-строк (если в каталогах ТехноПортала не представлен какой-либо товар) изображение товара берется с сайта магазина. Необязательный элемент. |
Гарантия |
Количество месяцев, на которые дается гарантия на товар (товарное предложение) Необязательный элемент. |
Курс |
Это поле актуально для прайс-листов, у которых цены указаны в иностранной валюте. Необязательный элемент. |
Скачать пример прайс-листа в формате CSV
Строки в прайс-листе, не удовлетворяющие указанным выше требованиям – пропускаются. Первая строка файла может содержать заголовки полей (столбцов таблицы прайс-листа), она при обработке пропускается, но помогает разобраться в структуре файла при настройке робота.
2) Описание XML-файла
Общие требования к XML-формату:
- Заголовок должен начинаться с первой строки, с нулевого символа.
- Стандарт XML не допускает использования в текстовых данных непечатаемых символов с ASCII-кодами в диапазоне значений от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки). Это требует обязательной замены некоторых символов на эквивалентные им символьные коды:
Символ в тексте |
Код для XML-файла |
" |
" |
& |
& |
> |
> |
< |
< |
' |
' |
Описание элементов XML-файла
Элементы |
Структура и синтаксис |
Описание |
Заголовок |
<?xml version="1.0" encoding="windows-1251"?> |
Это стандартный XML-заголовок со ссылкой на файл описания формата. Заголовок должен начинаться с первой строки, с нулевого символа. Возможны 2 варианта кодировки: windows-1251 и UTF-8. Обязательный элемент.
|
Корневой элемент <yml_catalog> |
<yml_catalog date="2010-04-01 17:00">
<shop>
...
</shop>
</yml_catalog>
|
Любой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент <yml_catalog>. Атрибут date элемента <yml_catalog> не обязателен.
|
Атрибуты магазина <shop> |
<shop>
<name>BestShop</name>
<url>http://best.seller.ru/</url>
<currencies> ... </currencies>
<categories> ... </categories>
<offers> ... </offers>
</shop>
|
Элемент <shop> содержит описание магазина и его товарных предложений.
<name> – Короткое название магазина
<url> – URL главной страницы магазина
|
Курсы валют магазина <currencies> |
<currencies>
<currency id="USD" rate="8.04"/>
<currency id="EUR" rate="10.5"/>
<currency id="UAH" rate="1"/>
</currencies>
|
Элемент <currencies> задает список курсов валют магазина. Каждая из валют описывается отдельным элементом <currency>.
Элемент <currencies> задает список курсов валют магазина. Каждая из валют описывается отдельным элементом <currency>.
Параметр id элемента <currency> указывает код одной или нескольких валют, которые могут быть использованы в YML-файле.
Параметр rate указывает курс валюты к той валюте, в которой сформированы цены в прайс-листе. Параметр rate может иметь только числовые значения. В качестве разделителя целой и дробной частей любых чисел в XML независимо от региональных установок используется точка (не запятая!).
|
Группа товаров <categories> |
<categories>
<category id="4">Видео</category>
<category id="6">Принтеры</category>
<category id="7">Оргтехника</category>
<category id="8" parentId="7">Проекторы</category>
</categories>
|
В элементе <categories> содержится список категорий магазина. Каждая категория описывается отдельным элементом <category>. Описание категории должно включать ее идентификатор (параметр id) для всех категорий и идентификатор категории более высокого уровня для подкатегорий. Идентификатор категории должен быть уникальным положительным целым числом. Ни у одной категории атрибут id не может быть равен «0». Если атрибут parentId не указан, то категория считается корневой.
Атрибуты:
id – идентификатор вашей категории товаров. Обязательный элемент.
parentId – идентификатор более высокой по иерархии (родительской) категории товаров. Обязательный элемент.
|
Позиции прайс-листа <offers> |
<offers>
<offer id="4707" available="true">
<url>http://www.shop.com.ua/Apple-iMac-27-MB952?from=technoportal</url>
<price>2035</price>
<currencyId>USD</currencyId>
<categoryId>137</categoryId>
<picture>http://www.shop.com.ua/data/small/46224.mac27</picture>
<delivery>true</delivery>
<vendor>Apple</vendor>
<name>iMac 27 (MB952)</name>
<description>27 (2560x1440),Core 2 Duo (3.06 ГГц) / 4 ГБ / 1000 ГБ (7200) / ATI Radeon HD 4670 / DVDplusmn;RW (SuperMulti Double Layer) / Lan / Mac OS X 10.5 Leopard</description>
<warranty>24</warranty>
</offer>
<offer id="4708" available="true">
...
</offer>
...
</offers>
|
Каждая товарная позиция прайс-листа описывается в элементе offer с следующими атрибутами и элементами:
id – идентификатор товара в магазине (например, артикул). Обязательный и уникальный атрибут для всего прайс-листа.
available – наличие товара (должно быть всегда "true"). В прайс-листе должны быть только те товары, которые есть в наличии. Необязательный атрибут.
url – URL страницы товара, на которую перенаправляется посетитель ТехноПортала при нажатии кнопки «Купить». Максимальная длина URL – 255 символов. Обязательный элемент.
price – Цена, по которой данный товар можно приобрести. Цена товарного предложения округляется, формат, в котором она отображается, зависит от настроек пользователя. Все товарные предложения в прайсе должны быть указаны в одной валюте (соответствующей курсу этой валюты у магазина к гривне). Обязательный элемент.
currencyId – Идентификатор валюты товара (USD, UAH, EUR). Для корректного отображения цены в национальной валюте необходимо использовать идентификатор (например, UAH) с соответствующим значением цены. Необязательный элемент.
categoryId – Идентификатор категории товара (целое число не более 18 знаков). Товарное предложение может принадлежать только одной категории. Обязательный элемент.
picture – изображение товара, предоставленное магазином. При выводе товаров в режиме прайс-строк (если в каталогах ТехноПортала не представлен какой-либо товар) изображение товара берется с сайта магазина. Необязательный элемент.
delivery – возможность доставки. Необязательный элемент.
vendor – производитель. Не должно повторяться в названии предложения. Обязательный элемент.
name – Название товарного предложения. Если у товара есть «номер продукта» (Product number), например как у ноутбуков, то он должен присутствовать в названии товара. Обязательный элемент.
description – Описание товарного предложения. Необязательный элемент.
warranty – Число месяцев, на которые дается гарантия на товар. Необязательный элемент.
|
Скачать пример прайс-листа в формате XML.
Прайс-листы, сформированные в соответствии с техническими требованиями системы Яндекс Маркет (csv и xml форматы) также принимаются к обработке.