Документация / Материалы

Материалы

Управляйте каталогом материалов проекта — ценами, единицами измерения, свойствами и массовым импортом/экспортом через Excel.

Обзор

Страница Материалы — это каталог товаров вашего проекта. Каждый материал представляет собой именованную позицию с ценами, единицами измерения и опциональными техническими свойствами. Материалы используются калькуляторами для расчёта позиций заказа.

Список материалов

Материалы показаны в таблице с постраничной навигацией, со следующими колонками:

  • Название — отображаемое название материала и опциональное краткое описание.
  • Группа — категориальная метка для группировки связанных материалов, показывается бейджем.
  • Артикул — артикул или код SKU поставщика.
  • Единица — единица измерения (штуки, метры, квадратные метры и т. д.).
  • Закупочная цена — видна участникам с правом просмотра закупочной цены.
  • Цена продажи — цена, показываемая клиентам, видна участникам с правом просмотра цены продажи.
  • Дилерская цена — видна участникам с правом просмотра дилерской цены.

В зависимости от вашей роли некоторые колонки с ценами могут быть не видны.

Фильтрация

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

Постраничная навигация

Если список длинный, он разбивается на страницы. Используйте кнопки «назад/вперёд» внизу таблицы для навигации между страницами. Номер текущей страницы показан слева.

Добавление материала

Нажмите кнопку Добавить в правом верхнем углу, чтобы открыть форму материала. Она состоит из трёх вкладок:

Материал

Основные детали материала:

  • Название (обязательно) — отображаемое название.
  • Группа — опциональная категория. По мере ввода существующие группы из вашего каталога предлагаются автозаполнением.
  • Артикул — артикул или код SKU поставщика.
  • Единица — единица измерения (выбирается из доступного списка).
  • Процент отходов — опциональный коэффициент потерь (0–100%). Если задан, калькулятор учтёт этот процент потерь материала при расчёте количеств.
  • Описание — краткое опциональное описание, показываемое под названием в таблице.
  • Цены — закупочная цена, дилерская цена и цена продажи. Все опциональны и по умолчанию равны 0.

Свойства

Опциональный набор кастомных пар ключ-значение для этого материала, вводимых в формате YAML. Свойства можно использовать в калькуляторах для предоставления вариантов выбора (например, цвета, отделки, размеры).

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

Пример:

color:
  - White
  - Brown
  - Anthracite

Изображение

Загрузите изображение для этого материала (PNG, JPEG или WebP). Изображение показывается миниатюрой. Можно заменить его загрузкой нового файла или удалить кнопкой Удалить.

Вкладка Изображение сейчас отключена и станет доступна в будущем обновлении.

Нажмите Сохранить, чтобы создать материал.

Редактирование материала

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

Дублирование материала

Нажмите значок копирования на любой строке, чтобы открыть форму материала, предзаполненную всеми данными этого материала, но без ID — сохранение создаст новый отдельный материал. Полезно для создания вариаций существующей позиции.

Удаление материала

Нажмите значок корзины на строке, чтобы её удалить. Строка затемняется на время удаления.

Импорт и экспорт (Excel)

Материалами можно управлять массово через файлы Excel с помощью кнопок Экспорт и Импорт в правом верхнем углу.

Экспорт

Скачивает текущий список материалов в виде файла .xlsx (materials.xlsx) с тремя листами:

  • Materials List — все ваши текущие материалы, по одному на строку.
  • Example — строка-пример, показывающая ожидаемый формат и значения колонок.
  • Units — справочный список всех допустимых значений единиц измерения.

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

Импорт

Загрузите файл .xlsx (должен содержать лист Materials List с той же структурой колонок, что и в экспорте). Импортированные строки заменяют текущий список в памяти на странице.

Правила импорта:

  • Строки без названия пропускаются.
  • Если у строки есть валидный существующий uuid, она трактуется как обновление этого материала; иначе генерируется новый UUID и создаётся новый материал.
  • Единица должна совпадать с одним из допустимых значений (см. лист Units в экспортированном файле); невалидные значения по умолчанию становятся pcs.
  • Свойства должны быть валидным YAML; невалидные значения молча игнорируются и трактуются как пустые.

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