Интеграция со СБИС

Получить список товаров по API

Получить список товаров по API

Запрос возвращает информацию о товарах и услугах по действующему прайс-листу.

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

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

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

Пример в формате *.php
Пример запроса в формате *.py

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

<?php
$ch = curl_init();
curl_setopt_array($ch, array(
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_FOLLOWLOCATION => false,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_URL => 'https://api.sbis.ru/retail/nomenclature/list?product=salon&pointId=123&priceListId=123&withBalance=true&page=0&pageSize=50',
    CURLOPT_HEADER => 0,
    CURLOPT_HTTPHEADER =>  array(
        'Content-type: charset=utf-8',
        'X-SBISAccessToken: WJbMyxUZ1JpSmshaFlTQyEpSGpydVlUIyFqXVtaZyloUGxtNW8vPGdOKVMsWWpnJSg7a3dSaWdeTDsybExfTzIwMjAtMTAtMTMgMDk6MTM6MjEuODc3OTkz'
        )
));
$response = curl_exec($ch);
curl_close($ch);
?>

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

import requests
parameters = {
    'pointId': '123',
    'priceListId': '555',
        'withBalance': 'true',
        'page': '0',
    'pageSize': '10'
        
}
url = 'https://api.sbis.ru/retail/nomenclature/list?'  
headers = {
"X-SBISAccessToken": "MlU3cjkmREE4elU5NihQKmglfFB0N1dqNH43W3BGPiVCYiZnZ21GUzlpLU1ERVFII2MmZUA4bG98N1ddOClBKjIwMjAtMTAtMTMgMTI6MDQ6MTMuODkzNjA4"
}  
response = requests.get(url, params=parameters, headers=headers)
print(response.text)

ПараметрТипОписание
pointId *integerИдентификатор точки продаж, который вернулся в результате запроса «Получить точку продаж»
priceListId *integerИдентификатор прайс-листа, который вернулся в результате запроса «Получить прайс-лист»
noStopListbooleanПараметр исключает позиции, которые есть в прайс-листе
withBalancebooleanПараметр определяет передаются остатки или нет
searchStringstringПоиск по названию или части названия товара
pageintegerНомер страницы
pageSizeintegerКоличество записей на странице
productstringНазвание сервиса, по которому нужно получить список товаров. В данном случае «salon»

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

{
    "nomenclatures": [
        {
            "attributes": null,
            "balance": string,
            "cost": string,
            "description": string,
            "externalId": string,
            "hierarchicalId": integer,
            "hierarchicalParent": integer,
            "id": integer,
            "images": Array[string],
            "indexNumber": 1097001,
            "modifiers": [],
            "name": "Процессоры",
            "nomNumber": null,
            "published": true,
            "unit": null
            
        }
    ],
    "outcome": {
        "hasMore": false
    }
}

ПараметрТипОписание
attributesarray[{...}]Характеристики номенклатуры
balancestringОстаток товара с учетом открытых смен. Остаток передается по складу точки продаж
descriptionstringПоле «Описание» из карточки номенклатуры
externalIdstringХешированное название номенклатурной позиции для запроса подробной информации
hierarchicalIdintegerИдентификатор раздела
hierarchicalParentintegerИдентификатор родительского раздела
idintegerИдентификатор номенклатуры
imagesarray[string]Изображение товара
indexNumberintegerПорядковый номер в каталоге
modifiersarray[{...}]Список модификаторов
namestringНазвание товара
nomNumberstringКод товара, указанный в карточке номенклатуры
publishedbooleanПризнак публикации номенклатурной позиции
masters **stringСписок мастеров, которые могут применять этот товар/услугу
unitstringЕдиница измерения
outcomebooleanФлаг наличия записей на следующих страницах
priceIntervals **array[number]Минимальная и максимальная цена товара/услуги среди всех прайс-листов, где применяется эта позиция
executionTime**integerВремя выполнения услуги. Возвращается, если в параметре "product" указано значение "salon"
Структура «modifiers»
id integerИдентификатор номенклатурной позиции
externalIdstringХешированное название номенклатурной позиции для запроса подробной информации
nomNumberstringКод товара, указанный в карточке номенклатуры
namestringНазвание товара
costnumberЦена модификатора
unitstringНазвание единицы измерения/Время приготовления(presto)
hierarchicalParentintegerИдентификатор родителя в иерархии
hierarchicalIdintegerИдентификатор в иерархии
isParentbooleanПризнак, является ли идентификатор родителем в иерархии

* — обязательный параметр.

** — условно-обязательный параметр, возвращается в запросах к СБИС Для салонов

Примеры

{
    "nomenclatures": [
        {
            "attributes": null,
            "balance": null,
            "cost": null,
            "description": null,
            "externalId": null,
            "hierarchicalId": 1098,
            "hierarchicalParent": null,
            "id": null,
            "images": null,
            "indexNumber": 1097001,
            "modifiers": [],
            "name": "Процессоры",
            "nomNumber": null,
            "published": true,
            "unit": null
        },
        {
            "attributes": {
                "Количество процессоров": "4",
                "Архетектура": "ARM"
            },
            "balance": 0.0,
            "cost": 5000.0,
            "description": null,
            "externalId": "96a287f1-1ef9-4201-b354-f2796c910296",
            "hierarchicalId": 1100,
            "hierarchicalParent": 1098,
            "id": 31,
            "images": [
                "/img?params=eyJPYmplY3RUeXBlIjogIm5vbWVuY2xhdHVyZV1mb3JfcmVmIiwgIk9iamVjdElkIjogMzEsICJQaG90b1VSTCI6ICJodHRwczovL29ubGluZS5zYmlzLnJ1L2NzdG9yYWdlL3YxL25vbWVuY2xhdHVyZV9maWxlcy80ZTU2NTcwMy00MjBiLTQ2N2QtYjE2Zi1lNmMyY2EzODk3YjMiLCAiUGhvdG9JZCI6IG51bGwsICJTaXplIjogbnVsbCwgIkFkZGl0aW9uYWxQYXJhbXMiOiBudWxsfQ=="
            ],
            "indexNumber": 1099001,
            "modifiers": [],
            "name": "процессор 3452",
            "nomNumber": "X8956880",
            "published": false,
            "unit": "шт"
        }
    ],
    "outcome": {
        "hasMore": false
    }
}

Чтобы получить изображение товара, выполните GET запрос, где «{img?param=...}» — значение параметра «images».

https://api.sbis.ru/retail/{img?param=...}
Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.