WooCommerce API 更新产品库存方法:开发者实用指南

在 WooCommerce 商店运营中,库存管理非常重要。通过 WooCommerce REST API,开发者可以实现自动化库存更新,减少人工操作,提高数据同步效率。本文会详细介绍使用 WooCommerce API 更新产品库存的方法,帮助你快速上手。

20250704113741193-image

1. 为什么使用 API 更新库存

对于拥有 ERP、POS、WMS 系统或多渠道销售平台的商家,API 更新库存有以下优势:

  • 实时同步:避免超卖或库存信息滞后。
  • 自动化流程:减少手动更新工作量。
  • 对接第三方系统:无缝连接库存管理系统和 WooCommerce。

2. 准备工作

在调用 WooCommerce API 前,需要完成以下配置:

生成 API Key

  • 登录 WordPress 后台
  • 前往 WooCommerce > 设置 > 高级 > REST API
20250704134848406-image
  • 点击 添加密钥
20250704135005640-image
  • 选择用户,设置权限为 Read/Write
20250704135219898-image
  • 生成后保存 Consumer KeyConsumer Secret
20250704135412144-image

确认 API 访问权限

确保目标用户拥有更新产品的权限(通常为管理员)。

获取产品 ID

库存更新需要对应产品或变体的 ID,可通过 API 查询或在后台查看。

3. 使用 WooCommerce REST API 更新库存

3.1 API Endpoint

更新产品库存使用的 Endpoint 格式为:

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

对于变体库存:

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

3.2 请求示例

以下以 PHP + cURL 为例,演示如何更新单个产品的库存数量:

<?php
$ck = 'ck_xxxxxxxxxxxxxxxxxxxxxxx'; // Consumer Key
$cs = 'cs_xxxxxxxxxxxxxxxxxxxxxxx'; // Consumer Secret
$site = 'https://yourstore.com';

$product_id = 123; // 替换为实际产品 ID

$data = [
    'stock_quantity' => 50, // 更新为库存数量
    'manage_stock' => true, // 启用库存管理
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $site . '/wp-json/wc/v3/products/' . $product_id);
curl_setopt($ch, CURLOPT_USERPWD, $ck . ':' . $cs);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($ch);
if(curl_errno($ch)){
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

echo $response;
?>

3.3 请求参数说明

  • stock_quantity:库存数量
  • manage_stock:是否启用库存管理(true/false)
  • in_stock:是否有库存(true/false)

如果使用 Postman 或其他语言(如 Python requests、Node.js axios),请求结构与上述一致。

4. 批量更新库存

WooCommerce REST API 也支持 Batch 更新,通过 products/batch Endpoint,可一次更新多个产品,减少 API 调用次数。

使用 Postman 测试

  • 打开 Postman
  • 创建一个 PUT 请求
  • URL 输入:https://yourstore.com/wp-json/wc/v3/products/batch
20250704141151421-image
  • 认证使用 Basic Auth,填写 Username 填写 Consumer Key, Password 填写 Consumer Secret
20250704141433963-image
  • Body 选择 raw -> JSON,粘贴这段 JSON 数据
20250704141538417-image
  • 发送测试,检查返回结果

示例 JSON 结构

{
  "update": [
    {
      "id": 123,
      "stock_quantity": 50,
      "manage_stock": true
    },
    {
      "id": 124,
      "stock_quantity": 30,
      "manage_stock": true
    }
  ]
}

请求方式同样为 PUT,Endpoint 为:

/wp-json/wc/v3/products/batch

5. 注意事项

  • API 权限:确认密钥拥有 write 权限。
  • 库存同步频率:如果第三方系统库存变动频繁,建议设置合适的更新间隔,避免 API 调用过多。
  • 限流和性能:WooCommerce REST API 有服务器并发限制,批量接口可以减少请求次数。
  • 多变体产品:变体库存更新需要调用变体专用 Endpoint。

6. 总结

使用 WooCommerce API 更新库存,是自动化电商运营的核心环节。无论是对接 ERP、WMS,还是自建库存管理系统,掌握 REST API 的调用方法,都能帮助你构建稳定高效的库存更新流程,避免超卖风险,提升用户体验。


了解 宝藏号 的更多信息

订阅后即可通过电子邮件收到最新文章。

© 版权声明

相关文章

暂无评论

none
暂无评论...

了解 宝藏号 的更多信息

立即订阅以继续阅读并访问完整档案。

继续阅读