> For the complete documentation index, see [llms.txt](https://support.morozovpimnev.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.morozovpimnev.ru/megaimport/dobavlenie-importa/vkladka-osnovnye/tip-faila.md).

# Тип файла

## <mark style="background-color:green;">CSV</mark>

<div data-full-width="true"><figure><img src="/files/IFSrsSFM1Wo9LReaD6uz" alt=""><figcaption><p>Настройки CSV</p></figcaption></figure></div>

* ***Кодировка*** *-* Выберите кодировку файла. Если кодировка не соответствует UTF-8, то для корректного импорта файла необходимо создать активную константу ALT\_SITE\_LOCALE, которая должна содержать альтернативную локаль. Например, если импорт ведется из CSV-файла в кодировке Windows-1251, то указанная константа должна иметь в своем значении наименование локали для этой кодировки, чаще всего это ru\_RU.CP1251.
* ***Разделитель** - р*азделитель для столбцов (например: Запятая, Точка с запятой при сохранении из Microsoft Excel® и др), укажите символ разделителя в поле
* ***Ограничитель** -* ограничитель для полей (например: Кавычки и др), укажите символ ограничителя
* ***Кол-во проп. строк** - число указывающее сколько нужно пропустить строк сверху (например если сверху есть название полей)*

### Настройка полей импорта

При настройке полей для импорта вы должны сопоставить номер столбца в файле с полем в которое выгружать (в файле столбец **А** → в админке **Название товара \[name]**), для вашего удобства порядок лучше соблюдать, но это не обязательно, пустые столбцы можно пропускать

* номер столбца в файле, диапазон от А до AZ
* Поле в которое будут записываться данные из столбца, стандартные поля товара и его доп. свойства (выбор поля идет автокомплитом, по названию и его названию из таблицы базы, так же по ID и XML тегу для доп. свойств)
* Поле для родителського товара (mod\_id - рекомендуем, marking, guid, name)
* Домен к image - укажите если в файле путь к изображениям не указан
* <img src="/files/rQfNR1ekC9iTk0aGSsuH" alt="" data-size="line">параметр обновления данных выбранного поля для уже существующих товаров, если вкл. то будет обновлять (например можно включить чтобы обновлял только остатки и цены, а название и описание не перезаписывал)
* ![](/files/VyLlxgcR2pR3wZ2cddzT) поставьте галочку если загружаете модификации и нужно из них создать род. товар, тогда текущие данные будут загружаться для родительского товара

## <mark style="background-color:yellow;">XLS/XLSX</mark>

<div data-full-width="true"><figure><img src="/files/Tn6Uwb8JLtHwnOYgmlqj" alt=""><figcaption><p>Настройки XLS/XLSX</p></figcaption></figure></div>

* ***Кол-во проп. строк** - число указывающее сколько нужно пропустить строк сверху (например если сверху есть название полей)*
* ***Номер листа** - в Excel файле может находится несколько листов с данными, можно указать какой именно загружать (от 1 до 99) или загружать все (-1)*

### Настройка полей импорта

При настройке полей для импорта вы должны сопоставить номер столбца в файле с полем в которое выгружать (в файле столбец **А** → в админке **Название товара \[name]**), для вашего удобства порядок лучше соблюдать, но это не обязательно, пустые столбцы можно пропускать

* номер столбца в файле, диапазон от А до AZ
* Поле в которое будут записываться данные из столбца, стандартные поля товара и его доп. свойства (выбор поля идет автокомплитом, по названию и его названию из таблицы базы, так же по ID и XML тегу для доп. свойств)
* Поле для родителського товара (mod\_id - рекомендуем, marking, guid, name)
* Домен к image - укажите если в файле путь к изображениям не указан
* <img src="/files/rQfNR1ekC9iTk0aGSsuH" alt="" data-size="line">параметр обновления данных выбранного поля для уже существующих товаров, если вкл. то будет обновлять (например можно включить чтобы обновлял только остатки и цены, а название и описание не перезаписывал)
* ![](/files/VyLlxgcR2pR3wZ2cddzT) поставьте галочку если загружаете модификации и нужно из них создать род. товар, тогда текущие данные будут загружаться для родительского товара

## <mark style="background-color:red;">XML</mark>

<div data-full-width="true"><figure><img src="/files/ARfBuBjgq55khTJ7T9hI" alt=""><figcaption><p>Настройки XML</p></figcaption></figure></div>

* ***Загружать группы*** - загружать группы из файла
* ***Путь до групп***&#xB2; - `xpath` *путь до тега групп (например* `shop/categories/category`*)*
* ***Путь до товаров***&#xB2; *-* `xpath` *путь до тега товара (например* `shop/offers/offer`*)*
* ***Путь до модификаций***&#xB2; *-* `xpath` *путь до тега внутри товара (например* `variant`*)*
* ***Путь названия свойства***&#xB2; *-* `xpath` *название тега (по умолчанию* `@name`*)*
* ***Путь значения свойства***&#xB2; *-* `xpath` *название тега (по умолчанию пусто)*

{% hint style="info" %}
²XPath реализовывает навигацию по DOM в XML [подробнее](https://ru.wikipedia.org/wiki/XPath)
{% endhint %}

### Настройка полей импорта

При настройке полей для импорта вы должны сопоставить XML тэг в файле с полем в которое выгружать (тег в файле`name` → в админке **Название товара \[name]**), для вашего удобства порядок лучше соблюдать, но это не обязательно

* xpath пути тега из XML (например `name`)
* Поле в которое будут записываться данные из столбца, стандартные поля товара и его доп. свойства (выбор поля идет автокомплитом, по названию и его названию из таблицы базы, так же по ID и XML тегу для доп. свойств)
* Поле для родителського товара (mod\_id - рекомендуем, marking, guid, name)
* Домен к image - укажите если в файле путь к изображениям не указан
* <img src="/files/rQfNR1ekC9iTk0aGSsuH" alt="" data-size="line">параметр обновления данных выбранного поля для уже существующих товаров, если вкл. то будет обновлять (например можно включить чтобы обновлял только остатки и цены, а название и описание не перезаписывал)
* ![](/files/VyLlxgcR2pR3wZ2cddzT) поставьте галочку если загружаете модификации и нужно из них создать род. товар, тогда текущие данные будут загружаться для родительского товара

## <mark style="background-color:blue;">HTML</mark>

<div data-full-width="true"><figure><img src="/files/bQaTg7yDj8kVcPbAKHze" alt=""><figcaption><p>Настройки HTML</p></figcaption></figure></div>

* **Путь к ссылкам на товары**²  - `xpath`, например `//a[@class = 'product-item' and @href]/@href)`
* **Маска пагинации** - например `?page=%d`
* **Путь к номеру последней страницы**² - `xpath`, например `//ul[@class = 'pagination']/a[position() = last()]/text())`
* **Путь названия свойства**² - `xpath`, например `//*[@class = 'name']/text())`
* **Путь значения свойства**² - `xpath`, например `//*[@class = 'value']/text())`

{% hint style="info" %}
²XPath реализовывает навигацию по DOM в HTML [подробнее](https://habr.com/ru/articles/753332/)
{% endhint %}

### Настройка полей импорта

При настройке полей для импорта вы должны сопоставить данные html с полем в которое выгружать (данные тэга `//h1/text()` → в админке **Название товара \[name]**), для вашего удобства порядок лучше соблюдать, но это не обязательно

* xpath пути тега из XML (например `//h1/text()`)
* Поле в которое будут записываться данные из столбца, стандартные поля товара и его доп. свойства (выбор поля идет автокомплитом, по названию и его названию из таблицы базы, так же по ID и XML тегу для доп. свойств)
* Поле для родителського товара (mod\_id - рекомендуем, marking, guid, name)
* Домен к image - укажите если в файле путь к изображениям не указан
* <img src="/files/rQfNR1ekC9iTk0aGSsuH" alt="" data-size="line">параметр обновления данных выбранного поля для уже существующих товаров, если вкл. то будет обновлять (например можно включить чтобы обновлял только остатки и цены, а название и описание не перезаписывал)
* ![](/files/VyLlxgcR2pR3wZ2cddzT) поставьте галочку если загружаете модификации и нужно из них создать род. товар, тогда текущие данные будут загружаться для родительского товара

## v2 XLS/XLSX

скоро ...

## CommerceML

скоро ...


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://support.morozovpimnev.ru/megaimport/dobavlenie-importa/vkladka-osnovnye/tip-faila.md?ask=<question>
```

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.
