OpenCart + AtoShip
在你的 OpenCart 店铺安装 AtoShip 扩展，用 API 密钥连接后，即可获得订单自动同步、 优惠的承运商面单，以及物流单号回写——全部在一套流程里完成。
工作原理
该集成使用一个轻量级 PHP 扩展，为你的 OpenCart 店铺添加一套 REST API。 AtoShip 通过 Bearer token 连接这套 API——无需 OAuth 跳转，也不用繁琐配置。
顾客下单
新订单出现在你的 OpenCart 店铺
订单同步到 AtoShip
自动导入顾客信息、商品和重量
购买面单，物流单号回写
物流单号和承运商信息回写到订单
安装步骤
第 1 步 — 下载扩展
通过侧边栏按钮下载 atoship-for-opencart.zip。 这是一个标准的 OpenCart 4.x 扩展包。
第 2 步 — 通过扩展安装器安装
在你的 OpenCart 后台：
- 进入 Extensions → Installer
- 点击 Upload 并选择
.zip文件 - 等待出现绿色的成功提示
- 点击 atoship 扩展旁的 Install 按钮
第 3 步 — 启用模块
安装完成后，激活该模块：
- 进入 Extensions → Extensions，然后在类型下拉框中选择 Modules
- 找到 Atoship，点击绿色的 Install 按钮（如果尚未安装）
- 点击蓝色的 Edit 按钮
- 将 Status 设为 Enabled，然后点击 Save
- 复制此设置页上显示的 API Key——下一步会用到
第 4 步 — 在 AtoShip 中连接
在你的 AtoShip 控制台：
- 进入 Channels → Add Channel → OpenCart
- 输入你的店铺网址（例如
https://your-store.com） - 粘贴第 3 步复制的 API Key
- 点击 Connect Store
AtoShip 会验证凭据、确认连接，并在你的店铺上注册一个 webhook 端点。 现有订单会开始自动同步。
扩展设置
所有设置都位于 Extensions → Modules → Atoship → Edit。
API Key
安装时自动生成。这是 AtoShip 用来对所有 API 调用进行身份验证的 Bearer token。 在配置过程中复制它，并粘贴到 AtoShip 的连接对话框。如果怀疑密钥泄露，请使用 Regenerate重新生成——请注意，重新生成会断开你当前的 AtoShip 连接，需要重新连接。
HMAC Secret
用于对店铺发送给 AtoShip 的 webhook 载荷签名（例如新订单事件、状态变更）。 自动配置——无需任何手动操作。
已发货状态 / 已送达状态
控制 AtoShip 回写物流单号时（已发货）或承运商报告送达时（已送达）设置为哪个 OpenCart 订单状态。 默认：已发货 → 状态 3，已送达 → 状态 5（Complete）。 请根据你的 OpenCart 订单状态设置进行调整。
Webhook URL
在连接步骤中由 AtoShip 自动设置，仅以只读方式显示供参考。这是你 AtoShip 账户上 接收来自 OpenCart 实时订单事件的端点。
同步哪些内容
OpenCart → AtoShip
- 订单号、日期、总额
- 收货地址和账单地址
- 含 SKU、数量的订单行项目
- 商品图片
- 顾客姓名和邮箱
- 订单状态
AtoShip → OpenCart
- 物流单号和承运商名称
- 承运商物流查询链接
- 订单历史备注（已发货 / 已送达）
- 订单状态更新（已发货 → Complete）
- 顾客订单页上的物流追踪组件
顾客订单追踪组件
在 AtoShip 中购买面单后，顾客会在其订单详情页顶部看到一个实时的 AtoShip Shipping 组件 （/index.php?route=account/order.info）。
承运商与服务
承运商标识（FedEx、UPS、USPS、DHL）、承运商名称和服务等级一目了然。
进度条
四步可视化指示：备货中 → 已揽收 → 运输中 → 已送达。 随物流状态变化自动更新。
物流单号
可点击的物流单号，直接链接到承运商的物流查询页面。
物流时间线
最近 5 条带时间戳的物流事件——由 AtoShip 物流定时任务自动更新。
该组件通过 OpenCart 的事件系统注入，无需修改任何模板。 且仅对该订单的顾客本人显示（通过会话验证）。
故障排查
连接时提示 "Unauthorized"
请确保 API Key 是从扩展设置页原样复制的——不要带多余空格。 同时确认模块的 Status 已设为 Enabled 并已保存。
订单不同步
检查 AtoShip Channels → Edit 中的店铺网址（Store URL）。它必须与你 OpenCart 店铺的公开网址 完全一致（www 的有无也要匹配）。 可在 Channels 页面手动触发一次同步来测试。
OpenCart 订单的物流信息不更新
Webhook 需要你的店铺可公开访问。如果店铺位于防火墙之后或在 localhost 上， webhook 将无法送达。请在 AtoShip 订单详情页使用 Resend Tracking 按钮 手动推送物流数据。
上传后扩展未出现
OpenCart 4.x 不会自动加载扩展。上传 zip 后，你必须在安装器列表中点击该扩展的 Install。如果仍看不到，请在Dashboard →（齿轮图标）→ Refresh 下清除缓存。
环境要求
- OpenCart 4.0.x 或更高版本
- PHP 8.0+
- 已启用 cURL 扩展
- 店铺可通过公开的 HTTPS 网址访问
- 拥有 Extensions 权限的管理员账户
v1.0.0· OpenCart 4.0+ · PHP 8.0+