DOCS
← На лендингВідкрити білдер

Імпорт товарів із CSV та XML-фідів

Як перенести каталог із таблиці чи фіду: завантажити файл, зіставити стовпці, перевірити результат і за потреби скасувати імпорт.

РОЗДІЛКаталогЧИТАННЯ~8 хвОНОВЛ.

Який потрібен файл

  • CSV або TSV до 250 МБ і до 100 000 рядків. Таблицю з Excel або Google Sheets збережіть як CSV — роздільник (кома, крапка з комою, табуляція) і кодування імпорт визначить сам.
  • Або XML-фід — YML чи фід Google — до 250 МБ і до 100 000 товарів.
  • Або вивантаження товарів Shopify чи WooCommerce — воно розпізнається за заголовками стовпців. Як його отримати і що перенесеться — у статтях «Переїзд із Shopify» і «Переїзд із WooCommerce».
  • Будь-який із цих файлів можна завантажити стиснутим у .gz. Розпакований, він теж має бути не більшим за 250 МБ.
  • Перший рядок — заголовки стовпців, далі по товару в рядку.
  • Фото — посиланнями на зображення, кілька через кому. Імпорт сам завантажить їх у медіатеку, до 10 на товар.
  • Категорії — шляхом через «>»: «Одяг > Футболки». Відсутні категорії створяться деревом.
Шаблон

«Каталог» → «Імпорт» → «Шаблон CSV». У шаблоні наші стовпці: id, sku, name, price, stock_quantity, categories, images та інші, а також стовпці мов магазину (name:en) і характеристик (attr:код). Файл за шаблоном розпізнається сам, і зіставляти майже нічого не треба.

Фіди YML

YML — XML-фід, у якому каталоги приймають маркетплейси й віддають постачальники. Особливості майданчика розпізнаються за тегами самі. Вивантаження Prom, Deal.by і Satu.kz читається з YML і з CSV; у CSV немає дерева груп, тому категорії будуть плоскими. Каталог із Horoshop вивантажте у форматі Prom. Теги фіду стають стовпцями й зіставляються самі: категорії беруться з дерева категорій фіду, кожен param — характеристика (стовпці на кшталт param:Колір), а name_ua і description_ua — український переклад, якщо українська є серед мов магазину.

Фіди Google

Фід Google Merchant — XML (RSS або Atom) або таблиця TSV чи CSV з назвами атрибутів Google. Ті самі атрибути у фідів Meta (Facebook, Instagram) і Microsoft Merchant Center — вони завантажуються так само. sale_price — ціна зі знижкою: якщо її заповнено, вона стає ціною товару, а звичайна ціна — старою. google_product_category записується в категорію Google товару, product_type — шляхом категорій «A > B > C», з нього будується дерево категорій магазину, а product_detail стають характеристиками.

Сумісні майданчики

Підійде вивантаження товарів файлом. «Автоматично» означає, що формат розпізнається сам. «Через свій CSV» означає, що файл завантажиться, а стовпці ви зіставите на кроці «Поля». Якщо вашого майданчика тут немає, вивантажте товари в CSV і завантажте як свій CSV. Файл Excel спочатку збережіть як CSV.

  • У будь-якій країні: автоматично — Wix, Ecwid; через свій CSV — Etsy, Amazon, eBay, Squarespace, BigCommerce, Magento.
  • Канада: автоматично — Lightspeed.
  • США: через свій CSV — GoDaddy, Webflow.
  • Бразилія: автоматично — VTEX.
  • Аргентина: через свій CSV — Tiendanube.
  • Чилі: через свій CSV — Jumpseller.
  • Німеччина: автоматично — Shopware.
  • Франція: через свій CSV — PrestaShop.
  • Польща: автоматично — Shoper.pl; через свій CSV — Allegro.pl.
  • Чехія: автоматично — Shoptet.cz.
  • Україна: автоматично — Prom.ua, Horoshop.ua.
  • Казахстан: автоматично — Satu.kz.
  • Туреччина: автоматично — ikas.
  • Індія: через свій CSV — Zoho Commerce.
  • Малайзія: через свій CSV — EasyStore.
  • Гонконг: через свій CSV — Shopline.
  • Саудівська Аравія: через свій CSV — Zid.sa.
  • Австралія: через свій CSV — Maropost.

