Square Online 集成
Square Online 集成
将你的 Square Online 店铺与 AtoShip 集成，让电商订单的发货流程更加高效顺畅。
前置条件
开始之前请准备好：
- 一个 Square Online 店铺
- 一个 Square 账户（任意套餐均可）
- 一个 AtoShip 账户
- Square 的管理员权限
Square 产品生态
Square 各产品支持情况：
| 产品 | 是否可与 AtoShip 配合使用 |
|---|---|
| Square Online | 支持（电商） |
| Square POS | 有限支持（自提） |
| Square for Retail | 支持（发货订单） |
连接 Square
OAuth 授权连接：
- 进入 AtoShip 的“设置”
- 选择“集成”
- 点击 Square Online
- 登录 Square
- 授权 AtoShip
- 选择要连接的门店地点
权限范围
我们会访问以下内容：
- 订单（读取）
- 履约状态（更新）
- 商品（读取）
- 客户（读取）
- 门店地点（读取）
订单导入
导入的内容包括：
- 订单详情
- 客户地址
- 商品信息
- 客户所选的配送方式
- 订单备注
订单筛选
导入条件：
| 状态 | 是否导入 |
|---|---|
| 未处理（Open） | 是 |
| 已完成（Completed） | 否 |
| 已取消（Canceled） | 否 |
| 待履约（Needs fulfillment） | 是 |
门店地点管理
多门店支持：
- 连接指定的门店地点
- 从不同发货地发货
- 按门店分别管理库存
配送方式
将 Square 配送方式映射到承运商：
Square Method → AtoShip Service
Free Shipping → USPS Ground
Standard → USPS Priority
Express → UPS Ground
Next Day → FedEx Priority
商品同步
同步的商品信息：
- 商品名称
- SKU（如已设置）
- 重量
- 价格
- 规格/款式
履约状态更新
自动化流程：
- 导入订单
- 在 AtoShip 中生成运单
- 抓取物流跟踪号
- 回传更新至 Square
- 通知客户
实时 Webhook
事件通知：
- 新订单创建
- 订单更新
- 订单取消
- 付款完成
库存注意事项
库存管理：
- 由 Square 负责跟踪库存
- 从可用库存中发货
- 发货后更新库存
自提与发货
订单类型：
- 发货订单 → 使用 AtoShip 处理
- 自提订单 → 在 Square 中处理
- 本地配送订单 → 交由本地快递
客户沟通
通知流程：
- Square 发送订单确认通知
- AtoShip 发送发货确认通知
- 物流跟踪自动更新
- 送达通知
多渠道卖家
统一发货：
- Square Online 订单
- 其他渠道订单
- 汇总到同一个发货队列
常见配置
设置建议：
- 设置默认配送方式
- 配置默认重量
- 开启自动导入
- 设置通知
错误处理
常见问题：
| 错误 | 原因 | 解决办法 |
|---|---|---|
| 授权错误 | 令牌已过期 | 重新连接 |
| 无订单 | 筛选条件过严 | 调整设置 |
| 缺少地址 | 属于自提订单 | 跳过 |
测试集成
验证配置是否成功：
- 下一个测试订单
- 检查是否成功导入
- 创建一张测试运单
- 确认 Square 已回传更新
最佳实践
给 Square 卖家的建议：
- 及时更新商品重量
- 使用统一规范的 SKU
- 密切关注订单队列
- 每天检查发货情况
使用限制
当前限制：
- 仅支持美国境内发货
- 不支持 Square Invoices（发票功能）
- 仅支持电商订单
疑难排查
订单没有出现：
- 检查订单状态
- 确认是发货订单还是自提订单
- 检查门店地点筛选条件
- 测试 Webhook 连接
断开连接
如需移除集成：
- AtoShip →“设置”
- “集成”→ Square
- 断开连接
- 在 Square Dashboard 中撤销授权