<xml header>

Стандартный XML-заголовок. Он должен начинаться с первой строки, с нулевого символа.

<yml_catalog>

Корневой тег XML-документа, который используется в YML-файле с атрибутом date. Атрибут date — это дата и время, в которые актуальны данные в файле.

Убедитесь, что указываете в файле правильные дату и время. Не указывайте будущие дату и время — вместо них будет использоваться дата и время загрузки файла. Неактуальное значение атрибута date вызовет ошибки в работе с предложениями.

Мы рекомендуем всегда заполнять атрибут date. Если файл генерируется автоматически, желательно указывать дату и время начала генерации.

Допустимый формат значения основан на стандарте RFC 3339.

Особенности атрибута date:
• между датой и временем должна стоять латинская буква T или пробел;
• можно не указывать секунды и часовой пояс. По умолчанию используется 0 секунд и часовой пояс домашнего региона магазина.

Рекомендуем использовать атрибут date в таком формате: 22.11.2020T14:37:38+03:00

Другие примеры значений атрибута date:
• 22.11.2020T14:37:38
• 22.11.2020 14:37

<shop>

Тег с информацией о магазине и его предложениях. Он включает в себя другие теги.

1. <name> — короткое название магазина: оно должно совпадать с фактическим названием, которое опубликовано на сайте.

2. <company> — наименование юрлица, которое владеет магазином.

Примеры:
<name> Золотое Яблоко
<company> ООО «Екатеринбург Яблоко»

3. <url> — URL главной страницы магазина, который сформирован по стандарту RFC 3986. Максимальная длина ссылки — 2048 символов, можно присылать кириллические ссылки.

4. <platform> — название CMS — системы управления контентом, на основе которой работает магазин.

5. <currencies> — основная валюта, в которой будут отображаться цены магазина. Тег должен быть расположен перед списком предложений <offers>.

6. <categories> —  список категорий магазина: он должен стоять перед списком предложений <offers> и совпадать с иерархией на сайте. ID категорий должен совпадать с ID на сайте.

7. <offers> — список предложений магазина. В этот тег нужно вставить по одному тегу <offer> для каждого предложения. Содержание <offer> должно соответствовать содержанию тега на сайте.

<offer id="516723" available="true" group_id="">

<offer id="516723" available="true" group_id="375904">

<offer id="516723" available="true" group_id="null">

<name>

Название товара, которое соответствует названию в карточке товара на сайте.

Название может быть двух типов:

1. Упрощенного типа: полное название товара, когда тип, производитель и модель указаны в одном теге.
Например: 
<name>Голубой свитер с воланами</name>

2. Произвольного типа: название товара составляется из трех разных тегов: <typePrefix>, <vendor> и <model>. 
Название произвольного типа сформируется, если тег <name> не указан.

Описание тегов:
• <typePrefix> — тип товара или категория, например футболка или кроссовки;
• <vendor> — название бренда, например Nike;
• <model> — название модели или ее особенности, например «с перламутровыми пуговицами».

Если один из тегов отсутствует, название будет состоять из оставшихся тегов. Порядок тегов и название после парсинга изменить невозможно.

<offer id="69357" type="vendor.model" available="false" group_id ="54805">

<vendor>Sensaj</vendor>

<model>Тональный крем Cellular Performance Foundation</model>

В названии не должен быть указан размер — это ошибка.

<url>

Ссылка на товар на сайте магазина:

<url>https://www.example.ru/product_page.asp?pid=12344</url>

<price>

Текущая цена на товар. Можно указать целое или дробное число с разделителем-точкой:

<price>999.99</price>

<oldprice>

Цена на товар до скидки, если она есть.
<oldprice> должен быть больше, чем <price>:

<price>999.99</price>
<oldprice>3000</price>

<vendor>

Бренд товара:

<vendor>Christian Dior</vendor>

<picture>

Ссылка на фотографию товара. Если у товара несколько фото, то ссылка на каждое передается в новом теге <picture>:

<picture>http://www.example.ru/img/picture1.jpg </picture>
<picture>http://www.example.ru/img/picture2.jpg </picture>
<picture>http://www.example.ru/img/picture3.jpg </picture>

Нужно прислать несколько изображений товара с разных ракурсов — это статистически значимо влияет на конверсию в покупку. Каждое изображение должно передаваться индивидуальной ссылкой в отдельном теге.

Ссылка на товар должна передаваться только через защищенный протокол передачи гипертекста HTTPS. Фото, которые переданы через HTTP, не будут отображаться.

<categoryId>

ID категории товара. Если категорий несколько, их нужно обернуть в тег <categories>. Товар присваивается только к дочерней категории:

<categories><categoryId>1</categoryId>
…
<categoryId>2</categoryId>
…
<categoryId>3</categoryId>
<categories/>

