Товары с ценами
catalog.get_products_with_prices
Возвращает список товаров номенклатуры с ценами — по поисковому запросу или по списку идентификаторов. Каждая позиция приходит полной проекцией: наименование, тип, единица измерения, бренд, категория, цена по запрошенному типу и базовые цены, ставка НДС, штрихкод, габариты и вес, упаковка, флаги и изображения. Только чтение.
Входы
| Ключ | Тип | Описание |
|---|---|---|
| query | string | Поисковый запрос |
| ids | array | Идентификаторы |
| priceTypeCode | string | Тип цены |
| limit | integer | Лимит |
Выходы
| Ключ | Тип | Описание |
|---|---|---|
| items | array | Товары |
| count | integer | Количество |
Что делает
Нода находит товары номенклатуры и возвращает их вместе с ценами. Искать можно двумя способами: по текстовому запросу (наименование, артикул, штрихкод) или сразу по списку идентификаторов, если нужные позиции уже известны. Дополнительно можно указать тип цены — тогда в каждой позиции поле «цена» будет заполнено значением именно этого типа.
Что приходит в ответе
Каждый товар — это полная карточка позиции: идентификатор и SKU, наименование, тип товара, единица измерения, описание, бренд и категория. По ценам приходят цена по запрошенному типу, а также базовые цены продажи и себестоимости и ставка НДС. Дополнительно — штрихкод, габариты и вес, данные упаковки, изображения и служебные флаги позиции: продаётся ли товар, закупается ли, ведётся ли учёт остатков, активен он или в архиве, есть ли варианты.
Когда применять
Основной сценарий — подбор позиций для документа: например, при составлении коммерческого предложения ассистент по описанию находит подходящие товары и сразу подставляет цены нужного типа. Также подходит, чтобы обогатить строки заказа актуальными данными карточки или получить по списку идентификаторов свежие цены и характеристики. Нода только читает данные и ничего не меняет в каталоге.