v0.21.0
Home

Print Dash — Inventory Module User Guide

Audience: Warehouse staff, inventory clerks, production managers (manager panel)
Version: 1.0.0 · Date: 2026-05-31
Language: English — العربية



1. Overview

The Inventory area is where your shop defines what you stock (items), where it is stored (warehouses), and how quantities change over time.

Typical tasks:

  • Set up categories and items
  • Record stock additions and disbursements (adjustments)
  • Move stock between warehouses (transfers)
  • Review on-hand quantity and history on each item

Stock changes are tracked in layers (FIFO) so costs stay traceable. After you click Process on an adjustment or transfer, quantities usually update within a short time once background processing finishes.


2. Categories

Open Inventory → Categories.

  • Categories are organized in a tree (parent/child), similar to a folder structure.
  • Use the category editor to add, rename, or reorganize nodes.
  • For roll materials, managers may configure allowed roll units on a category so items under that category use consistent units.

Tip: Create categories before items so new items can be classified correctly from the start.


3. Items

Open Inventory → Items.

Creating an item

  1. Click Create.
  2. Fill in name, code/SKU, category, and unit of measure.
  3. Set sale price if used on sales documents.
  4. Optionally enable minimum quantity tracking for low-stock alerts on the dashboard.
  5. Save.

After save

  • Open the item’s view page to see stock by warehouse, stock movements, and active FIFO layers (see section 5).

4. Warehouses

Open Inventory → Warehouses.

Each warehouse has a type, for example:

Type Typical use
Raw Materials Incoming materials
Finished Goods Completed products
Production WIP / floor buffer
Salvageable Scrap Recoverable waste
Other General storage

Choose the type that matches how your shop uses the location. Transfers and adjustments always specify one warehouse (adjustments) or from / to warehouses (transfers).


5. Viewing stock on an item

Open an ItemView.

Tab / section What it shows
Stock by warehouse Current on-hand quantity per warehouse
Stock Movements History of ins and outs (adjustments, transfers, sales, purchases, production, etc.)
Stock Entries (Active FIFO Layers) Remaining quantity in each cost layer — used for valuation and FIFO consumption

Use movements to answer “what happened?” Use layers to answer “what cost layers are still available?”


6. Stock adjustments

Open Inventory → Stock Adjustments.

Adjustments correct or record stock in one warehouse at a time.

Types

Type (UI label) Meaning
Addition Stock in — increases quantity (receipt, found stock, correction up)
Disbursement Stock out — decreases quantity (usage, spoilage, correction down)

Workflow

  1. Create a stock adjustment.
  2. Choose warehouse, adjustment date, type (Addition or Disbursement), and optional reason/notes.
  3. Add line items: pick item, quantity, and unit cost (especially important for additions).
  4. Save — status is Pending.
  5. Open the record and click Process when lines are correct.
  6. Status becomes Processed. Stock quantities update shortly after (background job).
  7. You may receive an in-app notification when processing is queued or complete.

Important

  • Disbursement cannot remove more than available FIFO layers allow.
  • You cannot process the same adjustment twice.
  • If quantities do not change, ask an administrator whether the queue worker is running.

7. Warehouse transfers

Open Inventory → Transfers.

Moves stock from one warehouse to another.

Workflow

  1. Create a transfer (Draft).
  2. Set transfer date, from warehouse, to warehouse, and notes.
  3. Add line items (item + quantity).
  4. Save and open the transfer view.
  5. Click Process when ready to complete the move.
  6. Status becomes Received (processed). Stock is deducted from the source and added to the destination via FIFO rules.
  7. Wait for background processing if balances do not update immediately.

Status labels you may see

Status Meaning
Draft Editable; not yet applied to stock
Received Processed — stock move completed (or processing)
Cancelled Voided / not applied

8. Dashboard widgets (managers)

If your role includes the customized dashboard, you may see inventory widgets such as:

Widget Purpose
Inventory summary Trends and overview metrics
Stock snapshot High-level stock picture (financial lines may require extra permission)
Low stock alerts Items at or below minimum quantity

For printable or detailed analysis, use Reports (separate menu), for example Stock valuation or Movement ledger — those reports read the same FIFO stock data.


9. Quick reference

Task Where to go Main action
New item Inventory → Items Create
Stock in Stock Adjustments Type Addition → Process
Stock out Stock Adjustments Type Disbursement → Process
Move between warehouses Transfers Create → Process
History on item Item → View Stock Movements tab
Low stock Dashboard widget Low stock alerts

10. Glossary

Term Plain meaning
FIFO layer A batch of stock received at a specific unit cost; older layers are used first when stock goes out
Stock movement One line in the audit log of quantity in or out
Addition Adjustment that increases stock
Disbursement Adjustment that decreases stock
Transfer Moving quantity from one warehouse to another
On-hand Total quantity currently in a warehouse for an item
Process Confirm the document so the system applies changes to stock