Начните поиск...

Получить список товаров по API для магазинов

Запрос возвращает информацию о товарах и услугах по действующему прайс-листу. В результате может вернуться до 10 000 номенклатурных позиций.

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

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

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

Параметр * — обязательный	Тип	Описание
pointId *	integer	Идентификатор точки продаж, который вернулся в результате запроса «Получить точку продаж»
priceListId *	integer	Идентификатор прайс-листа, который вернулся в результате запроса «Получить прайс-лист»
noStopList	boolean	Признак исключения позиций, которые есть в стоп-листе
onlyPublished	boolean	Признак возврата в ответе только опубликованных позиций. Если параметр не передавать, возвращаются все позиции
withBalance	boolean	Признак передачи остатков. Если «true», то остатки передаются в ответе
withBarcode	boolean	Признак передачи штрихкодов товара. Если «true», то штрихкоды передаются в ответе
searchString	string	Поиск по названию или части названия товара
page	integer	Номер страницы
pageSize	integer	Количество записей на странице. Если параметр не передан, вернется 30 записей

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

Параметр		Тип	Описание
article		string	Артикул наименования
attributes		array{...}	Массив с характеристиками товара
balance		string	Остаток товара с учетом открытых смен. Остаток передается по складу точки продаж
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	Порядковый номер в каталоге
modifiers		array[{...}]	Массив списков модификаторов
	id	integer	Идентификатор товарной позиции
	externalId	string	Идентификатор товара в формате UUID
	nomNumber	string	Код товара, указанный в карточке товара
	name	string	Название товара
	cost	number	Цена модификатора
	unit	string	Название единицы измерения
name		string	Название товара
nomNumber		string	Код товара, указанный в карточке товара
published		boolean	Признак публикации товарной позиции
masters		string	Список сотрудников, которые могут применять этот товар/услугу
short_code		integer	Короткий код
unit		string	Единица измерения
outcome		boolean	Признак наличия записей на следующих страницах

С помощью API-запросов вы можете получить дополнительную информацию по товарам.

Получить изображение товара:
- метод: GET
- запрос: https://api.sbis.ru/retail/{img?param=...}, где {img?param=...} — значение параметра «images» из вернувшихся данных товара.
Получить список «С этим товаром покупают»:
- метод: GET
- запрос: https://api.sbis.ru/retail/nomenclature/{externalId}, где {externalId} — идентификатор товара в формате UUID.

Примеры

Запрос списка товаров

В формате *.php

В формате *.py

В качестве примера используется функция «cURL».

В качестве примера используется библиотека «Requests».

Ответ на запрос списка товаров

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