Shopify Product Sync
How products, orders, and collections synchronize between Shopify and Umbrella.
Shopify Product Sync
Umbrella uses Shopify webhooks to automatically synchronize your products, collections, orders, customers, and fulfillment data in real time. When changes occur in your Shopify store, Umbrella updates warranty eligibility, pricing, and policy records automatically.
What Gets Synced
Products
Umbrella syncs product title, handle, type, vendor, tags, variants (ID, title, price, SKU), images, and collection membership. This data drives warranty plan matching rules (e.g., “apply to all products tagged ‘electronics’”).
Orders
Umbrella processes order number, line items, customer information, payment status, fulfillment status, and refund/cancellation data. This powers warranty policy creation, activation, and claim window calculations.
Other Data
- Collections — Used for collection-based warranty eligibility rules
- Customers — Associated with warranty policies for account-based lookups
- Fulfillments — Tracked to determine when claim windows begin (if configured to start on shipment)
Manual Reprocessing
If data appears out of sync, trigger a manual reprocess from Dashboard → Settings → Integrations → Shopify:
- Reprocess Products — Re-fetches all products and updates the local cache
- Reprocess Orders — Re-fetches recent orders and reconciles warranty policies
- Reprocess Collections — Re-fetches collections and updates eligibility rules
Large catalogs may take several minutes to complete.
Webhook Reliability
- Shopify delivers webhooks at least once (duplicates are handled safely)
- If the webhook endpoint is temporarily unavailable, Shopify retries with exponential backoff for up to 48 hours
- Use manual reprocessing to recover any missed data
Troubleshooting
| Problem | Solution |
|---|---|
| New products not appearing in warranty rules | Wait 1-2 minutes for webhook processing, then check product sync status |
| Order not creating a warranty policy | Verify the order contains a warranty line item and has been paid |
| Claim window not starting | Confirm the order has been fulfilled |
| Products out of sync after bulk import | Use manual reprocessing to refresh all product data |
Related
- Shopify Integration — Overall Shopify connection setup
- Shopify Checkout Extensions — Checkout warranty display
- Creating Warranty Plans — Product eligibility rules