Технические требования к прайс-листам

Прайс-листы принимаются в формате CSV (TSV) и XML Yandex (YML)

Файл с прайс-листом должен быть размещен на сайте вашего магазина по URL, который указывается в настройках магазина после регистрации. Данный файл регулярно скачивается роботом и обновленные данные импортируются в базу данных ТехноПортала, поэтому прайс-лист должен поддерживаться магазином в актуальном состоянии.

1) Описание CSV-файла

Общие требования к CSV (TSV)-формату:

  1. Одна строка файла должна содержать описание одного товарного предложения.
  2. В качестве разделителя столбцов (полей) используется запятая или точка с запятой (CSV), либо символ табуляции (TSV).
  3. Не допускается использование символов табуляции и переноса строки внутри полей.
  4. Если файл содержит пустые поля, то для них ставить разделители все-равно обязательно.
  5. Порядок следования элементов (полей) не важен, но в пределах одного файла порядок элементов должен быть одинаковым.
  6. Цена на все позиции в прайс-листе должна быть больше нуля.

Описание полей CSV (TSV)-файла

Поле Описание
Группа товаров Название категории товарного предложения. Каждый товар (товарное предложение) должен принадлежать только одной категории.
Обязательный элемент.
Брэнд Название производителя. Не должен содержаться в в названии товара (поле «модель»).
Обязательный элемент.
Модел Название товарного предложения. Если у товара есть «номер продукта» (Product number), то нужно, чтобы он присутствовал в названии товара (например, ноутбук Lenovo модели IdeaPad Z370-323ABK-1 (59-312484), где «59-312484» - это номер продукта).
Обязательный элемент.
Описание Краткое текстовое описание товарного предложения.
Необязательный элемент.
Цена Цена, по которой данный товар можно приобрести в магазине. Цена товарного предложения при отображении посетителю округляется, а формат, в котором она отображается, зависит от настроек пользователя. Все товарные предложения в прайс-листе должны быть указаны в одной валюте. Если данное поле не является числом, такая строка прайса будет пропущена.
Обязательный элемент.
Ссылка на товарную позицию на сайте магазина URL страницы товара, на которую перенаправляется посетитель ТехноПортала при нажатии кнопки «Купить» в товарном каталоге. Максимальная длина URL – 255 символов.
Обязательный элемент.
Ссылка на изображение товара При выводе товаров в режиме прайс-строк (если в каталогах ТехноПортала не представлен какой-либо товар) изображение товара берется с сайта магазина.
Необязательный элемент.
Гарантия Количество месяцев, на которые дается гарантия на товар (товарное предложение)
Необязательный элемент.
Курс Это поле актуально для прайс-листов, у которых цены указаны в иностранной валюте.
Необязательный элемент.

Скачать пример прайс-листа в формате CSV

Строки в прайс-листе, не удовлетворяющие указанным выше требованиям – пропускаются. Первая строка файла может содержать заголовки полей (столбцов таблицы прайс-листа), она при обработке пропускается, но помогает разобраться в структуре файла при настройке робота.

2) Описание XML-файла

Общие требования к XML-формату:

  1. Заголовок должен начинаться с первой строки, с нулевого символа.
  2. Стандарт XML не допускает использования в текстовых данных непечатаемых символов с ASCII-кодами в диапазоне значений от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки). Это требует обязательной замены некоторых символов на эквивалентные им символьные коды:

    Символ в тексте Код для XML-файла
    " "
    & &
    > >
    < &lt;
    ' &apos;

Описание элементов 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 форматы) также принимаются к обработке.

Сайт принадлежит компании ООО “Креатив Медиа” © 2007–2017
Карта сайта