Inventory, availability and immutable movements
This section covers the live stock list, availability calculation, manual adjustments and append-only movement evidence.
Understand inventory availability
Understand inventory availabilityUse the exact available = on hand − reserved − quarantined − damaged formula.
Open guide →GuideUnderstand on-hand stock
Understand on-hand stockPhysical quantity currently recorded at the location.
Open guide →GuideUnderstand reserved stock
Understand reserved stockQuantity committed to unfulfilled online orders when reservation is enabled.
Open guide →GuideUnderstand in-transit stock
Understand in-transit stockStored quantity that is not currently subtracted by the available formula.
Open guide →GuideUnderstand quarantined stock
Understand quarantined stockQuantity excluded from available stock.
Open guide →GuideUnderstand damaged stock
Understand damaged stockQuantity excluded from available stock.
Open guide →GuideUnderstand reorder level
Understand reorder levelThreshold used by low-stock indicators.
Open guide →GuideUnderstand available stock
Understand available stockComputed quantity used for availability checks.
Open guide →GuideSearch inventory by location and product
Search inventory by location and productFilter the live inventory list without changing balances.
Open guide →GuidePost a manual stock adjustment
Post a manual stock adjustmentChange on-hand stock with a non-zero delta, approved reason and mandatory note.
Open guide →GuideUse the opening inventory reason
Use the opening inventory reasonRecord a manual or system stock movement with the opening reason code.
Open guide →GuideUse the purchase inventory reason
Use the purchase inventory reasonRecord a manual or system stock movement with the purchase reason code.
Open guide →GuideUse the sale inventory reason
Use the sale inventory reasonRecord a manual or system stock movement with the sale reason code.
Open guide →GuideUse the return inventory reason
Use the return inventory reasonRecord a manual or system stock movement with the return reason code.
Open guide →GuideUse the damage inventory reason
Use the damage inventory reasonRecord a manual or system stock movement with the damage reason code.
Open guide →GuideUse the shrinkage inventory reason
Use the shrinkage inventory reasonRecord a manual or system stock movement with the shrinkage reason code.
Open guide →GuideUse the count inventory reason
Use the count inventory reasonRecord a manual or system stock movement with the count reason code.
Open guide →GuideUse the transfer in inventory reason
Use the transfer in inventory reasonRecord a manual or system stock movement with the transfer_in reason code.
Open guide →GuideUse the transfer out inventory reason
Use the transfer out inventory reasonRecord a manual or system stock movement with the transfer_out reason code.
Open guide →GuideUse the correction inventory reason
Use the correction inventory reasonRecord a manual or system stock movement with the correction reason code.
Open guide →GuideUnderstand stock movement source types
Understand stock movement source typesTrace adjustments, sales, returns and purchases through source_type and source_id.
Open guide →GuideUnderstand stock movement correlation IDs
Understand stock movement correlation IDsConnect related stock and audit events across one transaction.
Open guide →GuideUnderstand immutable inventory history
Understand immutable inventory historyTreat movement rows as append-only evidence.
Open guide →GuideUnderstand initial stock rows
Understand initial stock rowsKnow how the model creates a zeroed stock row when a tracked product/location pair first needs one.
Open guide →GuideUnderstand stock row locking
Understand stock row lockingKnow that stock updates lock the balance inside a database transaction.
Open guide →GuideUnderstand backorder behaviour
Understand backorder behaviourAllow a tracked product to pass negative-availability checks only when its backorder control is enabled.
Open guide →GuideUnderstand stock handling for non-tracked products
Understand stock handling for non-tracked productsSkip stock balance enforcement for services or products with tracking disabled.
Open guide →GuideUnderstand online stock reservation
Understand online stock reservationIncrease reserved stock when configured online orders are created.
Open guide →GuideUnderstand immediate online stock deduction
Understand immediate online stock deductionDeduct on hand during order creation when reservation is disabled.
Open guide →GuideUnderstand POS stock deduction
Understand POS stock deductionDeduct on hand immediately when a POS sale commits.
Open guide →GuideUnderstand return stock restoration
Understand return stock restorationRelease reserved quantity or restore on hand according to the original order path.
Open guide →GuideUnderstand purchase stock receipts
Understand purchase stock receiptsIncrease on hand and create a purchase movement when goods are received.
Open guide →GuideTroubleshoot insufficient stock
Troubleshoot insufficient stockReview available quantity, backorder control, location and concurrent reservations.
Open guide →GuideTroubleshoot an invalid stock adjustment
Troubleshoot an invalid stock adjustmentUse a non-zero delta, approved reason and required note.
Open guide →GuideTroubleshoot a product that cannot be adjusted
Troubleshoot a product that cannot be adjustedConfirm it is active, stock-tracked and belongs to the tenant.
Open guide →GuideTroubleshoot a stock transaction failure
Troubleshoot a stock transaction failureRetain the pre-transaction balance and inspect the exact validation/audit outcome.
Open guide →GuideUnderstand inventory screen limitations
Understand inventory screen limitationsKnow that version 1.0.0 does not expose direct editors for reserved, in transit, quarantined, damaged or reorder values.
Open guide →GuideRun an inventory reconciliation checklist
Run an inventory reconciliation checklistCompare balances, movement history, open reservations, purchases, sales and returns by location.
Open guide →