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