技能介绍

订单数据孤岛：电商运营的隐性成本

当 WooCommerce 店铺与外部 ERP 各自维护一套订单数据时，问题就会从「最后一公里」蔓延到全链路。客服看到的订单状态可能滞后，仓库按旧库存发货，财务月底对账时才发现退款和发货记录对不上。手工导出 CSV 再导入 ERP 的做法看似简单，实则容易在字段映射、时区处理和状态回写时出错，而且完全无法应对订单量的自然增长。

这个技能要解决的正是这类重复性数据搬运工作：把 WooCommerce 的订单生命周期与 ERP 系统对接起来，让状态变更、库存扣减和财务凭证在同一个时间线上发生。

核心能力与工作方式

技能基于 WooCommerce REST API v3 与 wp_schedule_event 构建，整体分为三个层次：

订单同步层：通过 REST API 拉取和推送订单数据，支持订单创建、支付、退款、完成等状态的双向流转。当 ERP 中发生退款或换货时，变更会回写到 WooCommerce 对应订单。
事件驱动层：利用 wp_schedule_event 处理订单状态变更 webhook，确保订单状态更新能够被实时捕获并触发后续逻辑，而不是依赖轮询。
库存与对账层：库存调整通过 wc_update_product_stock 完成，技能在同步订单的同时检查库存水平，必要时执行扣减或回补。对账报告则汇总同步窗口内的订单变更、库存变动和状态回写结果，供财务或运营人员核查。

适用边界与注意点

技能假设运行在 POSIX 兼容的操作系统（如 Linux 或 macOS）上。如果你在 Windows 环境工作，需要先通过 WSL 建立兼容层，否则后台定时任务和脚本执行可能无法正常触发。
需要 PHP 7.4+，因为 WooCommerce Core 本身依赖该版本，同时 Composer 和各类构建脚本也在此基础上运行。
依赖管理采用 PNPM 和 Composer，前者处理 JavaScript 项目依赖，后者管理 PHP 包和插件。
Node 版本建议通过 NVM 管理，以对齐上游团队使用的版本，避免本地构建与 CI 环境出现差异。