Перейти к основному содержимому

Настройка 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-тегах​

Данные находятся в XML-тегах

Укажите тег, в котором содержатся отдельные товарные позиции.

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

offer

Если данные находятся в атрибутах​

Данные находятся в атрибутах

Укажите тег, атрибуты которого содержат данные товарной позиции.

Например, если позиции находятся в теге product, укажите:

product

4. Поля прайс-листа​

Если данные находятся в XML-тегах​

Укажите теги, в которых содержатся данные каждой товарной позиции:

  • бренд;
  • артикул;
  • описание;
  • цена;
  • наличие;
  • другие необходимые поля.

Поля XML-прайс-листа

Если в 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.
warning

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

Чтобы исключить только позиции с наличием, равным нулю, используйте:

^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$
warning

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

7. Дополнительные настройки​

Автоматическое определение структуры​

Позволяет системе автоматически переопределять настройки прайс-листа при изменении структуры YML-файла.

Настройка включена по умолчанию.

Отключите её, если структура YML-файла не меняется, но система регулярно пытается изменить сопоставление полей и не может определить его автоматически.

Выбор лучшего предложения​

Если в YML-файле несколько предложений содержат один и тот же бренд и артикул, настройка определяет, какую позицию загружать.

Доступны следующие варианты:

  • Первая позиция;
  • Минимальная цена;
  • Максимальное наличие;
  • Максимальная цена;
  • Не использовать.

Разделитель описания​

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

8. Конфигурация состояния товара​

Состояние по умолчанию​

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

Укажите состояние для позиций, в которых значение отсутствует в YML-файле.

Разделитель ссылок на изображения​

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

Правила замены состояний​

Настройка обязательна при загрузке товаров с состоянием «Б/У», если в YML-файле есть поле с состоянием.

Например:

Следы установки → Удовлетворительное

Правила замены состояний товаров

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