Connect Shopify to Pipe17

Key capabilities:

• Pull orders from Shopify into Pipe17 for routing and fulfillment
• Push fulfillment confirmations and tracking back into Shopify
• Pull fulfillments from Shopify into Pipe17
• Push orders from Pipe17 into Shopify
• Sync inventory levels from Pipe17 into Shopify to keep stock counts accurate
• Detect cancellations in Shopify and update Pipe17 order statuses accordingly
• Sync returns between Pipe17 and Shopify in both directions
• Pull payout statements from Shopify into Pipe17

Supported API version: Shopify REST Admin API 2024-10
Authentication: OAuth
Rate limits: 2 requests/sec REST (leaky bucket, 40-request burst), 1,000 points/sec GraphQL

Setup

Prerequisites

Before configuring the connector, ensure you have:

1. A Shopify store on the Basic plan or higher.
2. A Shopify account with Owner permissions or the Apps and sales channels staff permission.
3. Your store's myshopify.com subdomain (e.g., yourstore.myshopify.com).

Steps

1. Start the OAuth flow

• In Pipe17, navigate to Integrations → Add Integration.
• Select Shopify from the catalog.
• Enter your Store URL (e.g., yourstore.myshopify.com) and click Connect.
• You will be redirected to Shopify to authorize the Pipe17 app. Log in with an account that has Owner or Apps permissions.
• After approving the required scopes, you will be redirected back to Pipe17. The connection is created automatically - no manual token entry is required.

If you have multiple Shopify stores, you can repeat this process to connect additional stores.

2. Configure webhooks in Shopify

• The connector automatically registers the required webhooks on first save.
• To verify, go to Shopify Admin → Settings → Notifications → Webhooks.
• If webhooks are missing, re-save the connector to re-register them.

You can read more about staff permissions on Shopify's help documentation.

Settings

Connection settings

Integration settings

Orders

Outbound orders matching

Order flow

Fulfillments

Returns

Products

Inventory

Statements

Flows

Orders in: Pipe17 ← Shopify

Pulls new and updated orders from Shopify into Pipe17 for routing and fulfillment.

Trigger: Shopify webhook (orders/create, orders/updated) with polling fallback every 15 minutes.

• Only orders matching the Order financial status filter setting are imported
• Orders can be further filtered by type, sales channel, note attributes, and creation date using the corresponding settings
• Orders containing unrecognized product variants are flagged for review in Pipe17
• Shopify draft orders are excluded unless explicitly converted to orders in Shopify

Orders out: Pipe17 → Shopify

Pushes orders from Pipe17 into Shopify.

Trigger: Pipe17 poll for orders designated for outbound push to Shopify.

Fulfillments out: Pipe17 → Shopify

Pushes Pipe17 fulfillment records back into Shopify, marking orders as fulfilled and adding tracking information.

Trigger: Pipe17 poll for fulfillment records linked to Shopify orders in fulfilled status.

• Partial shipments create partial fulfillments in Shopify, one per shipment
• Tracking number and carrier are mapped from the Pipe17 fulfillment record
• Customer shipping notifications can be suppressed per order using the Disable sending shipping notification for specific Shopify order ID patterns setting

Fulfillments in: Pipe17 ← Shopify

Pulls fulfillment records from Shopify into Pipe17.

Trigger: Shopify webhook (fulfillments/create, fulfillments/update) with polling fallback.

• Useful when fulfillments originate in Shopify or a Shopify-native fulfillment app rather than being pushed from Pipe17

Inventory out: Pipe17 → Shopify

Pushes current inventory quantities from Pipe17 into Shopify by location.

How it works:

1. Pipe17 computes the available quantity per SKU per fulfillment location
2. Inventory levels are read via the Shopify REST inventory_levels endpoint
3. Quantity updates are applied using GraphQL-based quantity resolution

Scheduling: Syncs run every 15 minutes by default. Use Force Inventory Resync to trigger an immediate full update outside the normal schedule.

• Use the Apply inventory updates only for SKUs matching following patterns setting to limit updates to specific products
• Inventory is location-aware - each Shopify location must be mapped to a Pipe17 fulfillment node

Manual action: Pull orders by ID

The connector supports an on-demand action (orders.in.by.id) to pull one or more specific Shopify orders immediately, without waiting for the next scheduled poll. Use this to recover a missed order or reprocess an updated one.

Returns in: Pipe17 ← Shopify

