Загрузка прайс-листа из XLSX/XLS/CSV

Если у вас есть готовый прайс-лист в Excel или CSV, вы можете загрузить его напрямую в Botobot. Этот формат подходит для быстрого импорта базовых данных о товарах.

Поддерживаемые форматы

Форматы файлов:

.xlsx — современный формат Excel
.xls — старый формат Excel
.csv — текстовый формат (с разделителями)

Скачать шаблон: botobot-import-sample.xlsx

Структура прайс-листа

Обязательные поля

Для успешного импорта файл должен содержать следующие столбцы:

Столбец	Описание	Пример	Формат
ID	Уникальный идентификатор товара	1, 2, 3	Целое число
Active	Статус товара	1 или 0	1 = показывать, 0 = скрыть
Section 1	Основная категория	Одежда	Текст
Name	Название товара	Футболка хлопковая белая	До 255 символов
Price	Цена товара	1500	Число (без пробелов)

Обязательные поля

Все пять столбцов должны присутствовать в файле. Пустые значения в обязательных полях приведут к ошибке импорта.

Дополнительные поля

Вы можете расширить прайс-лист дополнительными столбцами:

Столбец	Описание	Пример
Article	Артикул товара	TSH-WHT-M
Description	Описание товара	Классическая футболка из 100% хлопка
Weight	Вес товара (в граммах)	200
Volume	Объем товара	0.5
Diameter	Диаметр	10
Size	Размер	M, L, XL
Color	Цвет	Белый, Черный
Product Images	URL изображений товара	https://example.com/image.jpg
Product Link	Ссылка на товар	https://shop.com/product
Section Link	Ссылка на раздел	https://shop.com/category
Section 2	Подкатегория (уровень 2)	Женская одежда
Section 3	Подкатегория (уровень 3)	Футболки
Section 4	Подкатегория (уровень 4)	Летняя коллекция

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

ID (Идентификатор)

Формат:

Уникальное целое число
Используется для обновления товаров
Не должно повторяться

Примеры:

✅ 1
✅ 100
✅ 12345
❌ (пустое)
❌ ABC-001 (не число)

Совет по ID

ID используется для идентификации товаров при повторном импорте. Сохраняйте одинаковые ID для обновления существующих товаров.

Active (Статус)

Формат:

1 = товар видимый (активный)
0 = товар скрытый

Примеры:

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

Использование:

Скрывайте товары без удаления из системы
Управляйте видимостью сезонных товаров
Временно отключайте товары при отсутствии

Section 1-4 (Категории)

Формат:

Текстовое название категории
До 4 уровней вложенности
Section 1 — обязательное поле

Примеры:

Простая структура (1 уровень):

Section 1: Одежда
Section 2: (пустое)
Section 3: (пустое)
Section 4: (пустое)

Сложная структура (4 уровня):

Section 1: Одежда
Section 2: Женская
Section 3: Футболки
Section 4: Летняя коллекция

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

Name (Название)

Требования:

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

Примеры:

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

Price (Цена)

Формат:

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

Примеры:

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

Article (Артикул)

Формат:

Буквы, цифры, дефисы
До 50 символов
Рекомендуется делать уникальным

Примеры:

✅ SKU-001
✅ TSH-WHT-M
✅ PROD_12345

Product Images (Изображения)

Формат:

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

Примеры:

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

Рекомендуемые сервисы для хостинга изображений:

imgur.com — бесплатный хостинг изображений
vk.com — загрузите в альбом ВКонтакте

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

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

Особенности CSV-файлов

Если вы используете формат CSV, соблюдайте следующие требования:

Кодировка:

Обязательно UTF-8
Это важно для корректного отображения кириллицы

Разделитель:

Используйте точку с запятой: ;

Пример CSV-файла:

ID;Active;Section 1;Name;Price;Article;Description
1;1;Одежда;Футболка белая;1500;TSH-W-M;100% хлопок
2;1;Одежда;Футболка черная;1500;TSH-B-M;100% хлопок
3;0;Одежда;Джинсы синие;3500;JEANS-B;Классические джинсы

