WooCommerce 对接指南

将 WooCommerce 与 AtoShip 对接，自动化你 WordPress 店铺的发货流程。

前置条件

对接前请确认：

WordPress 已安装 WooCommerce
建议使用 WooCommerce 5.0 及以上版本
拥有 AtoShip 账户
拥有 WordPress 管理员权限

安装方式

方式一：WordPress 插件

进入插件 → 安装插件
搜索「AtoShip Shipping」
点击「现在安装」
启用插件
在「设置」中完成配置

方式二：REST API 对接

生成 WooCommerce API 密钥
在 AtoShip 后台填写
配置同步设置

生成 API 密钥

在 WooCommerce 中：

进入 WooCommerce → 设置
点击「高级」标签页
点击「REST API」
添加密钥：
- 描述：AtoShip
- 用户：管理员
- 权限：读/写
生成 API 密钥
复制 Consumer Key 和 Secret

连接到 AtoShip

在 AtoShip 后台：

进入设置 → 集成
点击「添加店铺」
选择 WooCommerce
填写：
- 店铺网址
- Consumer Key
- Consumer Secret
点击「连接」

同步配置

订单导入设置：

设置项	说明	推荐值
状态筛选	导入哪些订单	处理中（Processing）
同步频率	多久同步一次	15 分钟
自动创建	自动生成面单	关闭

Webhook 设置

实时更新： Webhook 可实现实时同步。

设置步骤：

WooCommerce → 设置 → 高级 → Webhook
添加 webhook：
- 名称：AtoShip Order Update
- 主题（Topic）：Order updated
- 投递 URL：（从 AtoShip 获取）
- 密钥：（从 AtoShip 获取）

数据映射

导入的内容：

订单号
客户信息
收货地址
商品信息
订单备注
配送方式

重量处理：

取自 WooCommerce 的商品重量
可通过 SKU 映射覆盖
无重量时使用默认重量兜底

配送方式映射

将 WC 配送方式对应到承运商：

WC "Flat Rate" → USPS Priority Mail
WC "Free Shipping" → USPS Ground Advantage
WC "Local Pickup" → Do not import

订单流程

标准流程：

WC Order (Processing) → Import → Ship → Update to Completed

状态更新：

AtoShip 操作	WC 状态
已创建面单	已完成（Completed）
已添加物流单号	添加备注

多站点支持

WordPress 多站点（Multisite）：

每个站点单独连接
每个站点使用独立的 API 密钥
在 AtoShip 中统一查看

处理商品变体

商品变体（Variations）：

导入完整的变体标题
通过 SKU 进行映射
可查看属性

自定义字段

添加自定义数据： WooCommerce 自定义字段可以：

传入面单备注
用于配送规则
映射到包裹信息

测试连接

验证配置：

在 WC 中创建一个测试订单
在 AtoShip 中查看是否导入
创建一张测试面单
确认 WC 状态已更新

常见问题

连接错误：

错误	原因	解决方法
401 Unauthorized	API 密钥有误	重新生成密钥
SSL Error	证书问题	启用 SSL
Timeout	服务器响应慢	调大超时时间
CORS	插件冲突	检查安全类插件

订单未同步：

确认订单状态
检查 webhook 投递情况
查看错误日志
测试 API 连接

性能建议

大型店铺：

使用 webhook（而非轮询）
批量处理订单
安排在非高峰时段同步
定期清理旧订单

安全注意事项

最佳实践：

仅使用 HTTPS
定期轮换 API 密钥
尽可能限制 IP 访问
监控 API 使用情况

插件兼容性

已知兼容：

WooCommerce Subscriptions
WooCommerce Bookings
WPML
大多数配送类插件

可能需要额外配置：

自定义结账插件
订单管理插件
部分页面构建器（page builder）

更新对接

WooCommerce 升级时：

升级后进行测试
检查 webhook 状态
确认 API 仍可正常使用
留意任何废弃（deprecation）提示

断开连接

断开步骤：

停用插件（如有使用）
在 AtoShip 设置中移除
在 WC 中删除 API 密钥
移除 webhook

支持资源

获取帮助：

WooCommerce 官方文档
AtoShip 对接指南
WordPress 支持论坛
[email protected]