Описание товарных фидов: структура и примеры
Товарный фид — файл в формате XML со ссылками и краткими описаниями товаров определённой категории.
В системе Adv.Cake товарные фиды работают по стандарту YML (Yandex Market Language), разработанному Яндексом на основе XML. Все требования стандарта XML применимы к YML. Используйте только те теги и правила, которые описаны в спецификации Яндекса.
Структура товарного фида
Описание элементов
| Поле | Описание | Пример |
|---|---|---|
| xml header | Стандартный XML-заголовок. Должен начинаться с первой строки, с нулевого символа. | <?xml version="1.0" encoding="UTF-8"?> |
| yml_catalog | Любой XML-документ содержит один корневой элемент. В YML им является <yml_catalog>. Атрибут date должен соответствовать дате и времени генерации файла на стороне магазина в формате YYYY-MM-DD hh:mm. | <yml_catalog date="2021-02-05 10:05"><yml> |
| shop | Содержит описание компании и список предложений (offers). | <shop> <name>...<name> <company>...<company> <url>...<url> <picture>...<picture> <currencies> ... <currencies> <categories> ... <categories> <offers> ... <offers> <shop> |
| name | Название бренда. | <name>Название бренда<name> |
| company | Юридическое название компании. | <company>Юридическое название компании<company> |
| url | Адрес сайта компании. | <url>https://site.ru<url> |
| picture | Ссылка на логотип компании. В теге <offer> одноимённый тег <picture> — ссылка на изображение товара размером до 500×500 пикселей. | <picture>https://site.ru/logo.png<picture> |
| currencies | Список валют для предложений компании. | <currencies> ... <currencies> |
| categories | Список категорий для предложений компании. | <categories> ... <categories> |
| offers | Список предложений (услуг) компании. | <offers> ... <offers> |
| currency | Список валют компании. Для каждой валюты используйте отдельный элемент currency. В атрибуте id укажите код валюты: RUR, RUB — рубли; UAH — гривны; BYN — белорусские рубли; KZT — тенге; USD — доллары; EUR — евро. В атрибуте rate укажите единицу. | <currency id="RUB" rate="1"/> |
| category | Список категорий компании. Для каждой категории — отдельный элемент category. Укажите id категории и parentId для дочерних категорий. Если parentId не указан, категория считается корневой. | <categories> <category id="1">Категория 1<category> <category id="2" parentId="1">Подкатегория 1.1<category> <category id="3" parentId="1">Подкатегория 1.2<category> <category id="4">Категория 2<category> <category id="5" parentId="4">Подкатегория 2.1<category> <category id="6">Категория 3<category> <categories> |
| offer | Список предложений компании. Для каждого предложения — отдельный элемент offer. Вложенные элементы могут отличаться в зависимости от типа оффера. | <offers> <offer id="1"> ... <offer> <offer id="2"> ... <offer> <offer id="3"> ... <offer> <offers> |
В поле categories указаны все категории товаров или услуг компании, даже если для каждой из них (например: детские товары, электроника, товары для дома) существует отдельный фид.
Примеры фидов и описание элементов
Образование и услуги
Пример предложения образовательного продукта:
Описание элементов
| Поле | Описание | Пример |
|---|---|---|
| id | Id продукта. | <offer id="1"> |
| available | Наличие продукта. Всегда принимает значение true. | |
| name | Название продукта. Допускается включать бренд и категорию услуги. | <name>Название бренда Категория 1 Название курса 1<name> <name>Название курса 1<name> |
| url | URL страницы продукта. Максимальная длина — 2048 символов. Допускаются кириллические ссылки. Формируется по стандарту RFC 3986. | <url>https://site.ru/courses/course_1/<url> |
| price | Актуальная цена продукта. Формат: целое или дробное число, разделитель — точка. Цена должна соответствовать стоимости продукта/услуги. В ряде категорий допустимо указывать цену «от» с атрибутом from="true". | <price>7500<price> |
| oldprice | Старая цена продукта — должна быть выше текущей. Используется для автоматического расчёта скидки. | <oldprice>15000<oldprice> |
| currencyId | Валюта цены: RUR, USD, EUR, UAH, KZT, BYN. Цена и валюта должны соответствовать друг другу. | |
| categoryId | Идентификатор категории продукта (целое число, не более 18 знаков). Все идентификаторы категорий указаны в поле categories. | |
| picture | Ссылка на изображение продукта, до 500×500 пикселей. | <picture>https://site.ru/courses/course_1.jpg<picture> |
| delivery | Доступна ли курьерская доставка. Значение по умолчанию — true. | |
| pickup | Доступен ли самовывоз. Значение по умолчанию — true. | |
| store | Можно ли забрать товар в торговом зале. Значение по умолчанию — true. | |
| description | Описание продукта, не более 3000 символов. В описании запрещены: номера телефонов, email, адреса, ссылки, слова «скидка», «распродажа», «бесплатно», «акция» и др.; условия продажи; регион продажи; информация о модификациях. В формате YML допустимы некоторые xhtml-теги в блоке CDATA. | <description>Лучший в мире курс. Выпускает самых совершенных дипломированных курсантов.<description> |
| sales_notes | Условия приобретения: минимальная сумма, предоплата, способы оплаты, акции. Обязателен при наличии ограничений при покупке. Максимальная длина — 50 символов. | <sales_notes>Возможна рассрочка на 12 месяцев с оплатой 7500 руб. в месяц<sales_notes> |
| enable_auto_discounts | Включить или отключить автоматический расчёт и показ скидок. | |
| manufacturer_warranty | Гарантия производителя. | |
| param | Характеристика продукта. Один элемент <param> — одна характеристика. В атрибуте name — название параметра (обязательно). В атрибуте unit — единицы измерения (опционально). | <param name="Ближайшая дата начала занятий">2021-02-06<param> <param name="Продолжительность обучения, месяцев">5<param> |
Интернет-магазины
Пример товарного предложения интернет-магазина:
Описание элементов
| Поле | Описание | Пример |
|---|---|---|
| id | Id продукта. | |
| available | Наличие продукта. Всегда принимает значение true. | |
| url | URL страницы продукта. Максимальная длина — 2048 символов. Допускаются кириллические ссылки. Формируется по стандарту RFC 3986. | <url>https://site.ru/courses/course_1/<url> |
| typePrefix | Тип или категория продукта. | |
| name | Название продукта. Допускается включать бренд и категорию услуги. | <name>Название бренда Категория 1 Название курса 1<name> <name>Название курса 1<name> |
| vendor | Название бренда. | <vendor>Название бренда<vendor> |
| model | Название продукта — используется в связке с тегами vendor и typePrefix. | <model>Название курса 1<model> |
| sales_notes | Условия приобретения: минимальная сумма, предоплата, способы оплаты, акции. Обязателен при наличии ограничений. Максимальная длина — 50 символов. | <sales_notes>Возможна рассрочка на 12 месяцев с оплатой 7500 руб. в месяц<sales_notes> |
| store | Можно ли забрать товар в торговом зале. Значение по умолчанию — true. | |
| pickup | Доступен ли самовывоз. Значение по умолчанию — true. | |
| delivery | Доступна ли курьерская доставка. Значение по умолчанию — true. | |
| manufacturer_warranty | Гарантия производителя. | |
| categoryId | Идентификатор категории продукта (целое число, не более 18 знаков). Все идентификаторы указаны в поле categories. | |
| price | Актуальная цена продукта. Формат: целое или дробное число, разделитель — точка. В ряде категорий допустимо указывать цену «от» с атрибутом from="true". | <price>7500<price> |
| oldprice | Старая цена — должна быть выше текущей. Используется для расчёта скидки. | <oldprice>15000<oldprice> |
| description | Описание продукта, не более 3000 символов. Запрещены: контакты, ссылки, слова «скидка», «акция», «бесплатно» и др.; условия продажи; информация о модификациях. | <description>Лучший в мире продукт. Дарит отличное настроение.<description> |
| currencyId | Валюта цены: RUR, USD, EUR, UAH, KZT, BYN. | <currency id="RUB" rate="1"/> |
| pickup-options | Описывает способы самовывоза (до пяти элементов <option>). Атрибуты: cost — любое число (не используется); days — срок в рабочих днях (0 — в день заказа, 1 — на следующий, максимум 60); order-before — до какого часа принимается заказ (0–24, по умолчанию 13). | <pickup-options> <option cost="123" days="2" order-before="18"/> <pickup-options> |
| condition | Состояние товара. | |
| enable_auto_discounts | Включить или отключить автоматический расчёт и показ скидок. | |
| picture | Ссылка на изображение продукта, до 500×500 пикселей. | <picture>https://site.ru/product/product_1.jpg<picture> |
| barcode | Международный номер для идентификации товара: EAN — штрихкод, ISBN — номер книжного издания. У одного товара может быть несколько штрихкодов. | <barcode>6937265110523<barcode> |
| param | Характеристика продукта. Один элемент <param> — одна характеристика. В атрибуте name — название (обязательно), в unit — единицы измерения (опционально). | <param name="Цвет">розовый<param> <param name="Объем">1.7<param> |
Вам помогла эта страница?
Последнее изменение: 2026-05-12