Shopify Sync and Webhooks

After you've imported products from Shopify, Peasy can keep Shopify orders and linked inventory items connected. Peasy remains the place where your real inventory is managed; Shopify sends orders into Peasy and can receive updated counts from Peasy depending on your sync settings.

How to Get There

Click Configure (gear icon) in the sidebar, select Integrations, then open Shopify. Use Inventory Sync Direction on the General tab to choose how counts should flow. Use Webhooks to review incoming delivery and recovery activity, and use History to review inventory sync activity.

How Sync Works

Peasy Is the Source of Truth

Peasy is the source of truth for actual inventory. Receives, production, sales, counts, transfers, and manual adjustments in Peasy determine what you have available.

When Peasy sends inventory to Shopify, it calculates the Shopify quantity from the linked Peasy item family and unit conversion. This helps your online store avoid overselling.

If several Shopify variants map to the same Peasy variant, Peasy sends the same converted available quantity to every mapped Shopify variant. It does not divide the quantity between those listings. A failure on one listing is recorded separately and does not prevent Peasy from updating the others.

Shopify Orders

When Shopify-to-Peasy sync is enabled, Shopify orders flow into Peasy as sales activity. Peasy adds the order to the current consolidated Shopify sales order and deducts inventory right away, recording the deduction as a shipment so it's consistent with the rest of Peasy.

To control which Peasy location is deducted, open Shopify's General tab and scroll to Location Mapping. Map each active Shopify location to the active Peasy location that holds that inventory. When Shopify reports the location that fulfilled an order, Peasy uses that mapping on both the shipment and its lines. A consolidated order can therefore contain separate fulfillments from different locations, even when they ship on the same date.

If the Shopify location is not mapped, the saved mapping is inactive, or the mapped Peasy location is inactive, Peasy keeps the existing fallback: the shipment uses the order's Ship from location, which comes from the customer's default and then the business default when no customer default is set.

Each Shopify order or refund line keeps its own Shopify identity even when multiple variants map to one Peasy variant. Their quantities apply independently to the shared Peasy inventory pool; Peasy does not merge or discard the lines just because their destination item is the same.

The daily or weekly consolidated order setting only controls how Shopify orders are grouped in Peasy. It does not wait until the end of the day or week to deduct inventory.

Shopify Inventory Counts

Shopify inventory-count updates are handled differently from Shopify orders. Automatic Shopify inventory-count notifications update Peasy's Shopify-side comparison data and sync history, but they do not overwrite Peasy's actual inventory count.

Shopify counts can set Peasy inventory only in explicit actions:

1. Initial Shopify import — if Shopify-to-Peasy inventory sync is enabled, Peasy can use Shopify quantities as starting inventory.
2. Manual Sync Shopify → Peasy — if you choose this action on a linked item, Peasy resets that item to the Shopify quantity.
3. Bulk Pull/Push availability — on the Shopify settings page, Pull all from Shopify and Push all to Shopify are one-time bulk actions for every linked item. Each shows a preview comparing current Shopify and Peasy quantities before you confirm, and neither changes your automatic Inventory Sync Direction setting above. These buttons are disabled until at least one active Shopify location is mapped to a Peasy location.

Choosing a Shopify source when you pull

When several Shopify variants are linked to the same Peasy inventory pool, only one of their counts can reset that pool. Peasy settles this on its own when there is no real choice to make — only one variant is stocked, or every variant works out to the same result — and lists what it handled under Automatically handled at the top of the preview.

Everything else appears under sources need review, one card per Shopify variant showing its title, Shopify SKU, and the count at each mapped location. Pick the card whose count should reset the pool. The info icon on a card shows the Peasy item that variant is linked to, including its SKU, unit, and price, so you can confirm the link before choosing.

When one variant has stock and the others read zero, Peasy pre-selects the one with stock, since a zero usually means that variant isn't the one you count. That is a guess, so the pool still appears in the review list with the guess already filled in — apply as-is to accept it, or pick a zero card if the zero is the real count.

Pools where Shopify does not stock any linked variant are left alone — the preview marks them Skipped and shows the Peasy count staying where it is.

Inventory Sync Direction

New Shopify connections start with inventory sync paused so you can import products, review units, and choose the direction that fits your workflow.

What Stays in Sync

New Product Alerts

When you add new products in Shopify after the initial import, Peasy doesn't import them automatically. Instead, you'll see an alert letting you know there are new Shopify products available to import. You can then go to the Shopify settings page to review and import them.