<vat>

Выберите одно из значений. Ставка НДС:
• none — без НДС;
• vat0 — 0%;
• vat10 — 10%;
• vat20 — 20%;
• vat110 — 10/110;
• vat118 — 18/118 (deprecated);
• vat120 — 20/120.

Пример: <vat>vat20</vat>

<weight>

Единица измерения — килограммы. Можно дроби: разделитель — точка или запятая, не больше трех цифр после него.

Пример: <weight>3.1</weight>

<dimensions>

Единица измерения — сантиметры. Можно дроби: разделитель — точка или запятая, не больше трех цифр после него.

Пример: <dimensions>22.1/40.425/22.1</dimensions>

<vendorCode>

Артикул товарной позиции. С помощью него мы:

1. Отслеживаем самые покупаемые товары и настраиваем рекомендации для покупок в нашем приложении.
2. Настраиваем оплату, критически важно для подключения Т-Корзины.

Если артикулов несколько, укажите их через запятую.

Пример: <vendorCode>VNDR-0005A, VNDR-0005B</vendorCode>

<param name>

Характеристики товара: например, цвет, размер, материал, артикул, вес, объем, производитель, франшиза.

Ниже — описание атрибутов с характеристиками товаров:

1. color. Параметр цвета товара:
<param name="color">Желтый</param>

2. size. Размер в одном из форматов:
• латиницей (S, M, L);
• цифрой (42);
• единый размер (one size).

<param name="Size">XL</param>

3. material. Перечень материалов, из которых сделана вещь: например, 80% хлопок, 20% эластан. Если в одном теге <offer> передается сразу несколько размеров, нужно указывать каждый размер под отдельным тегом.

Нельзя:
<param name="Размер">S, M,L</param>

Можно:
<param name="Размер">S</param>
<param name="Размер">M</param>

4. gender. Параметр пола — товар для мужчин или для женщин:
<param name="gender">Женское</param>

5. hit. Параметр для популярных товаров:
<param name="hit">=true</param name>.

<description>

Описание статистически значимо влияет на конверсию покупку в категориях «Косметика», «Товары для дома», «Товары для детей», «Электроника». В случае категории «Одежда и обувь» при отсутствии описания необходимо отправлять параметры товара в <param name> , иначе пользователю сложно принять решение о покупке.

Нежелательно использовать <![CDATA []]>, так как это ломает обработку даже стандартных тегов. В описании допускается использование HTML-тегов:

1. Списки:
• <ul></ul> — создает ненумерованный список
• <ol></ol> — создает нумерованный список
• <li></li> — предваряет каждый элемент списка и добавляет кружок/квадрат/номер

2. Переносы:
• <br> или <br/> или <br /> или \n — перенос строки 
• <p> — абзац, может быть с или без закрывающего тега

3. Спецсимволы:
• & nbsp; — неразрывный пробел

Подробнее об описаниях можно прочитать в этом разделе.

Пример товара с описанием:

<offer id="9917" available="true" group_id="9916">
<name>Набор мужских полубоксеров из сеточки 3 шт.</name>
<description>
Мужские боксеры Katy Maslova
—
широкий выбор цветовых решений и свобода в индивидуальных пожеланиях. Полубоксеры с фирменной резинкой в цвете на выбор. Важно: цвет обработки всегда черный. Швы надежно спрятаны во избежание натираний и лишнего дискомфорта. В нашем онлайн-ателье вы можете указать и другие индивидуальные пожелания в специальном окне. Обратите внимание, что цвет изделия может немного отличаться от оттенка на фотографиях. Для выбора размера ориентируйтесь на таблицу в галерее. Размер модели: S, обхват бедер — 93 см. Цвет на модели: сетка черная, резинка черная, обработка черная. 
</description>
<picture>https://katymaslova.ru/wp-content/uploads/2023/08/img_9894-
scaled.jpg</picture>
<url>https://katymaslova.ru/product/nabor-muzhskih-polubokserov-iz-setochki-3-
sht/</url>
<store>true</store>
<delivery>false</delivery>
<categoryId>71</categoryId>
<vat>no</vat>
<price>5490</price>
<currencyId>RUR</currencyId>
</offer>

<group_id>

Тег передает все варианты одной модели товара. Его нужно добавить ко всем вариантам одной модели товара. Этот тег должен стоять в одной строке с <offer_id> до закрывающей скобки. 

У <group_id> должно быть одинаковое значение, которое записано целым числом до 9 знаков. В каждом SKU группы товаров должен присутствовать один <group_id>.

Категории товаров, в которых чаще всего используется тег <group_id>:
• одежда, обувь и аксессуары;
• косметика, парфюмерия и уход;
• детские товары;
• мебель;
• аксессуары для портативной электроники.

<offer id="9917" available="true" group_id="9916">