Elbuz сам розкладає Excel-файл каталогу Prom.ua, Satu.kz чи Deal.by по картках товарів і зберігає навіть ті колонки, яким у стандартній картці немає місця, — розмічати колонки вручну не потрібно.
Коли це знадобиться:
- Шукаєте, куди поділася колонка з файлу — таблиця показує, у яке поле картки вона лягла.
- Готуєте файл для Prom самі — тут формати й межі довжини полів.
- Наявність на вивантаженні не така, як у файлі — символ Prom рахується з поточного статусу товару.
- Ведете різновиди й групи на Prom — зв'язки зберігаються і вертаються на Prom вивантаженням.
З чого почати: таблиця «колонка файлу → поле картки».
Що зберігає імпорт файлу Prom
- Два аркуші файлу — товари й групи читаються за назвами колонок, порядок колонок не важливий.
- Основні поля картки — назва, ціна, залишок, категорія, опис, фото лягають у рідні поля.
- Формати значень — які довжини й коди приймає Prom.
- Наявність — символи Prom стають статусами, а на вивантаженні рахуються з поточного статусу.
- Додаткові поля — решта колонок Prom зберігається в картці повністю.
- Характеристики, різновиди й групи — переносяться в атрибути, поле різновидів і дерево категорій.
- Зворотний шлях — ті самі поля вивантажуються назад на Prom.
Де це і хто має доступ
- Меню
- Довідники → Операції → Завантаження даних → шаблон «XLSX - prom.ua, satu.kz, deal.by»
- Де видно результат
- картка товару, «Решта полів» → «Користувацькі поля»
- Право доступу
- вікно «Завантаження даних» у «Правах груп»
- Підготувати
- файл .xlsx, вивантажений із Prom
Як налаштувати шаблон і запустити завантаження — у статті перенесення каталогу з Prom.ua файлом XLSX.
Як Elbuz читає файл: два аркуші
Офіційний опис формату — у довідці Prom: Імпорт через Excel — формат файлів XLS(X) та CSV. Тут же ми пояснюємо, як той самий формат читає й зберігає саме Elbuz.
Excel-файл Prom (XLS/XLSX) містить два аркуші, і Elbuz читає їх за назвами:
- «Export Products Sheet» — товари. Кожен рядок, крім першого, — це один товар; перший рядок — заголовки колонок.
- «Export Groups Sheet» — групи (категорії): їхні номери, назви, ідентифікатори та зв'язок «батько–дитина».
У форматі CSV аркуш лише один (тільки товари), у кодуванні UTF-8 або UTF-16.
Перший рядок кожного аркуша — заголовки: Elbuz зіставляє їх із відомими назвами полів і так визначає, у якій колонці що лежить. Назви розпізнаються і російською, і українською (Код_товара = Код_товару, Название_позиции = Назва_позиції тощо), тож обидві мовні версії файлу читаються однаково.
Порядок колонок значення не має — важлива саме назва в заголовку; якщо якоїсь колонки немає, відповідне поле лишиться порожнім.
Із трьох форматів, які вміє віддавати Prom, Elbuz читає лише .xlsx. Поле вибору файлу пропускає тільки таке розширення, а на сервері файл додатково перевіряється на початок книги Open XML — старий .xls і .csv, перейменовані в .xlsx, теж не пройдуть.
Не той файл зупиняє прогін ще до розбору повідомленням «Файл не є книгою XLSX. Prom.ua, Satu.kz і Deal.by вивантажують каталог у форматі .xlsx — старий .xls не підтримується. Відкрийте файл в Excel і збережіть як «Книга Excel (.xlsx)».», і каталог при цьому не змінюється взагалі.
Куди потрапляють основні значення картки
Частина колонок лягає прямо в рідні поля картки товару — ті, що є в кожній картці Elbuz:
| Колонка файлу | Поле картки в Elbuz |
|---|---|
| Назва_позиції / Назва_позиції_укр | назва товару (українська версія — в українську мову картки) |
| Ціна + Валюта | ціна (переводиться у вашу базову валюту за курсом) |
| Кількість | залишок |
| Наявність | статус наявності (див. розділ про символи) |
| Номер_групи / Назва_групи / Ідентифікатор_групи | категорія товару (прив'язка до дерева з аркуша груп) |
| Виробник | виробник (нового виробника Elbuz сам додає в довідник) |
| Опис / Опис_укр | опис товару (укр. версія — в українську мову) |
| HTML_заголовок / HTML_опис / HTML_ключові_слова (+ _укр) | meta-title, meta-description, meta-keywords картки |
| Вага, Ширина, Висота, Глибина, Довжина | вагогабаритні поля картки |
| Код_маркування_(GTIN) | GTIN (штрихкод для Google Merchant) |
| Посилання_зображення | фото товару (кілька URL через кому+пробіл; перше — головне) |
Артикул (Код_товару) записується одразу у два поля картки — артикул і MPN.
Ціна перед збереженням приводиться до вашої базової валюти: якщо у файлі ціни в іншій валюті, Elbuz бере курс за кодом валюти й перераховує. Категорія товару зв'язується з деревом груп із аркуша «Export Groups Sheet», а якщо групи товару там немає — вона створюється автоматично з номера й назви, вказаних у самому рядку товару.
У Prom діє окреме правило: щоб оновилась українська версія товару, у файлі мають бути заповнені обидва українські поля — і Назва_позиції_укр, і Опис_укр. Якщо заповнити лише одне з них, переклад на боці Prom не оновиться.
Elbuz же приймає українські поля в українську мову картки як є — але тримайте це правило Prom у голові, коли готуєте файл для зворотного вивантаження.
Які формати й межі значень приймає Prom
У полів Prom є конкретні формати, і файл варто готувати з їх урахуванням — інакше майданчик відхилить рядок або обріже значення:
- Код_товару — до 25 символів (цифри, кирилиця, латиниця, знаки
- _ . /та пробіл). - Назва_позиції — до 110 символів (рос.), Назва_позиції_укр — до 130.
- Опис / Опис_укр — до 12160 символів; HTML_заголовок/опис — до 250 (рос.) / 270 (укр.).
- Ціна — число від 0.01; Валюта — код (UAH, USD, EUR, PLN, KZT…) або скорочення (грн, дол, $).
- Тип_товару — літера:
r— лише роздріб,w— лише опт,u— і опт, і роздріб,s— послуга. - Одиниця_виміру — зі списку Prom (шт., упаковка, комплект, пара, м, кг, л, набір…).
- Оптова_ціна та Мінімальне_замовлення_опт — кілька значень через
;; Подарунки/Супутні — номери рядків або ID через;. - Знижка — число або відсоток (наприклад,
12.5або30%) з датами дії «від/до».
Elbuz зберігає ці значення такими, як вони у файлі (у відповідні поля картки — див. нижче), а перевірку на відповідність вимогам Prom робить уже сам майданчик під час вивантаження. Тому чистий, коректний за форматом файл заощаджує час на обох кінцях.
Як переводиться наявність: символи Prom і формула зворотного зв'язку
Наявність у файлі Prom кодується символами, і Elbuz переводить їх у свої статуси наявності:
+(або!— «готово до відправки») → у наявності;-→ немає в наявності;&→ очікується;- цифра (наприклад,
7) → під замовлення (кількість днів на доставку); - порожнє поле або будь-яке інше значення (зокрема
@) → основний статус «у наявності» вашого каталогу.
Поле наявності працює у два боки. Разом із додатковим полем «Наличие_xls» Elbuz створює для нього формулу, яка рахує символ Prom не зі старого значення файлу, а з поточного статусу наявності товару у вашому каталозі:
- статус «в наявності» →
+; - «немає в наявності» →
-; - «очікування» →
&; - «передзамовлення» →
5; - статус, який ви завели самі, →
+, якщо кількість більша за нуль, інакше-.
Стандартні статуси формула впізнає за їхнім номером, тож перейменування статусу на неї не впливає. Тому коли ви вивантажуєте каталог назад на Prom, наявність завжди свіжа — така, яка зараз у вашій системі, а не застигла на моменті імпорту.
Куди лягають поля Prom, яких немає в картці
У Prom значно більше полів, ніж у стандартній картці товару. Щоб нічого з файлу не втратити, Elbuz під час імпорту сам створює в базовому каталозі відповідні додаткові поля й записує туди ці значення.
Тобто картка не «обрізає» файл Prom до кількох стандартних полів — вона зберігає його вміст повністю. Ось основні групи таких полів, що з'являються в картці після першого імпорту:
- Ціни й замовлення: Оптова_ціна, Мінімальний_обсяг_замовлення, Мінімальне_замовлення_опт, Ціна_від, Знижка, Термін_дії_знижки_від/до.
- Логістика й пакування: Можливість_постачання, Термін_поставки, Спосіб_пакування (+ укр.), Одиниця_виміру, Де_знаходиться_товар, Країна_виробник. Гарантійний_термін окремого поля не отримує — він записується у стандартне поле гарантії картки.
- Класифікація Prom: Тип_товару, Ярлик, Номер_групи, Назва_групи, Ідентифікатор_підрозділу, Ідентифікатор_групи, ID_групи_різновидів, Номер_пристрою_(MPN).
- Контент і SEO: Ключові_слова, Пошукові_запити, Особисті_нотатки та українські версії назви, опису й meta-полів.
- Зв'язки й службове: Подарунки, Супутні (та їхні ID), Товар_на_видалення й Причина_видалення, Унікальний_ідентифікатор (окреме індексоване поле під внутрішній номер Prom).
У картці ці поля мають назви російської версії файлу Prom: «Оптовая_цена», «Тип_товара», «Уникальный_идентификатор», а знижка — «Скидка_xls». Їх видно поряд зі стандартними, і з ними можна працювати як зі звичайними: фільтрувати, показувати в сітці, використовувати у формулах і — головне — вивантажувати назад.
1
Уникальный_идентификатор — внутрішній номер товару Prom2
Оптовая_цена — одне з десятків полів фіда Prom- Уникальный_идентификатор — внутрішній номер товару в системі Prom, приходить із фіда без змін.
- Оптовая_цена — одне з десятків користувацьких полів, яке фід Prom.ua додає до картки товару.
Як завантажуються характеристики
Характеристики товару Prom тримає в трійках колонок, які завжди йдуть у строгому порядку: Назва_Характеристики, Одиниця_виміру_Характеристики, Значення_Характеристики. Таких трійок у файлі може бути багато — по одній на кожну характеристику, і колонка одиниці виміру має бути присутня, навіть якщо порожня. Множинні значення однієї характеристики розділяють символом | (наприклад, Алюміній | Пластик).
Elbuz розпізнає ці трійки за заголовком і переносить у атрибути товару: назва стає атрибутом, значення — його значенням, а одиниця виміру (см, кг, Вт…) автоматично додається у довідник одиниць, якщо її там ще немає.
Характеристики завантажуються разом з рештою даних файлу автоматично — окремо вмикати їх не треба. Якщо ж у товарі атрибутів немає, значить у файлі не було відповідних трійок колонок або їх не вдалося розпізнати за заголовком.
Як зберігаються різновиди (варіанти) товару
Prom позначає варіанти одного товару (кольори, розміри тощо) через поле ID_групи_різновидів: усі рядки з однаковим значенням цього поля й заповненими характеристиками вважаються різновидами одного товару, а перший рядок у групі — основним.
Elbuz зберігає це поле, тож зв'язок різновидів не губиться при зворотному вивантаженні. Якщо ви ведете варіанти на Prom, тримайте ID_групи_різновидів у файлі заповненим — саме воно тримає різновиди разом.
Як аркуш груп стає деревом категорій
Дерево категорій Elbuz будує з аркуша груп.
- Кожна група має Номер_групи (номер на сайті Prom), Назву (та її укр. версію), Ідентифікатор_групи (зовнішній ID — наприклад, номер групи у вашій CRM), а вкладеність задається полями Номер_батьківської_групи та Ідентифікатор_батьківської_групи (для кореневих груп вони порожні).
- Є й SEO-поля групи та описи «до» і «після» списку товарів.
- Групи зіставляються насамперед за ідентифікатором, а якщо його немає — за номером; нові створюються, наявні оновлюються.
- Якщо товар посилається на групу, якої немає на аркуші груп, Elbuz створить її з даних самого рядка товару, щоб позиція не лишилась «безхатньою».
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Як ці поля повертаються на Prom
Формат Prom влаштований так, що файл імпорту й файл експорту — однакові. Тому поля, у які імпорт записав дані, — це ті самі поля, з яких дані потім вивантажуються назад на Prom. Зокрема, наш UUID товару на вивантаженні лягає назад у колонку Ідентифікатор_товару, а додаткове поле «Унікальний_ідентифікатор» — у однойменну колонку.
Товар, створений у Elbuz, іде у файл вивантаження з власним UUID у колонці Ідентифікатор_товару і з порожнім Унікальним_ідентифікатором — Prom додасть його як новий, а наявні оновить. Повний порядок обміну: вивантаження на Prom (XLSX).
UUID товару (він же Ідентифікатор_товару на Prom) і «Унікальний_ідентифікатор» — це ключі синхронізації. Якщо змінити UUID наявного товару, Prom при наступному вивантаженні визнає його новим і задвоїть позицію. Тому ці поля не редагують вручну — імпорт та експорт керують ними самі.
Не видаляйте автоматично створені поля Prom, навіть якщо якесь із них вам зараз не потрібне. Саме вони забезпечують зворотне вивантаження без втрат: якщо поле прибрати, відповідна колонка на вивантаженні на Prom поїде порожньою.
Часті запитання
Чи можна завантажити старий .xls або CSV з Prom?
Ні, шаблон приймає лише .xlsx. Відкрийте файл в Excel і збережіть як «Книга Excel (.xlsx)». Каталог від невдалої спроби не змінюється. Детальніше: як Elbuz читає файл.
Чому на Prom не оновилась українська назва чи опис товару?
У Prom українська версія оновлюється, лише якщо у файлі заповнені обидва українські поля — і Назва_позиції_укр, і Опис_укр. Заповнене одне з них Prom проігнорує. Детальніше: основні значення картки.
Чому наявність на вивантаженні не збігається з тим, що було у файлі?
Бо символ наявності рахується формулою з поточного статусу товару у вашому каталозі, а не береться з файлу «як є». На Prom іде актуальна наявність. Детальніше: як переводиться наявність.
Чому не завантажились характеристики?
У файлі не було трійок колонок «Назва / Одиниця_виміру / Значення характеристики» або їх не розпізнано за заголовком — колонки мають іти саме в цьому порядку. Окремо вмикати характеристики не треба. Детальніше: характеристики.
Чому додаткові поля в картці названі російською?
Elbuz заводить їх під назвами російської версії файлу Prom — «Оптовая_цена», «Тип_товара», «Уникальный_идентификатор» — незалежно від мови вашого файлу. Значення в них лягають ті самі. Детальніше: поля Prom, яких немає в картці.
Суміжні теми
- Якщо потрібна загальна картина — як перенести й регулярно оновлювати каталог із Prom: імпорт каталогу з Prom.ua файлом XLSX.
- Якщо повторне завантаження зробило дублі — як програма впізнає товар.
- Якщо каталог треба повернути на Prom — вивантаження на Prom.ua (XLSX).
- Якщо майданчик віддає каталог у XML — імпорт каталогу з XML / YML.