> ## Documentation Index
> Fetch the complete documentation index at: https://learn.orbexa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ORBEXA WooCommerce集成接入指南

> WooCommerce商店接入ORBEXA完整操作指南：通过REST API密钥连接你的商店，实现商品信息、订单状态与库存数量的三向自动同步，配置Webhook实时事件处理与数据完整性验证机制，包含连接测试端点说明和同步状态查询方法，助力WooCommerce电商站点快速融入AI代理商务生态

# WooCommerce接入

## 概述

WooCommerce接入通过REST API实现，提供完整的商品、订单和库存三向同步。与Shopify的OAuth授权不同，WooCommerce需要商家提供API密钥完成连接。

## API端点

ORBEXA为WooCommerce集成提供以下端点：

### 连接管理

| 端点                                      | 方法   | 功能              |
| --------------------------------------- | ---- | --------------- |
| `/api/integrations/woocommerce/connect` | POST | 连接WooCommerce商店 |
| `/api/integrations/woocommerce/test`    | POST | 测试连接是否正常        |

### 数据同步

| 端点                                             | 方法   | 功能     |
| ---------------------------------------------- | ---- | ------ |
| `/api/integrations/woocommerce/sync/products`  | POST | 同步商品数据 |
| `/api/integrations/woocommerce/sync/orders`    | POST | 同步订单数据 |
| `/api/integrations/woocommerce/sync/inventory` | POST | 同步库存数据 |

### Webhook管理

| 端点                                              | 方法   | 功能          |
| ----------------------------------------------- | ---- | ----------- |
| `/api/integrations/woocommerce/webhooks/setup`  | POST | 注册Webhook   |
| `/api/integrations/woocommerce/webhooks/handle` | POST | 接收Webhook事件 |

## 连接流程

### 步骤1：生成WooCommerce API密钥

商家在WooCommerce后台（Settings -- Advanced -- REST API）创建API密钥，获取Consumer Key和Consumer Secret。

### 步骤2：连接商店

通过`/api/integrations/woocommerce/connect`端点提交：

* WooCommerce商店URL
* Consumer Key
* Consumer Secret

### 步骤3：测试连接

调用`/api/integrations/woocommerce/test`端点验证连接是否成功。ORBEXA会尝试访问WooCommerce REST API确认凭据有效。

### 步骤4：同步数据

连接成功后，分别调用三个同步端点拉取商品、订单和库存数据。

## 三向同步

### 商品同步

* 从WooCommerce拉取全部商品数据
* 包含名称、描述、价格、图片、变体、分类
* 进入AI Refinery Pipeline自动清洗
* 同步到所有协议端点

### 订单同步

* 同步WooCommerce订单到ORBEXA
* 支持ACP `commerce.order_status`查询
* 订单状态变更实时反映

### 库存同步

* 实时同步库存数量
* UCP/ACP/MCP端点的库存查询始终反映最新状态
* 库存不足时AI代理可获知准确信息

## Webhook配置

通过`/api/integrations/woocommerce/webhooks/setup`端点一键注册所有Webhook。注册后，WooCommerce会在以下事件发生时自动通知ORBEXA：

* 商品创建/更新/删除
* 订单创建/更新
* 库存变动

所有Webhook事件通过`/api/integrations/woocommerce/webhooks/handle`端点统一处理。

## 平台调用限速

ORBEXA对WooCommerce API的调用限制在 **5次/秒**，确保不超过WooCommerce服务器的承载能力。这是平台侧的限速，AI代理访问ORBEXA端点不受此限制。

## 与Shopify接入的对比

| 特性      | Shopify   | WooCommerce  |
| ------- | --------- | ------------ |
| 授权方式    | OAuth自动授权 | API密钥手动配置    |
| 初始设置    | 零代码       | 需要生成API密钥    |
| Webhook | 自动注册      | 调用setup端点注册  |
| 平台限速    | 2次/秒      | 5次/秒         |
| 数据同步    | 自动触发      | 手动或Webhook触发 |

## 小结

WooCommerce接入提供完整的商品/订单/库存三向同步，7个API端点覆盖连接、同步和Webhook全流程。配置完成后，数据自动流入ORBEXA的协议端点栈。

***

下一章：[WordPress插件接入](/zh/book-7/ch4-wordpress) -- 一键连接、自动创建商家账户和API密钥