Підготовка імпорту (CSV, Excel, XML, YML)
Повний процес підготовки файлу перед імпортом у магазин: від аналізу джерела і мапінгу колонок до збереження профілю, редагування preview та експорту підготовленого файлу.
Важливо: режим Підготовка імпорту не змінює товари в магазині. Тут ви лише готуєте дані, перевіряєте їх
і за потреби зберігаєте профіль для подальшого імпорту.
1) Що можна підготувати в цьому режимі
- Завантаження джерела з файлу або за URL/API.
- Мапінг колонок до системних полів товару (назва, SKU, ціна, собівартість тощо).
- Привʼязка до постачальника та налаштування auto-markup.
- Вибір правила пошуку існуючих товарів: за SKU або назвою.
- Позначення товарів характеристикою/атрибутом (mark feature) для сегментації.
- Редагування даних у preview-редакторі до запуску імпорту.
- Збереження профілю налаштувань для повторного використання.
Цей режим — “пісочниця”: ви готуєте файл, робите перевірки, і тільки потім запускаєте реальний імпорт.
2) Покроковий процес підготовки
- Виберіть проєкт для імпорту.
- Оберіть джерело: Файл або URL/API.
- Натисніть АНАЛІЗУВАТИ ДЖЕРЕЛО.
- Виконайте мапінг ключових полів. Обовʼязково задайте SKU.
- Перейдіть до блоку Постачальник і (за потреби) вкажіть колонку ціни закупки.
- Налаштуйте додаткові параметри (search rule, mark feature).
- Відкрийте Preview і перевірте/відредагуйте рядки.
- Збережіть профіль налаштувань для повторних запусків.
Якщо змінювали мапінг — після цього збережіть профіль, інакше при наступному запуску можна втратити частину налаштувань.
3) Обовʼязкові і рекомендовані поля
Мінімум для стабільного імпорту:
SKU → унікальний ідентифікатор
Назва → назва товару
Ціна → роздрібна ціна або формула через собівартість
SKU → унікальний ідентифікатор
Назва → назва товару
Ціна → роздрібна ціна або формула через собівартість
- SKU (обовʼязково): пошук існуючих товарів і запобігання дублям.
- Назва: бажано без технічного сміття, зі зрозумілим форматом.
- Ціна: якщо працюєте через собівартість — вкажіть колонку закупки і увімкніть auto-markup.
- Кількість/статус: для коректного відображення наявності.
- Зображення: перевірте валідність URL або структуру колонок із фото.
4) XML/YML: як працює мапінг
- Після аналізу структури відкривається менеджер відповідностей тегів.
- Для кожного тегу задається цільове системне поле або характеристика.
- Рекомендація: спочатку промапити SKU/Назву/Ціну, потім додаткові поля.
- Для мультимовних даних використовуйте відповідні поля локалізації.
Якщо у фіді є вкладені структури (наприклад, кілька фото або параметри) — мапте їх як список/масив у відповідні поля системи.
5) Preview-редактор: як правильно перевіряти дані
- Використовуйте режими Візуально і Таблиця для швидкого контролю.
- Застосовуйте фільтри: без фото, порожня назва/SKU, проблемні рядки.
- Редагуйте значення inline і зберігайте правки до експорту.
- Перед запуском імпорту перевіряйте критичні колонки: SKU, назва, ціна, категорія.
Preview — це остання точка контролю перед імпортом. Краще “піймати” помилки тут, ніж потім чистити каталог.
6) Збереження профілю і повторне використання
- Після налаштування вкажіть зрозумілу назву (наприклад: «Постачальник A / XML / Посуд»).
- Профіль зберігає: мапінг, джерело, постачальника і додаткові правила.
- При повторному запуску достатньо вибрати проєкт і профіль.
- Система памʼятає останні параметри сторінки підготовки для швидкого повернення до роботи.
7) Експорт підготовленого файлу
- Після перевірки експортуйте дані у CSV або XLSX.
- Експортований файл можна використати для погодження або архіву.
- За потреби файл можна завантажити назад без повторного редагування.
Рекомендовано зберігати експорт як “контрольну версію” перед реальним імпортом.
8) Типові проблеми і як їх уникнути
Найчастіші причини
- Не задано SKU: система не зможе коректно оновлювати існуючі товари.
- Порожні назви: перевіряйте фільтр “порожня назва/SKU” перед запуском.
- Невірний URL джерела: файл має бути доступний без авторизації або токен має бути актуальний.
- Некоректна ціна: перевірте формат чисел (крапка/кома, зайві символи валюти).
- Зміни не збереглись: після редагування мапінгу повторно збережіть профіль.
Порада: спочатку зробіть “мінімальний мапінг” (SKU/Назва/Ціна), перевірте preview, і лише потім додавайте додаткові поля.