Получить список блюд по API в Presto для доставки

Запрос возвращает информацию о блюдах:

из прайс-листа или колонки цен — если передан идентификатор в параметре priceListId;
из каталога — если идентификатор не указан.

Ограничения

Максимальное количество записей на странице — 25. Чтобы получить остальные, используйте постраничную или курсовую навигацию;
количество товаров внутри каталога — не более 1 000. Чтобы получить остальные, используйте курсовую навигацию;
максимальная вложенность элементов — 3 уровня, например «Папка/Папка/Номенклатура».

Структура запроса

Метод запроса: GET

Адрес запроса: https://api.sbis.ru/retail/v2/nomenclature/list?

Параметр	Тип	Описание
pointId	integer	идентификатор точки продаж, который вернулся в результате запроса «Получить точку продаж». Обязателен, если в запросе используется параметр priceListId
priceListId	integer	идентификатор прайс-листа или колонки цен. Идентификатор возвращается в результате запроса «Получить прайс-лист»
noStopList	boolean	параметр исключает позиции, которые есть в стоп-листе
withBalance	boolean	признак передачи остатков товаров. Возможные значения: true — передается остаток по складу точки продаж в параметре balance, false — не передается
withBarcode	boolean	признак передачи штрихкодов товара. Возможные значения: true — штрихкоды передаются в ответе, false — не передаются
searchString	string	поиск по названию или части названия товара
pageSize	integer	количество записей на странице. Максимальное возможное значение — 1000
page	integer	номер страницы
position	integer	иерархический идентификатор последней записи из предыдущей страницы. При получении первой страницы параметр не указывается
order	string	направление выборки данных в результате. Возможные значения: before — записи, которые идут до указанного значения position (как листание назад), after — записи, которые идут после указанного значения position (как листание вперед)

Структура ответа

Параметр		Тип	Описание
article		string	артикул наименования
attributes		array[{...}]	массив списков с характеристиками номенклатуры
balance		string	остаток товара на складе точки продаж. Параметр приходит, если в запросе отмечено флагом withBalance
barcodes		array{...}	массив штрихкодов
	code	string	штрихкод
	codeType	string	тип штрихкода (EAN-13, EAN-8)
cost		integer	цена товара из прайса или колонки цен
description		string	поле «Описание» из карточки номенклатуры
externalId		string	идентификатор номенклатуры в формате UUID
hierarchicalId		integer	идентификатор раздела
hierarchicalParent		integer	идентификатор родительского раздела
id		integer	идентификатор номенклатуры
images		array[string]	изображение товара
indexNumber		integer	порядковый номер в каталоге
isKit		boolean	признак, является ли номенклатура комплектом
isParent		boolean	признак, является ли идентификатор родителем в иерархии
modifiers		array[{...}]	список модификаторов
	id	integer	идентификатор номенклатурной позиции
	name	string	название модификатора или группы модификаторов
	cost	number	цена модификатора
	baseCount	integer	количество порций модификатора в базовой единице измерения, которое добавлено в товар
	сount	number	количество модификатора
	maxCount	number	максимальное количество модификатора, которое можно выбрать. Распространяется на все позиции, связанные с родителем, у которого оно заполнено
	minCount	number	минимальное количество модификатора, которое нужно выбрать. Распространяется на все позиции, связанные с родителем, у которого оно заполнено
	parentType	integer	тип родителя/папки
	hierarchicalParent	integer	идентификатор родителя в иерархии
	hierarchicalId	integer	идентификатор в иерархии
	isParent	boolean	признак, является ли идентификатор родителем в иерархии
name		string	название товара
nomNumber		string	код товара, указанный в карточке номенклатуры
published		boolean	признак публикации номенклатурной позиции
short_code		integer	короткий код
unit		string	единица измерения
outcome		boolean	флаг наличия записей на следующих страницах

Примеры

Получить простые товары

Получить товары с модификатором

Получить комплект товаров

Получить товары с помощью постраничной навигации (параметры pageSize и page)

Получить товары с помощью курсовой навигации (параметры order и position)

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

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

