Присоединяйтесь!

Выгрузить каталог в формате *.yml

Выгрузить каталог в формате *.yml

С помощью API вы можете выгрузить список позиций из каталога СБИС. В результате запроса вернется ссылка, по которой можно скачать yml-файл с каталогом продукции, чтобы разместить его на сайте вашей организации и использовать для обмена.

Аутентификация

Выполните аутентификацию в СБИС:

Выгрузить каталог

Установите розничную цену товаров и опубликуйте их в СБИС, чтобы выгрузить позиции из каталога СБИС.

Номенклатура берется либо от корня, либо от раздела, заданного фильтром «Folder» («Folder.Code»).

Тип запроса: POST.

Адрес запроса: https://online.sbis.ru/service/.

В заголовке «X-SBISSessionID» передайте «sid» или токен доступа, которые вернулись после аутентификации на сервере.

Параметр
* — обязательный параметр
ТипОписание
Filter*объектФильтр отбора номенклатуры для выгрузки
 FolderобъектРаздел, из которого отбирается номенклатура. По умолчанию не задан, номенклатура берется из корня каталога
 IdцелоеИдентификатор раздела
CodeстрокаКод раздела, из которого будет показана номенклатура. Это поле — первичный ключ для раздела. Номер запишется в фильтр «Folder.Id».
Параметр «Folder.Id» выше «Folder.Code» по приоритету
Filter.NomenclatureобъектФильтр для номенклатурных карточек
 ExcludeстрокаНазвание характеристики. Если параметр для карточки указан, карточка исключается из выгрузки.

Возможные значения:

  • «PROP_НазваниеХарактеристики» — указывает, что «НазваниеХарактеристики» нужно смотреть в обычных характеристиках;
  • «SPROP_НазваниеХарактеристики» — в служебных характеристиках;
  • «Да» — для логических характеристик
Shop*объектЗначения полей должны быть подставлены в одноименные теги
 Name*строкаКраткое название магазина, не более 20 символов.
В названии нельзя использовать слова, не относящиеся к наименованию магазина, например «лучший», «дешевый», указывать телефон и другие параметры.

Название должно совпадать с опубликованным на сайте фактическим названием, иначе Яндекс.Маркет вправе изменить название без уведомления

Company*строкаПолное наименование компании-владельца магазина для внутренней идентификации. На сайте не публикуется
Url*строкаАдрес сайта главной страницы магазина, не более 50 символов. Допускаются кириллические ссылки
PlatformстрокаСистема управления контентом, на которой работает магазин (CMS)
VersionстрокаВерсия CMS
AgencyстрокаНаименование агентства, которое отвечает за техническую поддержку магазина и работу сайта
EmailстрокаКонтактный адрес разработчиков или агенства, которые поддерживают CMS
Category*объектОбъект, который описывает название категории
 FieldстрокаСтрока для определения поля, которое содержит название выгружаемого раздела.

Возможные значения:

  • «PROP_НазваниеХарактеристики» — название смотреть в значении «НазваниеХарактеристики»;
  • «SPROP_НазваниеХарактеристики» — в значении служебной характеристики «НазваниеХарактеристики»

Если параметр пустой или название в результате перебора характеристик не определено, название берется из наименования раздела

Replacementsмассив объектовУпорядоченный массив объектов. Каждый объект состоит из полей:
  • «tmpl» — регулярное выражение для поиска;
  • «repl» — значение, на которое нужно заменить выражение
Offer*объектОбъект, описывающий узел «offer» для товаров
 Url*строкаШаблон адреса для товара на сайте.

Можно указать параметры для замены:

  • «#ID#» — идентификатор номенклатуры («1153812»);
  • «#CODE#» — номенклатурный номер товара («MacBookAir13_i5_1hz_8gb»);
  • «#CATEGORY_ID#» — идентификатор раздела-родителя;
  • «#CATEGORY_CODE#» — номенклатурный номер раздела-родителя;
  • «#PATH_ID#» — путь от корня или папки Folder, состоящий из идентификаторов категорий («3345/2354235/23452345/»);
  • «#PATH_CODE#» — путь от корня или папки Folder, состоящий из номенклатурных номеров категорий («Computers/Apple/MacBook/»)
NameобъектОписывает правила для формирования названия товара в предложении
 TmplстрокаШаблон названия товара для маркета.

