接 WooCommerce：拉订单进来，推履约出去

最后更新 2026-11-01

在 WooCommerce 里创建 REST API 密钥，把店铺网址、Consumer Key 和 Consumer Secret 填进 Integration，测试、配 Mapping、激活——订单流进来，履约流回去。

WooCommerce 连接器把您 WooCommerce 店铺的订单拉进 OMS，再把履约推回 WooCommerce。它还能推产品与库存，让两边的商品与库存保持同步。一个店铺一个连接：每个店铺有自己的 Consumer Key 和 Consumer Secret。

WooCommerce 接入步骤：先拿凭证，再测试，再配 Mapping，最后激活。

前置条件#

一个运行在 WordPress 上的 WooCommerce 店铺，且有 WooCommerce 设置的管理员权限。
在该店铺有创建 REST API 密钥的权限（WooCommerce → 设置 → 高级 → REST API）。
店铺网址使用 https，且固定链接没有设为朴素模式——REST API 在朴素模式下不能用。

拿凭证#

在店铺后台打开 WooCommerce → 设置 → 高级 → REST API → 添加密钥。
选择密钥所属的用户，把权限设为读写（Read/Write），再生成密钥。必须用读写：连接器不只拉订单，还要把履约、产品与库存推回去。
复制 Consumer Key（以 ck_ 开头）。
在同一页面复制 Consumer Secret（以 cs_ 开头，只显示一次）——两个值拿到后立即妥善保存。

填进 Integration#

打开 Integration → 连接器市场 → WooCommerce → 新建连接。
店铺网址（Store URL）——必填：网店完整网址，含 https，例如 https://www.example.com。填店铺本身的网址，不要填后台地址。
Consumer Key——必填：粘贴从 WooCommerce → 设置 → 高级 → REST API 复制的 Consumer Key（以 ck_ 开头）。
Consumer Secret——必填：粘贴同一页面的 Consumer Secret（以 cs_ 开头）。加密存储，永不回显。

测试连接#

点测试连接。测试分两级：连通性（店铺网址可达、Consumer Key 与 Consumer Secret 被接受）+ 单据级预览（真实拉一个订单，展示「平台字段 → 标准订单」对照）。店铺里还没有订单时，先在 WooCommerce 里下一个测试订单——预览需要一条真实单据。测试失败时先记下报错，对照下方常见问题排查，不要先改其他设置。

配 Mapping / 选模板#

选 WooCommerce 标准模板。它映射订单号、行 SKU、数量、收货地址、履约状态。激活前先用一个真实订单看映射预览——重点确认每个 WooCommerce SKU 都配到了 OMS 产品、地址字段落位正确。

WooCommerce 订单往返：订单进来，履约、产品与库存回去。

激活#

激活后，Integration 按您设的频率拉新订单，并把带追踪号的履约推回 WooCommerce。产品与库存推送让商品与库存保持同步。先在运行监控 / 日志里盯几单，确认无误再放手跑。

常见问题#

测试报 401

Consumer Key 或 Consumer Secret 与店铺对不上，或密钥创建时给了只读权限。复制错误或不完整会被直接拒绝；只读密钥也推不回履约、产品与库存，写调用同样会被拒。

去 WooCommerce → 设置 → 高级 → REST API，新建一个权限为读写（Read/Write）的密钥，把新的 Consumer Key 与 Consumer Secret 原样复制进 Integration，再重新测试。重新生成密钥后旧值会失效，所以要在同一步里把连接里的值一起更新。

REST API 路径不通

WordPress 固定链接设成了朴素模式。朴素模式下店铺页面还能打开，但 WooCommerce REST API 的路径走不通，Integration 连不上 API，自然拉不到订单、也推不回任何东西。

在 WordPress 里打开设置 → 固定链接，选任意一种非朴素的结构，保存后再回 Integration 重新测试连接。

店铺网址填错，测试连不上

Integration 里的店铺网址没有指向店铺本身：最常见是少了 https://，或把后台地址填了进来而不是店铺地址，测试连到了错误的地方，根本到不了 WooCommerce。

把店铺网址字段改成含 https 的完整店铺地址，例如 https://www.example.com——填顾客打开的店铺地址，不要填后台地址——再重新测试。

连接成功但没有新订单进来

连接本身没问题：只是店铺在拉单范围内没有新订单，暂时没有可拉的单据。

在 WooCommerce 店铺下一个测试订单，确认下单时间落在拉单范围内，再手动拉一次，在预览或运行监控 / 日志里确认订单出现。