Імпорт через 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-файл, обов'язково виконайте експорт уже існуючих товарів. Це потрібно для того, щоб ви могли використовувати актуальні ID категорії (category_id), які система привласнила раніше. Без них нові товари можуть бути завантажені з помилками.
📄 Аркуш «Категорії»: як вона працює
При завантаженні файлу на вкладці «Додавання товарів» система обробляє категорії за такими правилами:
Якщо у вашій таблиці вказано category_id, який вже існує в системі, то нічого не відбувається – категорія залишається без змін.
Якщо в таблиці вказано новий
category_id,якого ще немає в системі:Система створить нову категорію.
Замість вашого тимчасового ID буде присвоєно системний ID.
⚠️ Важливо:
Видаляти категорії через Excel не можна.
Перейменувати категорії через Excel не можна. Якщо ви спробуєте змінити назву існуючої категорії, з'явиться помилка: "Редагування категорії на вкладці додавання заборонено".
📦 Аркуш «Товари»: як він працює
У таблиці з товарами ви повинні обов'язково вказати category_id — це ID категорії, до якої належить товар. Цей ID має бути:
або вже існуючим у системі (ви його отримали під час експорту),
або новим, який ви вказуєте на аркуші "Категорії" в поточному файлі.
Якщо category_id:
не знайдено в базі,
і не вказано у поточному файлі,
то такий товар не буде завантажений, і ви отримаєте повідомлення про помилку.
✏️Редагування та видалення товару
Призначено тільки для редагування або видалення уже існуючих товарів в CRM. За допомогою цієї вкладки не можна додавати нові товари.
Як користуватися?
Вивантажте поточний список/об'єм товарів
Натисніть "Скачати" — ви отримаєте таблицю зі всіма категоріями, товарами і їх
product_id
Відредагуйте таблицю з товарами
Ви можете змінити будь-які стовпці таблиці: назва товару, ціна, наявність, опис товарів і т.д.
Щоб приховати товар — залиште стовбець
visibilityпорожнім або вкажіть значення False.Щоб видалити товар — необхідно видалити відповідний рядок із товаром з файлу 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