Перейти к основному содержимому

Импорт из Excel/CSV

Импорт из Excel — самый универсальный способ загрузки товаров. Вы можете подготовить данные в удобной таблице и загрузить их одним файлом.

Подготовка файла​

Шаг 1: Скачайте шаблон​

Где скачать:

Товары → Импорт/Экспорт → Импорт из Excel → Скачать шаблон

Или скачайте пример: botobot-import-sample.xlsx

Шаг 2: Структура файла​

Обязательные столбцы:

СтолбецОписаниеПример
nameНазвание товараФутболка хлопковая белая
priceЦена в рублях1500

Дополнительные столбцы:

СтолбецОписаниеПример
descriptionОписание товараКлассическая футболка из 100% хлопка
skuАртикулTSH-WHT-M
categoryКатегорияОдежда/Футболки
imageURL изображенияhttps://example.com/image.jpg
old_priceСтарая цена2000
stockОстаток10
weightВес в граммах200
visibleВидимость (1/0)1

Шаг 3: Заполнение данных​

Пример таблицы:

namepricedescriptionskucategorystock
Футболка белая1500100% хлопок, размер MTSH-W-MОдежда10
Футболка черная1500100% хлопок, размер MTSH-B-MОдежда15
Джинсы синие3500Классические джинсыJEANS-BОдежда5

Правила заполнения​

Название (name)​

Требования:

  • Обязательное поле
  • Длина: 3-255 символов
  • Должно быть уникальным

Примеры:

✅ Футболка хлопковая белая размер M
✅ Кофе арабика молотый 250г
✅ Наушники беспроводные TWS Pro Black
❌ Товар 1
❌ (пустое поле)

Цена (price)​

Формат:

  • Положительное число
  • Без пробелов и символов
  • Можно использовать точку для копеек

Примеры:

✅ 1500
✅ 1499.90
✅ 99.99
❌ 1 500
❌ 1500₽
❌ -100
❌ бесплатно

Описание (description)​

Формат:

  • До 4096 символов
  • Поддерживается Markdown
  • Можно использовать эмодзи

Примеры:

Классическая футболка из натурального хлопка

**Особенности:**
- 100% хлопок
- Свободный крой
- Приятная к телу

**Размеры:** S, M, L, XL

Артикул (sku)​

Формат:

  • Буквы и цифры
  • Дефисы и подчеркивания
  • До 50 символов
  • Должен быть уникальным!

Примеры:

✅ SKU-001
✅ TSH-WHT-M
✅ PROD_12345
❌ (пустое — будет сгенерировано автоматически)
Важность артикулов

Артикулы используются для обновления товаров. Без артикула система не сможет найти товар при повторном импорте.

Категория (category)​

Формат:

  • Название существующей категории
  • Или путь через / для подкатегорий

Примеры:

✅ Одежда
✅ Одежда/Женская
✅ Одежда/Женская/Платья
❌ Несуществующая категория (будет создана)

Автосоздание: Если категории нет, она будет создана автоматически

Изображения (image)​

Формат:

  • Прямая ссылка на изображение
  • Несколько URL через запятую

Примеры:

✅ https://example.com/images/product.jpg
✅ https://cdn.site.ru/img1.jpg,https://cdn.site.ru/img2.jpg
❌ /images/product.jpg (относительный путь)
❌ C:\Users\...\image.jpg (локальный путь)

Требования к изображениям:

  • Формат: JPG, PNG, WebP
  • Размер: до 10 МБ
  • URL должен быть доступен публично

Старая цена (old_price)​

Формат:

  • Число больше текущей цены
  • Для отображения скидки

Примеры:

✅ 2000 (при price = 1500)
✅ 1999.90
❌ 1000 (меньше price)

Отображение:

~~2000 ₽~~ 1500 ₽ (-25%)

Остаток (stock)​

Формат:

  • Целое неотрицательное число
  • Пустое = неограниченно (∞)
  • 0 = товар скрыт автоматически

