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