Pulls return requests initiated in Shopify into Pipe17.

Trigger: Shopify webhook for return events with polling fallback.

• Both full and partial returns are supported
• Restocked line items are reflected in Pipe17 inventory adjustments if restock is enabled in Shopify

Returns out: Pipe17 → Shopify

Pushes return requests from Pipe17 into Shopify.

Trigger: Pipe17 poll for return records designated for Shopify.

Locations in: Pipe17 ← Shopify

Pulls Shopify fulfillment location data into Pipe17 to support inventory and fulfillment mapping.

Trigger: Vendor poll against Shopify's locations endpoint.

Cancellations in: Pipe17 ← Shopify

Detects orders canceled in Shopify and updates the corresponding Pipe17 order status.

Trigger: Shopify webhook (orders/cancelled) with polling fallback.

• When a cancellation is detected, the Pipe17 order is updated to the status configured in the Fulfillment canceled action setting
• Default status applied is canceledRestock
• Available statuses: reviewRequired, canceled, canceledRestock, failed
• Partial cancellations (line-item level) are not supported - the entire order status is updated

Statements in: Pipe17 ← Shopify

Pulls Shopify Payments payout statement data into Pipe17.

Trigger: Vendor poll against Shopify's payouts endpoint.

• Requires the read_shopify_payments_payouts scope
• Only available for stores using Shopify Payments as their payment provider

Troubleshooting

Connection test fails

Orders not appearing in Pipe17

• Confirm the order's financial status matches one of the values in the Order financial status filter setting - the default includes paid, partially_refunded, and refunded
• Check whether the Order ID filter, Order types, Order channels, or Order note attribute exclusions settings are active and inadvertently excluding orders
• Check whether orders.in.filter.since is set to a date that excludes the orders you expect
• Verify webhooks are registered under Shopify Admin → Settings → Notifications → Webhooks - re-save the connector if any are missing
• Review Pipe17 error logs for import validation failures; the log will indicate which field or variant was rejected

Fulfillments not pushing to Shopify

• Confirm the Pipe17 fulfillment record status is fulfilled - records in other statuses will not be pushed
• Check that the Shopify order has not already been fully fulfilled or canceled - Shopify will reject fulfillment requests for closed orders
• Verify the tracking carrier value in Pipe17 maps to a carrier recognized by Shopify
• Ensure the fulfillment location in Pipe17 is correctly mapped to a valid Shopify location; use fulfillmentSwapLocations if IDs differ

Fulfillments not pulling from Shopify

• Confirm the fulfillments/create and fulfillments/update webhooks are registered in Shopify Admin → Settings → Notifications → Webhooks
• Verify the originating Shopify fulfillment is associated with an order that was imported into Pipe17 - fulfillments for unknown orders will be skipped

Inventory counts are incorrect in Shopify

• Inventory sync runs on a 15-minute schedule; use Force Inventory Resync to trigger an immediate update
• If you only need to update specific products, use the Inventory SKUs setting to scope the sync
• Check that the Pipe17 fulfillment node is correctly mapped to the target Shopify location - mismatched locations update the wrong stock level
• Confirm the token has write_inventory scope - a missing scope causes silent failures on inventory updates

Cancellations not reflecting in Pipe17

• Confirm the Fulfillment canceled action setting is configured to the intended target status
• Verify the order was fully canceled in Shopify, not just placed on hold or partially refunded - partial cancellations do not trigger the cancellation flow
• Check that the orders/cancelled webhook is registered in Shopify Admin

Returns not syncing

• For returns in: confirm the return-related webhooks are registered in Shopify Admin → Settings → Notifications → Webhooks
• Verify the original order exists in Pipe17 - returns for orders not imported into Pipe17 will be skipped
• For returns out: check Pipe17 error logs for mapping failures; confirm the write_returns scope was granted during OAuth

Request limit errors

Rate limit retries are handled automatically - the connector backs off and retries based on Shopify's REST and GraphQL rate limit headers. If you are consistently hitting limits, reduce the frequency of manual actions or avoid triggering bulk inventory resyncs during peak order volume periods.

Need Help?

If you need additional assistance:

• Use Ask Pippen, our AI agent, located at the top of the app page.
• Submit a support request with as much relevant detail as possible. Learn how to submit a request.
• For urgent issues, email us directly at support@pipe17.com.

We're here to help you succeed with your operations.