Базовий каталог — це фундамент Elbuz: навколо нього будується вся автоматизація цін, наявності й вивантаження. Перш ніж щось автоматизувати, товари треба в програму завантажити. Саме для цього є окреме вікно — «Імпорт категорій, товарів, виробників у базовий каталог».
Не плутайте з завантаженням прайсів постачальників. Прайс постачальника — це джерело для порівняння й дропшипінгу, він живе в окремому розділі. Тут ідеться про наповнення вашого базового каталогу: перенести існуючий асортимент, завантажити його з файлу чи підтягнути з майданчика, де ви вже продаєте.
Де це у програмі
Вікно імпорту працює через шаблони. Шаблон — це збережене налаштування одного завантаження: звідки брати дані, у якому форматі, за якими правилами й що саме тягнути. Ви створюєте шаблон, обираєте тип джерела, налаштовуєте його один раз — і далі запускаєте вручну або ставите на розклад. Повторний запуск оновлює каталог за тим самим шаблоном, тож морочитися з налаштуваннями доводиться лише на старті, а користуються ними постійно.
Чотири способи завантажити дані
Джерела бувають чотирьох видів — оберіть той, що підходить під ваш випадок.
1. З файлів за готовими шаблонами
Найпоширеніший шлях: у вас є файл вивантаження з іншої системи. Під популярні формати є готові шаблони, де колонки вже розмічені:
- XML / Yandex Market (YML) — універсальний XML-фід товарів;
- CommerceML 2 (1С) — обмін з 1С: файл товарів і файл пропозицій;
- XLSX (prom.ua, satu.kz, deal.by) — таблиця вивантаження з майданчиків EVO;
- Тунель Elbuz і Elbuz CMS — прямий зв'язок із базою іншого магазину без файлів, коли ви переносите каталог зі старого сайту на рушії Elbuz.
2. Універсальний імпорт
Коли готового шаблону під ваш файл немає, підходить універсальний імпорт: він читає будь-який XML, CSV, XLS чи XLSX, а ви самі вказуєте, яка колонка або вузол файлу відповідає якому полю каталогу. Це трохи більше ручної роботи на старті, зате підходить під будь-яке джерело — навіть саморобне вивантаження з чужої системи обліку. Один раз розмітили — і далі файл того самого формату вантажиться за цим шаблоном автоматично.
3. Через API — каталог
Якщо ви вже продаєте на майданчику або ведете облік у зовнішній системі, каталог можна тягнути напряму через API — без файлів, за ключами доступу. Так підключаються Rozetka, Shopify, WooCommerce, Amazon, eBay, Allegro, eMAG, Kaufland, OLX, Etsy, TikTok Shop, Wix, а також облікові системи «Мій склад», Horoshop і CRM SalesDrive.
Ключі ви берете в кабінеті майданчика чи системи — зазвичай у розділі для розробників або інтеграцій — і вставляєте у форму шаблону. Далі Elbuz забирає товари, категорії та зображення так само, як із файлу, тільки без самого файлу. Цей спосіб зручний, коли асортимент великий і часто змінюється: не треба щоразу вивантажувати й завантажувати таблицю вручну. У кожної інтеграції своя форма підключення й свої ключі — детальні статті зібрані в огляді імпорту каталогу через API.
4. Через API — тільки замовлення
Частина інтеграцій завантажує не товари, а замовлення — із маркетплейсів, кас і банків: Kaspi.kz, EVO/Prom (prom.ua, satu.kz), Forte Market, ceneo.pl, каса dotykacka, виписки PrivatBank. Каталог вони не наповнюють — це окрема історія, зібрана в огляді імпорту замовлень через API.
Каталог чи замовлення
Одні джерела приносять каталог, інші — замовлення, а деякі API вміють і те, й інше. У шаблоні ви вмикаєте, що саме тягнути: товари, замовлення або обидва. Тому та сама Rozetka чи Shopify може і наповнити каталог, і забирати нові замовлення — залежно від того, які галочки ви поставили. Файлові шаблони й універсальний імпорт завжди про каталог; частина API — тільки про замовлення.
Як це працює за кроками
Порядок однаковий для будь-якого джерела. Ви створюєте шаблон і обираєте тип. Для файлу — вказуєте файл або посилання й перевіряєте розмітку колонок. Для API — вводите ключі доступу. Далі вмикаєте, що завантажувати (товари, категорії, виробників), і запускаєте. Перший запуск створює товари, наступні — оновлюють. Коли все працює, шаблон ставлять на розклад, і завантаження відбувається саме.
Один шаблон — це одне джерело. Якщо ви возите товар від кількох постачальників чи з кількох майданчиків, під кожне заводять свій шаблон зі своїми налаштуваннями. Вони не заважають один одному й можуть мати різний розклад: один оновлюється щогодини, інший — раз на добу.
Що потрапляє в каталог
Імпорт наповнює картки не лише назвою й ціною. Залежно від джерела й налаштувань шаблону, у каталог потрапляють категорії (дерево розділів), виробники (бренди), зображення, характеристики й атрибути, ціни та залишки. Що саме брати, а що пропустити — ви вирішуєте самі: можна тягнути тільки нові товари й не чіпати опис, який ви вже вичистили руками, або оновлювати лише ціни та наявність, лишивши решту без змін.
Повторний імпорт: оновлення без дублів
Товари не задвоюються при кожному завантаженні. Elbuz упізнає позицію за ідентифікатором — артикулом, кодом чи зовнішнім id із джерела — і оновлює саме її, а не створює копію. Тому шаблон можна безпечно запускати щодня: наявне оновиться, нове додасться. Якщо ж ідентифікатори в джерелі змінюються від вивантаження до вивантаження, це варто врахувати заздалегідь — інакше програма прийме старі товари за нові й наробить дублів.
З чого почати
Подивіться, що у вас на руках. Є файл із товарами — оберіть шаблон під його формат, а якщо формат нетиповий, візьміть універсальний імпорт. Уже продаєте на майданчику — підключіть його через API, це найшвидший шлях без вивантаження файлів. Немає ні файлу, ні майданчика, а товари треба звідкись зібрати — тоді в пригоді стане парсер сайтів, який витягує картки прямо зі сторінок. Коли каталог наповнено, рухайтесь далі за загальною картою: Прайс-листи: з чого почати і куди рухатися.
Не завантажуйте одразу весь асортимент «наосліп». Спершу зробіть шаблон на маленькому файлі чи на одній категорії, перевірте, що товари стали як треба, і лише потім вантажте все й ставте на розклад.
Часті питання
Чим це відрізняється від завантаження прайсу постачальника?
Прайс постачальника завантажують для порівняння й дропшипінгу — це окремий розділ «Постачальники». Тут же ви наповнюєте власний базовий каталог: своїми товарами з файлу, з майданчика чи з облікової системи.
Мого формату немає серед готових шаблонів — що робити?
Візьміть універсальний імпорт. Він читає будь-який XML, CSV, XLS чи XLSX, а розмітку колонок ви задаєте самі під свій файл.
Чи можна завантажити каталог з мого сайту на маркетплейсі без файлу?
Так, якщо для майданчика є API-інтеграція (Rozetka, Shopify, WooCommerce та інші). Ви підключаєтесь за ключами доступу, і Elbuz тягне товари напряму, без вивантаження файлів.
Я підключив API, а замість товарів приходять замовлення — чому?
Частина інтеграцій приносить лише замовлення (каси, банки, деякі маркетплейси). А в тих, що вміють і каталог, і замовлення, перевірте галочки шаблону: увімкнено має бути саме завантаження товарів.
Чи треба завантажувати вручну щоразу?
Ні. Коли шаблон налаштовано й перевірено, його ставлять на розклад — і завантаження відбувається автоматично за таймером, без вашої участі.
Чи не задвояться товари під час повторного завантаження?
Ні, якщо в джерелі стабільні ідентифікатори. Elbuz упізнає товар за артикулом, кодом чи зовнішнім id і оновлює наявну картку, а не створює копію. Проблема з дублями виникає лише тоді, коли ідентифікатори в файлі щоразу різні.