Reviewing New Products

When you add new products in Shopify and import them into Peasy, they go through a staging process before becoming live items:

1. Data lands in staging — Imported products appear in a review area, not directly in your inventory.
2. You review and organize — Check names, categories, units, and groupings. Peasy's AI may suggest groupings and matches.
3. You confirm the import — Only after you approve does Peasy create the actual items.

In staging, you can:

• Edit item names and fix typos before items are created
• Group variants — Multiple Shopify variants can be grouped under one parent item
• Set units and conversions — Define buy/sell units and conversion ratios
• Match to existing items — Link incoming items to items already in Peasy instead of creating duplicates
• Import partially — Import some items now and leave others in staging for later

See Importing from Shopify for the full import flow.

Reviewing Webhook Recovery

Open the Webhooks tab to check whether Shopify deliveries are moving through Peasy. The health card summarizes work that is due, deliveries being processed, expired processing attempts, deliveries that have stopped, and the last automatic recovery progress. The page shows a snapshot from when it was loaded or last refreshed, so refresh it when you check back for updated recovery status.

The badge on the card tells you what to do next:

• Healthy — nothing is waiting for recovery. No action needed.
• Recovering — Peasy is catching up on delayed deliveries. Check back shortly.
• Waiting — deliveries came in a moment ago and recovery hasn't picked them up yet. Check back shortly and refresh the page. If recovery is overdue, the refreshed card will show Stalled.
• Stalled — recovery is overdue or has stopped moving deliveries through. Contact support.
• Action needed — at least one delivery has stopped and should be reviewed. It does not mean every Shopify delivery has stopped.
• Paused — automatic recovery is currently turned off for this environment.

Use the two views below the health card:

• Recent shows the newest deliveries.
• Needs attention searches all deliveries for the Shopify connection and shows the parked, exhausted, or terminal deliveries that need review. The results are not limited to the newest page.

Use Previous and Next to move through additional results. Select a row or choose View details to see its status, attempts, timing, and error category. The stored webhook payload is not shown.

You can retry a stopped delivery after reviewing it. Retry is unavailable while a delivery is still processing; Peasy's automatic recovery handles processing attempts whose lease has expired.

Good to Know

• Shopify orders deduct quickly — order activity normally appears in Peasy within seconds to minutes when Shopify-to-Peasy sync is enabled.
• A brief Peasy outage delays orders, it doesn't lose them — if Peasy can't record an incoming Shopify order, it tells Shopify the order wasn't received rather than accepting it. Shopify then sends it again, so the order arrives late instead of being missed. You don't need to do anything; if orders from a specific window never appear at all, contact support.
• Peasy counts do not get overwritten by normal Shopify count notifications — Shopify-side count changes update comparison and history data unless you explicitly import or manually sync from Shopify.
• Loop prevention — Peasy has built-in safeguards to prevent sync loops where a Peasy change bounces back from Shopify.
• Sync logs — Peasy tracks sync events, so you can see what was pushed or pulled and when.
• Needs attention covers the full delivery history — use this Webhooks view when the health card reports Action needed, then page through the results until you find the stopped delivery.
• With Shopify-to-Peasy sync turned off, deliveries show as Skipped — Peasy still records the order for your history, but deliberately does not apply it to your counts, so the delivery finishes as Skipped rather than needing review. If your store has sync turned off and the health card shows a large Due now number that never goes down, those are older deliveries from before this behavior was corrected; they are not blocking anything and no new order is affected. Contact support if you want that history brought into Peasy.
• Only linked items sync — Items that were imported from Shopify (or manually linked) participate in sync. Unlinked items are independent.
• Shared mappings remain independent — Multiple Shopify variants can map to one Peasy sell variant, while each link keeps its own sync history and can be unlinked separately.
• Multiple Shopify locations can share one Peasy location — If you map one Peasy location to multiple Shopify locations, Peasy sends that Peasy location's live quantity to each mapped Shopify location where the item is stocked. Shopify may count those location quantities separately for online selling, so this can make the sellable quantity in Shopify larger than the single Peasy location quantity.
• If Peasy and Shopify disagree, use Sync Peasy → Shopify when Peasy is correct, or Sync Shopify → Peasy only when Shopify is the count you want to adopt.

Related

• Importing from Shopify — The full import flow with staging
• Connecting Shopify — Setting up the connection
• Inventory Overview — How Peasy tracks inventory