Настройка XML- и YML-прайс-листа
В этой инструкции описана загрузка прайс-листов в форматах XML и YML.
После выбора типа файла «XML» необходимо указать, является ли файл YML-фидом для Яндекс Маркета:
- Да — файл будет обработан как YML-фид Яндекс Маркета.
- Нет — файл будет обработан как обычный прайс-лист в формате XML.
Дальнейшие настройки зависят от выбранного варианта.
XML-прайс-лист
1. Настройка параметров файла
В поле «Тип файла» выберите значение «XML».
В параметре «YML для Яндекс Маркета» выберите «Нет».
2. Настройка структуры прайс-листа
Выберите, в каком виде представлены данные о товарах в XML-файле:
- В XML-тегах — данные каждого товара находятся в отдельных дочерних тегах.
- В атрибутах — данные товара находятся в атрибутах определённого тега.
Данные в XML-тегах
В этом варианте данные товара находятся во вложенных элементах.
Пример:
<article>
<brandNumber>01089</brandNumber>
<brand>FEBI</brand>
<quantity>5</quantity>
<description>Антифриз</description>
</article>
Данные в атрибутах
В этом варианте данные товара находятся в атрибутах элемента.
Пример:
<article
brandNumber="01089"
brand="FEBI"
quantity="5"
description="Антифриз"
/>
3. Расположение товарных позиций
Если данные находятся в XML-тегах

Укажите тег, в котором содержатся отдельные товарные позиции.
Например, если позиции находятся в теге offer, укажите:
offer
Если данные находятся в атрибутах

Укажите тег, атрибуты которого содержат данные товарной позиции.
Например, если позиции находятся в теге product, укажите:
product
4. Поля прайс-листа
Если данные находятся в XML-тегах
Укажите теги, в которых содержатся данные каждой товарной позиции:
- бренд;
- артикул;
- описание;
- цена;
- наличие;
- другие необходимые поля.

Если в XML-файле нет тега с наличием, задайте общее наличие для всех позиций в разделе «Конфигурация наличия».
Если данные находятся в атрибутах
После указания тега товарной позиции настройте поля прайс-листа, указав атрибуты, содержащие:
- бренд;
- артикул;
- описание;
- цену;
- наличие;
- другие необходимые данные.

