Stock By Item List
Staff guide for finding items and reviewing current stock totals by item.
What Is Stock By Item List?
Stock By Item List is the Inventory screen for searching items and checking their current stock totals. Each row starts from an item, then shows whether the item currently has stock and how that stock is split across R, F, and D.
Use this list when staff need to answer:
- Does this item have stock now?
- How much total stock is available?
- Is the stock refrigerated, frozen, or dry?
- Which item should I open for stock history or stock batch detail?
This page is the entry point. Opening an item row takes staff to Item Stock Viewer, where they can review item-level history and current stock batches.
Where To Find It
| App | Screen | Use it to |
|---|---|---|
| Web client | Inventory > Stock by Item | Search catalog items and review stock totals by item. |
| Warehouse app | Stock > Stock by Item | Search items from the mobile app and open item stock detail. |
Main Fields
| Field | Notes |
|---|---|
| Item image | Web shows the item thumbnail when available. |
| Item name | English name and Korean name. |
| Code or barcode | Item code when available, otherwise barcode. |
| Total stock | Current active quantity across all active stock batches for the item. |
| R | Current refrigerated stock quantity and expiry range when available. |
| F | Current frozen stock quantity and expiry range when available. |
| D | Current dry stock quantity and expiry range when available. |
| Page | Web uses page controls. Warehouse uses Load More for mobile scrolling. |
Quantities show current active stock only. Archived stock and stock with zero quantity are not included in the list summary.
Search Stock By Item
Viewing Stock By Item List requires one of the stock read or stock action roles.
- Open
Inventory > Stock by Itemin the Web client, orStock > Stock by Itemin the Warehouse app. - Search by item keyword, item code, item name, or barcode.
- Review the row's total quantity.
- Review R/F/D lines if the item has stock.
- Open the item row when you need item-level stock history or stock batch detail.
The list searches catalog items first, then loads stock summaries for the items shown on the current page.
Open Item Stock Viewer
Selecting a row opens Item Stock Viewer for that item.
Use Item Stock Viewer when staff need more than the list summary, such as:
- recent stock movement history
- active stock batches for the item
- handoff to Stock Detail Viewer for one lot or batch
Stock actions are not performed from the Stock By Item List itself. Move, Adjust, and Split happen after opening a stock batch in Stock Detail Viewer.
Required Roles
| Action | Required role |
|---|---|
| View Stock By Item List | stock.read, stock.move, stock.adjust, or stock.split |
| Search items for stock review | stock.read, stock.move, stock.adjust, or stock.split |
| Read item stock summaries | stock.read, stock.move, stock.adjust, or stock.split |
| Open Item Stock Viewer from a row | stock.read, stock.move, stock.adjust, or stock.split |
| Open Stock Detail from Item Stock Viewer | stock.read, stock.move, stock.adjust, or stock.split |
admin users can perform these actions through the global admin override.
Stock action roles also allow viewing Stock By Item List because staff need to
inspect item and stock state before moving, adjusting, or splitting a batch. A
user with only stock.read can review the list and follow through to read-only
detail, but cannot perform stock actions.
Common Problems
| Problem | What it means |
|---|---|
| Stock by Item is hidden | The user does not have stock.read or a stock action role. |
| Search returns no items | No catalog item matches the keyword, code, name, or barcode. |
| Row says No stock | The item exists, but it has no active, non-archived stock with quantity greater than zero. |
| R/F/D lines are missing | The item has no current stock summary to show. |
| Page total looks different from item detail | Refresh the list or reopen the item. Stock actions may have changed quantities after the list loaded. |
| Item row opens but detail is blocked | The user's active company profile may have changed, or the user may no longer have stock read/action access. |