#255

Розділ в адмін-панелі: Каталог → Імпорт товарів.

Що це

Майстер масового додавання й оновлення товарів з Excel-файлу. Замінює ручне введення по одному в Каталог → Товари, коли фірма заводить нову колекцію плит, оновлює прайс виробника або підключає собі сотні нових позицій одразу. Файл може містити сотні й тисячі рядків.

Доступ: відкритий адміністратору кореневої фірми (з правом імпортувати «від імені» будь-якої вибраної фірми) і звичайним фірмам із заповненими контактами (телефон + email) — без контактів імпорт закритий, щоб було кого покликати при проблемах із великим завантаженням.

Підтримувані формати

Тільки Excel: .xlsx або .xls. Один файл за імпорт. Кодування — стандартне Excel, розділювачі колонок система визначає сама.

Кроки майстра

Крок 1. Завантаження файлу

  • Вибір фірми (тільки адміністратор кореневої; звичайна фірма імпортує тільки в себе). Імпортовані товари будуть прив'язані до вибраної фірми.
  • Завантажити приклад файлу — кнопка генерації еталонного Excel з усіма правильними колонками. Кожен заголовок містить коментар з описом поля — користуйтеся, щоб зрозуміти що куди. У самому файлі-прикладі є другий аркуш «Опис полів» — детальний довідник по кожному полю; при завантаженні обробляється тільки перший аркуш, інші (включно з цим) ігноруються і не заважають імпорту.
  • Завантажити файл — вибираєте свій .xlsx і натискаєте «Завантажити».

Також на цьому кроці видна формула формування імені товару:

[код декору] [структура] [тип скруглення] [радіус] [вологостійкий] [ім'я декору] [ім'я виробника] [X] [Y] [Z]

Тип скруглення стільниці приймає значення 1U, 2U, 1L, 2L (варіанти профілю торця), 1ABS (торець з одного поздовжнього боку закритий ABS-крайкою), 2ABS (торець з двох боків закритий ABS-крайкою) або XX (без скруглення). Радіус скруглення — один з: R1, R1.5, R3, R3.3, R5.5, R6, R9, R13 (у мм).

Ім'я збирається автоматично з відповідних колонок Excel — не потрібно вручну складати кожну назву. Це дає одноманітність: товари однієї колекції отримують однаковий формат імені, відрізняються тільки розмірами й характеристиками. Якщо тип і радіус скруглення вже присутні в коді чи назві декору, система вирізає їх звідти сама — щоб назва не дублювалася, — і формує підсумкове ім'я одразу всіма мовами каталогу.

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

Крок 2. Зіставлення колонок (маппінг)

