База знань

Імпорт товарів через CSV

Команда OKKKI · 3 хв читання · оновлено 13 червня 2026 р.

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

Коли варто використовувати CSV#

CSV економить час, якщо у вас:

  1. 30–50+ товарів готових до завантаження — ручне створення займе години

  2. Міграція з іншої платформи (1С, Prom, OLX, Excel-таблиця або власна CMS) — каталог вже структурований

  3. Регулярне оновлення асортименту — нові колекції, сезонні позиції, перепрайс

  4. Робота з постачальниками — отримуєте їхній каталог у CSV і вантажите без перенабору

Коли краще створювати картки вручну#

  • 5–20 унікальних товарів — швидше зробити кожну картку з фото-сесії та власним описом

  • Складні варіації з різними фото — варіації зручніше налаштовувати у візуальному редакторі

  • Послуги і пакети — кожна потребує індивідуального опису

Як підготувати CSV-файл#

OKKKi приймає CSV з основними полями товару:

  • Обов'язкові: назва товару і ціна

  • Опціональні: опис, артикул, стара ціна, залишок на складі, категорія, теги, бренд, одиниця виміру, валюта, статус активності

Точний список полів і назви колонок ви побачите у самому майстрі імпорту в кабінеті.

Базові правила підготовки файлу:

  1. Кодування — UTF-8 (інакше українські літери відобразяться як ???)

  2. Розділювач — кома або крапка з комою (стандарт Excel/Google Sheets)

  3. Категорії потрібно створити заздалегідь — у розділі Категорії додайте всі позиції, які будуть у файлі. CSV резолвить категорію за назвою — якщо назви у файлі і в кабінеті не співпадуть, товар не прив'яжеться.

  4. Фото додаєте окремо — після імпорту відкриваєте картку і завантажуєте зображення (JPG/PNG/WEBP/GIF до 5 МБ)

Як завантажити у OKKKi#

У розділі Товари знайдіть опцію імпорту з CSV. Майстер імпорту проведе вас через кроки: завантаження файлу, перевірка розпізнаних колонок і підтвердження.

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

Що буде після імпорту#

Товари з'являються у розділі Товари. Для кожної картки залишається доробити:

  • Фото — головне фото позначається зірочкою у списку

  • Варіації — якщо у товару різні розміри або кольори

  • Маркетинг-статуси — бейджі «Новинка», «Хіт продажу» додаються вручну

Поради по структуруванню каталогу#

  • Назви категорій у файлі = назви в кабінеті (символ у символ, разом з регістром і пробілами)

  • Унікальність артикулу (SKU) — якщо лишити порожнім, OKKKi згенерує сам. Якщо заповнюєте — артикул має бути унікальним у межах магазину

Якщо щось пішло не так#

Імпорт не запускається або файл не приймається:

  • Перевірте кодування (має бути UTF-8) і розширення (.csv)

  • Якщо майстер показує перевищення розміру або кількості рядків — розбийте файл на кілька менших

  • Перевірте, що обов'язкові поля (назва і ціна) заповнені у всіх рядках

Товари імпортувались, але не відображаються у вітрині:

  • Перевірте, чи створена відповідна категорія в кабінеті

  • Перевірте, чи товар активний (увімкнений до показу) — статус активності задається при імпорті або в самій картці

Після збереження картка не зберігається:

Якщо проблема не вирішилася — напишіть у підтримку @manager_okkki і додайте ваш CSV-файл.

Пов'язані матеріали#

Стаття допомогла?