Inventory guide

Manage stock quantities, allocation, and stock maintenance tasks.

Last updated:

Core workflow

  1. Receive stock into a chosen bin
  2. Put away, move, replenish, or quarantine stock by bin
  3. Allocate stock to orders
  4. Count and reconcile stock where it physically sits
  5. Record corrections where needed

What you can do

  • Manage stock items and stock groups
  • Review allocated lines
  • Run stock adjustments and checks
  • Transfer stock between locations and bins
  • Monitor low-stock risk

Inventory execution model

  • inventory_balance is the authoritative bin-level on-hand balance ledger
  • inventory_movement is the append-only movement history for warehouse tasks
  • stock.quantity_on_hand is treated as a stock summary derived from balances

Current scope note:

  • stock.quantity_allocated remains a stock-level summary in v1
  • bin-level quantity_reserved is present in the schema for future allocation work, but current warehouse flows mutate on-hand quantities only

Image previews in inventory lists

Inventory list forms now include small thumbnail previews sourced from stock product image manifests:

  • Stock items list (inline thumbnail in the Item column)
  • Low stock list (inline thumbnail in the Name column)
  • Allocated lines list (preview shown inside the Stock cell)

Performance rule for lists:

  • list forms use thumbnail variants only
  • detail forms can use preview/original image URLs
  • if no thumbnail exists, the inline list summary simply omits the image

Barcode model

Stock now uses two barcode concepts:

  • internal_barcode on the stock record for warehouse execution, labels, and tenant-unique scan identity
  • manufacturer_barcode on the stock product for the supplier / retail UPC, EAN, ISBN-13, or GTIN value on the item itself

On stock create, the internal barcode can be entered manually or left blank so ChannelWeave generates it automatically. After the stock item is saved, the standard stock-item edit form keeps the internal barcode read-only so warehouse labels and scans stay stable.

Warehouse scan precedence is:

  1. internal barcode
  2. manufacturer barcode
  3. SKU fallback

Barcode policy

Barcode rules are controlled in Settings → Policies → Inventory policies → Barcode policy.

That policy sets:

  • that every stock record receives an internal barcode on create
  • the internal barcode prefix and sequence width
  • that internal stock and bin labels render as Code 128
  • whether manufacturer barcodes are optional, recommended, or required

SKU policy

SKU checks are controlled in Settings → Policies → Inventory policies → SKU policy and applied when creating, editing, and importing stock.

Stock groups

Use stock groups to organise items and control group-level behaviour.

On narrower layouts, the Name column becomes the primary summary cell. When the standalone Status column is hidden, stock-group status badges fold into Name, and only the final Action column stays sticky.