Примеры:

✅ 10
✅ 0
✅ (пустое — неограниченно)
❌ -5
❌ бесконечно

Вес (weight)​

Формат:

  • Вес в граммах
  • Положительное число

Примеры:

✅ 250 (250 грамм)
✅ 1500 (1.5 кг)
✅ 50
❌ 1.5кг

Видимость (visible)​

Формат:

  • 1 = показывать
  • 0 = скрыть
  • Пустое = показывать

Примеры:

✅ 1
✅ 0
✅ (пустое)
❌ да
❌ true

Процесс импорта​

Шаг 1: Подготовьте файл​

  1. Заполните все данные в Excel
  2. Проверьте обязательные поля
  3. Сохраните файл

Формат сохранения:

  • .xlsx (рекомендуется)
  • .xls (старый формат)
  • .csv (только UTF-8)

Шаг 2: Загрузите файл​

  1. Перейдите в Товары → Импорт/Экспорт
  2. Нажмите "Импорт из Excel"
  3. Нажмите "Выбрать файл"
  4. Выберите подготовленный файл
  5. Нажмите "Загрузить"

Шаг 3: Сопоставление столбцов​

Система автоматически определит столбцы, но проверьте:

Пример:

Столбец в файле → Поле в Botobot
name            → Название
price           → Цена
description     → Описание
sku             → Артикул
category        → Категория

Если названия столбцов не стандартные, сопоставьте вручную.

Шаг 4: Настройки импорта​

Режим импорта:

  • 🆕 Только новые — создавать только новые товары
  • 🔄 Обновить существующие — обновлять по артикулу
  • ✅ Создать и обновить (рекомендуется)

Дополнительные настройки:

  • ☑️ Создавать новые категории автоматически
  • ☑️ Скачивать изображения по URL
  • ☑️ Пропускать товары с ошибками

Шаг 5: Превью импорта​

Система покажет превью первых 10 товаров.

Проверьте:

  • ✅ Названия корректны
  • ✅ Цены правильные
  • ✅ Категории определены верно
  • ✅ Нет ошибок

Если все верно, нажмите "Начать импорт"

Шаг 6: Ожидание​

Импорт выполняется в фоне:

  • Маленькие файлы (до 100 товаров): 1-2 минуты
  • Средние (100-1000): 5-10 минут
  • Большие (1000+): 15-30 минут

Что происходит:

  1. Загрузка файла
  2. Валидация данных
  3. Создание/обновление товаров
  4. Загрузка изображений
  5. Создание категорий

Можно:

  • Закрыть страницу (процесс продолжится)
  • Работать с другими разделами
  • Получите email по завершении

Шаг 7: Проверка результата​

После завершения:

  1. Откройте отчет об импорте:

    • Успешно: X товаров
    • Ошибки: Y товаров
    • Обновлено: Z товаров

  2. Проверьте ошибки (если есть):

    • Скачайте файл с ошибками
    • Исправьте
    • Импортируйте повторно

  3. Проверьте товары:

    • Откройте список товаров
    • Проверьте несколько позиций
    • Откройте бота в Telegram

Обновление товаров​

Как обновить существующие товары​

Шаг 1: Экспортируйте текущий каталог

Товары → Импорт/Экспорт → Экспортировать

Шаг 2: Откройте файл и измените данные

Шаг 3: Импортируйте с режимом "Обновить существующие"

Что обновляется:

  • Система находит товары по артикулу (sku)
  • Обновляет только измененные поля
  • Не создает дубликаты

Пример:

Исходный товар:

sku: TSH-001
name: Футболка белая
price: 1500
stock: 10

После импорта с новой ценой:

sku: TSH-001
name: Футболка белая
price: 1200  ← обновлено
stock: 10

Импорт с изображениями​

Способ 1: URL в файле​

В столбце image укажите прямые ссылки:

