# Импорт из XML /YML Товары можно массово добавлять и обновлять через импорт. В панели администратора нажмите раздел "импорт" и загрузите файл с товарами, произведите необходимые настройки и дождитесь завершения импорта. Возможности импорта: 1. Максимальный размер загружаемого файла — 20 мегабайт; 2. Файл может быть загружен с диска компьютера 3. Процесс импорта может занимать длительное время. Средняя скорость первичного добавления — 1000 товаров в час. Последующие обновления остатков и цен проходят гораздо быстрее. ### Требования к содержимому файла Чтобы ваши товары импортировались в систему корректно, советуем загружать фид, заполненный точно по нашему шаблону: {% file src="/files/Gqbern82lYIC7uWc2jWX" %} Что означают теги (параметры), и что будет, если их пропустить? Ознакомьтесь со списком тегов ниже, Все остальные теги, которые будут присутствовать в вашем фиде, система будет игнорировать. {% hint style="info" %} Важно: Данные о товарах, которые не меняются от обновления к обновлению — например, ваш SKU или название товара, — всегда указывайте без изменений. Обновление информации о товаре происходит по его ID, если при последующем импорте ID товара будет изменен или будет использован для импорта другого товара, то он задублируется или перезапишет товар. {% endhint %} **id -** идентификатор товара или категории **(обязательный)** Идентификатор товара в вашей системе. Если вы еще не использовали идентификатор — создайте его прямо во время добавления товара. Всегда должен быть уникальным. В случае пропуска ID товара, товар не сможет быть идентифицирован. Импорт товара завершится с ошибкой "Товары должны иметь атрибут "ID". В случае пропуска ID категории, товары не смогут ссылкать на данную категорию. **offer** - предложение (SKU), **(обязательный)** | Требования | Представление в XML | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

Последовательность любых символов.

Рекомендуем использовать тут значение, которое используется вами для синхронизации по внешнему идентификатору с внешними системами (Например, МойСклад) для упрощения синхронизации по остаткам/ценам с ними.

|

Атрибут id элемента \
\

\

| **group\_id** - объединение предложений в один товар **(необязательный)** | Требования | Представление в XML | | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Необязательное поле. Используется только для товаров с разными вариациями для объединения их в одну карточку |

Атрибут id элемента \ внутри элемента \

\

\

| **сategory** - наименование категории **(необязательный)** **parentId** - родительская (корневая) категория, к которой относятся подкатегории **(необязательный)** **categoryId -** категория к которой вы относите товар **(необязательный)** | Требования | Представление в XML | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

Необходимо указывать, если в вашем каталоге есть категории.

Один товар не может быть сразу в нескольких категориях.

Указывайте конкретные категории — например, Платья лучше отнести к категории Платья, а не просто Женская одежда.

|

\
\Название родительской категории\
\название подкатегории\

<сategory id="191118">Женская одежда\
<сategory id="1" parentId="191118">Платья\

| **name -** название товара, которое увидят ваши клиенты в карточке товара **(обязательный)** | Требования | Представление в XML | | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | До 30 символов. Для каждого варианта товара (SKU) может быть задано свое название товара |

Элемент \ внутри элемента \

\Платье Sun\

| **price** - цена продажи товара **(обязательный)** Цена одной единицы товара, включая все налоги. | Требования | Представление в XML | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

Цена указывается в рублях. Число должно быть целым.
Пример: 3500

Для каждого варианта товара (SKU) может быть задана своя цена

В случае пропуска, импорт завершится с ошибкой «Для товаров не указана цена»

|

Элемент \ внутри элемента \
\

\3500\

| **picture** - изображение товара **(необязательный)**\ \ До 10 изображений на один вариант товара (SKU) | Требования | Представление в XML | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

Принимаются jpg-, png-, jpeg- и webp-изображения товара, соответствующие требованиям: рекомендуемое разрешение 1080×1440.
Соотношение сторон: 3×4

Тегов может быть до 10 для одной вариации товара (SKU)

В случае пропуска, в карточке товара будет отображаться фото-заглушка. При необходимости фото можно будет загрузить через панель управления TGShop вручную

|

Элементы \ внутри элемента \

\...
\\
\\

