Skip to content
PartnerMCPPartnerMCP

§00Integrations / Commerce

All integrations

Shopify integration: Shopify orders into the ERP. Stock, shipments and refunds back.

Shopify's REST Admin API has been legacy since October 2024, and new public apps must use the GraphQL Admin API. PartnerMCP builds on GraphQL, verifies every webhook, writes inventory with idempotency keys and reconciles on a schedule — because Shopify doesn't promise that webhooks arrive in order.

Build an IntegrationShopify ↔ Priority ERP

How PartnerMCP connects

01Primary path

GraphQL Admin API

Quarterly versions, each supported for at least 12 months; the latest stable, 2026-10, is accessible until 16 October 2027. Calls are metered by calculated query cost: 100 points a second on Standard, 200 on Advanced, 1,000 on Plus and 2,000 on Shopify for enterprise.

Product
Shopify
Vendor
Shopify
Category
Commerce
Runs
Cloud
Connects through
GraphQL Admin API
Detects changes with
webhooks (orders/create, refunds/create)
On this page
  1. 01What you can build
  2. 02Objects and events
  3. 03What it handles
  4. 04Pairings
  5. 05Questions
  6. 06References
§01—What you can build

What you can build.

Each one starts as a sentence. PartnerMCP answers with a plan in Shopify’s own objects, then builds it against your systems.

01Shopify → Priority ERP

“Create Priority ERP orders from Shopify and keep stock, shipments and refunds in sync.”

Build this integration

PartnerMCP will

  1. Receive orders/paid, verify the HMAC and drop duplicates by X-Shopify-Webhook-Id.
  2. Map each ProductVariant SKU to a Priority part; hold unknown SKUs for review.
  3. Create ORDERS with ORDERITEMS_SUBFORM in one deep insert, once per Shopify order.
  4. Create the Shopify fulfillment with tracking when the Priority shipment exists.
  5. Push Priority stock to InventoryLevel and turn refunds into credits for review.

02Shopify → SAP S/4HANA

“Create SAP orders from Shopify, synchronize inventory, fulfillment, refunds and cancellations.”

Build this integration

PartnerMCP will

  1. Create A_SalesOrder for each paid order with the web channel's SalesOrganization and DistributionChannel.
  2. Read A_MaterialStock and update Shopify per location.
  3. Follow the outbound delivery and create the Shopify fulfillment.
  4. Turn refunds/create into credit memo requests and orders/cancelled into cancelled order lines.

03ERP stock → Shopify, safely

“Whenever stock changes in the ERP, update Shopify's available quantity at each location without ever double-counting.”

Build this integration

PartnerMCP will

  1. Read the ERP's stock change and the Shopify location it belongs to.
  2. Call inventoryAdjustQuantities with an idempotency key (required from API 2026-04) and changeFromQuantity as a compare-and-set check.
  3. If Shopify's quantity moved in the meantime, re-read and retry instead of overwriting.

04Refunds with approval

“When a Shopify refund is created, raise the credit in the ERP and hold refunds above $1,000 for finance approval.”

Build this integration

PartnerMCP will

  1. Receive refunds/create and read the refund's lines and amounts.
  2. Prepare the credit in the ERP against the original order.
  3. Post it automatically below the threshold; above it, wait for an approver.
§02—Objects and events

Objects and events, by their API names.

The records PartnerMCP reads and writes in Shopify, and the events that start a run.

  • Order

    Order

    displayFinancialStatus, displayFulfillmentStatus, lineItems, fulfillmentOrders, fulfillments and refunds. Only the last 60 days are readable by default; older orders need the approved read_all_orders scope.

  • Fulfillment order

    FulfillmentOrder

    The line items fulfilled together from one location, with holds, splits, merges and moves.

  • Fulfillment

    Fulfillment

    What ships, with its tracking — created from the ERP's shipment.

  • Refund and return

    RefundReturn

    Refunds and returns that become ERP credits.

  • Inventory

    InventoryItemInventoryLevelLocation

    Available quantities per location, adjusted with inventoryAdjustQuantities.

  • Products

    ProductProductVariant

    The variant carries the SKU that maps to an ERP part.

  • Customer and draft order

    CustomerDraftOrder

    Buyers, and orders created on a customer's behalf.

