Инструкция по созданию товарного фида для tone.place
Общие требования
Уникальные идентификаторы товаров. Каждый товар, независимо от формата фида, должен иметь уникальный ID. Один и тот же товар в разных фидах (YML, CSV, Excel) обязан иметь одинаковый идентификатор. Это упрощает синхронизацию с маркетплейсами и позволяет отслеживать остатки и цены.
Корневой элемент YML. В формате YML используется один корневой элемент
<yml_catalog>. Атрибутdateдолжен содержать дату и время генерации файла в форматеYYYY‑MM‑DD hh:mm.Структура YML. Внутри
<yml_catalog>должен быть элемент<shop>, который содержит:<currencies>– список валют,<categories>– список категорий,<offers>– список товарных предложений. Элементы<currencies>и<categories>всегда идут перед списком<offer>.
Типы офферов. Фид может содержать упрощённые офферы (название задаётся элементом
<name>) или офферы произвольного типаvendor.model, где название товара задаётся элементами<typePrefix>,<vendor>и<model>. Внутри одного фида допускается смешение обоих типов.Единая система категорий. Для проекта tone.place предлагается пять основных категорий для домашних товаров и дизайна интерьеров:
- Ковры – детализировать первым.
- Мягкая мебель – диваны, кресла, пуфы.
- Освещение – люстры, бра, настольные лампы.
- Столы и стулья – обеденные, журнальные, барные + стулья и табуреты.
- Декор и текстиль – шторы, подушки, пледы, вазы, настенные панно.
Пример структуры YML фида
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE yml_catalog SYSTEM "shops.dtd">
<yml_catalog date="2025-09-11 13:00">
<shop>
<name>tone.place</name>
<company>PT Atknin Global Science</company>
<url>https://tone.place</url>
<currencies>
<currency id="RUB" rate="1"/>
<currency id="USD" rate="CBRF"/>
</currencies>
<categories>
<category id="100">Ковры</category>
<category id="200">Мягкая мебель</category>
<category id="300">Освещение</category>
<category id="400">Столы и стулья</category>
<category id="500">Декор и текстиль</category>
</categories>
<offers>
<!-- Здесь размещаются офферы -->
</offers>
</shop>
</yml_catalog>
Категория «Ковры»: рекомендуемые атрибуты
- Размер (Д×Ш или стандартная сетка)
- Форма (прямоугольный/круглый/овальный/дорожка)
- Высота ворса (мм)
- Материал ворса и основы (шерсть, хлопок, джут, полипропилен и др.)
- Цвет/узор
- Страна производства
- Назначение (для гостиной, спальни, детской и т. д.)
- Совместимость с тёплым полом (да/нет)
- Уход (сухая чистка, щадящая стирка и т. д.)
Пример оффера для ковра
<offer id="RUG-000123" type="vendor.model" available="true">
<name>Ковер «Nordic Plain» 160×230 см, бежевый</name>
<categoryId>100</categoryId>
<url>https://tone.place/product/rugs/nordic-plain-160x230-beige</url>
<picture>https://tone.place/media/rugs/nordic-plain-160x230-1.jpg</picture>
<picture>https://tone.place/media/rugs/nordic-plain-160x230-2.jpg</picture>
<video>https://tone.place/media/rugs/nordic-plain-160x230.mp4</video>
<price>17990</price>
<oldprice>21990</oldprice>
<currencyId>RUB</currencyId>
<vendor>tone.place</vendor>
<model>Nordic Plain 160×230</model>
<typePrefix>Ковер</typePrefix>
<description>Современный ковер из полипропилена с мягким ворсом 10 мм и универсальным бежевым оттенком.</description>
<sales_notes>Скидка 10% для новых клиентов.</sales_notes>
<param name="Размер" unit="см">160×230</param>
<param name="Форма">Прямоугольный</param>
<param name="Высота ворса" unit="мм">10</param>
<param name="Материал ворса">Полипропилен</param>
<param name="Материал основы">Джут</param>
<param name="Цвет">Бежевый</param>
<param name="Назначение">Для гостиной</param>
<param name="Совместим с тёплым полом">Да</param>
<param name="Страна производства">Турция</param>
<param name="Уход">Сухая чистка</param>
</offer>
CSV/Excel формат
Для интеграции с Ozon, Wildberries и другими площадками удобно параллельно поддерживать CSV/Excel. Структура таблицы должна соответствовать атрибутам YML.
Пример (CSV):
id;name;category;price;oldprice;currency;vendor;model;url;picture;description;Размер;Форма;Высота ворса;Материал ворса;Материал основы;Цвет;Назначение;Страна;Совместимость с теплым полом
RUG-000123;Ковер Nordic Plain 160×230 см, бежевый;Ковры;17990;21990;RUB;tone.place;Nordic Plain 160×230;https://tone.place/product/rugs/nordic-plain-160x230-beige;https://tone.place/media/rugs/nordic-plain-160x230-1.jpg;Современный ковер из полипропилена;160×230;Прямоугольный;10;Полипропилен;Джут;Бежевый;Для гостиной;Турция;Да
Рекомендации
- Обновлять фид минимум раз в сутки.
- Сохранять единые SKU/ID для синхронизации между YML и CSV.
- Проверять соответствие требованиям конкретного маркетплейса (Ozon, Wildberries, Яндекс.Маркет).
- Использовать качественные изображения (не менее 1000 px по длинной стороне).