← На главную

Инструкция по созданию товарного фида для tone.place

Общие требования

  1. Уникальные идентификаторы товаров. Каждый товар, независимо от формата фида, должен иметь уникальный ID. Один и тот же товар в разных фидах (YML, CSV, Excel) обязан иметь одинаковый идентификатор. Это упрощает синхронизацию с маркетплейсами и позволяет отслеживать остатки и цены.

  2. Корневой элемент YML. В формате YML используется один корневой элемент <yml_catalog>. Атрибут date должен содержать дату и время генерации файла в формате YYYY‑MM‑DD hh:mm.

  3. Структура YML. Внутри <yml_catalog> должен быть элемент <shop>, который содержит:

    • <currencies> – список валют,
    • <categories> – список категорий,
    • <offers> – список товарных предложений. Элементы <currencies> и <categories> всегда идут перед списком <offer>.
  4. Типы офферов. Фид может содержать упрощённые офферы (название задаётся элементом <name>) или офферы произвольного типа vendor.model, где название товара задаётся элементами <typePrefix>, <vendor> и <model>. Внутри одного фида допускается смешение обоих типов.

  5. Единая система категорий. Для проекта tone.place предлагается пять основных категорий для домашних товаров и дизайна интерьеров:

    1. Ковры – детализировать первым.
    2. Мягкая мебель – диваны, кресла, пуфы.
    3. Освещение – люстры, бра, настольные лампы.
    4. Столы и стулья – обеденные, журнальные, барные + стулья и табуреты.
    5. Декор и текстиль – шторы, подушки, пледы, вазы, настенные панно.

Пример структуры 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 по длинной стороне).

Файл: /docs/tone_feed_instruction.md