WooCommerce API 结合 Webhook 实现库存同步：完整实现方案

WooCommerce插件1周前发布 lyc054211

2 0 0

电商网站最怕库存不准——卖多了发不出货，卖少了又压库存。用 WooCommerce 的 API 和 Webhook 功能，就能和仓库系统（ERP/WMS）实时同步库存数据，彻底解决这些问题。下面介绍具体怎么操作。

1. 为什么要实现库存同步

库存同步对于电商平台的重要性体现在：

避免超卖：多渠道销售时，如果库存不同步，可能出现卖出无货的情况
提高发货效率：ERP/WMS 实时获取 WooCommerce 最新订单，及时发货
自动化运营：减少人工核对库存，降低出错率
数据一致性：库存信息随时更新，财务、销售和仓储系统保持一致

2. WooCommerce API 与 Webhook 的区别与配合

WooCommerce API：用于 主动请求和操作 数据，如查询商品库存、更新库存数量。
WooCommerce Webhook：用于 被动接收事件通知，如有订单创建、更新时，WooCommerce 会自动推送事件到指定 URL。

二者结合，可以实现：

Webhook 监听订单变化（如新订单扣库存）
API 更新库存信息（如 ERP 回传实际库存数量至 WooCommerce）

3. 实现库存同步的整体流程

以下为 WooCommerce 与 ERP/WMS 的库存同步逻辑：

WooCommerce Webhook 通知 ERP
- 当 WooCommerce 中创建新订单时，触发 Webhook
- 将订单详情（包括商品 SKU 和数量）发送给 ERP 系统
- ERP 根据库存扣减逻辑更新实际库存
ERP 更新 WooCommerce 库存
- 当仓库收货、补货或其他系统库存变动时
- ERP 通过 WooCommerce API 调用，更新对应商品库存

4. 配置 WooCommerce Webhook

4.1 创建 Webhook

登录 WordPress 后台
进入【WooCommerce】>【设置】>【高级】>【Webhook】

点击【添加 Webhook】

4.2 配置参数

名称：如 “Order Created Webhook”
状态：激活
主题：选择 “Order Created” （订单创建时触发）
传送 URL：填写 ERP 系统接收通知的接口 URL
API 版本：选择最新 v3

保存后，WooCommerce 会在每次有新订单创建时，向 ERP 接口推送订单 JSON 数据。

5. 使用 WooCommerce API 更新库存

当 ERP 收到订单后，完成扣库存处理，需要把最新库存同步回 WooCommerce。

5.1 请求路径

更新单个商品库存的 API Endpoint：

PUT /wp-json/wc/v3/products/{product_id}

5.2 请求参数

JSON 请求体示例：

{
  "stock_quantity": 95, // 更新后的库存数量
  "manage_stock": true // 启用库存管理
}

5.3 cURL 请求示例

curl -X PUT https://example.com/wp-json/wc/v3/products/123 \
    -u consumer_key:consumer_secret \
    -H "Content-Type: application/json" \
    -d '{
      "stock_quantity": 95,
      "manage_stock": true
    }'

6. 注意事项

API 认证配置

使用 WooCommerce REST API 需要生成 Consumer Key 和 Secret

保证 ERP 系统保存并安全管理 API Key

Webhook 安全验证

WooCommerce Webhook 请求头会包含签名，可在 ERP 接收端验证 HMAC-SHA256 确认来源

API 调用频率限制

WooCommerce 本身无严格 rate limit，但服务器配置可能限制短时间过多请求，建议做好队列或节流处理

多仓库处理

如果使用多仓库，需要在 ERP 中根据区域库存计算总库存，再更新到 WooCommerce

7. 高级扩展方案

双向同步
除了 ERP 更新 WooCommerce，如果在 WooCommerce 后台手动修改库存，也可以通过 Webhook 将变化推送到 ERP，实现真正双向同步。
中间件队列架构
对于订单量较大的平台，可以在 WooCommerce 与 ERP 之间使用中间件（如 RabbitMQ、Redis 队列）缓冲请求，确保证保系统稳定。
商品 SKU 对应关系表
保证 WooCommerce 与 ERP 商品 SKU 保持一致，避免更新错误产品。