随着业务规模扩大,许多外贸公司希望将 WooCommerce 网站的数据自动对接到 ERP(企业资源计划)或 CRM(客户关系管理)系统中,实现订单同步、库存同步、客户数据共享等目标。WooCommerce 提供了完整的 REST API,使这种对接成为可能。
🔌 一、WooCommerce REST API 简介
WooCommerce 提供了基于 REST 的 API,支持以下操作:
类别 | 示例功能 |
---|---|
产品接口 | 获取/新增/修改/删除商品 |
订单接口 | 获取订单详情、新订单创建通知 |
客户接口 | 获取客户信息、创建客户 |
折扣券接口 | 创建优惠码、限制使用 |
报表接口 | 查看销售、订单、客户趋势 |
⚙️ 二、API 开启与密钥配置步骤
要开始使用 WooCommerce API,需要进行以下设置:
进入后台 → WooCommerce → 设置 → 高级 → REST API
点击 “添加密钥”,设置权限为 “读/写”
系统会生成一对密钥:
Consumer Key
Consumer Secret
建议只给予最小权限,例如只让 ERP 读取订单数据,而不能修改产品。
开启 Permalink 固定链接,API 才能正常访问。
📬 三、Postman 测试 WooCommerce API 示例
示例:获取所有订单信息
请求地址:
bash
GET https://yourdomain.com/wp-json/wc/v3/orders
请求头或 URL 参数中添加认证信息:
bash
?consumer_key=ck_xxxxxxxx&consumer_secret=cs_xxxxxxxx
Postman 请求截图如下:
bash
GET https://yourdomain.com/wp-json/wc/v3/orders?consumer_key=ck_xxx&consumer_secret=cs_xxx
成功返回的 JSON 数据结构示例:
json
[
{
"id": 1001,
"status": "processing",
"currency": "USD",
"total": "199.00",
"billing": {
"first_name": "Alice",
"last_name": "Wang"
},
"line_items": [
{
"product_id": 51,
"quantity": 2,
"subtotal": "89.00"
}
]
}
]
🔄 四、对接 ERP 的常见方式
对接方式 | 特点 | 示例工具 |
---|---|---|
自建 API 接口对接 | 灵活度高,可定制 | 使用 Python/PHP 脚本从 WooCommerce 拉取订单、推送至 ERP |
使用中间件连接器 | 快速部署、适配多个平台 | Zapier、Make、n8n |
购买现成 ERP 插件 | 稳定性强,但成本较高 | Webgility、Odoo WooCommerce Connector |
使用 WooCommerce Webhook | 实时推送特定事件 | 订单创建时推送给指定 URL 接口处理 |
🧠 五、常见对接需求举例
目标 | 示例描述 |
---|---|
自动同步订单至 ERP | 每当有新订单,自动推送到 SAP/用友/U8 |
读取客户信息 | ERP 端导入 WooCommerce 注册用户信息 |
同步库存 | ERP 改变库存后,自动更新 WooCommerce 商品 |
订单物流回传 | ERP 生成运单号后,自动更新 WooCommerce 订单状态与快递号 |
🧱 六、注意事项与安全建议
尽量使用服务器端调用 API,不要暴露密钥到前端
定期轮换 API 密钥,防止泄露
使用 HTTPS 保证数据传输安全
配置防火墙仅允许白名单服务器访问 API
对接后进行测试沙箱环境验证,避免误操作真实订单
✅ 小结
WooCommerce API 为外贸企业提供了灵活、标准化的对接方式,只需生成密钥、调用接口,就可以轻松实现数据共享。结合 Postman、Python、第三方工具,可以极大提升运营效率与自动化水平。