Як проходить імпорт

  1. Джерело
    «Каталог» → «Імпорт» → «Новий імпорт», виберіть файл. Кожне завантаження потрапляє в джерело — повторне завантаження в те саме джерело оновить його товари, а не створить нові. Якщо той самий каталог уже завантажували в інше джерело, майстер запропонує оновити його.
  2. Формат
    Видно, скільки записів у файлі, які формат і кодування визначилися, а таблиця показує перші записи й усі стовпці. Якщо формат визначився неправильно, у таблиці «кракозябри» або все в одному стовпці — змініть формат, кодування чи роздільник і прочитайте файл заново.
  3. Поля, категорії, характеристики
    Зіставте стовпці з полями товару, потім вирішіть, які категорії та характеристики створити, а які пов’язати з наявними.
  4. Модифікації
    Якщо у файлі є ключ групи або посилання на батьківський товар, майстер покаже знайдені групи модифікацій та їхні осі. Коли груп немає, крок пропускається.
  5. Налаштування
    Створювати й оновлювати чи лише одне з двох, що робити з товарами, яких немає у файлі, курс валюти, статус нових товарів, фото, фільтри. Зазвичай типових значень достатньо.
  6. Перевірка й запуск
    Імпорт показує, що створиться, оновиться й пропуститься, і лише потім пише в каталог. Імпорт іде у фоні: вікно можна закрити, а коли він завершиться, прийде лист.

Поля й перетворення

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

Кнопка «Перетворення» в стовпця змінює значення дорогою в каталог: замінити або прибрати текст («ОПТ», назву постачальника), додати текст на початок або в кінець, змінити регістр, обрізати, підставити значення для порожніх, замінити значення за таблицею, зібрати значення з кількох стовпців шаблоном на кшталт {Бренд} {Модель}, помножити, додати або округлити число — наприклад, націнка. Правила застосовуються по черзі, поруч видно «було → стало».

Ключ

Повторне завантаження знаходить товари за стовпцем id, а без нього — за SKU. Якщо у файлі немає ні того ні іншого, кожне завантаження створить товари заново.

Модифікації

  • Модифікація — окремий товар у групі. Група збирається зі стовпця зі спільним ключем групи (group_id у YML, item_group_id у фіді Google) або зі стовпця з посиланням на батьківський товар — його id чи SKU; сам батьківський товар теж входить у групу.
  • Осі — характеристики, якими модифікації відрізняються: колір, розмір. Типово ними стають характеристики, значення яких відрізняються всередині групи; на кроці «Модифікації» осі можна вибрати самому — до трьох. Вимкніть «Збирати модифікації», і кожен товар імпортується окремо.
  • Головний товар групи — батьківський, а без нього — перший товар групи у файлі. Модифікації без власного опису, категорій чи фото беруть їх у головного товару, як і відсутні характеристики.
  • Група з понад 100 товарів, з більш ніж трьома осями, з віссю не типу «Список» чи «Колір», з товаром без значення осі або з повторюваним поєднанням значень не збирається: її товари імпортуються поодинці, а в їхніх рядків лишається попередження.
  • Повторне завантаження додає нові модифікації в уже зібрану групу.

Фільтри

Фільтри на кроці «Налаштування» беруть із файлу лише частину записів — наприклад, один бренд або товари, дорожчі за 100. Умова — стовпець, порівняння (дорівнює, містить, більше, менше, одне зі списку через кому, порожньо та інші) і значення; значення порівнюється після перетворень стовпця. Імпорт візьме лише записи, що підходять під усі умови, решта не створюються й не оновлюються. Скільки записів відсіяно, видно на кроці «Перевірка». Умов — до 20.

