Stock By Location
Staff guide for finding stock by warehouse, shelf, level, and item keyword.
What Is Stock By Location?
Stock By Location is the Inventory screen for finding active stock by where it is stored. Staff can filter by warehouse, shelf, and shelf level, then add an item keyword when they need to narrow the result.
Use Stock By Location when staff need to answer:
- What stock is in this warehouse?
- What stock is on this shelf?
- What stock is on a specific shelf level?
- Is a specific item stored in this location?
This guide covers located stock search by location filters. General Located Stock and Unlocated Stock lists are covered in their own Inventory guide.
Where To Find It
| App | Screen | Use it to |
|---|---|---|
| Web client | Inventory > Stock by Location | Choose warehouse, shelf, level, and keyword from the desktop stock search screen. |
| Warehouse app | Stock > Stock by Location | Choose location from a mobile modal, search stock, and open stock detail. |
Main Fields
| Field | Notes |
|---|---|
| Warehouse | Optional. Limits results to one warehouse. |
| Shelf | Optional. Limits results to one shelf inside the selected warehouse. |
| Level | Optional. Limits results to one level inside the selected shelf. |
| Item keyword | Optional. Searches item names, code, or barcode through the item service. |
| Location | Warehouse, shelf, and level shown on each stock row. |
| Item | Item code, English name, Korean name, and barcode when lookup succeeds. |
| Lot Number | Internal lot number for the stock batch. |
| Quantity | Current remaining quantity for the stock batch. |
The result includes active located stock only. Unlocated stock is not included.
Location Selection UI
The Web client and Warehouse app do the same job, but the location picker is different.
| App | Location selection |
|---|---|
| Web client | Shows Warehouse, Shelf, and Level controls on the page. Warehouse is a dropdown. Shelf opens a shelf grid modal. Level is a dropdown after shelf selection. |
| Warehouse app | Shows one Location input button. Tapping it opens a full-screen-style modal with stages: Warehouse, Shelf grid, then Level. Staff apply the filter from the modal. |
Both apps send the same filter values to the API:
warehouseIdshelfIdlevelkeyword
Search By Location
Viewing Stock By Location requires one of the stock read or stock action roles.
- Open
Inventory > Stock by Locationin the Web client, orStock > Stock by Locationin the Warehouse app. - Choose a warehouse, or leave it as all warehouses.
- Choose a shelf if the search should be limited to one shelf.
- Choose a level if the search should be limited to one level.
- Enter an item keyword if needed.
- Press Search.
- Open a stock row when one batch needs Stock Detail review or an action.
Search does not automatically run when filters change. Staff choose filters and then press Search so the result matches the selected filter state.
Open Stock Detail
Selecting a stock row opens Stock Detail Viewer for that stock batch.
Move, Adjust, and Split are controlled by the user's stock action roles in Stock Detail Viewer. Stock By Location itself is read-only.
Required Roles
| Action | Required role |
|---|---|
| View Stock By Location | stock.read, stock.move, stock.adjust, or stock.split |
| Search by warehouse, shelf, level, and keyword | stock.read, stock.move, stock.adjust, or stock.split |
| Open Stock Detail from a result 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 Stock By Location because staff need to
find and inspect a stock batch before performing an action. A user with only
stock.read can search and open read-only detail, but cannot move, adjust, or
split stock.
Common Problems
| Problem | What it means |
|---|---|
| Stock by Location is hidden | The user does not have stock.read or a stock action role. |
| Shelf cannot be selected on Web | Choose a warehouse first, then open the shelf grid. |
| Level cannot be selected on Web | Choose a shelf first. Levels come from the selected shelf setup. |
| Warehouse app shows All locations | No warehouse/shelf/level filter has been applied yet. |
| Search returns no stock | No active located stock matches the selected location and keyword. |
| A shelf is missing from the selector | The shelf may be archived or not set up in the selected warehouse. |
| A row opens but actions are missing | The user can read stock but does not have the matching action role. |