# Импорт из XLS/XLSX
Товары можно массово добавлять и обновлять через импорт. В панели администратора нажмите раздел "импорт" и загрузите файл с товарами, произведите необходимые настройки и дождитесь завершения импорта.
Возможности импорта:
1. Максимальный размер загружаемого файла — 20 мегабайт;
2. Файл может быть загружен с диска компьютера
3. Процесс импорта может занимать длительное время. Средняя скорость первичного добавления — 1000 товаров в час. Последующие обновления остатков и цен проходят гораздо быстрее.
### Требования к файлу
Строки — это позиции товара или его вариантов, а столбцы — это атрибуты товара (наименование, артикул, ID товара, варианты товара, характеристики). Один столбец — один атрибут.
Файл состоит из двух листов:
1. Категории - служит для того, чтобы создать дерево категорий любой сложности с родительскими категориями (корневыми) и подкатегориями - необязателен к заполнению.
2. Товары - служит для того, чтобы заполнить всю информацию о товарах и добавления их в категории каталога - обязателен к заполнению.
{% hint style="info" %}
Файл необходимо заполнять строго в соответствии с шаблоном, не меняя названия столбцов и их порядок, нельзя добавлять свои столбцы или удалять существующие в шаблоне. Файл не должен содержать пустых строк.
{% endhint %}
### Требования к содержимому файла
{% hint style="info" %}
Скопируйте [шаблон](https://docs.google.com/spreadsheets/d/1J6if4IUGWp0lQLYGY6USmA1OUsmT94zTqaPE3GzohGI/edit?usp=sharing) из гугл-таблицы, заполните его там или скачайте шаблон ниже и заполните его по примеру.
{% endhint %}
{% file src="/files/jzn4ncHAy1p9w5nZBpSX" %}
1. **ID корневой -** идентификатор родительской категории, может быть любое числовое значение, оставьте столбец пустым если вам не требуется данная опция.
2. **ID подкатегории -** идентификатор подкатегории, может быть любое числовое значение, чтобы добавить категорию в подкатегорию - укажите ID корневой (родительской) категории. Оставьте столбец пустым, если вам не требуется данная опция.
3. **Название категории -** название категории, которая будет отображаться в вашем магазине, оставьте столбец пустым, если вам не требуется данная опция.
4. **ID категории** - идентификатор категории, к которой нужно отнести товар, если вы создаете дерево категорий с подкатегориями - чтобы товар отображался во всех категориях ветки, укажите ID подкатегории, которая является последней в дереве категорий. Например, при создании ветки Одежда - Мужская одежда - Кроссовки, товар "Кроссовки" необходимо указать ID категории "Кроссовки". Оставьте столбец пустым, если вам не требуется данная опция.
5. **ID группы** - идентификатор для объединения вариантов товара в одну карточку, ID группы должен совпадать для всех вариантов товара, чтобы система объединила их в карточку. Оставьте столбец пустым, если у товара нет вариантов.
6. **ID товара** - внешний идентификатор товара (SKU) для синхронизации с внешними системами учета и CRM-системами (например, МойСклад) и последующего обновления товара при импорте из эксель. Идентификатор должен быть уникальным для каждого варианта товара (SKU). Столбец обязателен к заполнению.
7. **Название товара** - название варианта товара (SKU), для каждого варианта товара может быть свое название, до 30 символов
8. **Цена продажи** - стоимость товара для покупателей, любое числовое значение. Обязательно к заполнению.
9. **Изображение** - изображение товара, должно быть прямой ссылкой на товар с сайта, маркетплейса, я.диска, гугл.диска или бесплатных сервисов Wampi, Yapics и др. Если фото у товаров несколько, то ссылки на фото добавляются через запятую без пробелов. До 10 фото на вариант товара (SKU).
10. **Артикул** - идентификатор товара, обязательно к заполнению.
11. **Старая цена** - стоимость товара до уценки, будет отображаться в карточке товара зачеркнутой. Если данная опция не требуется, оставьте столбец пустым.
12. **Полное описание** - описание товара, которое будет отображаться в карточке при раскрытии подробностей о товара. До 5000 символов. Обязательно к заполнению.
13. **Краткое описание** - краткое описание товара, которое будет отображаться в карточке товара. До 200 символов. Обязательно к заполнению.
14. **Остаток** - количество товара (SKU) в наличии, если у варианта товара (SKU) значение указано 0, то такой товар будет отображаться в карточке товара, но не будет доступен к покупке. Если у товара нет вариантов, то такой товар не будет отображаться в магазине, но будет отображаться в панели управления после импорта. Необязательно к заполнению.
15. **Варианты товара** - свойства (вариант) товара, на которые можно разделить товар. Например, цвет и размер, объем и запах. Может быть до 2-х вариантов для 1-го товара. Для настройки вариантов товара, необходимо заполнять столбец Варианты товара в формате “Название варианта|значение варианта”. Например, “Цвет|Желтый”. Названия вариантов могут быть любыми. Например, объем и запах. Значения вариантов могут быть любыми. Для того, чтобы задать несколько вариантов для товара заполните столбец Варианты товара в формате “Название варианта1|Значение варианта1;Название варианта2|Значение варианта2”. Например, “Цвет|Желтый;Размер|S”. Где “цвет” - название варианта 1, “желтый” - значение варианта 1, а “размер” - название варианта 2, “S” - значение варианта 2. Для разделения названия варианта и его значения использовать символ “|”. Для разделения нескольких вариантов нужно использовать символ “;” - точка с запятой. Использование других символов недопустимо. Необязательно к заполнению.
16. **Характеристики** - другие свойства товара, например, бренд, или страна производитель, технические особенности товара, которые не будут использоваться для разделения товара на варианты, но будут добавлены в полное описание к каждому товару. В будущем будут использоваться для фильтров товаров в каталоге.
17. **Приоритет** - параметр для настройки отображения товаров в каталоге, где товары с параметром 100 будут отображаться в самом верху каталога, а товары с параметром - 1 в самом низу. Необязательно к заполнению.
18. **Габариты (Ш/Г/В) (см)** - габариты указываются как Ш/Г/В (ширина, глубина, высота). Значения должны быть в сантиметрах, допустимы целые и десятичные числа. Для десятичных чисел используется точка. Разделителем является символ "/" (слэш). Любые другие разделители недопустимы. Все три значения должны быть заполнены. Используются для более точной калькуляции стоимости доставки. Необязательно к заполнению.
19. **Вес (кг)** - вес товара. Значения должны быть в килограммах, допустимы целые и десятичные числа. Для десятичных используется точка. Если были заданы габариты, то обязательно к заполнению.
20. **Размерная сетка** - параметр, который нужно заполнить в формате “”. Где “” - ссылка на статью в сервисе telegra.ph. Отвечает за создание кнопки внутри карточки товара со ссылкой на инструкцию. По умолчанию кнопка будет называться “размерная сетка”. Если вы хотите изменить ее название, то нужно заполнить столбец в формате “Название кнопки|”.\
\
Где “название кнопки” - значение для кнопки в карточке товара, а “” - ссылка на статью в сервисе telegra.ph. Для отображения любой дополнительной информации о товаре внутри мини-приложения. Необязательно к заполнению.
### Процедура импорта
1. Перейдите в раздел "импорт товаров" и нажмите кнопку "импорт"
2. Выберите "импорт из файла"
3. В появившемся модальном окне выберите файл для импорта в формате xls/xlsx
4. Настройте условия для импорта: что делать если в файле нет SKU (варианта товара), что делать если в новом файле нет товаров ранее загруженных, а также настройка добавления новых товаров при импорте.
**Что делать, если SKU (варианта товара) пропал из файла:** \
**а. Ничего не делать -** при импорте файла система будет игнорировать изменения внутри товара и не будет обновлять SKU (вариант товара), отсутствующие в новом файле.
**б. Удалить -** при импорте файла система удалит все SKU (вариант товара), отсутствующие в новом файле и оставит в товаре только те, SKU (вариант товара), которые есть в новом файле.
{% hint style="info" %}
**Важно:** используйте этот вариант, если вам нужно массово удалить определенные SKU (варианты товара) из карточки товара не удаляя товар целиком.
{% endhint %}
**Что делать, если товар пропал из файла:**
**а. Ничего не делать -** при импорте файла система не будет удалять товары в системе, отсутствующие в новом файле.
**б. Удалить -** при импорте файла система удалит все товары в системе, отсутствующие в новом файле.
**в. Скрыть -** при импорта файла система скроет все товары в системе, отсутствующие в новом файле.
{% hint style="info" %}
**Важно:** используйте этот вариант, если вам нужно массово удалить из TGShop все или какие-то определенные товары
{% endhint %}
**Настройка добавления новых товаров -** по умолчанию система всегда импортирует новые товары из файла. Уберите "галочку", если вы хотите запретить импорт новых товаров, например, чтобы обновить только существующие товары.
5. Нажмите "продолжить" для перехода к настройкам импорта, по умолчанию стоят базовые настройки, проверьте - подходят ли они для текущего импорта. При помощи данных настроек вы можете защитить определенные атрибуты товаров от изменений. Подробнее о настройках импорта [читайте в инструкции. ](/osnovnye-nastroiki/import-eksport-tovarov/nastroiki-importa-iz-xls-xlsx-xml-yml.md)
6. После проверки настроек, нажмите "импортировать"
7. Дождитесь окончания импорта
8. При успешной загрузке всех товаров, в отчетах вы сможете увидеть следующую информацию:
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.tgshop.io/osnovnye-nastroiki/import-eksport-tovarov/import-iz-xls-xlsx.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.