Требования к каталогу товара

Товарный каталог (фид) загружается в формате XML. Ознакомьтесь с требованиями.

Ваш каталог товаров загружается в формате XML. Большинство CMS систем умеют генерировать такие файлы автоматически.
У вас также могут быть подходящие фиды, которые генерируются для других платформ, их тоже можно использовать для импорта в Aplaut, главное убедиться что в них есть весь актуальный ассортимент товаров, которые доступны к просмотру на сайте и они соответствуют требованиям ниже и не содержат много лишних данных.


Если готовите каталога с нуля

Поддерживается формат каталога — XML/YML, и кодировка UTF-8.

Заголовок

В "шапке" фида необходимо наличие заголовка с указанием версии и кодировки:

 <?xml version="1.0" encoding="UTF-8"?>  

Корневой элемент

Далее должен быть корневой элемент каталога yml_catalog, в котором указана дата в формате YYYY-MM-DD hh:mm  (Указание даты позволяет системе определять обновляется ли фид чтобы импортировать обновления. Дата должна соответствовать моменту, на который актуальны данные в файле):

 <yml_catalog date="2025-11-01 17:22"> 

Элемент <shop>

В корневой элемент добавляются данные по магазину, в элемент <shop>. В него добавьте общие данные по магазину, а также категории (<categories>) и сами товары (товарные предложения, в элемент <offers>).


Вложенные элементы:

ЭлементТип данныхОписание
<name>Текст: <name>BestSeller</name>
Название магазина
<company>Текст: <company>Tne Best inc.</company>Название компании
<url>Текст: <url>http://yuorsite.ru</url>Адрес сайта магазина
<platform>Текст:<platform>Bitrix24</platform>Название системы управления контентом (CMS)
<categories>Содержит вложенные элементы <category> Список категорий товаров сайта/мобильного приложения
<offers>Содержит вложенные элементы <offer>Список товаров (товарных предложений), доступных к просмотру на сайте и(или) в мобильном приложении

Элемент <categories>

В этот элемент необходимо добавить данные по категориям сайта, идентифифкаторы и наименования.

Чтобы вложить одну категорию в другую, используйте атрибут parentId.

Пример:

<categories>
  <category id="1">Телефоны</category>
  <category id="10" parentId="1">Смартфоны</category>
</categories>
☝️ 

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

Элемент <offers>

В этот элемент необходимо добавить актуальные товары, доступные для просмотра на сайте. Товары добавляются во вложенные элементы <offer>. У элемента <offer> есть обязательный атрибут id, это уникальный идентификатор товара (товарного предложения).

Также у offer  есть несколько необязательных, но полезных атрибутов:

group_id

Идентификатор группы товаров. Если у вас есть товары-варианты, вы можете объединить их в группы, как указано в статье по ссылке.

Параметр рекомендован к использованию, при возможности. Влияет на покрытие каталога отзывами в положительную сторону. В случае если в каталоге есть товары, у которых могут быть варианты (например iPhone 16 с вариантами памяти 128Гб, 256Гб и т.д.). Мы рекомендуем объединять такие варианты в группы с помощью параметра group_id.

available

Атрибут доступности товара в наличии. Если товар в наличии укажите значение true, если нет — false.

☝️

Параметр также рекомендован к использованию для формирования актуальных отчетов с помощью сегментирования товаров в ЛК Aplaut и, например, экспортов для последующего анализа данных.

type

Тип предложения, используется редко. Предназначен для формирования наименования товара из значений элементов vendor и model, а также typePrefix.

Всегда =vendor.model 

Вложенные элементы и атрибуты  offer :

ЭлементОбязательноОписание
categoryIdДаИдентификатор категории товара
descriptionНетОписание товара, если в описании есть html-теги, его необходимо помещать внутрь `CDATA`, пример: `<description> <![CDATA[ <p>текст</p> ]]> </description>`<br>
modelНет**Модель товара, добавляется если нужно строгое формирование названия товара, или если нет возможости передать элемент `name`
nameДаПолное наименование товара.<br><br>Наименование товара по умолчанию формируется из этого поля, если не передаются параметр `type` и элементы `vendor`, `model` и `typePrefix`.
pictureДаСсылка на изображение товара. Можно добавить несколько, но использоваться будет только одно.
priceНет**Цена
typePrefixДаТип/категория товара
urlДа**URL страницы товара на сайте магазина
vendorДа**Бренд товара
vendorCodeНетКод товара, который ему присвоил производитель (Артикул производителя)

* — если передается type, в фиде также необходимо передавать атрибуты vendor, model и typePrefix. Значение vendor.model  означает, что наименование товара будет формироваться из этих двух атрибутов, в формате typePrefix+vendor+model.

** — Имя товара при импорте формируется из поля name. Имя товара при импорте формируется из полей typePrefix, vendor  и  model.

Пример структуры YML файла с двумя товарами:

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2025-11-01 17:22">
  <shop>
    <name>ACME Shop</name>
    <company>Tne ACME inc.</company>
    <url>http://yoursite.ru</url>
    <platform>Bitrix24</platform>
    <categories>
      <category id="1">Телефоны</category>
      <category id="10" parentId="1">Смартфоны</category>
    </categories>
    <offers>
      // пример товара только с обязательными и рекомендованными атрибутами
      <offer id="100" available="true" group_id="1000">
        <categoryId>10</categoryId>
        <vendor>Apple</vendor>
        <name>Смартфон Apple iPhone 7 128gb Space Gray</name>
        <url>https://www.abc.ru/100.html</url>
        <picture>https://www.abc.ru/1580.jpg</picture>
      </offer>

      // пример товара большим набором атрибутов
      <offer id="101" available="true" group_id="1000" type="vendor.model">
        <vendorCode>NWC22RU/A</vendorCode>
        <url>https://www.abc.ru/101.html</url>
        <price>55690</price>
        <categoryId>10</categoryId>
        <picture>https://www.abc.ru/1580.jpg</picture>
        <picture>https://www.abc.ru/1581.jpg</picture>
        <name>Смартфон Apple iPhone 7 64gb Space Gray</name>
        <vendor>Apple</vendor>
        <model>iPhone 7 64gb Space Gray</model>
        <description>iPhone 7 — непременный спутник любого успешного обязателен к покупке. Успей оформить кредит!</description>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Общие примечания и рекомендации.

- Если товара нет в наличии, но пользователь может его найти и перейти в карточку, лучше чтобы этот товар был в файле.


Еще:


👆 На этом пока всё