Inventory guide

Manage stock quantities, allocation, and stock maintenance tasks.

Last updated:

Core workflow

  1. Review low-stock risk and create supplier purchase orders where needed
  2. Receive stock against the purchase order into a chosen location
  3. Put away, move, replenish, or quarantine stock by bin
  4. Allocate stock to orders
  5. Count and reconcile stock where it physically sits
  6. Record corrections where needed

What you can do

  • Manage stock items and stock groups
  • Open stock item detail from the linked SKU or item name in Stock items
  • Create stock-linked eBay, Website, and Shopify listing drafts from selected stock items
  • See Amazon in the draft channel picker as a disabled placeholder until the Amazon draft workflow is promoted from blueprint to persisted creation
  • See Discogs in the draft channel picker as a disabled research-gated placeholder until the provider API and commercial-use approval is explicit
  • Review allocated lines
  • Maintain suppliers and supplier purchase orders
  • Run stock adjustments and checks
  • Transfer stock between locations and bins
  • Monitor low-stock risk

Stock items list controls

  • Search is the first control in the Stock items list card so SKU, name, and description searches remain visually primary.
  • The low-stock shortcut appears inside Filters as Low stock (count). It becomes an active filter chip only when the low-stock filtered view is open.
  • On phones, bulk selection starts from a compact select icon. Choosing it expands the row to Done plus Bulk actions and reveals row selection controls.

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)
  • Stock items low-stock filtered view
  • 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 → 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 → Inventory policies → SKU policy and applied when creating, editing, and importing stock.

Stock item text fields

The stock item detail form keeps product-facing and operator-facing text separate:

  • Default listing description stores the product-level draft prefill copy used when new listings are created from the stock item.
  • Internal notes stores operator-only notes on the stock product and is not used for channel listing copy.

Creating drafts from stock

On stock item detail, Create drafts opens the draft creation modal directly. The listing template is optional: continue without one to create basic stock-linked eBay, Website, Shopify, or combined drafts from the stock defaults, or choose a saved listing template when you want its reusable pricing, copy, and policy rules applied to eBay and Website.

Amazon is shown in the modal as a disabled placeholder until the Amazon draft workflow is promoted from blueprint to persisted creation. Discogs is also shown as a disabled research-gated placeholder; it does not create drafts or call Discogs.

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.