Skip to main content
Stock quantities and availability. Inventory represents the quantity available for sale and the rules used to prevent overselling.

Core concepts

Distinguish on-hand quantity, reserved quantity, sellable/available quantity, back-order policy, and stock status. These terms are conceptual until mapped to the actual v6 fields and services. Inventory may be tracked at product, variant, warehouse, or location level depending on the edition and enabled modules.

Safe stock updates

  • Use the server-side inventory workflow; do not allow clients to set arbitrary stock values.
  • Validate non-negative quantities and permitted adjustment reasons.
  • Make order reservation/decrement operations transactional where the implementation supports it.
  • Protect against concurrent checkout and duplicate webhook/event processing.
  • Record who changed stock, when, and why.

Operational checks

Test simultaneous purchases, cancellation/refund restocking, failed payment cleanup, back-order behavior, and stock visibility in staging. Inspect entities, order services, and migrations to establish the actual source-of-truth fields.