Універсальний імпорт товарів до Elbuz: завантаження каталогу з XML, CSV та Excel — без програмістів та ручного введення

Яку головну проблему це вирішує

Кожен постачальник і маркетплейс мають свій формат вивантаження. Один надсилає <name>, інший <model>, третій взагалі таблицю Excel з колонками українською. Звичайні імпортери вимагають, щоб файл був «правильним» — і якщо він не підійшов, ви залишаєтеся віч-на-віч із тисячами рядків.

Універсальний імпорт Elbuz перевертає правило: не ви підганяєте файл під систему, а система підлаштовується під ваш файл. Ви один раз показуєте, де що лежить («ось тут назва, тут ціна, тут штрихкод») і зберігаєте це як шаблон. Далі кожне оновлення прайсу – це один клік.

Що вміє універсальний імпорт

Це не просто «завантажувач прайсів». Це повноцінний інструмент заповнення каталогу, який вирішує реальні болі:

• Читає три сімейства форматів: XML та YML (вивантаження маркетплейсів, постачальників, 1С), CSV (текстові таблиці з будь-яким роздільником) та Excel - XLS/XLSX.
• Завантажує не тільки товари, а й все «обваження»: категорії з деревом вкладеності, характеристики, об'єднані в групи, фотографії, теги, ціни, залишки, виробників, штрих-коди та артикули.
• Будує дерево категорій автоматично — за тими самими зв'язками, що й у файлі постачальника, зберігаючи «батька → підкатегорія».
• Групує характеристики у блоки («Габарити та вага», «Основна інформація») та проставляє одиниці виміру (мм, кг, г) — каталог виглядає акуратно відразу.
• Оновлює вже завантажені товари, а не плодить дублі: знаходить «свій» товар за артикулом або зовнішнім кодом та оновлює його.
• Вміє перетворювати значення на льоту - Наприклад, перетворити available="true" кількість на складі.
• Підказує структуру файлу: кнопка "Аналізувати файл" читає ваш файл і показує, які в ньому є теги та стовпчики.
• Працює з файлом та за посиланням (URL): можна завантажити файл із комп'ютера або вказати посилання на розвантаження постачальника — зручно для регулярних оновлень.
• Тягне великі обсяги: сотні тисяч позицій обробляються пакетами на швидкому "движку", а важкий перерахунок виконується один раз наприкінці - без зависань.

Чому це краще за звичайних імпортерів

• Гнучкість без програміста. Більшість систем мають жорсткий формат: «завантаж строго за зразком». Тут ви налаштовуєте відповідність полів мишкою у візуальній формі – під будь-який файл.
• Готові пресети. Для типових випадків (стандартний YML, базовий CSV) налаштування вже зроблено за вас – вибрали зі списку та поїхали.
• Два рівні складності. Новачок працює у простій візуальній формі. Досвідчений користувач може відкрити вкладку JSON та налаштувати тонкі деталі.
• Один шаблон – багаторазове використання. Налаштували постачальника один раз — далі оновлюєте прайс в один клік, хоч щодня.
• Чесна робота з поновленнями. Система не засмічує каталог дублями: повторне завантаження оновлює наявні картки.

Що ви отримаєте після налаштування

• Повністю заповнений каталог: товари, категорії, характеристики, фото та ціни на своїх місцях.
• Економію десятків годин ручної роботи на кожному оновленні прайсу.
• Можливість підключення нових постачальників за хвилини, а не за дні.
• Акуратний, структурований каталог, готовий до розвантаження на маркетплейси та у ваш магазин.
• Спокій: оновлення більше не ламають дані та не плодять дублі.

Кому підійде

• Інтернет-магазинам, які одержують прайси від десятків постачальників у різних форматах.
• Дропшипперам та маркетплейс-селерам, яким потрібно швидко заливати та оновлювати тисячі позицій.
• Оптовикам та дистриб'юторам з великими каталогами та регулярними оновленнями залишків.
• Контент-менеджерам, що втомився від ручного копіювання з Excel.
• Усім, хто має файл із товарами і бажання завантажити його швидко та без болю.

Як це працює: загальна логіка за одну хвилину

