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, and use the History tab to review recent Shopify 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.
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.
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:
- Initial Shopify import — if Shopify-to-Peasy inventory sync is enabled, Peasy can use Shopify quantities as starting inventory.
- Manual Sync Shopify → Peasy — if you choose this action on a linked item, Peasy resets that item to the Shopify quantity.
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.
| Setting | What happens |
|---|---|
| Two-way sync between Peasy and Shopify | Shopify orders deduct inventory in Peasy, and Peasy inventory changes push updated counts to Shopify. Shopify count changes do not reset Peasy counts. |
| Only sync from Shopify to Peasy | Shopify orders deduct inventory in Peasy. Shopify count changes update comparison data, not Peasy counts. Peasy does not push corrected counts back to Shopify. |
| Only sync from Peasy to Shopify | Peasy pushes inventory changes to Shopify. Shopify orders are still recorded for reference, but they do not create Peasy sales orders or deduct inventory. |
| Pause inventory sync | Product and order data can still be received, but automatic inventory movement is paused in both directions. |
What Stays in Sync
| Data | What happens |
|---|---|
| Shopify orders | Flow into Peasy and deduct inventory when Shopify-to-Peasy sync is enabled. |
| Peasy inventory quantities | Push to Shopify when Peasy-to-Shopify sync is enabled. |
| Shopify inventory quantities | Used for comparison, initial import when enabled, and manual Sync Shopify → Peasy actions. |
| Product names/descriptions | Imported initially, not continuously synced. |
| Prices | Imported initially, not continuously synced. |
| New products | Peasy notifies you of new Shopify products via alerts. |
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:
- Data lands in staging — Imported products appear in a review area, not directly in your inventory.
- You review and organize — Check names, categories, units, and groupings. Peasy's AI may suggest groupings and matches.
- 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.
Good to Know
- Shopify orders deduct quickly — order activity normally appears in Peasy within seconds to minutes when Shopify-to-Peasy sync is enabled.
- 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.
- Only linked items sync — Items that were imported from Shopify (or manually linked) participate in sync. Unlinked items are independent.
- 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
