Shopify 产品同步

Umbrella 使用 Shopify Webhook 实时自动同步您的产品、产品系列、订单、顾客和履约数据。当您的 Shopify 店铺发生变更时，Umbrella 会自动更新保修资格、定价和保单记录。

---

同步哪些内容

产品

Umbrella 会同步产品标题、handle、类型、供应商、标签、变体（ID、标题、价格、SKU）、图片以及所属产品系列。这些数据驱动保修计划的匹配规则（例如“应用于所有带有 ‘electronics’ 标签的产品”）。

订单

Umbrella 会处理订单编号、行项目、顾客信息、付款状态、履约状态以及退款/取消数据。这些数据用于保修保单的创建、激活以及索赔期的计算。

其他数据

• 产品系列 — 用于基于产品系列的保修资格规则
• 顾客 — 与保修保单关联，用于按账户查询
• 履约 — 进行跟踪，以确定索赔期何时开始（如果配置为从发货时开始）

---

手动重新处理

如果数据看起来不同步，请在 仪表板 → 设置 → 集成 → Shopify 中手动触发重新处理：

• 重新处理产品 — 重新获取所有产品并更新本地缓存
• 重新处理订单 — 重新获取近期订单并核对保修保单
• 重新处理产品系列 — 重新获取产品系列并更新资格规则

大型产品目录可能需要几分钟才能完成。

---

Webhook 可靠性

• Shopify 至少投递一次 Webhook（重复投递会被安全处理）
• 如果 Webhook 端点暂时不可用，Shopify 会按指数退避方式重试，最长持续 48 小时
• 使用手动重新处理来恢复任何遗漏的数据

---

故障排除

问题	解决方法
新产品未出现在保修规则中	等待 1-2 分钟让 Webhook 完成处理，然后检查产品同步状态
订单未生成保修保单	确认订单包含保修行项目且已付款
索赔期未开始	确认订单已履约
批量导入后产品不同步	使用手动重新处理刷新所有产品数据

---

相关内容

• Shopify 集成 — Shopify 连接的整体设置
• Shopify 结账扩展 — 在结账时显示保修
• 创建保修计划 — 产品资格规则