Understanding Stock State

The Core Philosophy introduced state as the sum of all recorded history. In practice, inventory requires a more detailed model to handle the gap between an order being created and the goods leaving the warehouse. Relying on a single quantity creates ambiguity when units are spoken for but still physically present. Nooryx resolves this by tracking three quantities for every SKU at every location.

  1. On Hand: What is physically present
  2. Reserved: What is committed to orders
  3. Available: What can still be sold

These values give you an accurate view of your inventory at any moment. They can be viewed per location, per SKU, or aggregated across all locations.

The Core Equation

Available = On Hand - Reserved

Nooryx calculates this in real time based on the underlying ledger.

On Hand

On Hand is the number of units physically present at a location. A physical count should match this quantity.

What increases On Hand

  • Receiving stock
  • Positive adjustments during cycle counts (Adjustments)
  • Incoming transfers from other locations
  • Customer returns once inspected and restocked

What decreases On Hand

  • Shipping orders
  • Negative adjustments (damage, loss, shrinkage)
  • Outgoing transfers to other locations

On Hand reflects the physical quantity on the shelf. It is location-specific and rolls up cleanly when viewing totals across multiple locations.

Reserved

Reserved is inventory allocated to orders but not yet shipped. These units remain physically present but cannot be sold again.

Why reservations matter

If you sell an SKU across multiple channels, reservations prevent overselling. When an order is created, Nooryx increases the Reserved quantity. On Hand stays the same, and Available decreases so other channels cannot allocate the same units.

Reservation workflow

  1. An order is created → Reserved increases
  2. Warehouse picks and packs → Reserved remains the same
  3. Order ships → Reserved decreases and On Hand decreases

When shipping, Nooryx asks whether to ship from the Reserved quantity or the Available quantity. Shipping from Available reduces On Hand directly.

Cancelled orders

If an order is cancelled before shipment, its reservation should be released. This returns those units to the Available pool.

If reservations are not released for cancelled orders, Available will be lower than it should be. This can cause false stockouts.

Available

Available represents what you can sell or allocate right now. It is a calculated value and is never stored directly. Nooryx prevents any operation that would push Available below zero.

Try It in the Simulator

Use the interactive illustration below to see how receiving, reserving, and shipping affect the three quantities.

On Hand
100
Reserved
20
Available
80

Interact with the buttons above to see how transactions update inventory state

Stock Status Indicators

Nooryx uses the Available quantity and the Low Stock Threshold (set in Settings) to determine stock status.

StatusConditionMeaning
In StockAvailable > Low Stock ThresholdNormal levels
Low Stock0 < Available ≤ Low Stock ThresholdReorder soon
Out of StockAvailable = 0Nothing can be sold

Next Steps

Learn how the primary workflows change these quantities:

These workflows follow consistent, auditable rules to ensure that stock state always reflects reality.