PrestaShop + AtoShip
使用 PrestaShop 内置的 WebService API 连接你的店铺——无需安装任何插件或扩展。 在后台生成一个 API 密钥，粘贴到 AtoShip，订单便会立即开始同步。
工作原理
PrestaShop 自带一套 REST WebService API。AtoShip 使用你在后台创建的 WebService 密钥 与其连接。无需额外安装任何模块——开箱即用。
买家下单
新订单出现在 PrestaShop 后台
订单同步到 AtoShip
自动导入买家信息、商品明细与收货地址
购买面单，追踪号回写
追踪号自动写回 PrestaShop 订单
配置（无需插件）
第 1 步 — 启用 WebService API
PrestaShop 的 WebService 默认是关闭的，请先将它打开：
- 进入 高级参数 → WebService
- 将 启用 PrestaShop WebService 设为 是
- 点击 保存
如果看不到 WebService 菜单，请确认你的 PrestaShop 站点可通过 HTTPS 访问。 WebService API 只有在安全连接下才能完整工作。
第 2 步 — 创建 WebService 密钥
仍在 高级参数 → WebService 页面：
- 点击 新增 WebService 密钥
- 点击 生成 创建一个随机 API 密钥
- 在 权限 中，为以下资源至少开启 GET访问权限：
orders、customers、addresses、products、order_details - 同时为
orders和order_histories开启 PUT 访问权限（追踪号回写需要） - 将 状态 设为 已启用
- 点击 保存
- 复制生成的 API 密钥——下一步会用到
第 3 步 — 在 AtoShip 中连接
在你的 AtoShip 控制台中：
- 进入 渠道 → 添加渠道 → PrestaShop
- 填写你的店铺网址（例如
https://your-store.com） - 粘贴第 2 步的 WebService API 密钥
- 点击 连接店铺
AtoShip 会通过 GET /api/ 验证凭据，并自动识别你的店铺名称。 订单将在下一个定时同步周期开始导入。
WebService 权限对照表
以下是 AtoShip 所需的具体权限及其用途：
| 资源 | GET | PUT | 用途 |
|---|---|---|---|
| orders | GET | PUT | 读取订单、更新追踪信息 |
| order_details | GET | — | 读取商品明细与数量 |
| order_histories | GET | PUT | 在发货/送达时更新订单状态 |
| customers | GET | — | 读取买家姓名与邮箱 |
| addresses | GET | — | 读取收货与账单地址 |
| products | GET | — | 同步商品目录 |
你可以授予更多权限——AtoShip 只会使用上表列出的这些。
同步内容
PrestaShop → AtoShip
- 订单号、日期、总金额
- 收货与账单地址
- 商品明细（含商品名称、数量）
- 买家姓名与邮箱
- 订单状态
- 商品目录
AtoShip → PrestaShop
- 追踪号与承运商名称
- 订单状态更新（已发货 / 已送达）
- 含承运商信息的订单历史备注
故障排查
连接失败并提示「Invalid API key」
请确认在 高级参数 → WebService 中，WebService 已设为 已启用，且该密钥的状态也为 已启用。 同时确认该密钥对 orders 至少拥有 GET 访问权限。
后台看不到 WebService 菜单
进入 高级参数 → 性能，检查是否是缓存导致菜单显示异常。 另外，WebService 菜单需要管理员级别的权限——请检查你的后台角色。
订单未同步
AtoShip 按定时任务周期同步。你可以在渠道页面点击 立即同步 触发一次即时同步。 如果仍然失败，请检查店铺网址——它必须包含协议前缀（https://），并与 PrestaShop 实际安装的网址完全一致。
追踪号未回写到 PrestaShop 订单
请确认该 WebService 密钥对 orders 和 order_histories 拥有 PUT 访问权限。 你也可以在 AtoShip 订单详情页点击 重新推送追踪号 按钮，手动回写追踪信息。
环境要求
- PrestaShop 1.7.x 或 8.x
- 已启用 WebService API（高级参数 → WebService）
- 店铺可通过公网 HTTPS 网址访问
- 拥有可创建 WebService 密钥的管理员账号