Inventory
Inventory control center
Understand stock prerequisites, inventory dashboards, ledger behavior, settings, and permissions.
Inventory is the operational stock hub at /inventory. It shows stock value, movement, procurement, fulfillment, expiring lots, warehouse utilization, dead stock, and recent ledger activity from the installed supply chain capabilities.
Access and permissions
Inventory, Purchase, Warehouse, Sales, and Manufacturing are separate routes under one Inventory entitlement. Users with the module can read records allowed by their scope. Creating or changing supply chain records generally requires SUPER_ADMIN or MANAGER.
Only a SUPER_ADMIN can change Inventory capability flags under /inventory/settings. A workspace can therefore expose a configuration page while the related execution feature remains disabled.
Create the prerequisites
If the Inventory Control Center shows No inventory yet, start in this order:
- Create a product at
/products/new. - Ensure the product has the appropriate inventory variant and SKU.
- Create a warehouse at
/warehouse/warehouses. - Confirm its Main stock location or create the required bins at
/warehouse/locations. - Receive stock through a purchase order receipt, opening adjustment, or another supported inbound operation.
Creating a product alone does not create on hand stock. A stock affecting transaction must post to the ledger.
Stock as an append only ledger
/warehouse/stock-moves is the immutable movement ledger. Confirmed receipts, deliveries, transfers, adjustments, scrap, manufacturing, returns, and unbuild operations append stock moves. The on hand cache updates atomically with those entries.
Do not correct stock by editing a historical move. Use a compensating transfer, adjustment, return, scrap, or other supported reversal. This preserves quantity, value, actor, and source traceability.
Inventory navigation
| Area | Routes and purpose |
|---|---|
| Overview | /inventory, /inventory/executive, /inventory/reports |
| Traceability | Lots, serials, expiry, scan, recall |
| Planning | Reorder rules, suggestions, forecast, safety stock |
| Catalog configuration | Units of measure, attributes, kits |
| Maintenance | Equipment, maintenance requests, request board |
| Finance and configuration | Inventory accounting and Inventory settings |
Some planning and configuration pages remain visible before their feature flag is enabled. They show an explicit disabled state and do not create operational data while disabled.
Reports
Open /inventory/reports for stock on hand, stock moves, valuation, locations, and replenishment views. Exports use the current report filters. The Executive page is a separate read only analytics capability when enabled.
Common problems
| What you see | What to check |
|---|---|
| Product exists but on hand is zero | No confirmed inbound stock move exists for its variant and location. |
| Create action is disabled | Your role is read only, the workspace is restricted, or the feature flag is off. |
| Inventory page is empty | Create a product and receive or adjust stock. |
| Quantity changed but no source is clear | Open Stock Moves and inspect the source type and source identifier. |
| Negative stock is rejected | The workspace does not allow negative stock. Receive or transfer stock before the outbound action. |
| A feature page says disabled | Ask the SUPER_ADMIN to review /inventory/settings. |