5. Конфигурация брендов прайс-листа
Эта настройка выполняется так же, как для других типов прайс-листов.
Бренд по умолчанию
Укажите бренд, который будет применён ко всем товарам прайс-листа.
Эта настройка используется для монобрендовых прайс-листов, в которых нет отдельного поля с брендом.
Соответствие брендов
Настройка позволяет сопоставить названия брендов из прайс-листа с эталонными брендами платформы.
Например, если вместо BMW в прайс-листе указано BNW, настройте соответствие:
BNW → BMW
В левом поле укажите значение точно так, как оно записано в прайс-листе, включая регистр, пробелы и другие символы. В правом поле выберите эталонный бренд из выпадающего списка.
Для каждого ошибочно указанного бренда необходимо настроить отдельное соответствие.
Список эталонных брендов платформы.
Копирование соответствий брендов
Позволяет скопировать соответствия брендов из текущего поставщика в другого поставщика.
Укажите ID или название поставщика, в который необходимо скопировать настройки.
6. Правила для артикулов и описаний
Для правил замены и удаления поддерживаются регулярные выражения в формате RE2.
Правила замены в артикулах
Позволяют заменить артикул из прайс-листа на новое значение.
Пример:
12345 → A-12345
Правила удаления части артикула
Позволяют удалить часть артикула.
Пример:
12345-ABC → 12345
Правила замены в описаниях
Позволяют заменить описание товара на новое.
Пример:
Замена → Хорошая замена
Правила удаления части описания
Позволяют удалить часть описания товара.
Пример:
Хорошая замена → замена
7. Конфигурация цен
Десятичный разделитель
Выберите разделитель, используемый в ценах прайс-листа:
- точка:
100.65; - запятая:
100,65.
Для корректной обработки рекомендуется использовать режим «Автоматический».
Допустимый диапазон цен
Настройка позволяет отфильтровать цены, загружаемые из прайс-листа:
- Цена от — минимальное значение цены;
- Цена до — максимальное значение цены.
Например:
Цена от = 300
Цена до = 100 000
В этом случае система загрузит товары с ценой от 300 до 100 000 рублей.
8. Конфигурация наличия
Наличие по умолчанию
Позволяет указать наличие для позиций, у которых значение отсутствует в поле «Наличие».
Если задано значение по умолчанию, поле «Наличие» необходимо выбрать в настройках полей, даже если оно остаётся пустым.
Определить наличие для всех позиций
Позволяет задать единое значение наличия для всех позиций прайс-листа.
При этом значение наличия из файла использоваться не будет.
Соответствие значений наличия
Позволяет заменить значения наличия из прайс-листа на заданные значения.
Формат настройки:
Значение в прайс-листе → Новое значение
Новое значение может быть положительным числом.
Также поддерживаются специальные значения:
| Значение | Отображение на сайте |
|---|---|
-10 | Под заказ |
-3 | +++ |
-2 | ++ |
-1 | + |
9. Фильтрация прайс-листа
Исключение позиций с пустыми полями
Позволяет исключить позиции, в которых выбранные поля не заполнены.
Например, если выбрать поле «Сертификат ЕАЭС», будут загружены только позиции, у которых в этом поле указано значение.
Фильтрация по условию
Позволяет включать или исключать позиции по заданному условию.
Поддерживаются регулярные выражения в формате RE2.
Примеры:
- если указать
Бренд = ABC, будут загружены только позиции брендаABC; - если указать
Наличие ≠ 20, будут загружены все позиции, кроме позиций с наличием20.
Если заданное значение не совпадает полностью, система может интерпретировать его как регулярное выражение и найти строки, в которых это значение встречается как часть текста.
Чтобы исключить только позиции с наличием, равным нулю, используйте:
^0$
Чтобы загрузить только бренд LS, используйте:
^LS$
Без символов начала и конца строки значение LS также может совпасть с брендами STELS и Bilstein.
10. Дополнительные настройки
Конвертер прайс-листа
Настройка доступна только для файлов формата Excel.
Обычно менять её не требуется. Используйте альтернативный конвертер, если стандартный обработчик не может корректно обработать прайс-лист.
Если первая колонка файла .xls или .xlsx полностью пустая:
- конвертер «Альтернативный» пропустит эту колонку;
- конфигурацию нужно задавать так, как будто пустой колонки нет;
- конвертер «Стандартный» пустую колонку не пропустит.
Автоматическое определение структуры
Позволяет системе автоматически переопределять структуру прайс-листа, например при изменении расположения колонок.
Настройка включена по умолчанию.
Отключите её, если структура файла не меняется, но система регулярно пытается изменить сопоставление колонок и не может определить его автоматически.
Выбор лучшего предложения
Если в прайс-листе несколько строк содержат один и тот же бренд и артикул, настройка определяет, какую позицию загружать.
Доступны следующие варианты:
- Первая позиция — загружается первая найденная строка.
- Минимальная цена — выбирается строка с минимальной ценой.
- Максимальное наличие — выбирается строка с максимальным наличием.
- Максимальная цена — выбирается строка с максимальной ценой.
- Не использовать — загружаются все одинаковые позиции.
Вариант «Не использовать» доступен, если в настройках колонок выбрана колонка «Код от поставщика» или «Изображение».
Разделитель описания
Позволяет выбрать разделитель между частями описания, если описание загружается из нескольких колонок.
11. Конфигурация состояния товара
Состояние по умолчанию
Настройка обязательна при загрузке товаров с состоянием «Б/У».
Укажите состояние для позиций, в которых значение отсутствует в поле «Состояние».
Разделитель ссылок на изображения
Укажите разделитель, используемый между несколькими ссылками на изображения одного товара с состоянием «Б/У».
Правила замены состояний
Настройка обязательна при загрузке товаров с состоянием «Б/У», если в прайс-листе есть поле «Состояние».
Создайте соответствия между значениями из прайс-листа и системными состояниями.
Например:
Следы установки → Удовлетворительное

