在 WooCommerce 商店運(yùn)營(yíng)中，庫(kù)存管理非常重要。通過(guò) WooCommerce REST API，開(kāi)發(fā)者可以實(shí)現(xiàn)自動(dòng)化庫(kù)存更新，減少人工操作，提高數(shù)據(jù)同步效率。本文會(huì)詳細(xì)介紹使用 WooCommerce API 更新產(chǎn)品庫(kù)存的方法，幫助你快速上手。

1. 為什么使用 API 更新庫(kù)存

對(duì)于擁有 ERP、POS、WMS 系統(tǒng)或多渠道銷(xiāo)售平臺(tái)的商家，API 更新庫(kù)存有以下優(yōu)勢(shì)：

• 實(shí)時(shí)同步：避免超賣(mài)或庫(kù)存信息滯后。
• 自動(dòng)化流程：減少手動(dòng)更新工作量。
• 對(duì)接第三方系統(tǒng)：無(wú)縫連接庫(kù)存管理系統(tǒng)和 WooCommerce。

2. 準(zhǔn)備工作

在調(diào)用 WooCommerce API 前，需要完成以下配置：

生成 API Key

• 登錄 WordPress 后臺(tái)
• 前往 WooCommerce > 設(shè)置 > 高級(jí) > REST API

• 點(diǎn)擊 添加密鑰

• 選擇用戶，設(shè)置權(quán)限為 Read/Write

• 生成后保存 Consumer Key 和 Consumer Secret

確認(rèn) API 訪問(wèn)權(quán)限

確保目標(biāo)用戶擁有更新產(chǎn)品的權(quán)限（通常為管理員）。

獲取產(chǎn)品 ID

庫(kù)存更新需要對(duì)應(yīng)產(chǎn)品或變體的 ID，可通過(guò) API 查詢(xún)或在后臺(tái)查看。

3. 使用 WooCommerce REST API 更新庫(kù)存

3.1 API Endpoint

更新產(chǎn)品庫(kù)存使用的 Endpoint 格式為：

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

對(duì)于變體庫(kù)存：

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

3.2 請(qǐng)求示例

以下以 PHP + cURL 為例，演示如何更新單個(gè)產(chǎn)品的庫(kù)存數(shù)量：

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

$product_id = 123; // 替換為實(shí)際產(chǎn)品 ID

$data = [
    'stock_quantity' => 50, // 更新為庫(kù)存數(shù)量
    'manage_stock' => true, // 啟用庫(kù)存管理
];

$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 請(qǐng)求參數(shù)說(shuō)明

• stock_quantity：庫(kù)存數(shù)量
• manage_stock：是否啟用庫(kù)存管理（true/false）
• in_stock：是否有庫(kù)存（true/false）

如果使用 Postman 或其他語(yǔ)言（如 Python requests、Node.js axios），請(qǐng)求結(jié)構(gòu)與上述一致。

4. 批量更新庫(kù)存

WooCommerce REST API 也支持 Batch 更新，通過(guò) products/batch Endpoint，可一次更新多個(gè)產(chǎn)品，減少 API 調(diào)用次數(shù)。

使用 Postman 測(cè)試

• 打開(kāi) Postman
• 創(chuàng)建一個(gè) PUT 請(qǐng)求

• URL 輸入：https://yourstore.com/wp-json/wc/v3/products/batch

• 認(rèn)證使用 Basic Auth，填寫(xiě) Username 填寫(xiě) Consumer Key， Password 填寫(xiě) Consumer Secret

• Body 選擇 raw -> JSON，粘貼這段 JSON 數(shù)據(jù)

• 發(fā)送測(cè)試，檢查返回結(jié)果

示例 JSON 結(jié)構(gòu)

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

請(qǐng)求方式同樣為 PUT，Endpoint 為：

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

5. 注意事項(xiàng)

• API 權(quán)限：確認(rèn)密鑰擁有 write 權(quán)限。
• 庫(kù)存同步頻率：如果第三方系統(tǒng)庫(kù)存變動(dòng)頻繁，建議設(shè)置合適的更新間隔，避免 API 調(diào)用過(guò)多。
• 限流和性能：WooCommerce REST API 有服務(wù)器并發(fā)限制，批量接口可以減少請(qǐng)求次數(shù)。
• 多變體產(chǎn)品：變體庫(kù)存更新需要調(diào)用變體專(zhuān)用 Endpoint。

6. 總結(jié)

使用 WooCommerce API 更新庫(kù)存，是自動(dòng)化電商運(yùn)營(yíng)的核心環(huán)節(jié)。無(wú)論是對(duì)接 ERP、WMS，還是自建庫(kù)存管理系統(tǒng)，掌握 REST API 的調(diào)用方法，都能幫助你構(gòu)建穩(wěn)定高效的庫(kù)存更新流程，避免超賣(mài)風(fēng)險(xiǎn)，提升用戶體驗(yàn)。

聯(lián)系我們
教程看不懂？聯(lián)系我們?yōu)槟赓M(fèi)解答！免費(fèi)助力個(gè)人，小企站點(diǎn)！	客服微信
① 電話：020-2206-9892
② QQ咨詢(xún)：1025174874
③ 郵件：info@361sale.com
④ 工作時(shí)間：周一至周五，9:30-18:30，節(jié)假日休息