BurtonSoftware01 适用范围
当第三方 ERP、OMS 或电商平台提供 OAuth 2.0，并且 Burton 已具备对应连接器或完成项目适配时，可通过平台官方授权页面建立连接。客户无需在 Burton 文档或工单中提交平台登录密码。
OAuth 并非所有系统的统一接入方式。对于仅提供 API Key、Token、签名接口或文件交换的平台，应采用对应认证方案。
02 授权前准备
| 准备项 | 要求 |
|---|---|
| 账号权限 | 使用目标平台具有授权权限的管理员账号。 |
| 连接范围 | 明确店铺、组织、站点、仓库和环境。 |
| 权限清单 | 确认订单读取、商品读取、库存、履约回传等必要范围。 |
| 基础映射 | 准备客户、SKU、仓库、承运商和状态映射。 |
| 浏览器环境 | 确认已登录正确账号，避免授权到错误组织。 |
从 Integrations 选择目标连接器；实际按钮和字段以已启用的连接器为准。
03 标准授权流程
- 在 Burton Integrations 或 Setup Wizard 中选择目标平台。
- 确认连接名称、环境、客户和店铺范围。
- 点击 Connect 后进入第三方平台官方授权页面。
- 核对登录账号、组织和权限范围，再批准授权。
- 返回 Burton 后确认连接状态、授权时间和可访问范围。
- 使用测试订单验证读取、履约和回传链路。
Setup Wizard 可用于维护连接参数、业务映射和上线检查项。
04 授权后验证
- 连接状态显示为 Connected 或项目定义的有效状态。
- 测试订单能够进入指定客户与仓库，且不会重复创建。
- SKU、数量、地址、物流服务和状态映射符合方案。
- 发货后能够回传承运商、Tracking 和履约状态。
- Activity Logs 能够定位授权、限流、字段或回调异常。
05 安全与变更控制
Burton 不要求客户在公开文档、即时通信或截图中提供密码、Client Secret、Refresh Token。凭证应按最小权限配置，并区分测试与生产环境。管理员变更、平台安全事件或合作终止时，应及时撤销或重新授权。
权限范围、回调地址、平台 API 版本或店铺归属发生变化时，应先在测试环境验证，再安排生产变更。
06 常见问题
| 问题 | 建议检查 |
|---|---|
| 授权后仍未连接 | 回调地址、应用状态、授权账号与权限范围。 |
| 授权到了错误店铺 | 立即断开，退出第三方平台账号后重新授权。 |
| 连接一段时间后失效 | Token 生命周期、管理员变更、权限撤销和平台策略。 |
| 页面没有目标 ERP | 该连接器可能尚未启用，应提交系统名称和接口资料进行评估。 |
| 只需接收订单 | 可评估最小权限模式，仅开放订单及必要履约范围。 |