Масове редагування товарів Prom.ua через XLSX безпечніше виконувати в циклі «експорт, копія, зміни, автоматична перевірка, мала тестова партія, повний імпорт». Критично важливо зберегти ID товарів, назви колонок, структуру аркушів і парні мовні поля.
- Оригінальний експорт як резервну копію.
- ID позиції та артикул без автоматичного переформатування.
- Службові колонки, аркуші товарів і груп.
- Відповідність української назви українському опису.
- Статус кожного зміненого рядка до імпорту.
Які формати підтримує Prom.ua
За офіційною документацією Prom приймає товарні дані у XLS, XLSX, CSV та YML. Для табличного обміну Prom рекомендує сучасний XLSX замість старого XLS. Файл XLSX містить окремі аркуші для товарів і груп, а кожен рядок товарного аркуша відповідає одній позиції. Джерело: імпорт через Excel у довідці Prom.ua.
Експорт потрібен не лише для створення резервної копії. Він дає актуальну структуру колонок, технічні ідентифікатори та поточні значення. Не варто збирати файл з нуля, якщо завдання полягає в оновленні наявних карток.
Безпечний процес у восьми кроках
- Експортуйте товари з описами. Оберіть потрібні групи й переконайтеся, що експорт містить поля, які плануєте змінювати.
- Збережіть оригінал. Створіть робочу копію з датою в назві. Оригінальний файл не редагуйте.
- Зафіксуйте колонки. Перевірте назви заголовків, порядок аркушів і типи даних для ID та артикулів.
- Виберіть поля оновлення. Змінюйте лише назви, запити, описи або характеристики, які входять до поточного завдання.
- Обробіть рядки. Для кожного товару використовуйте його власні факти. Універсальними мають бути правила, а не словник готових фраз.
- Перевірте файл. Знайдіть порожні ID, дублікати, змішані мови, зламаний HTML, змінені числа та надмірно довгі значення.
- Імпортуйте малу партію. Спочатку оновіть 10 або 20 різних товарів і перегляньте результат у кабінеті.
- Масштабуйте після перевірки. Повний імпорт запускайте лише тоді, коли тестова партія зберегла структуру й коректно оновила потрібні поля.
Окрема офіційна інструкція Prom пояснює варіанти експорту товарів і груп. Перед кожним великим оновленням варто повторити експорт, щоб резервна копія відповідала поточному стану каталогу. Джерело: експорт товарів і груп Prom.ua.
Поля та технічні межі
Ліміти нижче взяті з чинної інструкції Prom для XLSX. Вони потрібні для валідації, а не як цільовий обсяг. Короткий точний опис може бути кориснішим за текст, розтягнутий до максимальної довжини.
| Поле | Межа або правило | Практична перевірка |
|---|---|---|
| Назва позиції | До 110 символів | Тип товару та важливі атрибути стоять на початку |
| Назва позиції укр. | До 130 символів | Українська версія не є сумішшю мов |
| Пошукові запити | До 1024 символів, слово до 50 | Немає повторів і непідтверджених властивостей |
| Опис | До 12 160 символів | HTML валідний, твердження походять з товарних даних |
| Український переклад | Назва й опис оновлюються разом | Обидва українські поля заповнені для оновлення перекладу |
| ID | Технічний ідентифікатор | Не змінений і не перетворений на число з округленням |
Точні назви колонок і обов'язковість полів залежать від типу операції. Перед імпортом звіряйте заголовки з файлом, який щойно експортував ваш кабінет Prom, а не зі старою локальною копією.
Чому таблиці ламаються під час редагування
Excel змінює тип даних
Артикул на кшталт 00125 може перетворитися на 125. Довгий цифровий ID іноді показується в науковому форматі. Перед збереженням перевірте, що службові значення залишилися текстом і збігаються з експортом посимвольно.
Формула підміняє значення
Формула може виглядати правильно в Excel, але імпортер очікує готове значення. Якщо обробка створює новий файл, доцільно записувати результати як значення й окремо перевіряти, що в потрібних колонках немає формул або помилок обчислення.
HTML пошкоджується
Незакритий тег або небезпечний фрагмент може зламати відображення опису. Мінімальна перевірка має видаляти скрипти, обробники подій і невідомі теги, а також підтверджувати, що текст після очищення не зник.
Мовні поля оновлюються неповністю
Prom вказує, що для оновлення українського перекладу потрібно передати і назву, і опис українською. Якщо змінити лише одне з цих полів, очікуваного оновлення може не статися. Перевіряйте мовну пару як єдиний контракт.
Як автоматизувати тисячі різних товарів
Масштабування не означає, що всі товари повинні отримати однакову конструкцію. Надійний пайплайн працює інакше:
- читає доступні поля конкретного рядка;
- визначає категорію та корисні атрибути;
- формує перелік дозволених фактів;
- створює назву, запити або опис лише з цих фактів;
- перевіряє числа, одиниці, мову, HTML і ризикові твердження;
- записує статус OK, WARN або ERROR замість тихого маскування проблеми.
Такі правила переносяться між магазинами й категоріями. Жорсткий список слів для «правильного опису» не переноситься, бо атрибути акумулятора, сукні та запчастини не збігаються.
Prom AI Optimizer накладає результат на вихідну структуру та не повинен змінювати технічні ідентифікатори. Опис робочого процесу зі скриншотами є в інструкції з пакетної обробки XLSX. Перед великим імпортом все одно потрібна тестова партія в конкретному кабінеті.
Перевірка перед імпортом
Поширені питання
Чи можна імпортувати тільки змінені товари?
Практично безпечніше сформувати окрему партію зі зміненими позиціями, якщо обраний режим імпорту й структура файлу це дозволяють.
Чи треба видаляти незмінені колонки?
Не видаляйте службові та обов'язкові колонки без перевірки вимог імпортера. Зберігайте структуру свіжого експорту.
Яку партію обрати для першого тесту?
Візьміть 10 або 20 різних товарів зі складними назвами, мовними полями, HTML та різними типами артикулів.