← Back to Docs

Inventory Adjustments

Overview

The Inventory Adjustments page allows you to make manual stock corrections and sync them directly to Shopify. Use it for cycle counts, damage write-offs, receiving corrections, or any situation where the system inventory differs from physical stock. Every adjustment is recorded with a reason and synced to Shopify via the InventoryLevel API.

Making an Adjustment

Step 1: Select Product/SKU

Search for and select the product or SKU you want to adjust. The search matches on product name, SKU, or vendor name. Selecting a product shows its current stock level at each location.

Step 2: Select Location

If your store has multiple locations, select which location you are adjusting. The current available quantity at that location is displayed.

Step 3: Enter Adjustment Quantity

Enter the adjustment amount:

The system shows the resulting quantity after the adjustment (current + adjustment) for confirmation.

Step 4: Add Reason

Select or enter a reason for the adjustment:

ReasonDescription
Cycle CountPhysical count revealed discrepancy
DamagedStock damaged and unsellable
LostStock lost or unaccounted for
FoundStock found that was previously missing
Receiving ErrorIncorrect quantity received from supplier
OtherCustom reason (free text)

Step 5: Submit

Clicking Apply Adjustment will:

  1. Validate the adjustment (quantity cannot result in negative stock)
  2. Record the adjustment in the local database
  3. Sync the new inventory level to Shopify via the InventoryLevel API
  4. Display a success message with the updated quantity

Shopify Sync

All adjustments are synced to Shopify in real-time using the InventoryLevel API endpoint:

POST /admin/api/2024-01/inventory_levels/set.json
{
  "location_id": 12345678,
  "inventory_item_id": 87654321,
  "available": 42
}
Sync Confirmation: After a successful sync, the adjustment record shows a Syncs to Shopify badge. If the sync fails, the adjustment is still recorded locally but flagged with a Sync Failed badge and can be retried.

Location-Based Inventory

Inventory is tracked per location. When making an adjustment, you must specify which location you are adjusting:

Each location maintains its own available quantity. The Products page shows a breakdown of stock across all locations.

Adjustment History

Every adjustment is recorded in the history log with full audit trail:

History Columns

ColumnDescription
DateTimestamp of the adjustment
ProductProduct name and SKU
LocationLocation where adjustment was made
AdjustmentQuantity change (+/-)
Previous QtyStock level before adjustment
New QtyStock level after adjustment
ReasonReason for the adjustment
UserWho made the adjustment
Sync StatusSyncs to Shopify or Sync Failed

History Filters

Data Sources

DataSourceUpdate Frequency
Adjustment Form/api/inventory/adjustUser-initiated
Adjustment History/api/inventory/historyReal-time from database
Shopify SyncShopify InventoryLevel APIReal-time on submit
Location Datalocations tableSynced from Shopify Locations API
Inventory Levelsinventory_snapshots tableUpdated on adjustment or sync
Important: Adjustments that result in negative stock are blocked. If you need to correct an over-selling situation, process a return or exchange in Shopify first, then adjust.