Універсальний імпорт товарів до Elbuz: завантаження каталогу з XML, CSV та Excel — без програмістів та ручного введення
Чи отримали від постачальника прайс на 50 000 товарів у незрозумілому форматі? Завантажили вивантаження з маркетплейсу у XML? Ведете склад Excel? Раніше це означало тижні ручного копіювання або дорогого програміста. Тепер – п'ять хвилин налаштування та одна кнопка. Універсальний імпорт каталогу Elbuz читає будь-який файл - XML (YML), CSV або Excel - і сам розкладає товари, категорії, характеристики, фотографії та ціни на місця.
Ви завантажуєте файл "як є" - система підлаштовується під нього, а не навпаки.
Яку головну проблему це вирішує
Кожен постачальник і маркетплейс мають свій формат вивантаження. Один надсилає <name>, інший <model>, третій взагалі таблицю Excel з колонками українською. Звичайні імпортери вимагають, щоб файл був «правильним» — і якщо він не підійшов, ви залишаєтеся віч-на-віч із тисячами рядків.
Універсальний імпорт Elbuz перевертає правило: не ви підганяєте файл під систему, а система підлаштовується під ваш файл. Ви один раз показуєте, де що лежить («ось тут назва, тут ціна, тут штрихкод») і зберігаєте це як шаблон. Далі кожне оновлення прайсу – це один клік.
Що вміє універсальний імпорт
Це не просто «завантажувач прайсів». Це повноцінний інструмент заповнення каталогу, який вирішує реальні болі:
- Читає три сімейства форматів: XML та YML (вивантаження маркетплейсів, постачальників, 1С), CSV (текстові таблиці з будь-яким роздільником) та Excel - XLS/XLSX.
- Завантажує не тільки товари, а й все «обваження»: категорії з деревом вкладеності, характеристики, об'єднані в групи, фотографії, теги, ціни, залишки, виробників, штрих-коди та артикули.
- Будує дерево категорій автоматично — за тими самими зв'язками, що й у файлі постачальника, зберігаючи «батька → підкатегорія».
- Групує характеристики у блоки («Габарити та вага», «Основна інформація») та проставляє одиниці виміру (мм, кг, г) — каталог виглядає акуратно відразу.
- Оновлює вже завантажені товари, а не плодить дублі: знаходить «свій» товар за артикулом або зовнішнім кодом та оновлює його.
- Вміє перетворювати значення на льоту - Наприклад, перетворити
available="true"кількість на складі. - Підказує структуру файлу: кнопка "Аналізувати файл" читає ваш файл і показує, які в ньому є теги та стовпчики.
- Працює з файлом та за посиланням (URL): можна завантажити файл із комп'ютера або вказати посилання на розвантаження постачальника — зручно для регулярних оновлень.
- Тягне великі обсяги: сотні тисяч позицій обробляються пакетами на швидкому "движку", а важкий перерахунок виконується один раз наприкінці - без зависань.
Чому це краще за звичайних імпортерів
- Гнучкість без програміста. Більшість систем мають жорсткий формат: «завантаж строго за зразком». Тут ви налаштовуєте відповідність полів мишкою у візуальній формі – під будь-який файл.
- Готові пресети. Для типових випадків (стандартний YML, базовий CSV) налаштування вже зроблено за вас – вибрали зі списку та поїхали.
- Два рівні складності. Новачок працює у простій візуальній формі. Досвідчений користувач може відкрити вкладку JSON та налаштувати тонкі деталі.
- Один шаблон – багаторазове використання. Налаштували постачальника один раз — далі оновлюєте прайс в один клік, хоч щодня.
- Чесна робота з поновленнями. Система не засмічує каталог дублями: повторне завантаження оновлює наявні картки.
Що ви отримаєте після налаштування
- Повністю заповнений каталог: товари, категорії, характеристики, фото та ціни на своїх місцях.
- Економію десятків годин ручної роботи на кожному оновленні прайсу.
- Можливість підключення нових постачальників за хвилини, а не за дні.
- Акуратний, структурований каталог, готовий до розвантаження на маркетплейси та у ваш магазин.
- Спокій: оновлення більше не ламають дані та не плодять дублі.
Кому підійде
- Інтернет-магазинам, які одержують прайси від десятків постачальників у різних форматах.
- Дропшипперам та маркетплейс-селерам, яким потрібно швидко заливати та оновлювати тисячі позицій.
- Оптовикам та дистриб'юторам з великими каталогами та регулярними оновленнями залишків.
- Контент-менеджерам, що втомився від ручного копіювання з Excel.
- Усім, хто має файл із товарами і бажання завантажити його швидко та без болю.
Як це працює: загальна логіка за одну хвилину
Перш ніж перейти до кроків, зрозуміємо головну ідею — все стане очевидним.
- Є файл - Прайс або вивантаження (XML, CSV або Excel).
- Є «карта відповідності» (мапінг) — налаштування, яке говорить системі: «поле Назва бери з тега
name, Ціну - зprice»і так далі. - Система проходить по файлу і для кожного товару бере значення по цій карті, попутно створюючи категорії, характеристики та підвантажуючи фото.
- Готовий каталог зберігається в Elbuz.
Головне: формат файлу (XML/CSV/Excel) задається всередині налаштування, а чи не вгадується з розширення. Один шаблон = один формат + одна картка відповідності. Налаштували постачальника - користуєтеся скільки завгодно разів.
Крок 1. Відкрийте вікно налаштування імпорту
Перейдіть до розділу імпорту даних та створіть (або відкрийте) шаблон «Універсальний імпорт (XML/CSV/XLS)». Відкриється вікно з налаштуванням. У ньому три смислові зони:
- Верх: вибір формату, вибір готового пресета та налаштування джерела.
- Середина: дві вкладки - «Відповідність полів» (проста візуальна форма) та "JSON (розширено)" (Для тонкої настройки).
- Низ: блок завантаження — файл із комп'ютера або посилання (URL), кнопки «Аналізувати файл» та «Імпортувати».
Порада: у самому низу вікна є відкритий довідковий блок із розшифровкою всіх позначень. Він завжди під рукою — підглядайте туди, коли вагаєтесь.
Крок 2. Виберіть готовий пресет (найшвидший старт)
Якщо ваш типовий файл — не налаштовуйте нічого вручну. У списку, що випадає «Пресет» вже є готові конфігурації:
| Пресет | Для чого | Що завантажує |
|---|---|---|
| YML стандарт | Класичні YML/XML-розвантаження маркетплейсів та постачальників | Назва, ціна, виробник, артикул, опис, дерево категорій, характеристики, фото |
| CSV базовий | Текстові таблиці з роздільником ";" | Назва, артикул, ціна, штрих-код, виробник, категорія, характеристики по колонках, фото і теги через кому |
| Demo (XML, групи/одиниці) | Просунутий приклад з групами характеристик та одиницями виміру | Все перераховане + блоки характеристик, одиниці виміру, зовнішній код товару, залишок |
Вибрали пресет → форма заповнилася автоматично → за потреби поправили пару полів під свій файл. Готово.
Крок 3. Вкажіть формат та налаштування джерела
Зверху виберіть формат файлу. Від нього залежать налаштування джерела:
Для XML/YML
- Вузол товару - Тег, який повторюється для кожного товару. У YML це зазвичай
offer. Система «проходить» усім таким вузлам і з кожного бере один товар.
Для CSV
- Розділювач - Символ між колонками: найчастіше
;або,. - Перший рядок - заголовки — увімкніть, якщо в першому рядку назви колонок («Назва», «Ціна»…). Тоді в налаштуванні можна посилатися на колонки на ім'я, а не за номером.
Для Excel (XLS/XLSX)
- Аркуш - Номер листа книги (нумерація з 0: перший лист - це 0).
- Перший рядок - заголовки так само, як для CSV.
Крок 4. Аналізуйте файл – нехай система підкаже
Це найзручніший прийом для новачка. Виберіть файл внизу вікна та натисніть "Аналізувати файл". Система прочитає початок файлу та покаже, які в ньому є теги, атрибути та стовпчики. Далі вам не потрібно нічого вгадувати – ви просто вибираєте підказані значення у полях форми.
Аналіз нічого не завантажує і не змінює - він лише "оглядає" файл. Робіть його скільки завгодно разів.
Крок 5. Налаштуйте відповідність полів товару
На вкладці «Відповідність полів» у блоці «Поля товару» ви порівнюєте поле системи з джерелом у файлі. Зліва поле у системі, праворуч звідки брати.
Доступні поля товару, які можна заповнити:
- Назва, Опис
- Артикул, Артикул виробника (MPN), Штрихкод (EAN), Модель
- Ціна, Стара ціна, Кількість (залишок)
- Виробник
- Категорія (шлях) і ID категорії
- Посилання (джерело), Гарантія
- і додаткові поля вашого каталогу
Як писати «джерело» - прості правила
Для XML у полі «Джерело» використовуються короткі позначення. Їх легко запам'ятати:
| Запис | Що означає | приклад |
|---|---|---|
| ім'я тега | Взяти значення цього тега всередині товару (найчастіший випадок) | name, price |
$text | Взяти текст самого тега | з <price> 100</price> отримаємо «100» |
@ім'я | Взяти значення атрибута тега, а чи не його текст | @id у <offer id="51103"> дасть «51103» |
| тег/тег | Шлях до вкладеного тегу через косу межу | dimensions/width, можна і до атрибуту: url/@href |
Для CSV і Excel у «Джерелі» вказується номер колонки (1, 2, 3…) або назва колонки із заголовка, якщо увімкнено опцію «Перший рядок — заголовки».
Крок 6. Підтягніть категорії
Категорії завантажуються по-різному, залежно від формату.
У XML/YML – ціле дерево категорій
Якщо файл має окремий блок категорій (зазвичай <categories> з тегами <category> ), система збудує з нього повне дерево. Заповніть у блоці «Категорії»:
- Вузол категорії - Тег категорії (наприклад
category). - ID - Ідентифікатор категорії (наприклад
@id). - ID батька - щоб побудувати вкладеність (наприклад
@parentId). - Назва - Наприклад
$text. - Посилання у товарі - тег усередині товару, що вказує на категорію (у YML це
categoryId).
Зв'язок іде за ID, як у файлі — тому зберігається вся ієрархія «батько → підкатегорія» та точне прив'язування товарів.
У CSV/Excel – категорія одним полем
Тут категорія задається звичайним полем «Категорія (шлях)» у списку полів товару. Наприклад, в осередку може бути повний шлях «Електроніка/Камери/Аксесуари».
Крок 7. Налаштуйте характеристики (атрибути)
Це одна з найсильніших можливостей: завантажити десятки характеристик, розкласти їх за групами та проставити одиниці виміру.
У XML/YML — повторюваний вузол
Характеристики зазвичай йдуть списком однакових тегів усередині товару (наприклад, багато <param> ). Вкажіть у блоці «Характеристики»:
- Вузол, що повторюється - тег характеристики (наприклад
param). - Назва - Звідки брати ім'я характеристики (часто
@name). - Значення - Її значення (часто
$text). - Одиниця - одиниця виміру (наприклад
@unit): мм, кг, г підставляються автоматично.
Якщо файл підтримує групи характеристик (наприклад блоки «Габарити та вага», «Основна інформація»), можна додатково вказати назву групи, її ID та порядок – тоді характеристики красиво згрупуються у картці товару.
Приклад із реального файлу:<param name="Длина" unit="мм" group="Габариты и вес"> 190</param> перетвориться на характеристику «Довжина = 190 мм» у групі «Габарити та вага».У CSV/Excel – характеристики по колонках
Тут кожна характеристика це окрема колонка. Просто перерахуйте потрібні колонки (наприклад "Колір", "Розмір", "Матеріал") - система створить з них характеристики, де ім'я характеристики = назва колонки, а значення = вміст комірки.
Крок 8. Фото та теги
Фотографії
- У XML/YML: вкажіть повторюваний тег фото (наприклад
picture) - Система завантажить всі фото товару відразу, в порядку їхнього прямування. - У CSV/Excel: вкажіть колонку з фото та роздільник значень (якщо в одному осередку кілька посилань через кому).
Теги
- У XML/YML: повторюваний тег (можна по дорозі, наприклад
Tags/Tag). - У CSV/Excel: колонка з тегами та роздільник.
Крок 9. Запустіть імпорт
Внизу вікна виберіть джерело даних та натисніть кнопку завантаження:
- Файл із комп'ютера — Виберіть файл та натисніть «Імпортувати».
- За посиланням (URL) — Вставте посилання на розвантаження постачальника. Це зручно для регулярних оновлень: посилання залишається у шаблоні, і кожен наступний імпорт бере нові дані.
Система покаже хід роботи: читання файлу, скільки товарів збережено, і наприкінці – «Імпорт завершено». На великих каталогах наприкінці ви побачите етап «Фінальна обробка каталогу» — це нормальний, прискорений перерахунок цін, сортування та індексу, який виконується один раз для всього набору.
Не закривайте вікно до повідомлення «Імпорт завершено».
Тонкі можливості для просунутих
Перетворення значень: map та default
Іноді у файлі значення потрібно «перекласти» на те, що розуміє система. Класичний приклад – наявність: у файлі написано available="true", а каталозі потрібно число (залишок складі).
Для цього у будь-якого поля можна задати:
- map - Словник замін (порівняння без урахування регістру): одне значення підміняється іншим.
- default — значення за промовчанням, якщо результат виявився порожнім.
Приклад налаштування поля «Кількість»:
{ "from": "@available", "map":{ "true": "100", "false": "0" }, "default": "0" } Тут true перетвориться на залишок 100, false — 0. Це працює для будь-якого поля: статуси, «так/ні», коди наявності.
Зовнішній код товару - ключ для коректних оновлень
Якщо файл має унікальний ідентифікатор товару у постачальника (наприклад @id ), зіставте його з полем «Зовнішній код». Тоді при повторних завантаженнях система надійно знаходитиме «свій» товар і оновлюватиме саме його, а не створюватиме дубль.
Вкладка JSON – повний контроль
Все, що ви налаштовуєте у візуальній формі, можна побачити та відредагувати як єдиний текст налаштування на вкладці "JSON (розширено)". Це зручно, щоб скопіювати готове налаштування, перенести його між шаблонами або встановити рідкісні параметри, яких немає у формі. Після редагування натисніть «Застосувати до форми».
Збереження налаштувань як шаблону
Кнопка «Зберегти налаштування» запам'ятовує вашу карту відповідності у шаблоні. Налаштували постачальника один раз — просто завантажуєте новий файл цією ж кнопкою.
Рекомендації щодо оптимального настроювання
- Починайте з пресету. Навіть якщо він не ідеальний, виправити пару полів швидше, ніж налаштовувати з нуля.
- Завжди натисніть "Аналізувати файл". Це прибирає здогадки: ви вибираєте реальні теги та стовпчики з вашого файлу.
- Обов'язково налаштуйте унікальний ключ (артикул виробника, штрих-код або зовнішній код) - це страховка від дублів при оновленнях.
- Перевірте на маленькому файлі. Перед заливкою 100 000 позицій проженіть 5–10 рядків і переконайтеся, що все стало на місця.
- Для регулярних постачальників використовуйте імпорт URL - Оновлення прайсу стане справою одного кліку.
- Групуйте характеристики якщо файл це дозволяє - каталог буде виглядати професійно.
Часті запитання
Файл не завантажився – що робити?
Перевірте, чи вибрано правильний формат (XML/CSV/Excel) і вірно вказано вузол товару (для XML) або роздільник (для CSV). Натисніть "Аналізувати файл" - якщо система не бачить товари, швидше за все неправильно заданий вузол товару або роздільник.
Завантажилися дублі товарів
Значить, не налаштований унікальний ключ. Зіставте артикул виробника, штрих-код або зовнішній код - і повторне завантаження буде оновлювати картки, а не створювати нові.
Характеристики не розклалися за групами
Групи працюють тільки якщо вони є в самому файлі. Переконайтеся, що у вивантаженні характеристик зазначена група, і зіставте поля групи в блоці «Характеристики».
Великий каталог – чи не зависне система?
Ні. Імпорт обробляє товари пакетами, а найважчий перерахунок виконується один раз наприкінці. Сотні тисяч позицій – штатний режим роботи.
Довідка: що означають налаштування та як їх заповнювати
Форма зіставляє поля файлу з полями системи. Для стандартного YML-файлу все вже налаштовано за промовчанням – достатньо завантажити файл. Змінювати настройки потрібно лише, якщо ваш файл відрізняється від стандартного. Нижче розшифровка спеціальних позначень простими словами.
$text - Взяти текст (вміст) самого тега. Наприклад, з
@ім'я - Взяти значення атрибута тега, а не його текст. Наприклад, у … запис @name дасть "Колір".
ім'я тега Просто ім'я тега (наприклад name, price) взяти значення цього тега всередині товару. Це найчастіший випадок.
тег/тег - Шлях до вкладеного тегу через косу межу. Наприклад, dimensions/width візьме
repeat Вузол, що повторюється - тег, який зустрічається всередині товару кілька разів: характеристики (param), картинки (picture), теги. Система обробить кожне повторення окремо - так завантажуються всі характеристики та всі фото відразу.
Вузол товару - Тег, який повторюється для кожного товару у файлі. У YML це зазвичай offer. Імпорт «проходить» усім таким вузлам і з кожного бере один товар.
Характеристики: "Назва" - звідки взяти ім'я характеристики (часто @name), "Значення" - її значення (часто $text), "Одиниця" - одиниця виміру (наприклад @unit).
Зовнішні ідентифікатори характеристик (необов'язково, але рекомендується): attribute_uuid_ext – зовнішній ID характеристики у постачальника, attribute_block_uuid_ext – зовнішній ID групи. За ними система знаходить характеристику і групу навіть якщо постачальник їх перейменував — і не створює дублів. attribute_code - службовий код характеристики (зберігається для довідки). Зіставлення: спочатку за зовнішнім ID, за відсутності - за назвою.
Оновити у існуючих характеристик (прапорці під характеристиками) режим синхронізації. За замовчуванням імпорт вже існуючих характеристик змінює тільки значення у товарів, а самі картки характеристик не чіпає. Увімкніть прапорці, щоб оновлюватися з файлу: назва характеристики, назва групи, прив'язка до групи, одиниця вимірювання. Корисно для синхронізації довідника із джерелом; тримайте вимкненим, якщо ваші назви «чистіші», ніж у постачальника.
Категорії зв'язуються за ID, як у файлі: "ID" - ідентифікатор категорії, "ID батька" - для побудови дерева, "Посилання в товарі" - тег усередині товару, що вказує категорію (у YML це categoryId). Так зберігається вся ієрархія та прив'язка товарів до категорій.
Для CSV/XLS у полі «Джерело» вказується номер колонки (1, 2, 3…) або назва колонки із заголовка, якщо увімкнено опцію «Перший рядок — заголовки».
split Роздільник значень — символ, яким в одному осередку/тегу перераховано кілька значень (наприклад, кілька фото або тегів через кому).
map / default — заміна значень та значення за промовчанням. map замінює одні значення іншими (порівняння без урахування регістру), default підставляється, якщо результат порожній. Приклад наявності: {"from":"@available","map":{"true":"100","false":"0"},"default":"0"} - "true" перетвориться на кількість 100, "false" - в 0.
Готові навести лад у каталозі?
Більше ніякого ручного копіювання з Excel, жодних тижнів очікування програміста та жодних дублів після оновлення прайсу. Один файл, п'ять хвилин налаштування і весь каталог в Elbuz.
Відкрийте розділ імпорту, виберіть відповідний пресет і завантажте свій перший файл прямо зараз. Ви здивуєтеся, як швидко.
Універсальний імпорт Elbuz — ваш каталог наповнюється сам, доки ви займаєтеся продажем.
- Яку головну проблему це вирішує
- Що вміє універсальний імпорт
- Чому це краще за звичайних імпортерів
- Що ви отримаєте після налаштування
- Кому підійде
- Як це працює: загальна логіка за одну хвилину
- Крок 1. Відкрийте вікно налаштування імпорту
- Крок 2. Виберіть готовий пресет (найшвидший старт)
- Крок 3. Вкажіть формат та налаштування джерела
- Крок 4. Аналізуйте файл – нехай система підкаже
- Крок 5. Налаштуйте відповідність полів товару
- Крок 6. Підтягніть категорії
- Крок 7. Налаштуйте характеристики (атрибути)
- Крок 8. Фото та теги
- Крок 9. Запустіть імпорт
- Тонкі можливості для просунутих
- Рекомендації щодо оптимального настроювання
- Часті запитання
- Довідка: що означають налаштування та як їх заповнювати
- Готові навести лад у каталозі?