Как сохранить CSV в правильной кодировке

В Microsoft Excel:

Нажмите Файл → Сохранить как
Выберите тип файла: CSV UTF-8 (разделитель — запятая)
Если нет варианта UTF-8:
- Сохраните как обычный CSV
- Откройте в Notepad++
- Меню Кодировка → Преобразовать в UTF-8
- Сохраните

В Google Sheets:

Файл → Скачать → Значения, разделенные запятой (.csv)
Откройте файл в текстовом редакторе
Замените запятые на точки с запятой (если требуется)
Сохраните в кодировке UTF-8

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

Шаг 1: Подготовка файла

Скачайте шаблон прайс-листа
Заполните все обязательные столбцы
Добавьте дополнительные поля при необходимости
Проверьте данные на корректность
Сохраните файл

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

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

Шаг 2: Загрузка в Botobot

Путь:

Личный кабинет → Товары → Импорт/Экспорт → Импорт прайс-листа

Действия:

Войдите в личный кабинет Botobot
Перейдите в раздел Товары
Выберите Импорт/Экспорт
Нажмите "Импорт прайс-листа"
Нажмите "Выбрать файл"
Загрузите подготовленный файл
Нажмите "Загрузить"

Шаг 3: Ожидание импорта

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

Время обработки:

Маленькие файлы (до 100 товаров): 1-2 минуты
Средние (100-500): 3-5 минут
Большие (500-1000): 5-10 минут
Очень большие (1000+): 10-20 минут

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

Загрузка файла на сервер
Валидация данных
Создание/обновление товаров
Создание категорий (если нужно)
Загрузка изображений по URL

Можно:

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

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

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

Откройте отчет:
- Успешно импортировано: X товаров
- Ошибки: Y товаров
- Обновлено: Z товаров
Проверьте товары:
- Перейдите в раздел Товары
- Проверьте несколько позиций
- Убедитесь, что категории созданы
- Проверьте цены и описания
Проверьте в боте:
- Откройте Telegram
- Запустите своего бота
- Проверьте отображение товаров

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

Как работает обновление

При повторном импорте:

Система находит товары по полю ID
Если ID существует — товар обновляется
Если ID новый — создается новый товар
Старые данные перезаписываются новыми

Пример:

Первый импорт:

ID: 1
Name: Футболка белая
Price: 1500
Active: 1

Второй импорт (обновление цены):

ID: 1
Name: Футболка белая
Price: 1200  ← обновлено
Active: 1

Результат:

Цена изменилась на 1200
Остальные поля остались без изменений

Массовое обновление цен

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

Шаг 2: Откройте файл в Excel

Шаг 3: Измените цены

Шаг 4: Импортируйте файл обратно

Шаг 5: Товары обновятся по ID

Быстрое обновление

Такой метод удобен для сезонных распродаж, массового изменения цен или обновления остатков.

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

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

Причина: Не заполнено одно из обязательных полей (ID, Active, Section 1, Name, Price)

Решение:

Проверьте все строки файла
Убедитесь, что нет пустых ячеек в обязательных столбцах
Заполните отсутствующие данные

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

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

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

❌ "Дубликат ID"

Строка: 25 ID: 100

Причина: В файле несколько товаров с одинаковым ID

Решение: Сделайте ID уникальными

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

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

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

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

Решение:

Проверьте URL в браузере
Используйте прямые публичные ссылки
Загрузите изображения на imgur.com или vk.com
Проверьте размер изображения (до 10 МБ)

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

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

Решение:

Вариант 1 (Excel):

Откройте файл в Excel
Сохранить как → CSV UTF-8

Вариант 2 (Notepad++):

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

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

Совет 1: Используйте шаблон

Всегда начинайте с официального шаблона — это гарантирует правильную структуру.

Совет 2: Тестовый импорт

Перед загрузкой всего каталога создайте тестовый файл с 3-5 товарами и проверьте результат.

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

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

Генерация ID:

=ROW()-1

Автоматическая активация всех товаров:

=1

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

=ROUND(E2*0.8, 0)  // 20% скидка от цены в E2