Можно указать параметры для замены:

  • «#NAME#» — название товара;
  • «#SHORT_NAME#» — короткое наименование товара;
  • «#PROP_Названиехарактеристики#» — значение характеристики «НазваниеХарактеристики»;
  • «#SPROP_Названиехарактеристики#» — значение служебной характеристики «НазваниеХарактеристики»

Если параметр пуст или название в результате замен не определено, название берется из наименования товара

Replacementsмассив объектовУпорядоченный массив объектов. Каждый объект состоит из полей:
  • «tmpl» — регулярное выражение для поиска;
  • «Replacement » — значение, на которое нужно заменить выражение
VendorстрокаСтрока для определения поля, которое содержит название производителя.

Возможные значения:

  • «PROP_НазваниеХарактеристики» — название смотреть в значении «НазваниеХарактеристики»;
  • «SPROP_НазваниеХарактеристики» — в значении служебной характеристики «НазваниеХарактеристики»

Если параметр пустой или название в результате перебора характеристик не определено, название берется из характеристики «Производитель»

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

Возможные значения:

  • true — доставка курьером;
  • false — только самовывоз;
  • «PROP_НазваниеХарактеристики» — название смотреть в значении «НазваниеХарактеристики»;
  • «SPROP_НазваниеХарактеристики» — в значении служебной характеристики «НазваниеХарактеристики»
PickupстрокаУказывается признак, по которому определяется возможность самовывоза из точки продаж, либо значение характеристики из карточки товара.

Возможные значения:

  • true — доставка курьером;
  • false — только самовывоз;
  • «PROP_НазваниеХарактеристики» — название смотреть в значении «НазваниеХарактеристики»;
  • «SPROP_НазваниеХарактеристики» — в значении служебной характеристики «НазваниеХарактеристики»
StoreстрокаУказывается признак, по которому определяется возможность самовывоза из магазина, либо значение характеристики из карточки товара.

Возможные значения:

  • true — доставка курьером;
  • false — только самовывоз;
  • «PROP_НазваниеХарактеристики» — название смотреть в значении «НазваниеХарактеристики»;
  • «SPROP_НазваниеХарактеристики» — в значении служебной характеристики «НазваниеХарактеристики»
DescriptionстрокаШаблон для формирования описания предложения.

Возможные значения:

  • «#DESCRIPTION#» — описание из карточки номенклатуры;
  • «#PROP_НазваниеХарактеристики#» — описание нужно смотреть в значении «НазваниеХарактеристики»;
  • «#SPROP_НазваниеХарактеристики#» — описание нужно смотреть в значении служебной характеристики «НазваниеХарактеристики»
SaleNotesстрокаКонкретное значение для тега условий продаж или характеристики для его заполнения.

Возможные значения:

  • «текст с условием продажи»;
  • «PROP_НазваниеХарактеристики» — значение смотреть в «НазваниеХарактеристики»;
  • «SPROP_НазваниеХарактеристики» — в служебной характеристике «НазваниеХарактеристики»
MinQuantityстрокаКонкретное значение для тега минимального заказа или характеристики для его заполнения.

Возможные значения:

  • «текст с условием заказа»;
  • «PROP_НазваниеХарактеристики» — значение смотреть в значении «НазваниеХарактеристики»;
  • «SPROP_НазваниеХарактеристики» — в служебной характеристике «НазваниеХарактеристики»
ManufacturerWarrantyстрокаНазвание характеристики, по которой определяется наличие гарантии или само значение.

Возможные значения:

  • true — есть гарантия;
  • false — нет гарантии;
  • «PROP_НазваниеХарактеристики» — значение смотреть в значении «НазваниеХарактеристики»;
  • «SPROP_НазваниеХарактеристики» — в служебной характеристике «НазваниеХарактеристики»

Результат

Ссылка для неавторизованного скачивания сгенерированного yml-файла в поле «result».

Комментарий

  1. В зависимости от типа значения характеристик считаются как:
    • логические — «Да»/«Нет»/Пусто;
    • списочные — перечисление выбранных значений через запятую («,»).
  2. Для логических тегов yml-файла значение false определяют:
    • логические характеристики — если указано отрицательное значение;
    • текстовые и списочные характеристики — если значение «Нет» (без учета регистра);
    • числовые характеристики — значение «0».
  3. В итоговый выходной yml-файл пустые теги не попадают.
  4. Файлы для разных витрин-агрегаторов могут генерироваться одновременно.
  5. Для названия характеристики из блока «Описание» в карточке номенклатуры используется префикс «PROP_».

Пример запроса

Пример ответа

Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.