Регулярный обмен ценами и остатками через YML

Регулярный обмен через YML позволяет автоматически загружать цены и остатки из YML-файла поставщика по ссылке.

SelSup обращается к указанному URL, получает файл, обрабатывает данные и обновляет цены или остатки по товарам.

Такой способ подходит, если поставщик размещает файл с остатками и ценами на сайте или передаёт ссылку на регулярно обновляемый YML-файл.

Перед настройкой обмена через YML рекомендуем проверить общие параметры регулярного обмена: организацию, маркетплейс, периодичность обновления, склад и правила передачи остатков. Подробнее — в статье «Регулярный обмен ценами и остатками: общие настройки».

Как создать обмен через YML

Перейдите в раздел Закупки → Дропшиппинг → Регулярные обмены и нажмите Добавить.

В поле Тип выберите YML.

После этого заполните параметры обмена и укажите ссылку на файл.

Какие данные нужно указать

В поле URL укажите ссылку на YML-файл.

Если сайт поставщика требует авторизацию, дополнительно укажите логин и пароль Basic Auth.

После настройки SelSup будет обращаться к файлу по указанной ссылке и получать из него данные для обновления цен и остатков.

Пример формата YML:

Как SelSup сопоставляет товары

При обработке YML-файла SelSup извлекает из файла артикул или штрих-код и использует его для сопоставления данных поставщика с товарами в SelSup.

Для сопоставления можно использовать:

• артикул товара;
• штрих-код товара;
• другое поле из YML-файла, если оно указано в настройках обработки.

Если данные не сопоставились с товарами в SelSup, цены и остатки по таким товарам обновлены не будут.

Как указывать теги в YML

В настройках YML можно указать теги, из которых SelSup должен брать данные.

Указывать можно теги, которые находятся внутри offer.

Например, если остаток передаётся в теге count, укажите: count

Пример структуры:

<offer>
  <count>5</count>
</offer>

Если тег вложен в другой тег

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

Например, если остаток передаётся так:

<offer>
  <outlets>
    <count>5</count>
  </outlets>
</offer>

В поле с Названием колонки для остатка укажите: outlets/count

В этом случае SelSup возьмёт значение из тега count, который вложен в outlets.

Если значение находится глубже

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

Например:

<offer>
  <count>
    <quantity>5</quantity>
  </count>
</offer>

Для извлечения значения укажите: count/quantity

Если нужно указать условие по атрибуту

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

Например, для тега: <param name="name">value</param>

укажите: param[@name = "name"]

Если нужно проверить только наличие атрибута, укажите: param[@name]

Поле с артикулом

В поле Название колонки с артикулом укажите, откуда SelSup должен брать артикул товара.

По умолчанию используется: offer/@id

Если артикул передаётся в другом теге, можно указать его название, например:

vendorCode или article

Поле со штрих-кодом

В поле Название колонки со штрих-кодом укажите, откуда SelSup должен брать штрих-код товара.

По умолчанию значение берётся из тега: barcode

Если штрих-код передаётся в стандартном теге barcode, поле можно не заполнять.

Поле с остатком

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

По умолчанию используется тег: count

<offer id="123">
  <count>5</count>
</offer>

Можно указать outlet , для использования схемы передачи остатка МегаМаркет, когда внутри тега offer передается тег outlet с остатками по складам

Пример структуры:

<offer id="123">
  <outlets>
    <outlet id="34" instock="5"/>
  </outlets>
</offer>

После настройки

После заполнения параметров нажмите Сохранить.

SelSup будет регулярно обращаться к YML-файлу по указанной ссылке, обрабатывать данные и обновлять цены или остатки по товарам.

Если включена передача данных на маркетплейсы, после обработки файла обновлённые остатки и цены будут передаваться на подключённые площадки.

Если обмен не сработал

Если данные из YML-файла не обновились, проверьте:

• доступна ли ссылка на YML-файл;
• не изменилась ли структура файла;
• корректно ли указаны теги для артикула, штрих-кода, остатка и цены;
• есть ли нужные товары в SelSup;
• совпадают ли артикулы или штрих-коды из файла с данными в карточках товаров;
• указан ли логин и пароль Basic Auth, если файл закрыт авторизацией;
• выбран ли склад для обновления остатков;
• включена ли передача остатков или цен на маркетплейсы, если это необходимо.