https://example.com/images/product1.jpg
https://example.com/images/product2.jpg,https://example.com/images/product2-2.jpg

Система:

  • Скачает изображения
  • Загрузит в Botobot
  • Привяжет к товарам

Способ 2: ZIP-архив​

Подготовка:

  1. Создайте папку с изображениями

  2. Назовите файлы по артикулу:

    TSH-001.jpg
    TSH-002.jpg
    JEANS-001.jpg

  3. Упакуйте в ZIP-архив

  4. При импорте загрузите архив

Преимущества:

  • Не нужен веб-сервер
  • Работает локально
  • Быстрее для большого количества

Частые ошибки​

❌ "Обязательное поле 'name' пустое"​

Строка: 5

Решение: Заполните название товара в строке 5

❌ "Некорректный формат цены"​

Строка: 12
Значение: "1 500 руб"

Решение: Укажите цену числом: 1500

❌ "Дубликат артикула"​

Строка: 25
SKU: TSH-001

Решение: Сделайте артикул уникальным или объедините товары

❌ "Не удалось загрузить изображение"​

URL: https://example.com/image.jpg

Возможные причины:

  • URL недоступен (404)
  • Требуется авторизация
  • Неправильная ссылка

Решение:

  • Проверьте URL в браузере
  • Используйте прямые ссылки
  • Загрузите изображения архивом

❌ "Кодировка файла не поддерживается"​

Причина: CSV сохранен не в UTF-8

Решение:

  1. Откройте CSV в Notepad++
  2. Кодировка → Преобразовать в UTF-8
  3. Сохранить

Или:

  1. Excel → Сохранить как
  2. Выбрать "CSV UTF-8 (разделитель — запятая)"

Экспорт каталога​

Зачем экспортировать​

  • 📥 Резервная копия
  • ✏️ Массовое редактирование
  • 📊 Анализ в Excel
  • 🔄 Миграция

Как экспортировать​

Шаг 1:

Товары → Импорт/Экспорт → Экспортировать в Excel

Шаг 2: Выберите параметры:

  • Все товары / Только видимые
  • Включить скрытые товары
  • Включить изображения (URL)

Шаг 3: Нажмите "Экспортировать"

Шаг 4: Скачайте файл

Что экспортируется:

  • Все данные товаров
  • URL изображений
  • Категории
  • Остатки
  • Все дополнительные поля

Советы и хитрости​

Совет 1: Формулы в Excel

Используйте формулы для генерации данных:

Артикулы:

=CONCATENATE("PROD-", ROW())

Цены со скидкой:

=ROUND(B2*0.8, 0)  // 20% скидка
Совет 2: Заполнение вниз

Если у всех товаров одинаковая категория:

  1. Заполните первую ячейку
  2. Протяните вниз (Ctrl+D)
Совет 3: Проверка данных

Используйте условное форматирование для поиска ошибок:

  • Пустые обязательные поля → красный
  • Отрицательные цены → желтый
Совет 4: Тестовый импорт

Создайте файл с 5-10 товарами для теста перед импортом всего каталога.

Лучшие практики​

1. Регулярные бэкапы Экспортируйте каталог еженедельно

2. Используйте артикулы Всегда заполняйте поле SKU

3. Проверяйте перед импортом Используйте режим превью

4. Импортируйте поэтапно 100-200 товаров за раз

5. Сохраняйте версии файлов Нумеруйте: catalog_v1.xlsx, catalog_v2.xlsx

Что дальше?​

После успешного импорта:

  1. Проверьте товары в боте — откройте Telegram
  2. Настройте варианты — если нужны размеры/цвета
  3. Управляйте остатками — отслеживайте наличие

Нужна помощь?​

📧 Email: support@botobot.ru
💬 Telegram: @BotobotSupport_bot

При обращении приложите:

  • Файл для импорта
  • Скриншот ошибки
  • Описание проблемы

Готовы импортировать? Скачайте шаблон →