Events

  • Order webhooks

    orders/create, orders/paid, orders/updated, orders/edited, orders/cancelled, orders/fulfilled and orders/partially_fulfilled.

  • Fulfillment and inventory webhooks

    fulfillment_orders/* (placed_on_hold, hold_released, split, merged, moved and more), fulfillments/create and fulfillments/update, and inventory_levels/update.

  • Refunds and returns

    refunds/create and returns/*.

  • Delivery rules

    Each delivery is verified with X-Shopify-Hmac-SHA256 and must be acknowledged within 5 seconds. Shopify retries 8 times over 4 hours, then deletes a subscription created through the Admin API. PartnerMCP de-duplicates on X-Shopify-Webhook-Id.

§03—What it handles

What PartnerMCP handles for you.

The details that break Shopify integrations in production, and what PartnerMCP does about each one.

  1. 01

    Subscriptions get deleted

    After 8 consecutive failed deliveries over 4 hours, Shopify deletes a webhook subscription created through the Admin API. PartnerMCP watches its subscriptions, re-creates them and reconciles the orders it missed.

  2. 02

    No ordering guarantee

    Webhooks can arrive out of order within and across topics, and Shopify recommends a reconciliation job. PartnerMCP runs one: it compares Shopify's orders with the ERP on a schedule.

  3. 03

    Idempotent inventory

    From API 2026-04, inventoryAdjustQuantities requires an idempotency key. PartnerMCP sends one with every adjustment, so a retry never moves stock twice.

  4. 04

    The 60-day order window

    Orders older than 60 days need the approved read_all_orders scope. PartnerMCP requests it when a backfill needs it.

  5. 05

    Query cost, not request counts

    GraphQL is metered in calculated cost per app and store; one query can't exceed 1,000 points, input arrays stop at 250 items and pagination caps at 25,000 objects. PartnerMCP shapes queries to the shop's bucket and uses bulk operations for history.

  6. 06

    Quarterly API versions

    Each version is supported for at least 12 months — 2026-01 stops being accessible on 16 January 2027. PartnerMCP pins a version and treats each upgrade as a tested change.

  7. 07

    Fulfillment orders, not just orders

    An order can split into fulfillment orders by location, be held, merged or moved. PartnerMCP fulfills per FulfillmentOrder, so partial and multi-location shipments stay correct.

§04—Pairings

Pairings, step by step.

Each pair page has the plan, the field mapping and the edge cases for that combination.

§05—Questions

Shopify integration questions.

Does PartnerMCP use Shopify's REST Admin API?

No. The REST Admin API has been legacy since October 2024, so PartnerMCP uses the GraphQL Admin API, with bulk operations for large reads and writes.

What happens if our ERP is down when orders come in?

Shopify retries each webhook 8 times over 4 hours. PartnerMCP accepts and queues orders even while the ERP is unavailable, and its reconciliation job catches anything that still slips through.

Does it handle Shopify Plus volumes?

Plus stores get 1,000 query-cost points a second. PartnerMCP paces itself to the store's bucket and uses bulk operations for backfills, so normal traffic isn't starved.

Does PartnerMCP use Shopify's MCP servers?

No. They serve developers and buyer-side agents — catalog, cart and checkout — not back-office order and inventory sync.

How are split and partial shipments handled?

Through fulfillment orders: each location's lines are fulfilled separately, and orders/partially_fulfilled keeps the ERP in step until the whole order ships.

§06—References

Vendor documentation.

The public documentation behind the technical details on this page.

§07Next step

Connect Shopify to the rest of your systems.

Describe what should happen. PartnerMCP shows you the plan before anything is built.

Build an IntegrationTalk to an engineer