WooCommerce REST API：使用 SKU 跨站匹配商品并创建订单-php教程-PHP中文网

WooCommerce REST API：使用 SKU 跨站匹配商品并创建订单

本文介绍如何在 woocommerce rest api 创建订单时，不依赖本地 product_id，而是通过商品 sku 在目标站点动态查询对应 product_id，实现多环境（如测试/生产）间订单无缝同步。

本文介绍如何在 woocommerce rest api 创建订单时，不依赖本地 product_id，而是通过商品 sku 在目标站点动态查询对应 product_id，实现多环境（如测试/生产）间订单无缝同步。

在跨站同步 WooCommerce 订单的场景中（例如从测试环境推送订单到生产环境），一个常见痛点是：同一商品在不同站点的 product_id 不一致，但 SKU 唯一且保持一致。此时若直接使用源订单中的 product_id 提交 REST API，将导致商品无法识别、订单创建失败或商品错配。

WooCommerce REST API 的 /orders 端点（如 POST /wp-json/wc/v3/orders）仅接受 product_id 字段作为 line_items 的必填关联标识，不支持直接传入 sku。因此，正确做法是：在提交订单前，针对每个订单项，先通过 /products?sku=xxx 接口在目标站点实时查询该 SKU 对应的真实 product_id，再构造合法的 line_items 数组。

以下是完整、健壮的实现方案（含错误处理与性能优化建议）：

Wordpress REST API

OpenClaw技能，提供WordPress REST API命令行工具，支持通过原生HTTP处理文章、页面、分类、标签、用户及自定义请求。

下载

✅ 核心逻辑：SKU → 远程 product_id 查询

foreach ( $order->get_items() as $item_id => $item ) {
    $quantity = $item->get_quantity();
    $product  = $item->get_product();
    $sku      = $product ? $product->get_sku() : '';

    if ( ! $sku ) {
        error_log( "Warning: Order #{$order_id} item {$item_id} has no SKU. Skipping." );
        continue;
    }

    // 构造远程产品查询 URL（注意：需确保 consumer_key & secret 有 products:read 权限）
    $remote_keys = 'consumer_key=ck_xxx&consumer_secret=cs_xxx';
    $query_url   = "https://live-site.com/wp-json/wc/v3/products?sku=" . urlencode($sku) . "&{$remote_keys}";

    $response = wp_remote_get( $query_url, [
        'timeout' => 15,
        'headers' => [ 'User-Agent' => 'WooCommerce-SKU-Transfer' ]
    ] );

    if ( is_wp_error( $response ) || wp_remote_retrieve_response_code( $response ) !== 200 ) {
        error_log( "Failed to fetch product by SKU '{$sku}': " . print_r( $response, true ) );
        continue;
    }

    $products = json_decode( wp_remote_retrieve_body( $response ), true );
    if ( empty( $products ) || ! isset( $products[0]['id'] ) ) {
        error_log( "No product found for SKU '{$sku}' on remote site." );
        continue;
    }

    $line_items[] = [
        'quantity' => (int) $quantity,
        'product_id' => (int) $products[0]['id']
    ];
}

⚠️ 关键注意事项

权限要求：目标站点的 API key 必须拥有 products:read 权限，否则 /products?sku=... 请求将被拒绝（401/403）。
SKU 唯一性：WooCommerce 默认允许重复 SKU，务必在目标站点确保 SKU 全局唯一（可通过插件如 Unique SKU 或自定义钩子校验）。
性能优化：
- 避免在循环内重复拼接 URL，推荐提前定义 $base_api_url；
- 对高频 SKU 可增加轻量级内存缓存（如 wp_cache_set/get），减少重复请求；
- 生产环境建议添加请求限流（如每秒 ≤2 次）防止触发 API 限速。
容错处理：必须检查 wp_remote_get 返回值、HTTP 状态码、JSON 解析结果及数组结构，避免因单个商品失败导致整个订单同步中断。
变体商品：若涉及可变产品（Variable Product），/products?sku=xxx 同样能精准返回对应变体（variation）的 id，无需额外处理。

✅ 最终订单提交示例（精简版）

$body = [
    'status'     => 'processing',
    'line_items' => $line_items, // ✅ 已填充远程 product_id
    'billing'    => [ /* ... */ ],
    'shipping'   => [ /* ... */ ],
    'meta_data'  => [ /* ... */ ]
];

$response = wp_remote_post(
    "https://live-site.com/wp-json/wc/v3/orders?{$remote_keys}",
    [
        'headers' => [ 'Content-Type' => 'application/json' ],
        'body'    => wp_json_encode( $body ),
        'timeout' => 30
    ]
);

通过该方案，你即可彻底摆脱 product_id 环境依赖，构建稳定、可扩展的 WooCommerce 多站点订单同步链路。