| **vendorCode** - артикул товара **(необязательный)** | Требовования | Представление в XML | | ------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | Необязательный элемент, в случае загрузки товаров без артикула система сгенериует их самостоятельно. Могут быть одинаковыми для вариантов товара. |

элемент \ внутри элемента \

\AE897917\

| **oldprice** - зачеркнутая цена в карточке товара, цена до скидки **(необязательно)** | Требования | Представление в XML | | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | |

Цена указывается в рублях. Число должно быть целым.
Пример: 4999

|

элемент \ внутри элемента \

\4999\

| **description -** описание товара, которое отображается в карточке **(обязательный)** | Требования | Представление в XML | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | |

До 5000 символов. Для каждой SKU (offer id) может быть задано свое описание.

В случае пропуска импорт завершится с ошибкой «Заполните описание товара в теге description»

|

элемент \ внутри элемента \

\Комбинированное платье представлено в новой коллекции итальянской марки VIA TORRIANI 88. Сочетание двух материалов добавляет модели особого шика. Принт в полоску является особенностью модели. Специфика кроя обеспечит отличную посадку на любой тип силуэта\

| **shortDescription -** краткое описание товара **(необязательный)** | Требования | Представление в XML | | ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

До 200 символов

Необязательное поле. В случае пропуска будет использоваться полное описание.

|

элемент \ внутри элемента \

\Платье на каждый день\

| **quantityInStock -** количество товара (SKU) в наличии | Требования | Представление в XML | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | Если у варианта товара (SKU) значение указано 0, то такой товар будет отображаться в карточке товара, но не будет доступен к покупке. Если у товара нет вариантов, то такой товар не будет отображаться в магазине, но будет отображаться в панели управления после импорта. |

элемент \ внутри элемента \

\497\

| **param -** дополнительные параметры товара, при помощи которых вы можете создавать дополнительные характеристики для товара: цвет, размер, объем, запах, состав, страна производства, бренд и так далее. | Требования | Представление в XML | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

При помощи этого тэга вы можете задавать название и значение характеристик товара.

Рекомендуемое количество характеристик (вариантов товара) на которые разделяется товар - 2.

Количество вариантов товара не ограничено.

При помощи атрибута type "primary" - вы сможете задать варианты товара (характеристики, на которые будет делиться товар), а при помощи type "secondary" - добавить характеристики товара, будет отображаться в описании и использоваться для фильтров (в будущем).

Для настройки сортировки расположения товара в каталоге (какие товары показывать в каталоге первыми) используйте \

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

|

элемент \ с атрибутами name и type внутри элемента \

\желтый\

\S (42 RUS)\
\100% хлопок\
\100\



| **dimensions -** габариты товара в формате Ш/Г/В (ширина, глубина, высота) **(необязательный)** | Требования | Представление в XML | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | Значения должны быть в сантиметрах, допустимы целые и десятичные числа. Для десятичных используется точка. Разделителем является символ “/” - слэш. Любые другие разделители недопустимы. Все три значения должны быть заполнены. |

элемент \ внутри элемента \

\10/11/12\

| **weight** - вес товара **(необязательный)** | Требования | Представление в XML | | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | Значения должны быть в килограммах, допустимы целые и десятичные числа. Для десятичных используется точка. |

элемент \ внутри элемента \


\0.5\

| **sizeChart** - размерная сетка, инструкции по эксплуатации, схемы сборки и т. д **(необязательный)** | Требования | Представление в XML | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

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

Можно задать отдельную ссылку и название для каждого варианта товара (SKU). Название можно не передавать, по умолчанию будет называться "Размерная сетка".

Для того, чтобы инструкция открывалась нативно без перехода на сторонние ресурсы и не уводила клиента из карточки товара и вашего магазина, мы рекомендуем размещать ссылку на инструкцию через сервис

|

элемент \ внутри элемента \


\\

Для того, чтобы передать свое название для кнопки используйте атрибут name

\\

| **НДС -** значение ставки НДС для товара. | Требования | Представление в XML | | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------- | | Значения должны быть целым числом. |

Элемент \ внутри элемента \.

\VAT\_20\


| ### Процедура импорта 1. Перейдите в раздел "импорт товаров" и нажмите кнопку "импорт" 2. Выберите "импорт из файла" 3. В появившемся модальном окне выберите файл для импорта в формате xml/yml 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-xml-yml.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.