Каталог товаров

Каталог товаров загружается в формате YML.

Требования к элементу offer

Для описания товарных предложений (оффер) необходимо использовать произвольный тип описания предложений.

Обязательные элементы и атрибуты:

Переменная Тип Описание
id String Идентификатор предложения
url String URL страницы товара на сайте магазина
type String Тип предложения. Всегда vendor.model
price String Цена
categoryId String Идентификатор категории
picture String Ссылка на изображение товара
name String Название товара
vendor String Бренд/производитель/вендор

Подробнее читайте в документации Яндекс.Маркета

Пример описания оффера:

<offer id="100" type="vendor.model" available="true">
  <url>http://www.abc.ru/158.html</url>
  <price>55690</price>
  <categoryId>1293</categoryId>
  <picture>http://www.abc.ru/1580.jpg</picture>
  <picture>http://www.abc.ru/1581.jpg</picture>
  <picture>http://www.abc.ru/1582.jpg</picture>
  <picture>http://www.abc.ru/1583.jpg</picture>
  <name>Смартфон Apple iPhone 7 128gb Space Gray</name>
  <vendor>Apple</vendor>
  <model>iPhone 7 128gb Space Gray</model>
  <description>iPhone 7 — непременный спутник любого успешного человека и оттого обязателен к покупке. Успей оформить кредит!</description>
</offer>

Объединение товаров в группы

Если у вас имеется один и тот же товар в разных вариантах и вы хотите делить отзывы между ними, то такие товары необходимо объединить в одну группу. Для этого в фид нужно выгружать варианты товара и задать им общий атрибут group-id. Пример:

<offer id="101" group-id="12345">
  <name>Apple iPhone 7 32Gb</name>
</offer>
<offer id="102" group-id="12345">
  <name>Apple iPhone 7 64Gb</name>
</offer>
<offer id="103" group-id="12345">
  <name>Apple iPhone 7 128Gb</name>
</offer>

Таким образом импортируются 3 товара, но отзывы каждого из них будут одни и те же.

Карточка Яндекс Маркета

При наличии добавляйте идентификатор модели на Яндекс Маркете. Пример:

<offer id="101" model-id="14206636">
  <name>Apple iPhone 7 32Gb</name>
</offer>

Пользовательские атрибуты

Если к товару необходимо добавить нестандартные атрибуты, это можно сделать через элемент <custom_attributes>...</custom_attributes>.

Содержимым будет JSON документ, обернутый в секцию CDATA. Документ может содержать только один уровень вложенности аттрибутов. Пример: {"a": 1, "b": 2}.

Пример:

<offer id="1">
    <custom_attributes>
      <![CDATA[
        {
          "available_msk": true,
          "available_spb": true
        }
      ]]>
    </custom_attributes>
</offer>
<offer id="2">
    <custom_attributes>
      <![CDATA[
        {
          "available_msk": true,
          "available_spb": false
        }
      ]]>
    </custom_attributes>
</offer>

Проверка валидности

Для проверки валидности файла можно воспользоваться утилитой xmllint из пакета libxml2-utils. Также необходимо скачать XML Schema с нашего сайта.

Пример для Ubuntu:

# Install xmllint 
apt-get install libxml2-utils

# Download XML Schema
curl -O https://shoppilot.ru/static/catalog.xsd

# Validate catalog.xml
xmllint --schema catalog.xsd catalog.xml --noout

После выполнения всех команд, следуйте дальнейшим указаниям утилиты xmllint.

results matching ""

    No results matching ""