Inventory Statistics — SanadiqCloud
Product version: 1.0.0+1
Last updated: 2026-08-13
Audience: Tenant Owners, Tenant Employees, Regular Users
A. Where statistics appear
There is no dedicated Inventory → Statistics screen in the app.
| Surface | What you see |
|---|---|
| Merchant Dashboard | Organization inventory health — low stock, expiring soon, and related KPIs (fed by inventory events / dashboard materialization) |
| Stock item screens | Per-item cues such as below-minimum or expiry dates on the item itself |
| Inventory Statistics API | Programmatic aggregates for integrations (/api/inventory/v1/statistics/...) — requires inventory:statistics:read |
Warehouse, stock-pool, and transaction list pages do not host a full statistics dashboard. Use the Merchant Dashboard for operational alerts.
B. Metrics (API / dashboard concepts)
Tenant-level
| Metric | Description |
|---|---|
| Total Inventories | Active stock pools across warehouses |
| Total Items | Inventory item lines |
| Total Quantity | Sum of quantity_on_hand |
| Total Value | Sum of quantity_on_hand × unit_cost |
| Total Locations / Warehouses | Site and facility counts |
| Low Stock Items | On hand at or below minimum_stock_level |
| Expiring Items | Items with expiry_date within the configured window (commonly 30 days) |
Inventory-level / location-level
Per stock pool or site: item counts, quantity, value, out-of-stock, low stock, expiring soon, and warehouses under a location.
Valuation
| Field | Description |
|---|---|
| Total Value | unit_cost × quantity_on_hand |
| Total Quantity | Aggregate on hand |
| Average Unit Cost | Weighted average |
| By Currency | Breakdown (e.g. USD, SAR, AED) |
Stock alerts
| Alert | Description |
|---|---|
| Low Stock | At or below minimum |
| Out of Stock | Zero on hand |
Dashboard Stock Alerts are the primary SaaS UX for these signals.
C. Document statistics (API)
Adjustment, transfer, pick-list, and transaction routers also expose statistics endpoints (counts by status, quantities moved). Those power integrations and admin tooling — not a separate Inventory Statistics page.
D. Interpreting signals
| Signal | Suggested action |
|---|---|
| High low-stock count | Review reorder points; create requisitions or purchase externally |
| Many expiring items | Damage/expiry adjustments or prioritize outbound |
| Stuck pending / submitted adjustments | Review and approve/reject |
| Stuck pending / approved transfers | Approve, ship, or receive |
Next: Inventory Hub Overview
See also: Transactions | Stock & Inventory | Merchant Dashboard