Валюта й курс

Ціни в іншій валюті перераховуються у валюту магазину: за курсом із фіду (currencies у YML), для USD з курсом NBU в гривневому магазині — за поточним курсом НБУ, інакше — за «Курсом джерела» на кроці «Налаштування»: скільки коштує одиниця валюти файлу у валюті магазину. Без курсу імпорт не запуститься: перевірка покаже, для якої валюти його немає, — так ціни в доларах не потраплять на сайт гривнями.

Перевірка

На кроці «Перевірка» в каталог ще нічого не записано. Угорі — скільки товарів створиться, оновиться й пропуститься і скільки рядків із помилками, нижче — вкладки «Товари», «Категорії» та «Характеристики». У кожного рядка — номер рядка у файлі й причина помилки. Зніміть позначку з рядка, щоб виключити його з цього імпорту. «Звіт про помилки» завантажує їх списком у CSV.

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

Перевірка перед публікацією

Типово нові товари записуються чернетками, а нові категорії приховано: дані вже в каталозі, але на сайті їх немає. Перегляньте й виправте їх у звичайній адмінці — список «Створено імпортом» веде в картки товарів — і натисніть «Опублікувати». Зміни наявних товарів застосовуються одразу. Налаштування «Перевірити перед публікацією» — на кроці «Налаштування».

Зупинка й скасування

  • «Зупинити» під час запису спрацьовує після поточної пачки. Далі — «Продовжити» з того самого місця, «Завершити як є» або «Скасувати імпорт». Без рішення зупинений імпорт через добу завершується як є.
  • Імпорт, який ще не запущено, закривається кнопкою «Закрити» на картці джерела або видаляється разом із джерелом: у каталог він нічого не записав.
  • «Скасувати імпорт» є в останнього імпорту джерела, що писав у каталог. Він видаляє створені імпортом товари, а також категорії та характеристики, якими більше ніщо не користується. Товари із замовленнями йдуть в архів. Вікно підтвердження покаже, скільки товарів видалиться і скільки з них редагували після імпорту.
  • Скасування не повертає назад оновлені поля наявних товарів.

Ліміт тарифу

Товарів у магазині може бути до 100 на Free, до 5 000 на Pro і до 15 000 на Team. Якщо файл не вміщується, імпорт скаже про це одразу після читання файлу: перейдіть на вищий тариф або виключіть зайві рядки на кроці «Перевірка». Імпорт, що виведе магазин за ліміт, не запуститься.

Синхронізація за посиланням

Замість файлу можна дати посилання на фід постачальника: «Новий імпорт» → «За посиланням». Імпорт завантажить фід (до 100 МБ) і пройде ті самі кроки, що й з файлом. Якщо фід відкривається за логіном і паролем, позначте «Закритий фід» і вкажіть їх — вони зберігаються зашифрованими.

  • На Pro і Team джерело за посиланням оновлюється за розкладом — раз на 1, 3, 6, 12 або 24 години. Розклад вмикається в меню джерела → «Змінити».
  • Типово синхронізація оновлює ціну, стару ціну, наявність і залишок, а товари, яких більше немає у фіді, прибирає в архів. Це змінюється в налаштуваннях джерела.
  • Націнка у відсотках або сумою й округлення ціни — до цілого чи до .99 — застосовуються до ціни й старої ціни після перерахунку валюти.
  • Якщо фід не змінився з минулого запуску, синхронізація його пропускає — в історії запуск позначено «Фід не змінився».
  • Помітні зміни — ті самі, що потребують підтвердження під час ручного запуску, або фід, що став набагато коротшим, — синхронізація сама не записує: джерело стає на паузу, а вам приходить лист. Відкрийте перевірку й запустіть імпорт або зніміть паузу.
  • П’ять збоїв поспіль — фід не завантажився або за посиланням відкрилася сторінка замість фіду — теж ставлять джерело на паузу. Перевірте посилання й доступ, потім зніміть паузу.