Импорт товаров xls

#255

Раздел в админ-панели: Каталог → Импорт товаров.

Что это

Мастер массового добавления и обновления товаров из Excel-файла. Заменяет ручной ввод по одному в Каталог → Товары, когда фирма заводит новую коллекцию плит, обновляет прайс производителя или подключает себе сотни новых позиций сразу. Файл может содержать сотни и тысячи строк.

Доступ: открыт администратору корневой фирмы (с правом импортировать «от имени» любой выбранной фирмы) и обычным фирмам с заполненными контактами (телефон + email) — без контактов импорт закрыт, чтобы было кого позвать при проблемах с большой загрузкой.

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

Только Excel: .xlsx или .xls. Один файл за импорт. Кодировка — стандартная Excel, разделители колонок система определяет сама.

Шаги мастера

Шаг 1. Загрузка файла

  • Выбор фирмы (только администратор корневой; обычная фирма импортирует только в себя). Импортируемые товары будут привязаны к выбранной фирме.
  • Скачать пример файла — кнопка генерации эталонного Excel со всеми правильными колонками. Каждый заголовок содержит комментарий с описанием поля — пользуйтесь, чтобы понять что куда. В самом файле-примере есть второй лист «Описание полей» — подробный справочник по каждому полю; при загрузке обрабатывается только первый лист, остальные (включая этот) игнорируются и не мешают импорту.
  • Загрузить файл — выбираете свой .xlsx и нажимаете «Загрузить».

Также на этом шаге видна формула формирования имени товара:

[код декора] [структура] [тип скругления] [радиус] [влагостойкий] [имя декора] [имя производителя] [X] [Y] [Z]

Тип скругления столешницы принимает значения 1U, 2U, 1L, 2L (варианты профиля торца), 1ABS (торец с одной продольной стороны закрыт ABS-кромкой), 2ABS (торец с двух сторон закрыт ABS-кромкой) или XX (без скругления). Радиус скругления — один из: R1, R1.5, R3, R3.3, R5.5, R6, R9, R13 (в мм).

Имя собирается автоматически из соответствующих колонок Excel — не нужно вручную составлять каждое название. Это даёт единообразие: товары одной коллекции получают одинаковый формат имени, отличаются только размерами и характеристиками. Если тип и радиус скругления уже присутствуют в коде или названии декора, система вырезает их оттуда сама — чтобы название не задваивалось, — и формирует итоговое имя сразу на всех языках каталога.

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

Шаг 2. Сопоставление колонок (маппинг)

Excel редко выглядит точно так, как требует система: у разных производителей колонки названы по-разному и расположены в разном порядке. На этом шаге вы говорите системе, где в файле какое поле.

  • Превью файла — раскрывающаяся таблица с содержимым: первые строки видны сразу, можно посмотреть, какая колонка содержит что.
  • Строка заголовков — номер строки, где находятся названия колонок (часто 1, но не всегда — у некоторых производителей есть несколько строк шапки).
  • Диапазон импорта — с какой строки начать («Данные с строки») и по какую закончить («По строку»). Это позволяет пропустить итоговые строки в конце или служебные комментарии в начале.
  • Сопоставление полей — для каждого поля системы выберите соответствующую колонку Excel (или «не использовать», если в файле такого нет).
  • Влагостойкость — необязательное поле, значение пусто или 1. Если указано 1, к названию товара на всех языках каталога автоматически добавляется приписка «Влагостойкий», а при сопоставлении дубликатов (шаг 3) влагостойкий и обычный материал считаются разными позициями. Колонку система умеет находить по ключевым словам (влагостойкость, влага, waterproof, moisture и похожим).
  • Удобные горячие клавиши в превью: клик по строке = начальная строка импорта, Shift+клик = конечная, Ctrl+клик = строка заголовков. Помогает не вбивать номера вручную на больших файлах.
  • Единица продажи — поле принимает несколько форматов записи: по площади (м2, m2 или соответствующий цифровой код) — материал считается и продаётся по квадратным метрам, либо листами (sheet или соответствующий цифровой код) — материал продаётся целыми листами. Регистр и точное написание не важны. В форме редактирования товара единицу также можно выбрать из выпадающего списка.
  • Обязательные поля подсвечиваются — если их не сопоставить, кнопка «Продолжить» заблокирована.
  • Проверка габаритов по типу материала — для каждого типа материала заданы допустимые пределы по ширине, длине и толщине; если размеры позиции выходят за рамки, строка подсвечивается предупреждением с указанием допустимого диапазона. В таблице результатов импорта виден столбец «Тип материала» — понятно, к какому типу отнесена каждая позиция.
  • Валидация на лету — если в данных есть очевидные ошибки (пустые обязательные поля, неверные числа в размерах), они показываются с указанием номеров строк.
  • Проверка названий и кодов — недопустимые символы (кавычки, скобки, спецсимволы) в коде декора, названии декора, структуре или дополнительном названии показываются отдельной ошибкой со списком найденных символов. Смешивать кириллицу и латиницу в названии декора нельзя — например, латинскую C вместо кириллической С система распознаёт и подсказывает, каким символом её заменить, с указанием позиции и кода символа.

