# Імпорт товарів

Імпорт завантажує товари з таблиці: створює нові й оновлює наявні. Відкрийте магазин, виберіть «Товари» й натисніть «Імпорт». Імпорт доступний власникові проєкту та співробітникові з правом «Товари та категорії».

Вивантаження каталогу у файл у магазині немає.

## Підготувати файл

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

| Поле товару | Що має бути в комірці |
|---|---|
| «Назва» | Назва товару. Обов'язкове поле |
| «Ціна» | Число у валюті магазину, наприклад `1990,50` |
| «Стара ціна» | Число у валюті магазину |
| «Артикул» | Код товару, до 64 символів |
| «Залишок» | Ціле невід'ємне число. Порожня комірка в нового товару — залишок не враховується |
| «Категорія» | Вкладеність через «/», кілька категорій через «;»: `Букети / Троянди; Новинки` |
| «Опис» | Текст опису |
| «Фото» | Посилання на фото через пробіл або кому |

Приклад таблиці:

| Назва | Ціна | Артикул | Залишок | Категорія | Фото |
|---|---|---|---|---|---|
| Букет «Ромашка» | 1990 | RM-001 | 12 | Букети / Польові | `https://example.com/romashka.jpg` |
| Ваза скляна | 850,50 | VZ-014 | 5 | Вази; Новинки | `https://example.com/vaza.jpg` |

Що важливо знати про файл:

- **CSV.** Роздільник колонок — кома, крапка з комою або табуляція — визначається сам. Кодування — UTF-8 або Windows-1251, у якому зберігає російський Excel.
- **Категорії.** Категорії, яких ще немає, імпорт створює сам. Рівні, глибші за третій, відкидаються.
- **Фото.** Платформа завантажує фото за посиланнями — посилання мають відкриватися без авторизації й починатися з `http://` або `https://`. Формати — JPG, PNG, GIF, WebP.
- **Характеристики.** Колонки можна завантажити в характеристики товарів. Створіть характеристику заздалегідь — колонка з тією самою назвою підставиться сама. Для типу «Кілька зі списку» значення пишуть через «;», для «Так чи ні» — «так», «ні», 1 або 0.
- **Опції та варіанти** таблицею не завантажуються — їх додають у картці товару.

## Завантажити

![Завантаження файлу з товарами](https://support.jetbot24.ru/_media/uk/05-shop/_images/import-upload.webp?v=1791786051)

1. Перетягніть файл в область «Файл з товарами» або натисніть на неї й виберіть файл.
2. На кроці «Зіставлення колонок» для кожного поля товару виберіть колонку таблиці. Знайомі назви колонок платформа підставить сама. Поле без колонки — «Не завантажувати». Унизу для перевірки показано «Перші рядки» файлу.
3. Нижче, у блоці «Характеристики», виберіть колонки для характеристик. Тут само можна створити характеристику — «Нова характеристика».
4. Виберіть, що робити, «Якщо товар уже є»:

   | Варіант | Що відбувається |
   |---|---|
   | «Додавати як новий» | Кожен рядок створює новий товар |
   | «Оновлювати за артикулом» | Товар із таким артикулом оновлюється, решта рядків створює нові товари |
   | «Оновлювати за назвою» | Товар із такою назвою оновлюється, решта рядків створює нові товари |

5. Натисніть «Почати імпорт».

![Зіставлення колонок під час імпорту](https://support.jetbot24.ru/_media/uk/05-shop/_images/import-mapping.webp?v=1791786051)

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

Під лічильниками — таблиця з колонками «Рядок» і «Що не так»: номери рядків файлу й причини, з яких рядок не завантажився або завантажився не повністю.

![Підсумок імпорту: лічильники й рядки з помилками](https://support.jetbot24.ru/_media/uk/05-shop/_images/import-result.webp?v=1791786051)

## Як оновлюються товари

- Порожні комірки не стирають дані товару: оновлюється лише те, що заповнено.
- Категорії з файлу додаються до тих, що вже є в товару.
- Фото завантажуються, лише якщо в товару ще немає жодного фото.
- У товару з варіантами колонка залишку пропускається: залишок ведеться за варіантами.

> [!TIP]
> Щоб оновити ціни й залишки, завантажте таблицю з колонок «Артикул», «Ціна» і «Залишок» із варіантом «Оновлювати за артикулом». Колонку назви при цьому однаково потрібно вказати — без неї імпорт не почнеться.

## Обмеження

- За один імпорт обробляється не більше 20 000 рядків.
- За один імпорт завантажується не більше 10 000 фото, для одного товару — не більше 50.
- У магазині — не більше 10 000 товарів і 500 категорій: рядки понад ліміт потраплять у помилки.
- У товару — не більше 100 характеристик.
- У таблиці помилок показано перші 100 записів.
- Одночасно триває один імпорт.

## Якщо щось не працює

| Повідомлення | Причина |
|---|---|
| «Для імпорту підходять таблиці XLSX, ODS і CSV.» | Файл іншого формату — наприклад, старий XLS |
| «Не вдалося прочитати файл. Збережіть таблицю у форматі XLSX або CSV.» | Файл пошкоджено або збережено з помилкою |
| «Імпорт уже триває. Дочекайтеся його завершення.» | Попередній імпорт ще не завершено |
| «Щоб шукати товари за артикулом, вкажіть колонку з артикулом.» | Вибрано «Оновлювати за артикулом», а колонку для поля «Артикул» не вказано |
| «Немає назви товару.» | У рядку порожня назва, а товар для оновлення не знайдено |
| «Не вдалося розібрати ціну «…».» | У комірці ціни не число |
| «Залишок має бути цілим невід’ємним числом, а не «…».» | У комірці залишку дробове чи від'ємне число або текст |
| «Не вдалося завантажити фотографію …» | Посилання не відкривається або веде не на зображення. Товар при цьому завантажено — без цього фото |
| «Характеристика «…»: значення «…» не підходить.» | Значення не відповідає типу характеристики. Товар завантажено без нього |
| «Імпорт зупинено: автор імпорту більше не може редагувати каталог.» | У співробітника, який запустив імпорт, під час імпорту забрали право «Товари та категорії» |
| «Імпорт перервано через помилку. Спробуйте ще раз.» | Збій на боці платформи. Запустіть імпорт заново — уже завантажені рядки зручніше оновлювати за артикулом |