Запрос возвращает информацию о товарах и услугах по действующему прайс-листу.
Структура запроса
Метод запроса: 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 | Количество записей на странице |
| product | string | Название сервиса, по которому нужно получить список товаров. В данном случае «salon» |
Структура ответа
Параметр | Тип | Описание | |
| attributes | array{...} | Массив с характеристиками товара | |
| balance | string | Остаток товара с учетом открытых смен. Остаток передается по складу точки продаж | |
| barcodes | array{...} | Массив штрихкодов | |
| code | string | Штрихкод |
| codeType | string | Тип штрихкода (EAN-13, EAN-8) | |
| description | string | Поле «Описание» из карточки товара | |
| externalId | string | Хешированное название товарной позиции для запроса подробной информации | |
| hierarchicalId | integer | Идентификатор раздела | |
| hierarchicalParent | integer | Идентификатор родительского раздела | |
| id | integer | Идентификатор товара | |
| images | array[string] | Ссылка на изображение товара | |
| indexNumber | integer | Порядковый номер в каталоге | |
| modifiers | array[{...}] | Массив списков модификаторов | |
| id | integer | Идентификатор товарной позиции |
| externalId | string | Хешированное название товарной позиции для запроса подробной информации | |
| nomNumber | string | Код товара, указанный в карточке этого товара | |
| name | string | Название товара | |
| cost | number | Цена модификатора | |
| unit | string | Название единицы измерения | |
| hierarchicalParent | integer | Идентификатор родителя в иерархии | |
| hierarchicalId | integer | Идентификатор в иерархии | |
| isParent | boolean | Признак, является ли идентификатор родителем в иерархии | |
| name | string | Название товара | |
| nomNumber | string | Код товара, указанный в карточке этого товара | |
| published | boolean | Признак публикации товарной позиции | |
| masters ** | string | Список мастеров, которые могут применять этот товар/услугу | |
| unit | string | Единица измерения | |
| outcome | boolean | Флаг наличия записей на следующих страницах | |
| priceIntervals ** | array[number] | Минимальная и максимальная цена товара/услуги среди всех прайс-листов, где применяется эта позиция | |
| executionTime** | integer | Время выполнения услуги. Возвращается, если в параметре "product" указано значение "salon" | |
С помощью API-запросов вы можете получить дополнительную информацию по товарам.
- Получить изображение товара:
- метод: GET
- запрос: https://api.sbis.ru/retail/{img?param=...}, где {img?param=...} — значение параметра «images» из вернувшихся данных товара.
- Получить список «С этим товаром покупают»:
- метод: GET
- запрос: https://api.sbis.ru/retail/nomenclature/{externalId}, где {externalId} — идентификатор товара в формате UUID.
Примеры
Запрос списка товаров и услуг
В формате *.php
В формате *.php
В формате *.py
В формате *.py
В качестве примера используется функция «cURL».
В качестве примера используется библиотека «Requests».
Ответ на запрос получения списка товаров и услуг
Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.