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