Item.Get

Возвращает постраничный список всех актуальных товаров кассы, включая созданные вручную и через другие интеграции. Удалённые товары не возвращаются. Один товар появляется в списке один раз.

Для авторизации передайте Bearer-токен интеграции в HTTP-заголовке. Подробнее — авторизация API.

Входные параметры

Название	Тип данных	Обязательность	Описание
page	int32	Необязательный	Номер страницы с 1, по умолчанию 1
page_size	int32	Необязательный	От 1 до 30, по умолчанию 30

Передайте объект params, в том числе пустой для первой страницы. Порядок — по возрастанию item_id. Результат содержит page, page_size, total (число всех доступных товаров), items. За пределами списка items пуст. Изменения каталога между запросами могут сдвигать страницы. Возвращаются текущие данные товара; ранее созданные корзины сохраняют свои цены и скидки.

Пример запроса

Authorization: Bearer <integration-token>
Content-Type: application/json;charset=utf-8

{
    "jsonrpc": "2.0",
    "method": "Item.Get",
    "params": {
        "page": 1,
        "page_size": 30
    },
    "id": 1
}

Выходные параметры

Название	Тип данных	Описание
page	int32	Номер текущей страницы, начиная с 1
page_size	int32	Размер страницы, от 1 до 30
total	int64	Количество всех доступных товаров
items	array	Список товаров
items[].external_id	string	Общий внешний ключ; пустой, если ключ не задан или старое совпадение ключей ещё не разрешено
items[].item_id	int64	Локальный ID товара для Cart.Add
items[].name	string	Наименование товара
items[].barcode	string	Штрихкод; пустой при отсутствии
items[].price	int64	Цена единицы в тийинах
items[].vat_value	int64 или null	Ставка НДС в сотых долях процента; -1 — без НДС; null — ставка недоступна
items[].icps	string	Код ИКПУ
items[].package_code	string или null	Код упаковки; null при отсутствии
items[].unit_kkm_code	int64	Код единицы измерения
items[].owner_type	int32	-1 — не задан; 0 — купля-продажа; 1 — производство; 2 — услуги
items[].is_labeled	boolean	Признак маркированного товара
items[].label_required	boolean или null	Требование маркировки; при null используется is_labeled

Пример ответа

{
    "jsonrpc": "2.0",
    "result": {
        "page": 1,
        "page_size": 30,
        "total": 1,
        "items": [
            {
                "external_id": "SKU-001",
                "item_id": 101,
                "name": "Тестовый товар",
                "barcode": "4780000000000",
                "price": 10000,
                "vat_value": 0,
                "icps": "00000000000000000",
                "package_code": null,
                "unit_kkm_code": 1,
                "owner_type": 0,
                "is_labeled": false,
                "label_required": null
            }
        ]
    },
    "ok": true,
    "id": 1
}

Повторный запрос не изменяет товары. Ошибки: общие ошибки; 701003 — некорректные параметры страницы.