С помощью 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 | строка | Название характеристики. Если параметр для карточки указан, карточка исключается из выгрузки. Возможные значения:
| |||
Shop* | объект | Значения полей должны быть подставлены в одноименные теги | |||
Name* | строка | Краткое название магазина, не более 20 символов. В названии нельзя использовать слова, не относящиеся к наименованию магазина, например «лучший», «дешевый», указывать телефон и другие параметры. Название должно совпадать с опубликованным на сайте фактическим названием, иначе Яндекс.Маркет вправе изменить название без уведомления | |||
Company* | строка | Полное наименование компании-владельца магазина для внутренней идентификации. На сайте не публикуется | |||
Url* | строка | Адрес сайта главной страницы магазина, не более 50 символов. Допускаются кириллические ссылки | |||
Platform | строка | Система управления контентом, на которой работает магазин (CMS) | |||
Version | строка | Версия CMS | |||
Agency | строка | Наименование агентства, которое отвечает за техническую поддержку магазина и работу сайта | |||
строка | Контактный адрес разработчиков или агенства, которые поддерживают CMS | ||||
Category* | объект | Объект, который описывает название категории | |||
Field | строка | Строка для определения поля, которое содержит название выгружаемого раздела. Возможные значения:
Если параметр пустой или название в результате перебора характеристик не определено, название берется из наименования раздела | |||
Replacements | массив объектов | Упорядоченный массив объектов. Каждый объект состоит из полей:
| |||
Offer* | объект | Объект, описывающий узел «offer» для товаров | |||
Url* | строка | Шаблон адреса для товара на сайте. Можно указать параметры для замены:
| |||
Name | объект | Описывает правила для формирования названия товара в предложении | |||
Tmpl | строка | Шаблон названия товара для маркета. Можно указать параметры для замены:
Если параметр пуст или название в результате замен не определено, название берется из наименования товара | |||
Replacements | массив объектов | Упорядоченный массив объектов. Каждый объект состоит из полей:
| |||
Vendor | строка | Строка для определения поля, которое содержит название производителя. Возможные значения:
Если параметр пустой или название в результате перебора характеристик не определено, название берется из характеристики «Производитель» | |||
Delivery | строка | Указывается признак, по которому определяется возможность самовывоза, либо значение характеристики из карточки товара. Возможные значения:
| |||
Pickup | строка | Указывается признак, по которому определяется возможность самовывоза из точки продаж, либо значение характеристики из карточки товара. Возможные значения:
| |||
Store | строка | Указывается признак, по которому определяется возможность самовывоза из магазина, либо значение характеристики из карточки товара. Возможные значения:
| |||
Description | строка | Шаблон для формирования описания предложения. Возможные значения:
| |||
SaleNotes | строка | Конкретное значение для тега условий продаж или характеристики для его заполнения. Возможные значения:
| |||
MinQuantity | строка | Конкретное значение для тега минимального заказа или характеристики для его заполнения. Возможные значения:
| |||
ManufacturerWarranty | строка | Название характеристики, по которой определяется наличие гарантии или само значение. Возможные значения:
|
Результат
Ссылка для неавторизованного скачивания сгенерированного yml-файла в поле «result».
Комментарий
- В зависимости от типа значения характеристик считаются как:
- логические — «Да»/«Нет»/Пусто;
- списочные — перечисление выбранных значений через запятую («,»).
- Для логических тегов yml-файла значение false определяют:
- логические характеристики — если указано отрицательное значение;
- текстовые и списочные характеристики — если значение «Нет» (без учета регистра);
- числовые характеристики — значение «0».
- В итоговый выходной yml-файл пустые теги не попадают.
- Файлы для разных витрин-агрегаторов могут генерироваться одновременно.
- Для названия характеристики из блока «Описание» в карточке номенклатуры используется префикс «PROP_».