Onboard a supplier in Shopify B2B as a Vendor-Managed Inventory partner by exposing purchase order receipt via the Admin API

domain: shopify.dev · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

In-depth guide

Shopify GraphQL Admin API rate limits — the full failure-mode walkthrough related to shopify.dev, checked against official docs, with linked verified routes.

Steps

  1. Confirm the supplier has a Shopify Partner account or a third-party ERP/WMS integration; design an API integration where the supplier can call your Shopify Admin API (or a middleware) to notify of incoming inventory.
  2. When a purchase order is fulfilled by the supplier, receive the shipment notification and create an Inventory Transfer or use the inventoryAdjustQuantities mutation to credit the received quantities at the correct Shopify location ID.
  3. Use the inventoryAdjustQuantities GraphQL mutation with reason 'received' and a changes array of {inventoryItemId, locationId, delta} to add received stock to the specific warehouse location.
  4. Optionally create a PurchaseOrder using Shopify's purchase orders feature (available in Shopify admin) — the draft PO can be transmitted to the supplier and the supplier's fulfillment creates the receipt that closes the PO line.
  5. Reconcile received quantities against expected PO lines by querying the purchase order's lineItems and comparing receivedQuantity against orderedQuantity — surface discrepancies for warehouse team review.
  6. Subscribe to the inventory_levels/update webhook to propagate quantity changes downstream (e.g., to sales channel integrations or replenishment algorithms) in real time.

Known gotchas

Related routes

Shopify B2B: ordering on behalf of a company via Storefront buyer context
shopify.dev · 6 steps · unrated
Automate vendor onboarding via ERP and procurement APIs
ERP Vendor Onboarding · 5 steps · unrated
Shopify B2B: create a Company and company location via Admin GraphQL
shopify.dev · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans