Retry and reprocess Shopify webhook events
Shopify sends SKU.io a webhook event each time an order, product or stock level changes. SKU.io records every event and works through it within seconds. When an event fails, for example because the order was being changed by another sync at the same moment, you can find it on the Webhooks page and run it again.
Before you begin
- Connect your Shopify store.
- To run events, you need the Integrations Sync permission (
integrations.sync). To delete them, you need the Integrations Edit permission (integrations.update).
What each status means
The cards at the top of the Events tab count your events by status. Click a card to filter the list to that status. Click it again to clear the filter.
| Status | Meaning |
|---|---|
| Pending | The event has arrived and is waiting its turn. |
| Processing | SKU.io is working through the event now. |
| Processed | The event finished. Its changes are in SKU.io. |
| Failed | The event stopped with an error. Hover over Error in the row to read it. |
You usually don't need to act on a failed event. SKU.io tries each event up to three times, a few minutes apart, and also picks up failed events again every 30 minutes. The Attempts column shows how many tries an event has had. An event that has failed three times is left for you.
Processed events are deleted after 14 days. Pending and failed events stay until they're processed or you delete them.
Steps
Find the event
- Go to Apps & Integrations, open Shopify, and pick your store from the selector at the top.
- Click Webhooks. The Events tab opens.
- Click the Failed card to list the failed events.
- To find the events for one order, type Shopify's ID for the order in Search webhook events.... That's the number at the end of the order's address in Shopify admin, and it shows in the Unique ID column. Use Topic to narrow the list to order events, such as Orders - Updated.
- Click the event's number in the ID column to open it. The Processing Error section shows what went wrong, and Payload shows the data Shopify sent.
Run the failed events again
To run every failed event in one go, click Retry Failed at the top of the list. SKU.io runs each failed event that has had fewer than three attempts and tells you when it's done. Events that already failed three times are skipped, so run those one at a time.
To run one event, use the buttons in its Actions column, or in the event's details:
- Process Event runs a pending or failed event. SKU.io asks you to confirm, and warns you when the event has been tried before. Click Process.
- Reprocess Event runs any event again, including one that's already Processed. It doesn't ask first.
To run several events again, tick them in the list and click Reprocess. Choose Selected Only to run the ticked events, or All Filtered to run every event that matches your filters.
Check the result
- Click the refresh button in the toolbar. The event moves to Processed, or back to Failed with a new error.
- For an order event, open Orders in the Shopify integration and find the order. The sales order catches up within about a minute.
When to use which action
| Use | When |
|---|---|
| Retry Failed | Several events failed together, for example during a short Shopify outage, and you want to clear them all. |
| Process Pending | Events are sitting in Pending and you don't want to wait for the next automatic run. |
| Process Event | One event failed three times, and you've fixed what blocked it, such as a missing product mapping. |
| Reprocess Event or Reprocess | An event shows Processed, but the order or product in SKU.io doesn't match Shopify, and you want SKU.io to apply that event again. |
Each event carries the order as it was when Shopify sent it. When an order has several events, reprocess the newest one, so SKU.io doesn't go back to an older copy of the order.
Why an order never imports twice
Running an order event again, or Shopify sending the same order twice, doesn't create a second sales order. SKU.io keeps one copy of each Shopify order per store, matched on Shopify's order ID, and only updates that copy when another event arrives. A sales order is created only when that Shopify order doesn't have one yet, and only one creation can run for an order at a time. Once the sales order exists, every later event for that order updates it instead.
So you can retry or reprocess an order event as often as you need. The worst case is that SKU.io applies the same order details again.
Next steps
- When a Shopify order is cancelled: what an order update from Shopify does when the order is cancelled.
- Set up Shopify returns: how refunds and returns from Shopify reach SKU.io.
- How Shopify inventory sync works: what happens to the stock events Shopify sends.