Импорт через EXCEL файл (добавление/редактирование/удаление товаров)
Слева, в боковом меню платформы CRM выберите опцию “Каталог”, а затем – “Импорт и экспорт”. В блоке "Способ добавления товаров" выберите EXCEL, формат файла должен быть XLSX. С шаблоном импортного файла можно ознакомиться на странице “Импорт и экспорт товаров”.
Страница содержит 3 вкладки:
Добавление товара – для новых товаров;
Редактирование и удаление товара – чтобы изменить или удалить существующие товары;
Экспорт — получение файла с текущими товарами.
➕ Добавление товара
Предназначено только для загрузки новых товаров в магазин.
Как пользоваться?
Скачайте шаблон
Нажмите кнопку "Скачать шаблонный пример EXCEL".
Заполните таблицу своими товарами
Загруженный файл с таблицей уже содержит все нужные столбцы и подсказки внутри ячеек. Каждый столбец подписан – следуйте примерам в файле.
Не удаляйте и не переименовывайте названия столбцов.
Столбец product_id можно оставить пустым. Он нужен только для связей с другими системами или для сопутствующих/рекомендуемых товаров (recommended_products).
Загрузите в CRM файл эксель с вашими товарами
Нажмите кнопку «Загрузить».
Формат файла: .xlsx, до 20 МБ.
⚠️Важно⚠️
Не удаляйте и не переименовывайте столбцы таблицы.
Любой товар должен обязательно относиться к конкретной категории (в файле Excel – вкладка Categories).
Значение
category_idможно указывать рандомно для отдельных категорий.
🛒 Как добавить товары в полностью пустой магазин
Если ваш магазин ещё не содержит ни одного товара или категории, вы можете самостоятельно задать любые ID категорий в Excel-файле. Эти ID могут быть любым числом, главное — чтобы они были уникальными внутри файла.
📄 Лист «Категории»: создание с нуля
На этапе первой загрузки:
В колонке
category_idвы придумываете любые уникальные значения — например:1001В колонке
parent_idвы можете указать другойcategory_idиз этой же таблицы — это создаст вложенные категории.
🧠 Важно: вам не нужно знать настоящие ID из системы — они будут автоматически созданы и подставлены системой при первой загрузке.
После загрузки:
Все
category_id, которые вы указали, будут заменены на системные ID.Связи между категориями будут сохранены на основе ваших
category_idиparent_id.
📦 Лист «Товары»: как ссылаться на новые категории
При добавлении товаров:
В колонке
category_idвы указываете тот же ID, который вы придумали на листе «Категории».Система поймёт, к какой категории принадлежит товар, и свяжет его с правильной категорией после присвоения системных ID.
🧩 Как работает загрузка товаров с вариациями и фотографиями
При загрузке товаров через Excel важно понимать, как система обрабатывает вариации, фотографии и цену.
🔹 Общие правила для группы товаров с вариациями
Название и описание товара берутся из первой строки группы (то есть первой строки с этим товаром).
Цена указывается для вариации ( потому что может быть разная стоимость товара ) ➝ Цена из первой строки автоматически сохраняется как цена основного товара, и для вариации.
🔹 Если у вас товар без вариаций:
Вы можете указать до 10 фото в строке товара.
Ссылки на фото указываются через
;в одной ячейке.Первая ссылка фото станет главным фото в карточке товара.
🔹 Если вы хотите указать отдельные фото для вариации:
Для вариации можно указать до 5 фото.
В этом случае:
Первое фото станет главным фото вариации.
Остальные — дополнительные фото для этой вариации.
Если фото в строке вариации не указаны — система использует первое фото из основной строки товара.
🧩 Как правильно добавлять товары, если у вас уже есть товары в системе
Перед тем как добавить новые товары через Excel-файл, обязательно выполните экспорт уже существующих товаров. Это нужно для того, чтобы вы могли использовать актуальные ID категорий (category_id), которые система присвоила ранее. Без них новые товары могут быть загружены с ошибками.
📄 Лист «Категории»: как он работает
При загрузке файла на вкладке «Добавление товаров» система обрабатывает категории по таким правилам:
Если в вашей таблице указан category_id, который уже существует в системе, то ничего не происходит — категория остаётся без изменений.
Если в таблице указан новый category_id, которого ещё нет в системе:
Система создаст новую категорию.
Вместо вашего временного ID будет присвоен системный ID.
⚠️ Важно:
Удалять категории через вкладку добавление Excel нельзя. Удалять категории можно только с вкладки редактирование
Переименовывать категории через Excel нельзя. Если вы попытаетесь изменить название существующей категории, появится ошибка: «Редактирование категории на вкладке добавления запрещено».
📦 Лист «Товары»: как он работает
В таблице с товарами вы обязательно должны указать category_id — это ID категории, к которой принадлежит товар.
Этот ID должен быть:
либо уже существующим в системе (вы его получили при экспорте),
либо новым, который вы указываете на листе «Категории» в текущем файле.
Если category_id:
не найден в базе,
и не указан в текущем файле,
то такой товар не будет загружен, и вы получите сообщение об ошибке.
✏️ Редактирование и удаление товара
Предназначено только для редактирования или удаления существующих товаров в CRM. С помощью этой вкладки нельзя добавлять новые товары.
Как пользоваться?
Выгрузите текущий список/объем товаров
Нажмите "Скачать" - вы получите таблицу со всеми категориями, товарами и их
product_id
Отредактируйте таблицу с товарами
Вы можете изменить столбцы таблицы: название товара, цена, наличие, описание товаров и т.д.
Чтобы скрыть товар, оставьте столбец
visibilityпустым или укажите значение " - ".Чтобы удалить товар, необходимо удалить соответствующую строку с товаром из файла Excel.
Загрузите уже отредактированный файл (таблицу) в CRM
Нажмите кнопку «Загрузить».
Нажмите “Начать редактирование товаров”
⚠️Важно ⚠️
Не удаляйте и не переименовывайте столбцы таблицы.
Не изменяйте
product_idсамостоятельно вручную – в противном случае изменения к товарам не применятся.Любой товар должен обязательно относиться к конкретной категории (в файле Excel – вкладка Categories).
Не изменяйте значение в столбце
category_id.Удалить категорию нельзя, если она содержит товары. Но если в категории отсутствуют товары, достаточно удалить строку с соответствующей категорией из файла.
↗️Экспорт
Предназначено только для выгрузки из CRM файла, содержащего список текущих товаров.
Как пользоваться?
Выгрузите текущий список/объем товаров
Нажмите "Скачать файл" – вы получите таблицу со всеми товарами и категориями.
Файл экспорта будет сохранен на вашем устройстве
Имя файла "tgmall_текущая дата".
📑 Описание полей таблицы
сategory_id
Уникальный идентификатор категории. Используется системой связи с другими категориями и товарами.
Да
5775
Товар не будет прикреплен к категории. Товар не будет создан.
parent_id
ID родительской категории.
Нет
5774
Категория с пустым parent_id считается главной.
name_categories
Название категории отображается на сайте.
Да
Джинсы
Категория не будет создана; товары прикрепленные к этой категории не будут созданы.
group_id
ID группы товаров (используется для вариаций).
Все товары с одним group_id считаются вариациями одного товара.
Нет
10284
Вариации не будут соединены.
product_id
Уникальный ID товара в системе. Используется для редактирования.
Указывать
product_idнужно обязательно, если вы хотите настроить рекомендованные товарыПри создании нового товара вы указываете рандомный product_id или оставляете пустой столбец (мы заменим его на наш системный id.)
Нет
10284
Товар будет создан, значение product_id будет заменено на наш системный ID.
vendorCode
Артикул – внутренний код товара. Может содержать только цифры, латинские буквы и символы "-_." . Допустимое количество символов для артикула 2–19
Нет
65208323
Товар будет создан; артикул будет сгенерирован системой автоматически.
name_product
Название товара.
1-100 символов
Да
Джины Regular Fit мужские
Товар не будет создан.
description
Описание продукта.
Можно использовать форматирование текста HTML
1-10000 симв
Да
Стильные классические джинсы прямого кроя
Товар не будет создан.
product_type
Тип товара - может содержать только 3 значения:
physical - физический товар
digital_all - цифровой товар, по типу = один товар для всех
digital_individual – цифровой товар, по типу = каждому отдельный товар.
Да
physical
digital_all
digital_individual
Товар не будет создан.
digital_sales
Значения в этих ячейках будут отправлены покупателю после оплаты цифрового товара.
Для physical – оставляйте пустым.
Для digital_all – заполняете как угодно.
Для digital_individual – все значения товара заполняются через ";"
Нет - для physical товаров
Да - для digital_all иdigital_individual товаров
ключ доступа 1; ключ доступа 2
Для physical - товар будет создан.
Для digital_all или digital_individual — товар не будет создан.
unit_of_measurement
Единица измерения продукта.
Да
шт, л, кг и др..
Будет автоматически использована единица измерения "шт."
quantity_step
Шаг добавления товара. Определяет, насколько увеличивается количество товара при добавлении в корзину. Минимальный шаг равняется 0,1. Для десятичных значений разделитель "," или "."
Нет
0,1
Будет применен шаг добавления товара, равный "1"
price
Цена товара. Указывайте значение без валюты.
Да
1 399,00
Товар не будет создан.
price_with_discount
Цена с учетом скидки. Выступает в качестве новой цены продукта.
в таком кейсе старая цена из столбика "Price" будет зачеркнута
Нет
1 300,00
Товар будет создан с ценой без скидки.
discount_percent
Процент скидки от основной цены (price).
Укажите значение числом без знака "%"
Нет
12
Товар будет создан с ценой без скидки.
picture
Ссылка на изображение продукта. Первое фото является основным изображением. Загружать можно до 10 ссылок. Каждая новая ссылка на изображение разделяется знаком "";""
Нет
Товар будет создан без изображений.
video
Ссылка на видеообзор товара на Youtube
ссылка только формата YouTube
Нет
-
Товар будет создан без видеообзора на товар.
product_quantity
Количество товара в наличии
Нет
25
Товар будет создан со значением к-ва – бесконечный.
product_tag
Метки позволяют эффективно сегментировать аудиторию и настраивать рассылки. Например, присваивая товару метку, вы автоматически добавляете клиентам совершившим покупку. Это облегчает поиск необходимой аудитории в базе и позволяет предлагать релевантные продукты или услуги.
Каждая новая метка делится знаком ";" . Если товар с вариациями, добавляйте метки только к первой вариации
Нет
Premium
Товар будет создан, не будет содержать метки.
product_keywords
Ключевые слова для поиска. Каждое новое слово разделяется пробелом.
Если товар с вариациями, добавляйте ключевые слова только к первой вариации
Нет
штаны джинс джинсы мужские
Товар будет создан без ключевых слов (товар будет хуже находиться в каталоге покупателями).
main_variation
Название главной вариации товара (разновидностей товара)
*Примечание: Если вы хотите задать для товара цвет и чтобы в магазине отображались цветные метки, укажите точное название вариации hex_color. Значения цвета для этих параметров указываются в колонке hex_color_value Если вы не хотите использовать цветовые метки, просто напишите имя параметра, например: цвет, color, окрас, и они будут отображаться как обычный текст."
Нет
Цвет
Товар будет создан без вариаций.
variation_display_type
Тип отображения вариации: выпадающим списком или плашкой.
Нет
dropdown
chips
Товар будет создан со значением chips.
parameter_value
Название параметра для вариации
Нет
красный, черный.
S, M, L
пакет, коробка
Товар будет создан без вариаций (разновидностей).
hex_color_value
Используется только по main_variation = hex_color. В других случаях поле не используется.
Цвет продукта в формате HEX. Используется для отображения цветовых меток внутри магазина.
Указывается как код с решеткой.
Ниже вы найдете таблицу с самыми популярными цветами и их HEX-кодами – просто скопируйте нужный.
Нет
#FF0000
Цветная метка для товара будет белой по умолчанию. Вы можете изменить ее вручную при редактировании товара в CRM.
first_secondary_variation
Название первой дополнительной вариации
Нет
Размер
Товар будет создан без вариаций (разновидностей).
second_secondary_variation
Название второй дополнительной вариации
Нет
Упаковка
Товар будет создан без вариаций (разновидностей).
recommended_products
В этом блоке можно настроить рекомендации для вашего покупателя. В карточке конкретного товара магазин предложит пользователю дополнительные товары, которые вы добавите в этот блок.
Добавьте значение product_id рекомендуемых товаров через знак "";"" до 5 штук.
Если у вас рекомендуемый товар имеет вариации, то добавляете его любой product_id.
Привязка к рекомендуемым товарам происходит именно к основному товару, не к вариации.
Нет
10392;10388;10384
Товар будет создан без рекомендуемых (сопутствующих) товаров.
visibility
Отображение товара в магазине. Может содержать только следующие 2 значения:
+ – товар отображается,
- – товар скрыт.
Можно также оставить ячейку пустой.
Нет
+
-
Товар будет создан и скрыт от пользователей.
HEX-цвета
Черный
#000000
Белый
#FFFFFF
Серый
#808080
Серебристый
#C0C0C0
Бежевый
#F5F5DC
Коричневый
#8B4513
Бордовый
#800000
Красный
#FF0000
Темно-синий
#000080
Синий
#1E90FF
Голубой
#00BFFF
Фиолетовый
#800080
Жёлтый
#FFFF00
Золотой
#FFD700
Оранжевый
#FFA500
Розовый
#FFC0CB
Пудровый
#E3C6C6
Лавандовый
#E6E6FA
Мятный
#98FF98
Оливковый
#808000
Хаки
#BDB76B
Тёмно-серый
#2F4F4F
Space Gray
#1A1A1A
Titanium
#7E7E7E
Graphite
#2E2E2E
Песочный
#D2B48C
Слоновая кость
#FFFFF0
Шампань
#F7E7CE
Лайм
#BFFF00
Небесно-голубой
#87CEEB
Персиковый
#FFE5B4
Last updated