Item Stock Viewer

What Is Item Stock Viewer?

Item Stock Viewer is the Inventory view for checking stock from the item point of view. Instead of starting from one warehouse shelf or one stock batch, staff start with an item and review:

total stock for that item
stock split by R, F, and D
recent stock movement history for the item
current stock batches that can be opened in Stock Detail Viewer

Use Item Stock Viewer when the question is "what stock do we have for this item?" Use Stock Detail Viewer when the question is about one specific lot or batch.

Where To Find It

App	Screen	Use it to
Web client	`Inventory > Stock by Item`	Search items, review stock totals, and open the Item Stock modal.
Web client	Item Stock modal	Review one item's summary, history, and stock batches.
Warehouse app	`Stock > Stock by Item`	Search items from the mobile app and open item stock detail.
Warehouse app	Item Stock detail	Review one item's stock dashboard and open stock batch detail.

Main Fields

Field	Notes
Item	English name, Korean name, item code or barcode, and UOM.
Total	Current active quantity across all active stock batches for the item.
R	Quantity currently in refrigerated stock batches.
F	Quantity currently in frozen stock batches.
D	Quantity currently in dry stock batches.
Exp Range	Earliest and latest expiry dates for each stock summary line when expiry dates are recorded.
History	Recent stock actions for the item, including lot number, quantity before and after, reference, staff name, and action time.
Stocks	Current active stock batches for the item. Rows can open Stock Detail Viewer.

Review Stock By Item

Viewing Stock by Item requires one of the stock read or stock action roles.

Open Inventory > Stock by Item in the Web client, or Stock > Stock by Item in the Warehouse app.
Search by item keyword, item code, item name, or barcode.
Review the total quantity and the R/F/D summary shown in the item row.
Open the item row to review the full Item Stock view.
Use History to understand recent movements and adjustments for the item.
Use Stocks to review active lots and open Stock Detail Viewer when one batch needs closer review or an action.

The History tab shows item-level stock history across stock batches. It is useful when staff need to see why the item quantity changed or which lot was moved, adjusted, split, received, allocated, picked, or returned.

History rows are read-only. They do not perform stock actions by themselves.

Stocks Tab

The Stocks tab shows current active stock batches for the item. It is loaded when staff open the tab so the first item view can focus on the summary and history.

Select a stock row to open Stock Detail Viewer. Move, Adjust, and Split are controlled by the user's stock action roles in Stock Detail Viewer.

Required Roles

Action	Required role
View Stock by Item	`stock.read`, `stock.move`, `stock.adjust`, or `stock.split`
Open Item Stock Viewer	`stock.read`, `stock.move`, `stock.adjust`, or `stock.split`
Read item stock summary	`stock.read`, `stock.move`, `stock.adjust`, or `stock.split`
Read item stock history	`stock.read`, `stock.move`, `stock.adjust`, or `stock.split`
Read current stock batches for the item	`stock.read`, `stock.move`, `stock.adjust`, or `stock.split`
Open Stock Detail from a stock batch row	`stock.read`, `stock.move`, `stock.adjust`, or `stock.split`
Move stock from Stock Detail	`stock.move`
Adjust stock from Stock Detail	`stock.adjust`
Split stock from Stock Detail	`stock.split`

admin users can perform these actions through the global admin override.

Stock action roles also allow viewing Item Stock Viewer because staff need to inspect the item and stock batch before performing an action. A user with only stock.read can review the item stock dashboard and stock detail, but cannot move, adjust, or split stock.

Common Problems

Problem	What it means
Stock by Item is hidden	The user does not have `stock.read` or a stock action role.
Item Stock Viewer does not open	The item id may be invalid, the item may not exist, or the user may not have a stock read/action role.
Summary shows no stock	The item has no active, non-archived stock with quantity greater than zero.
History is empty	No stock history has been recorded for this item yet.
Stocks tab is empty	The item currently has no active stock batches.
A stock row shows a raw location id	Some Warehouse app item stock rows may show the cached location id string instead of a resolved warehouse/shelf name. Open Stock Detail for the resolved location.
Move, Adjust, or Split is missing after opening stock detail	The user does not have the matching stock action role.