Inventory

Overview

The Inventory section tracks stock levels across multiple warehouses and synchronizes available quantities to all connected marketplaces. NexusCommerce maintains a master stock ledger and pushes updates whenever quantities change — whether due to orders, returns, manual adjustments, or replenishment.

Key Concepts

Warehouse — A physical or virtual stock location. You can have multiple warehouses (e.g., your own warehouse, an Amazon FBA center, a 3PL). Each warehouse has its own stock level per SKU.

Available Quantity — The quantity available for sale. Calculated as:

available = on_hand - reserved - safety_stock

Where reserved is the quantity committed to open orders not yet shipped.

Safety Stock — A configurable buffer that NexusCommerce never lists as available. Prevents overselling if orders arrive faster than inventory counts update.

Allocation — When an order is received, the relevant quantity is moved from available to reserved. When the order ships, it moves from reserved to sold (decremented from on_hand).

Sync Direction — NexusCommerce is the system of record for inventory. Changes made directly in a marketplace (e.g., via Seller Central) are overwritten on the next sync cycle.

Getting Started

After completing the initial catalog sync, navigate to Inventory. Stock levels imported from each connected marketplace are shown immediately.

To configure warehouses:

1. Go to Settings > Inventory > Warehouses
2. Click Add Warehouse
3. Enter name, address, and type (own / FBA / FBS / 3PL)
4. Save

NexusCommerce automatically detects FBA and Shopify Fulfillment Network inventory from the marketplace adapters and creates corresponding warehouses.

Features

Inventory List

The Inventory list shows every SKU with stock data:

Status thresholds:

• Normal — Available > replenishment threshold
• Low — Available ≤ replenishment threshold
• Critical — Available ≤ 3 units
• Out of Stock — Available = 0

Warehouse Breakdown

Click any SKU to see the warehouse breakdown view:

• Per-warehouse stock table (on_hand, reserved, available)
• Stock allocation chart (donut)
• Recent adjustment history

Manual Adjustments

To record a stock adjustment (e.g., cycle count correction, damage write-off):

1. Click the SKU in the Inventory list
2. Click Adjust Stock
3. Select the warehouse
4. Enter the new quantity or the adjustment delta
5. Select a reason: cycle_count, damage, theft, supplier_receipt, return_restock, other
6. Optionally add a note
7. Click Save

Adjustments are recorded in the inventory_adjustments table with a timestamp and user ID. The adjustment immediately triggers a sync to push the new quantity to all connected marketplaces.

Replenishment Alerts

Configure replenishment thresholds per SKU or globally:

• Global threshold — Set a default threshold (units or days of stock) in Settings > Inventory
• Per-SKU threshold — Override the global threshold for specific SKUs from the inventory detail page

When stock falls below the threshold, a warning alert appears on the Dashboard alert feed.

Days of stock calculation:

days_of_stock = available / avg_daily_sales_30d

Average daily sales is calculated from the last 30 days of order data.

Bulk Import

Upload a CSV to update stock levels across many SKUs at once:

sku,warehouse,quantity,reason
SKU-001,Warehouse A,500,cycle_count
SKU-002,Warehouse A,150,supplier_receipt
SKU-003,FBA EU,200,supplier_receipt

The import creates individual adjustment records for each row, maintaining a full audit trail.

Inventory Sync to Marketplaces

Inventory is pushed to marketplaces via the adapter's inventory update endpoint. The sync happens:

• Immediately when a manual adjustment is made
• Immediately when an order ships (reservation consumed)
• Immediately when a return is restocked
• On the scheduled adapter sync interval (as a reconciliation pass)

For Amazon FBA, NexusCommerce reads FBA inventory from the SP-API Inventory API and displays it alongside your own warehouse stock. FBA quantities are read-only (adjustments must be made via FBA inbound shipments).

Multi-Warehouse Allocation

When a new order is received, NexusCommerce allocates inventory from warehouses in priority order. Configure warehouse priority in Settings > Inventory > Allocation:

1. Own warehouse (highest priority by default)
2. 3PL warehouse
3. FBA / FBS (lowest priority — these are managed by the marketplace)

If an SKU has no stock in the priority warehouse but has stock in a lower-priority warehouse, allocation falls through to the next warehouse in the list.

Configuration