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

Матеріали

Керуйте каталогом матеріалів проєкту — цінами, одиницями виміру, властивостями та масовим імпортом/експортом через 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; невалідні значення мовчки ігноруються і трактуються як порожні.

Імпорт оновлює лише список, показуваний на сторінці, — натисніть Зберегти на будь-якій зачепленій позиції чи оновіть сторінку, щоб підтвердити, що зміни збережено на сервері.