Метаданные для вариантов

Метаданные для вариантов нужны для товаров, которые остаются одним и тем же товаром по смыслу, но имеют несколько вариантов исполнения. Чаще всего речь идет о цвете, размере, длине, объеме и других похожих признаках.

Этот раздел помогает не создавать много почти одинаковых карточек товара, а собрать их в одну вариативную группу. Для покупателя это выглядит как один товар с выбором нужного варианта.

Для кого и когда нужен этот документ

Этот документ нужен как основная инструкция по разделу Метаданные для вариантов. Здесь собраны:

• назначение раздела
• различие между типом и значением варианта
• описание списка и карточки
• правила создания, изменения и удаления
• связь с карточками товаров и клиентскими витринами

Связанные документы по разделу:

• FAQ поможет быстро ответить на типовые вопросы.
• Пошаговые сценарии работы пригодятся, если нужно последовательно выполнить конкретную задачу.
• Проблемы и решения стоит открывать, если раздел ведет себя не так, как ожидалось.

Релевантные разделы

• Раздел Товары - если нужно посмотреть, как варианты живут в карточке товара.
• Публикация каталога - если важно, как вариантность видит клиент.
• Клиентский опыт в приложении - если важно оценить выбор варианта глазами покупателя.

Откройте эту страницу, если нужно:

• понять, как устроен раздел целиком
• разобраться, когда товару действительно нужны варианты
• объяснить сотруднику разницу между типом варианта и его значением

Если нужен быстрый ответ на конкретный вопрос, открывайте:

• FAQ

Если нужен готовый рабочий маршрут, открывайте:

• Пошаговые сценарии работы

Для решения проблемы откройте:

• Проблемы и решения

1. Для чего нужен этот раздел

Этот справочник используется только для тех признаков, по которым товар должен переключаться как вариант внутри одной общей карточки.

Простой пример:

• есть товар Футболка
• у него бывают варианты Белая, Черная, Синяя

В такой ситуации покупателю удобнее видеть один товар Футболка и выбрать нужный цвет, чем листать несколько почти одинаковых карточек.

Раздел помогает:

• сделать каталог аккуратнее
• уменьшить число дублей в витрине
• упростить выбор варианта для покупателя
• поддерживать единый порядок в карточках товаров

2. Что в этом разделе считается типом, а что значением

В разделе есть два уровня:

• Тип
• Значение

Тип отвечает на вопрос: по какому признаку товар делится на варианты.

Примеры типов:

• Цвет
• Размер
• Длина
• Объем

Значение отвечает на вопрос: какой именно вариант существует внутри выбранного типа.

Примеры значений:

• для типа Цвет: Белый, Черный, Красный
• для типа Размер: S, M, L
• для типа Объем: 250 мл, 500 мл, 1 л

Главное правило раздела:

• сначала создают тип
• затем внутри этого типа создают конкретные значения

3. Когда метаданные для вариантов действительно нужны

Раздел подходит, если товары отличаются одним понятным вариантом, но остаются одной моделью.

Хорошие примеры:

• одна и та же футболка в разных цветах
• один и тот же стул в разных размерах
• один и тот же напиток в нескольких объемах

Не используйте этот раздел, если товары отличаются назначением или составом. Для таких товаров лучше оставить отдельные карточки.

4. Как устроен интерфейс раздела

В верхней части раздела находятся кнопка Создать значение и свёрнутый блок Типы признаков. По умолчанию каталог показывает все значения. Кнопка Показать типы раскрывает карточки групп, после чего сотрудник может отфильтровать значения одним нажатием.

Карточка Все значения возвращает полный справочник. Кнопка Новый тип открывает отдельное окно создания группы. После выбора типа под карточками появляется его контекст, а таблица показывает только связанные значения.

Ниже расположены поиск, сортировка, количество найденных записей и список значений. Для каждого значения видны наименование, тип, рабочее значение и код.

5. Поиск и сортировка

Поиск помогает быстрее найти нужную запись, если справочник уже наполнен. Сортировка меняет порядок значений, а счетчик рядом показывает количество найденных записей.

На практике поиск полезен, чтобы:

• проверить, не создан ли тип или вариант раньше
• быстро найти нужное значение среди большого списка
• не заводить дубли вроде Синий, blue и Blue

Перед созданием новых записей поиск лучше использовать всегда.

6. Как устроена работа с типами

Типы вариантов обычно создают нечасто. Это скорее каркас, на который потом опирается вся дальнейшая работа.

В реальной практике у компании таких типов обычно немного:

• цвет
• размер
• длина
• объем
• вкус

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

Некоторые типы могут уже быть доступны в системе заранее. Это нормально. В таком случае сотруднику остается использовать уже готовый тип, если он подходит под правила компании.

7. Как устроена карточка значения варианта

У каждого значения есть отдельная карточка.

Основные поля карточки:

• Тип
• Наименование
• Иконка
• Значение

Практический смысл полей:

• Тип показывает, к какому признаку относится запись
• Наименование используется как понятное имя для сотрудников и обычно для покупателя
• Значение хранит сам вариант в рабочем виде
• Иконка помогает визуально выделить вариант, если компания использует такой подход

8. Как правильно понимать поле Наименование

Наименование должно быть простым и однозначным.

Хорошие примеры:

• Белый
• Черный
• M
• 500 мл

Плохие примеры:

• слишком длинные описания
• разный стиль записи для одинаковых по смыслу значений
• смешение языков без общего правила

Именно это поле чаще всего видит сотрудник при выборе варианта в карточке товара.

9. Как правильно понимать поле Значение

Поле Значение хранит сам рабочий вариант в том формате, который принят в компании.

Для большинства типов это обычное значение:

• M
• 42
• 500 мл
• 150 см

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

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

10. Где этот справочник используется дальше

10.1. В карточке товара

Именно здесь сотрудник связывает конкретный товар с нужным вариантом.

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

10.2. В клиентской витрине, Telegram Mini App и Max мини-приложении

Если товар настроен как вариативный, покупатель видит одну общую карточку товара и может переключаться между вариантами.

Это особенно полезно для:

• одежды
• обуви
• товаров с цветами
• товаров с разным объемом или размером

11. Как поддерживать справочник в порядке

Чтобы раздел оставался удобным:

• не создавайте новый тип под каждый частный случай
• заранее договоритесь о названиях типов
• договоритесь, как будут называться значения внутри каждого типа
• не смешивайте несколько способов записи одного и того же значения

Хорошая практика:

• сначала утвердить небольшой набор типов
• затем уже наполнять их значениями

12. Что важно помнить при изменении и удалении

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

Практически это означает:

• не переименовывать рабочие значения без необходимости
• не создавать дубли с тем же смыслом
• перед удалением проверять, где запись уже используется

Если удалить тип варианта, система удалит все значения внутри этого типа. В товарах, где были выбраны эти значения, поле варианта очистится.

Будьте особенно внимательны с типом Цвет, если он уже показан в клиентской витрине. Изменения увидят сотрудники и покупатели.

13. Импорт и экспорт CSV

Для типов и значений вариантов предусмотрены отдельные CSV-действия. Сначала импортируйте типы, затем значения. Экспорт значений учитывает текущий поиск, сортировку и выбранный тип; ссылка на тип в выгрузке всегда передаётся по id.

Типы признаков

Общие типы доступны в экспорте, но их нельзя изменить импортом или повторно создать с тем же именем.

Значения вариантов

Если тип по имени не найден или найден неоднозначно, импорт не выполняется. Иконка и внутренний code в CSV не передаются.