Stock Adjustments

A stock adjustment makes an immediate, manual correction to a quant’s on-hand quantity. Use this for one-off corrections — damaged goods, discovered stock, data errors — outside of a full stock count session.

Adjustments are made from the Quants screen, not from a dedicated “Stock Adjustments” page. Each quant (a quantity of an item in a specific bin, optionally under a lot) can be edited directly.

Before you start

• Adjusting stock is not permission-guarded today — any signed-in user with access to the Quants screen can post an adjustment. Control this through who you give accounts to.
• Adjustments are immediate and cannot be undone — to reverse one, make another adjustment in the opposite direction.
• Serialized stock (SERIAL/RFID) cannot be adjusted here — the Edit action is disabled for those rows. Use a stock count instead, which reconciles the individual serialized units correctly.

---

Making an adjustment

1. In the sidebar, open Stock → Quants
2. (Optional) Use the Warehouse filter to narrow the list
3. Find the quant you want to correct — the table shows its Item, Bin, On Hand quantity, and Lot
4. Click the Edit (pencil) action on that row. The Adjust Stock Quantity dialog opens, showing the current on-hand quantity
5. Enter the New Quantity — this is the absolute count you want the quant to have, not a +/- change. For example, if it currently reads 42 and you found 3 extra, enter 45
6. Enter Notes describing why (e.g., “Damaged in handling”, “Found during audit”). This text is stored on the resulting transaction
7. Click Save

The adjustment is applied immediately. Behind the scenes the system:

• Computes the change as New Quantity − current on hand and updates the quant’s onHandQuantity
• Records a system_correction inventory transaction with the change, the before/after balance, and your notes
• Picks the reason automatically from the direction of the change: found when you increase the quantity, correction when you decrease it

The dialog does not let you choose a reason or enter a source-document number — those exist in the underlying API (see the reason list in the Order Statuses reference) but the screen only sends found or correction. Put any extra context in the Notes field.

---

Constraints

• The new quantity must differ from the current quantity. Entering the same number produces a zero change, which the system rejects (“Adjustment quantity cannot be zero”).
• The new quantity cannot be negative, and an adjustment cannot drive a quant below zero. Setting it to exactly 0 is allowed.
• An adjustment only changes the quant’s quantity. It does not create or remove serialized unit records — which is why the screen blocks adjusting SERIAL/RFID stock and points you to a stock count instead.

---

Reviewing adjustments

All adjustments are visible under History → Inventory Transactions, filtered by transaction type system_correction. Each record shows:

• The quant affected (item, bin, lot)
• Quantity before and after
• Reason and notes
• The user who made the adjustment
• Timestamp