WooCommerce + AtoShip
把 WooCommerce 店铺的订单同步到 atoship，用折扣价购买 USPS / UPS / FedEx 面单，再把物流单号自动回写——整个流程无需在两个后台之间来回切换。
工作原理
集成由两部分组成：一个安装在 WooCommerce 店铺里的 WordPress 插件，以及来自 atoship 后台的连接。两者协同工作，自动保持订单、物流单号和订单状态的同步。
WooCommerce 里生成新订单
买家在你的店铺下单
订单同步到 atoship
自动导入买家信息、商品明细和重量
购买面单，单号自动回传
物流单号和承运商写回 WooCommerce 订单
安装
第 1 步 — 安装 WordPress 插件
从侧边栏（或下方按钮）下载 atoship-for-woocommerce.zip 文件，然后进入你的 WordPress 后台：
- 插件 → 安装插件 → 上传插件
- 选择 .zip 文件，点击 现在安装
- 点击 启用
启用后，插件会出现在你的插件列表中，并带有「停用」和「删除」操作。
第 2 步 — 从 atoship 连接
在 atoship 后台，进入 渠道 → 添加渠道 → WooCommerce。填写店铺网址并点击「连接」。系统会把你跳转到 WooCommerce 后台以授权 API 访问——授权完成后，两端会自动建立连接。
OAuth 或 API 密钥——选择适合你店铺的方式即可。推荐使用 OAuth，它会自动处理所有步骤。
第 3 步 — 验证连接
授权完成后，在 WordPress 后台进入 WooCommerce → 设置 → AtoShip。你应该能看到 OAuth 状态显示为「已连接」，以及你的 atoship 账户邮箱。
插件设置
所有设置都在 WooCommerce → 设置 → AtoShip 选项卡下。下面说明每个板块的作用：
订单同步设置
- 自动同步订单 — 启用后，符合所选状态的新订单会自动发送到 atoship。
- 同步的订单状态 — 选择要导入哪些 WooCommerce 订单状态。默认：处理中和保留。
- 同步已完成的订单 — 同时导入已标记为完成的订单（首次设置时很有用）。
物流跟踪设置
- 自动完成订单 — 当承运商跟踪显示已送达时，自动把 WooCommerce 订单标记为「已完成」。
- 发送物流跟踪邮件 — 在 atoship 购买面单后，向买家发送一封「您的订单已发货」邮件。邮件包含承运商名称、物流单号，以及一个「跟踪您的包裹」按钮。
Webhook 配置
显示你店铺的 webhook URL 和密钥。这些是自动配置的——除非在排查问题，否则无需改动。webhook 会实时接收来自 atoship 的面单事件（创建、作废）和物流跟踪更新（已发货、已送达、异常）。
调试日志
启用后会把详细日志写入 WooCommerce → 状态 → 日志（来源：atoship）。用于排查同步或 webhook 问题。在生产环境中请保持关闭——它的输出非常冗长。
同步的内容
WooCommerce → atoship
- 订单号、日期、总金额
- 账单地址与收货地址
- 商品行项目（含 SKU、数量、重量）
- 订单备注
- 买家姓名与邮箱
atoship → WooCommerce
- 物流单号、承运商 + 服务名称
- 可视化进度条（备货中 → 已揽收 → 运输中 → 已送达）
- 完整的物流时间线，含事件与地点
- 面单 PDF 链接（用于重新打印）
- 订单状态更新（→ 已完成）
- 送达与异常通知
物流跟踪数据以订单元数据形式存储（_atoship_tracking_number、_atoship_carrier 等），并在订单编辑页的一个信息丰富的元框中显示——无需额外的物流跟踪插件。
订单物流跟踪元框
在 atoship 购买面单后，插件会在 WooCommerce 订单编辑页添加一个内容丰富的 AtoShip Shipping 元框。无需额外的物流跟踪插件——所有功能都已内置。
承运商与服务
显示真实的承运商 logo（FedEx、UPS、USPS、DHL 等）、承运商名称，以及服务等级（Ground、Priority、Express）。
进度条
可视化的 4 步指示器：备货中 → 已揽收 → 运输中 → 已送达。随物流状态变化自动更新。
物流时间线
可折叠的逐条事件时间线，带时间戳和地点，按最新在前排序。
快捷操作
在承运商官网跟踪、查看/重新打印面单 PDF，或作废未使用的面单——全部在订单页面上完成。
物流单号会链接到 atoship 跟踪页面，方便查看详情。物流跟踪数据通过 webhook 实时推送。
批量购买面单
插件会在 WooCommerce 订单的批量操作下拉菜单中添加一个 「AtoShip - Buy Labels」 选项。选中多个订单、选择该操作，你就会被直接带到 atoship 后台，这些订单已预先筛选好——可以随时批量比价并购买面单。
结账时的实时运费
插件会在 WooCommerce 中注册一个 AtoShip Shipping配送方式。启用后（在 WooCommerce → 设置 → 配送 下），买家在结账时会看到实时的 USPS、UPS 和 FedEx 运费——与你在 atoship 购买面单时享受的折扣价一致。
为了保证运费准确，请确保你的商品都设置了重量和尺寸。如果有商品缺少重量数据，插件会在设置页面显示警告。
断开连接
你可以从任意一端断开连接：
- 从 atoship：进入「渠道」，找到你的 WooCommerce 店铺并删除它。WordPress 端的插件会收到通知并自动清除其令牌。
- 从 WordPress：进入 WooCommerce → 设置 → AtoShip，点击「断开连接」。或者在插件页面点击红色的 删除 链接——这会一步完成断开连接、停用并移除插件。
断开连接不会删除店铺中已有的任何订单、物流单号或订单备注，只是停止同步。
故障排查
出现「AtoShip is not configured」提示
插件已启用，但尚未连接到 atoship。按照上面的连接步骤操作——OAuth 完成后，该提示就会消失。
订单没有同步
确认「自动同步订单」已启用，并且订单状态匹配。处于未选中状态的订单不会被导入。你随时可以在 atoship 的「渠道」页面手动触发同步。
WooCommerce 订单上不显示物流跟踪
确保 webhook URL 可从公网访问。如果你的店铺在防火墙后面或运行在 localhost，webhook 就无法送达。可在 WooCommerce → 状态 → 日志 查看是否有 webhook 错误。
商品缺少重量的警告
插件会检查商品重量以准确计算运费。点击警告中的商品链接去设置重量。在修复之前，运费可能不准确。
系统要求
- WordPress 5.8+
- WooCommerce 6.0+
- PHP 7.4+
- 已启用 REST API（WooCommerce 默认开启）
- 使用固定链接（而非「朴素」模式）
- 推荐使用 HTTPS，HTTP 可通过 OAuth 1.0a 工作
v1.1.0· WooCommerce 6.0+ · PHP 7.4+