Совет 4: Заливка вниз

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

Заполните первую ячейку
Выделите диапазон
Нажмите Ctrl+D (заполнить вниз)

Работа с изображениями

Хостинг на Imgur.com

Шаг 1: Перейдите на imgur.com

Шаг 2: Нажмите "New post"

Шаг 3: Загрузите изображения

Шаг 4: Скопируйте прямую ссылку:

Правый клик на изображение
Копировать адрес изображения

Шаг 5: Вставьте URL в столбец Product Images

Хостинг на VK.com

Шаг 1: Создайте альбом в ВКонтакте

Шаг 2: Загрузите изображения

Шаг 3: Откройте изображение

Шаг 4: Скопируйте URL изображения:

Правый клик
Копировать адрес изображения

Шаг 5: Вставьте в прайс-лист

Несколько изображений

Для добавления нескольких изображений к одному товару:

Формат:

https://imgur.com/image1.jpg,https://imgur.com/image2.jpg,https://imgur.com/image3.jpg

В Excel:

=CONCATENATE(A1,",",B1,",",C1)

Где A1, B1, C1 — ячейки с URL изображений

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

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

2. Единая система ID Разработайте логичную систему ID и придерживайтесь её:

1-999: Одежда
1000-1999: Обувь
2000-2999: Аксессуары

3. Проверка перед импортом Используйте встроенные инструменты Excel для проверки:

Условное форматирование для поиска пустых ячеек
Фильтры для проверки дубликатов ID
Сортировка по категориям

4. Пошаговый импорт Для больших каталогов:

Разбейте на файлы по 200-300 товаров
Импортируйте поэтапно
Проверяйте каждую партию

5. Версионирование файлов Сохраняйте разные версии:

pricelist_2025-01-15.xlsx
pricelist_2025-02-01.xlsx
pricelist_2025-03-10.xlsx

Сравнение с другими форматами

Критерий	Прайс-лист	Excel/CSV	YML
Сложность	Легко	Легко	Средне
Обязательных полей	5	2	Много
Категории	До 4 уровней	Неограниченно	Неограниченно
Варианты товаров	❌	✅	✅
Автообновление	❌	❌	✅
Подходит для	Простые прайсы	Универсальный	Большие каталоги

Что дальше?

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

Проверьте товары в боте — откройте Telegram и проверьте
Добавьте изображения — если не загрузили через URL
Организуйте категории — настройте структуру каталога
Управляйте остатками — отслеживайте наличие

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

Поддержка Botobot:

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

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

Файл прайс-листа (первые 10 строк)
Скриншот ошибки
Описание проблемы

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

Поддерживаемые форматы​

Структура прайс-листа​

Обязательные поля​

Дополнительные поля​

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

ID (Идентификатор)​

Active (Статус)​

Section 1-4 (Категории)​

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

Price (Цена)​

Article (Артикул)​

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

Особенности CSV-файлов​

Как сохранить CSV в правильной кодировке​

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

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

Шаг 2: Загрузка в Botobot​

Шаг 3: Ожидание импорта​

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

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

Как работает обновление​

Массовое обновление цен​

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

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

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

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

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

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

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

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

Хостинг на Imgur.com​

Хостинг на VK.com​

Несколько изображений​

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

Сравнение с другими форматами​

Что дальше?​

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

Поддерживаемые форматы

Структура прайс-листа

Обязательные поля

Дополнительные поля

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

ID (Идентификатор)

Active (Статус)

Section 1-4 (Категории)

Name (Название)

Price (Цена)

Article (Артикул)

Product Images (Изображения)

Особенности CSV-файлов

Как сохранить CSV в правильной кодировке

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

Шаг 1: Подготовка файла

Шаг 2: Загрузка в Botobot

Шаг 3: Ожидание импорта

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

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

Как работает обновление

Массовое обновление цен

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

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

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

❌ "Дубликат ID"

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

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

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

Работа с изображениями

Хостинг на Imgur.com

Хостинг на VK.com

Несколько изображений

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

Сравнение с другими форматами

Что дальше?

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