Подробнее о загрузке товаров с состоянием «Б/У» см. в отдельной инструкции.
YML-фид для Яндекс Маркета
1. Настройка параметров файла
Выберите тип файла «XML».
В параметре «YML для Яндекс Маркета» выберите «Да».
В этом режиме система самостоятельно определяет структуру YML-фида, поэтому первоначальная настройка выполняется проще.
Требования к YML-файлу
Для корректной загрузки в каждом элементе <offer> должны присутствовать:
- атрибут
available; - тег
<price>; - тег
<vendor>; - тег
<vendorCode>.
Пример структуры:
<offers>
<offer available="true">
<price>Цена</price>
<vendor>Бренд</vendor>
<vendorCode>Каталожный номер</vendorCode>
</offer>
</offers>
2. Конфигурация брендов прайс-листа
Игнорировать бренд из файла
Если все товары в YML-файле относятся к одному бренду, выберите значение «Да».
После этого система не будет использовать бренд из файла. Укажите общий бренд в поле «Бренд по умолчанию».
Бренд по умолчанию
Укажите бренд, который будет применён ко всем товарам прайс-листа.
Эта настройка используется для монобрендового YML-файла.
Соответствие брендов
Настройка позволяет сопоставить названия брендов из YML-файла с эталонными брендами платформы.
Например:
BNW → BMW
В левом поле укажите значение точно так, как оно записано в файле. В правом поле выберите эталонный бренд из выпадающего списка.
Для каждого ошибочно указанного бренда необходимо настроить отдельное соответствие.
Список эталонных брендов платформы.
Копирование соответствий брендов
Позволяет скопировать соответствия брендов из текущего поставщика в другого поставщика.
Укажите ID или название поставщика, в который необходимо скопировать настройки.
3. Правила для артикулов и описаний
Настройки правил замены и удаления для артикулов и описаний выполняются так же, как для обычного XML-прайс-листа.
Для правил поддерживаются регулярные выражения в формате RE2.
Правила замены в артикулах
12345 → A-12345
Правила удаления части артикула
12345-ABC → 12345
Правила замены в описаниях
Замена → Хорошая замена
Правила удаления части описания
Хорошая замена → замена
4. Конфигурация цен
Десятичный разделитель
Выберите разделитель, используемый в ценах:
- точка:
100.65; - запятая:
100,65.
Для корректной обработки рекомендуется использовать режим «Автоматический».
Допустимый диапазон цен
Настройка позволяет отфильтровать цены, загружаемые из YML-файла:
- Цена от — минимальное значение цены;
- Цена до — максимальное значение цены.
5. Конфигурация наличия
Определить наличие для всех позиций
Позволяет задать единое значение наличия для всех позиций YML-файла.
При этом значение атрибута available и другие данные о наличии из файла использоваться не будут.
6. Фильтрация прайс-листа
Исключение позиций с пустыми полями
Позволяет исключить позиции, в которых выбранные поля не заполнены.
Фильтрация по условию
Позволяет включать или исключать позиции по заданному условию.
Поддерживаются регулярные выражения в формате RE2.
Примеры:
Бренд = ABC— загружаются только позиции брендаABC;Наличие ≠ 20— загружаются все позиции, кроме позиций с наличием20.
Для строгого соответствия используйте:
^0$
или:
^LS$
Если заданное значение не совпадает полностью, система может интерпретировать его как регулярное выражение и найти значения, в которых заданная строка встречается как часть текста.
7. Дополнительные настройки
Автоматическое определение структуры
Позволяет системе автоматически переопределять настройки прайс-листа при изменении структуры YML-файла.
Настройка включена по умолчанию.
Отключите её, если структура YML-файла не меняется, но система регулярно пытается изменить сопоставление полей и не может определить его автоматически.
Выбор лучшего предложения
Если в YML-файле несколько предложений содержат один и тот же бренд и артикул, настройка определяет, какую позицию загружать.
Доступны следующие варианты:
- Первая позиция;
- Минимальная цена;
- Максимальное наличие;
- Максимальная цена;
- Не использовать.
Разделитель описания
Позволяет выбрать разделитель между частями описания, если описание загружается из нескольких полей.
8. Конфигурация состояния товара
Состояние по умолчанию
Настройка обязательна при загрузке товаров с состоянием «Б/У».
Укажите состояние для позиций, в которых значение отсутствует в YML-файле.
Разделитель ссылок на изображения
Укажите разделитель между несколькими ссылками на изображения одного товара с состоянием «Б/У».
Правила замены состояний
Настройка обязательна при загрузке товаров с состоянием «Б/У», если в YML-файле есть поле с состоянием.
Например:
Следы установки → Удовлетворительное

Подробнее о загрузке товаров с состоянием «Б/У» см. в отдельной инструкции.