Ваш каталог товаров загружается в формате 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.
<?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>- Если товара нет в наличии, но пользователь может его найти и перейти в карточку, лучше чтобы этот товар был в файле.