What is the Stock Ledger and how does it work?

Understanding the Stock Ledger

In StoreYug, inventory is tracked like a bank account:

• Live Balance: The current number of units physically sitting on your shelf right now (e.g. 42 units).
• The Stock Ledger: An append-only historical record (like a bank statement) that logs every single unit that moves into or out of your store.

Whenever an order is confirmed, cancelled, adjusted, or received, StoreYug writes an immutable ledger entry recording the exact timestamp, who made the change, the reason, and a before-and-after snapshot.

The 5 Types of Stock Movements

1. Stock Added (STOCK_IN): Created when you receive new inventory from suppliers, manufacture items, or add opening stock. Increases available quantity.
2. Sold (SALE_OUT): Automatically triggered whenever an order is confirmed on your store. Deducts the ordered units and links directly to the customer receipt.
3. Order Cancelled (REVERSAL): Automatically triggered if a confirmed order is later cancelled or rejected. Automatically restores the reserved units back to available stock.
4. Customer Return (RETURN_IN): Recorded when a customer returns a previously delivered item in sellable condition, re-adding it to your shelf.
5. Stock Adjustment (ADJUSTMENT): Manual corrections made by you or your store staff for damaged, expired, stolen, or miscounted goods.

Audit Integrity: Before & After Snapshots

Every ledger entry captures three key numbers:

• Quantity Before: The snapshot of your stock balance immediately before the change.
• Quantity Change: The movement amount (e.g. +10 or -3).
• Quantity After: The new balance immediately following the change (Before + Change = After).