After reverseFulfillmentOrderDispose marks lines as RESTOCKED, query inventoryLevel for the relevant inventoryItemId and locationId to confirm the stock increase was applied
If items are returned to a non-primary location, use inventoryTransfer mutation to move units from the receiving location to the primary fulfillment location
For damaged items that should not be restocked, create an inventoryAdjustQuantities mutation with reason set to damaged to reduce available stock and maintain audit trail
Reconcile inventory counts against your warehouse management system by comparing Shopify inventoryLevel quantities with the WMS pick location quantities
Schedule periodic inventoryAdjustQuantities corrections for shrinkage or count discrepancies discovered during reconciliation
Known gotchas
reverseFulfillmentOrderDispose with RESTOCKED disposition automatically increments inventory; calling inventoryAdjustQuantities in addition will double-count the units
Inventory transfers between locations are not instantaneous in Shopify's model; in-transit quantities are tracked separately and only become available at the destination after the transfer is received
Adjustments made with reason set to damaged affect on-hand but not committed quantities; ensure your reporting distinguishes between available, on-hand, and committed to avoid fulfillment errors
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp