BigCommerce 集成指南
BigCommerce 集成指南
将您的 BigCommerce 店铺连接到 atoship，通过实时订单同步实现发货流程自动化。
前置条件
开始之前请准备：
- BigCommerce 店铺（任意套餐均可）
- 店铺所有者或管理员权限
- atoship 账户
- 已启用 API 凭证
连接方式
两种选择：
| 方式 | 配置 | 适用场景 |
|---|---|---|
| 安装应用 | 一键完成 | 大多数用户 |
| API 密钥 | 手动配置 | 自定义需求 |
通过 BigCommerce 应用安装
快速配置：
- 登录 BigCommerce
- 前往 Apps → Marketplace
- 搜索 “atoship”
- 点击 Install
- 授权相关权限
- 完成设置
手动 API 连接
分步操作：
- BigCommerce → Settings
- API Accounts → Create
- 设置权限：
- Orders：Read/Modify
- Products：Read
- Customers：Read
- 复制凭证
- 在 atoship 中填入
所需权限
API 权限范围：
- Orders（read、modify）
- Fulfillment（create）
- Products（read）
- Customers（read）
订单导入设置
配置导入：
- 自动导入频率
- 订单状态筛选
- 日期范围选择
- 包含/排除规则
订单状态
状态映射：
| BigCommerce | 操作 |
|---|---|
| Awaiting Fulfillment | 导入 |
| Awaiting Shipment | 导入 |
| Partially Shipped | 导入 |
| Pending | 跳过 |
| Shipped | 跳过 |
配送方式
映射承运商：
BigCommerce Method → AtoShip Service
Standard Shipping → USPS Ground
Express Shipping → UPS Ground
Priority Shipping → UPS 2nd Day
Overnight → FedEx Priority
多店面支持
企业版功能：
- 连接多个店面
- 订单可分开或统一管理
- 支持按店面分别设置
商品信息
同步内容：
- 商品名称
- SKU
- 重量
- 尺寸
- 自定义字段
履约状态更新
自动同步：
- 在 atoship 创建面单
- 抓取追踪单号
- 更新 BigCommerce
- 订单标记为已发货
- 通知买家
配送区域
区域配置：
- 与 BigCommerce 区域保持一致
- 各区域可设置不同费率
- 提供国际配送选项
订单备注
数据传递：
- 导入买家备注
- 包含礼品留言
- 同步特殊说明
库存同步
可选功能：
- 双向库存同步
- 库存数量更新
- 低库存提醒
多渠道订单
统一工作流：
- 与其他渠道合并管理
- 单一发货队列
- 流程始终一致
Webhook 事件
实时更新：
- 新订单通知
- 订单变更提醒
- 取消通知
错误处理
常见问题：
| 错误 | 原因 | 解决方法 |
|---|---|---|
| 认证失败 | 令牌已过期 | 重新连接应用 |
| 找不到订单 | 已完成履约 | 跳过 |
| 触发限流 | 请求过于频繁 | 稍候后重试 |
测试连接
验证步骤：
- 下一笔测试订单
- 检查是否导入到 atoship
- 创建测试面单
- 确认 BigCommerce 已更新
- 确认追踪信息同步
最佳实践
针对 BigCommerce：
- 设置一致的配送区域
- 启用 webhook 通知
- 每日检查订单队列
- 保持库存准确
- 关注同步状态
故障排查
订单未导入：
- 检查订单状态筛选
- 核对 API 凭证
- 检查 webhook 设置
- 测试连接
断开连接
移除集成：
- atoship → Settings
- Integrations → BigCommerce
- 断开连接
- 如有需要，可撤销 API 密钥