Excel рідко виглядає точно так, як вимагає система: у різних виробників колонки названі по-різному й розташовані в різному порядку. На цьому кроці ви говорите системі, де у файлі яке поле.

  • Превʼю файлу — розкривна таблиця з вмістом: перші рядки видно одразу, можна подивитися, яка колонка містить що.
  • Рядок заголовків — номер рядка, де знаходяться назви колонок (часто 1, але не завжди — у деяких виробників є кілька рядків шапки).
  • Діапазон імпорту — з якого рядка почати («Дані з рядка») і яким закінчити («По рядок»). Це дозволяє пропустити підсумкові рядки в кінці або службові коментарі на початку.
  • Зіставлення полів — для кожного поля системи виберіть відповідну колонку Excel (або «не використовувати», якщо у файлі такого немає).
  • Вологостійкість — необов'язкове поле, значення порожньо або 1. Якщо вказано 1, до назви товару всіма мовами каталогу автоматично додається приписка «Вологостійкий», а при зіставленні дублікатів (крок 3) вологостійкий і звичайний матеріал вважаються різними позиціями. Колонку система вміє розпізнавати за ключовими словами (вологостійкість, волога, waterproof, moisture і подібними).
  • Зручні гарячі клавіші в превʼю: клік по рядку = початковий рядок імпорту, Shift+клік = кінцевий, Ctrl+клік = рядок заголовків. Допомагає не вбивати номери вручну на великих файлах.
  • Одиниця продажу — поле приймає кілька форматів запису: за площею (м2, m2 або відповідний цифровий код) — матеріал рахується і продається за квадратними метрами, або листами (sheet чи відповідний цифровий код) — матеріал продається цілими листами. Регістр і точне написання не важливі. У формі редагування товару одиницю також можна вибрати зі спадного списку.
  • Обов'язкові поля підсвічуються — якщо їх не зіставити, кнопка «Продовжити» заблокована.
  • Перевірка габаритів за типом матеріалу — для кожного типу матеріалу задані допустимі межі за шириною, довжиною і товщиною; якщо розміри позиції виходять за межі, рядок підсвічується попередженням із зазначенням допустимого діапазону. У таблиці результатів імпорту видно колонку «Тип матеріалу» — зрозуміло, до якого типу віднесена кожна позиція.
  • Валідація на льоту — якщо в даних є очевидні помилки (порожні обов'язкові поля, неправильні числа в розмірах), вони показуються із зазначенням номерів рядків.
  • Перевірка назв і кодів — неприпустимі символи (лапки, дужки, спецсимволи) в коді декору, назві декору, структурі або додатковій назві показуються окремою помилкою зі списком знайдених символів. Змішувати кирилицю й латиницю в назві декору не можна — наприклад, латинську C замість кириличної С система розпізнає і підказує, яким символом її замінити, із зазначенням позиції та коду символу.

Крок 3. Зіставлення дублікатів (matching)

Найрозумніший крок. Система порівнює кожен рядок з Excel з уже існуючими товарами вибраної фірми й пропонує три сценарії на кожен рядок:

Порівняння враховує не тільки код декору, а й тип матеріалу та структуру: якщо в Excel вказано тип матеріалу, який не збігається з типом уже існуючого товару, це вважається різними позиціями, і чужа картка не підставляється. Так само зі структурою — якщо в наявного товару вона задана, а в прайсі ні, це теж різні товари.

  • Новий товар — такого артикула ще немає, створити з нуля.
  • Оновити існуючий — артикул уже є, оновити характеристики/ціни/картинки. Видно, які поля будуть змінені. Властивості товару (код декору, назва, структура, параметри скруглення) перезаписуються тільки якщо ввімкнено галочку «оновити дані» — без неї повторне завантаження прайсу не затирає вручну вивірені картки, оновлення просто фіксується як пропущене.
  • Пропустити — не чіпати існуючий товар, не створювати новий.

Для кожного рядка видно preview порівняння: поточне значення в системі ↔ нове значення з Excel. Можна поміняти рішення «новий/оновити/пропустити» по рядках перед запуском імпорту.

Якщо у товару задані псевдоніми (внутрішні позначення вашої фірми), вони видно прямо в процесі імпорту — на цьому кроці зіставлення, під час редагування рядка й у підсумкових результатах. Відображаються тільки псевдоніми вашої фірми — чужі позначення не підмішуються.

Крок 4. Обробка картинок

Якщо в Excel є колонка з URL картинок (Google Drive, прямі посилання), система окремо обробляє зображення:

  • Завантаження за URL — система скачує картинку й зберігає в каталог.
  • Порівняння розмірів — якщо у товару вже є картинка, нова завантажується тільки якщо вона більша (вища роздільна здатність). Низькоякісна картинка не замінить добру.
  • Перегляд перед заміною — видно обидві картинки поруч, помічено що відбудеться: «буде замінена (нова більша)» або «не буде оновлена (поточна більша)».
  • Поширені проблеми:
    • Google Drive: файл повинен бути публічним, інакше посилання не працює.
    • Локальні шляхи (C:\photos\...) — не працюють, потрібні повноцінні URL.
    • Посилання, що вимагають авторизації, — пропускаються з поміткою.

Крок 5. Результат

Підсумковий звіт: скільки рядків створено, скільки оновлено, скільки пропущено, скільки з помилками. Помилки показуються построково — можна поправити Excel і імпортувати заново тільки проблемні рядки.

Історія імпортів

Усі запущені імпорти зберігаються з датою, фірмою, ім'ям файлу й користувачем, що запустив. Адміністратор кореневої фірми бачить усі імпорти всіх фірм; звичайна фірма — тільки свої. Можна відкрити картку минулого імпорту, щоб подивитися, що й коли заливалося — корисно при розборах «звідки раптом з'явилися ці 200 товарів».

Що важливо

  • Завантажте приклад перед першим імпортом. У ньому коментарі в заголовках пояснюють кожне поле — це в рази швидше, ніж вгадувати.
  • Ім'я товару не вказується вручну. Заповніть окремі поля (код декору, ім'я декору, ім'я виробника, розміри) — система збере ім'я за формулою сама. Це гарантує одноманітність.
  • Виробник повинен існувати до імпорту (див. Виробники). Якщо в Excel вказаний виробник, якого немає в довіднику, рядок потрапить у помилки.
  • Спочатку пробуйте на 10 рядках, потім на повному файлі. Маппінг колонок і перевірка дублікатів часто вимагають 2–3 ітерації, щоб упіймати всі тонкощі вашого конкретного прайсу.
  • Картинки краще готувати заздалегідь: розмістіть на Google Drive з публічним доступом, поставте посилання у відповідну колонку Excel. Після імпорту вони підтягнуться.
  • Вид товару (кромка чи плита) система визначає за типом матеріалу в довіднику, а не за текстом назви — кромка розпізнається як кромка будь-якою мовою назви. Якщо тип позначено як плитний, але габарити явно кромкові (мала ширина й товщина), позиція автоматично перевизначається в кромку; у кромок буквений суфікс коду декору при цьому переноситься в поле «Структура», але тільки якщо воно ще не заповнене.
  • Якщо результат кроку 3 (matching) показав багато «оновлень» там, де мають бути «нові» — у вас, швидше за все, неправильно зіставлений код виробника. Поверніться на крок 2 і перевірте маппінг колонки «код».
  • Якщо контакти вашої фірми порожні (телефон або email) — імпорт заблокований. Заповніть їх спочатку в картці фірми.