Шаг 3. Сопоставление дубликатов (matching)

Самый умный шаг. Система сравнивает каждую строку из Excel с уже существующими товарами выбранной фирмы и предлагает три сценария на каждую строку:

Сравнение учитывает не только код декора, но и тип материала и структуру: если в Excel указан тип материала, который не совпадает с типом уже существующего товара, это считается разными позициями, и чужая карточка не подставляется. Так же и со структурой — если у существующего товара она задана, а в прайсе нет, это тоже разные товары.

  • Новый товар — такого артикула ещё нет, создать с нуля.
  • Обновить существующий — артикул уже есть, обновить характеристики/цены/картинки. Видно, какие поля будут изменены. Свойства товара (код декора, название, структура, параметры скругления) перезаписываются только если включена галочка «обновить данные» — без неё повторная загрузка прайса не затирает вручную выверенные карточки, обновление просто фиксируется как пропущенное.
  • Пропустить — не трогать существующий товар, не создавать новый.

Для каждой строки виден preview сравнения: текущее значение в системе ↔ новое значение из Excel. Можно поменять решение «новый/обновить/пропустить» по строкам перед запуском импорта.

Если у товара заданы псевдонимы (внутренние обозначения вашей фирмы), они видны прямо в процессе импорта — на этом шаге сопоставления, при редактировании строки и в итоговых результатах. Отображаются только псевдонимы вашей фирмы — чужие обозначения не подмешиваются.

Шаг 4. Обработка картинок

Если в Excel есть колонка с URL картинок (Google Drive, прямые ссылки), система отдельно обрабатывает изображения:

  • Загрузка по URL — система скачивает картинку и сохраняет в каталог.
  • Сравнение размеров — если у товара уже есть картинка, новая загружается только если она больше (выше разрешение). Низкокачественная картинка не заменит хорошую.
  • Предпросмотр перед заменой — видны обе картинки рядом, помечено что произойдёт: «будет заменена (новая больше)» или «не будет обновлена (текущая больше)».
  • Распространённые проблемы:
    • Google Drive: файл должен быть публичным, иначе ссылка не работает.
    • Локальные пути (C:\photos\...) — не работают, нужны полноценные URL.
    • Ссылки, требующие авторизации, — пропускаются с пометкой.

Шаг 5. Результат

Итоговый отчёт: сколько строк создано, сколько обновлено, сколько пропущено, сколько с ошибками. Ошибки показываются построчно — можно поправить Excel и импортировать заново только проблемные строки.

История импортов

Все запущенные импорты сохраняются с датой, фирмой, именем файла и пользователем, который запустил. Администратор корневой фирмы видит все импорты всех фирм; обычная фирма — только свои. Можно открыть карточку прошлого импорта, чтобы посмотреть, что и когда заливалось — полезно при разборах «откуда вдруг появились эти 200 товаров».

Что важно

  • Скачайте пример перед первым импортом. В нём комментарии в заголовках объясняют каждое поле — это в разы быстрее, чем угадывать.
  • Имя товара не указывается вручную. Заполните отдельные поля (код декора, имя декора, имя производителя, размеры) — система соберёт имя по формуле сама. Это гарантирует единообразие.
  • Производитель должен существовать до импорта (см. Производители). Если в Excel указан производитель, которого нет в справочнике, строка попадёт в ошибки.
  • Сначала пробуйте на 10 строках, потом на полном файле. Маппинг колонок и проверка дубликатов часто требуют 2–3 итерации, чтобы поймать все тонкости вашего конкретного прайса.
  • Картинки лучше готовить заранее: разместите на Google Drive с публичным доступом, поставьте ссылки в соответствующую колонку Excel. После импорта они подтянутся.
  • Вид товара (кромка или плита) система определяет по типу материала в справочнике, а не по тексту названия — кромка распознаётся как кромка на любом языке названия. Если тип помечен как плитный, но габариты явно кромочные (малая ширина и толщина), позиция автоматически переопределяется в кромку; у кромок буквенный суффикс кода декора при этом переносится в поле «Структура», но только если оно ещё не заполнено.
  • Если результат шага 3 (matching) показал много «обновлений» там, где должны быть «новые» — у вас, скорее всего, неверно сопоставлен код производителя. Вернитесь на шаг 2 и проверьте маппинг колонки «код».
  • Если контакты вашей фирмы пустые (телефон или email) — импорт заблокирован. Заполните их сначала в карточке фирмы.