Перш ніж перейти до кроків, зрозуміємо головну ідею — все стане очевидним.

1. Є файл - Прайс або вивантаження (XML, CSV або Excel).
2. Є «карта відповідності» (мапінг) — налаштування, яке говорить системі: «поле Назва бери з тега name, Ціну - з price »і так далі.
3. Система проходить по файлу і для кожного товару бере значення по цій карті, попутно створюючи категорії, характеристики та підвантажуючи фото.
4. Готовий каталог зберігається в Elbuz.

Головне: формат файлу (XML/CSV/Excel) задається всередині налаштування, а чи не вгадується з розширення. Один шаблон = один формат + одна картка відповідності. Налаштували постачальника - користуєтеся скільки завгодно разів.

Крок 1. Відкрийте вікно налаштування імпорту

Перейдіть до розділу імпорту даних та створіть (або відкрийте) шаблон «Універсальний імпорт (XML/CSV/XLS)». Відкриється вікно з налаштуванням. У ньому три смислові зони:

• Верх: вибір формату, вибір готового пресета та налаштування джерела.
• Середина: дві вкладки - «Відповідність полів» (проста візуальна форма) та "JSON (розширено)" (Для тонкої настройки).
• Низ: блок завантаження — файл із комп'ютера або посилання (URL), кнопки «Аналізувати файл» та «Імпортувати».

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

Крок 2. Виберіть готовий пресет (найшвидший старт)

Якщо ваш типовий файл — не налаштовуйте нічого вручну. У списку, що випадає «Пресет» вже є готові конфігурації:

Вибрали пресет → форма заповнилася автоматично → за потреби поправили пару полів під свій файл. Готово.

Крок 3. Вкажіть формат та налаштування джерела

Зверху виберіть формат файлу. Від нього залежать налаштування джерела:

Для XML/YML

• Вузол товару - Тег, який повторюється для кожного товару. У YML це зазвичай offer. Система «проходить» усім таким вузлам і з кожного бере один товар.

Для CSV

• Розділювач - Символ між колонками: найчастіше ; або ,.
• Перший рядок - заголовки — увімкніть, якщо в першому рядку назви колонок («Назва», «Ціна»…). Тоді в налаштуванні можна посилатися на колонки на ім'я, а не за номером.

Для Excel (XLS/XLSX)

• Аркуш - Номер листа книги (нумерація з 0: перший лист - це 0).
• Перший рядок - заголовки так само, як для CSV.

Крок 4. Аналізуйте файл – нехай система підкаже

Це найзручніший прийом для новачка. Виберіть файл внизу вікна та натисніть "Аналізувати файл". Система прочитає початок файлу та покаже, які в ньому є теги, атрибути та стовпчики. Далі вам не потрібно нічого вгадувати – ви просто вибираєте підказані значення у полях форми.

Аналіз нічого не завантажує і не змінює - він лише "оглядає" файл. Робіть його скільки завгодно разів.

Крок 5. Налаштуйте відповідність полів товару

На вкладці «Відповідність полів» у блоці «Поля товару» ви порівнюєте поле системи з джерелом у файлі. Зліва поле у системі, праворуч звідки брати.

Доступні поля товару, які можна заповнити:

• Назва, Опис
• Артикул, Артикул виробника (MPN), Штрихкод (EAN), Модель
• Ціна, Стара ціна, Кількість (залишок)
• Виробник
• Категорія (шлях) і ID категорії
• Посилання (джерело), Гарантія
• і додаткові поля вашого каталогу

Як писати «джерело» - прості правила

Для XML у полі «Джерело» використовуються короткі позначення. Їх легко запам'ятати:

Для 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 - Взяти текст (вміст) самого тега. Наприклад, з 100 запис $text візьме "100".
@ім'я - Взяти значення атрибута тега, а не його текст. Наприклад, у … запис @name дасть "Колір".
ім'я тега Просто ім'я тега (наприклад name, price) взяти значення цього тега всередині товару. Це найчастіший випадок.
тег/тег - Шлях до вкладеного тегу через косу межу. Наприклад, dimensions/width візьме всередині . Можна до атрибуту: url/@href.
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 — ваш каталог наповнюється сам, доки ви займаєтеся продажем.