ERP授权回调 — 用户操作手册
功能概述
ERP 授权回调页面可以理解为“ERP 连接结果页”。当您在 ERP 系统里完成授权后，系统会自动跳回本页，继续完成连接确认。大多数情况下，您只需要关注是否显示“授权成功”或“授权失败”，不需要手动处理技术参数。
前置条件
- 已登录品牌管理后台
- 已在ERP对接中心发起授权申请
- ERP系统已正确配置回调地址
一、页面总览
页面由以下几个区域组成：
- 页面标题区：显示"ERP 授权回调"标题和说明文字
- 结果提示区：显示授权处理结果（成功/失败/处理中）
- 授权信息区：展示本次授权返回的关键信息和处理状态
- 结果区：授权成功后显示连接结果和有效期等信息
- 操作按钮区：提供“立即重试”和“返回 ERP 对接中心”按钮
二、自动完成授权流程
Step 1：发起ERP授权
在ERP对接中心的"连接与授权"页面，点击对应ERP系统的"授权"按钮，系统将自动跳转至ERP系统的授权页面。
提示
目前支持的ERP系统包括：管家婆 NGP、金蝶云星空。
Step 2：完成ERP端授权
在ERP系统的授权页面完成登录并确认授权，授权成功后ERP系统会自动跳转回本系统的ERP授权回调页面。
Step 3：系统自动完成连接确认
页面加载后会自动执行以下操作：
- 识别当前 ERP：系统判断您刚刚授权的是哪一个 ERP
- 完成连接确认：系统自动向 ERP 申请正式连接凭证
- 显示处理结果：页面提示授权成功或失败
说明
正常情况下，您只需要等待页面自动处理完成即可。
三、手动重试授权流程
如果页面没有自动完成，或者显示失败，您可以手动重试。
Step 1：确认页面信息
在“授权信息”区域确认以下内容：
| 字段 | 说明 |
|---|---|
| code | ERP 返回的一次性授权码，通常只在短时间内有效 |
| state | 系统用于识别本次授权记录的标识 |
| ERP 类型 | 当前处理的ERP系统类型 |
| 处理状态 | 当前状态：待执行 / 处理中 / 已成功 / 失败 |
Step 2：选择 ERP 类型（如果系统没有识别出来）
如果系统未能自动识别ERP类型，页面会显示警告提示：
"未找到本次授权对应的 ERP 记录，请手动选择 ERP 后继续。"
此时需要：
- 在"ERP"选项中选择对应的ERP系统（管家婆 NGP 或 金蝶云星空）
- 确认选择后，“立即换取 Token”按钮会变为可点击状态
Step 3：点击立即重试
点击“立即换取 Token”按钮后，系统会再次尝试完成 ERP 连接。
注意
- 授权码有效时间较短，过期后需要重新发起授权
- 换取过程中请保持页面打开，不要刷新或关闭
Step 4：查看结果
换取完成后，页面会显示处理结果：
成功时：
- 结果图标变为绿色成功状态
- 标题显示“授权成功”或“连接成功”
- 结果区域显示连接信息
- 系统将在3秒后自动返回ERP对接中心（可点击"取消自动返回"停止）
失败时：
- 结果图标变为红色失败状态
- 标题显示“授权失败”或“连接失败”
- 页面会显示失败原因
- 您可以根据提示重新发起授权
四、查看授权结果
授权成功后，结果区域会显示以下信息：
| 字段 | 说明 |
|---|---|
| AccessToken | 系统与 ERP 通信时使用的连接凭证（页面会做隐藏处理） |
| RefreshToken | 用于续期的连接凭证（页面会做隐藏处理） |
| ERP 账套 ID | ERP系统中的账套标识 |
| AccessToken 有效期 | 当前连接凭证的有效时长 |
| RefreshToken 有效期 | 续期凭证的有效时长 |
| Token 到期时间 | 当前连接失效的时间 |
说明
这些信息会自动保存，普通使用人员无需手动记录。
五、返回ERP对接中心
完成Token换取后，您可以通过以下方式返回ERP对接中心：
- 自动返回：授权成功后系统默认会在3秒后自动跳转
- 手动返回：点击"返回 ERP 对接中心"按钮立即返回
- 取消自动返回：在自动倒计时期间点击"取消自动返回"可停止自动跳转
返回对接中心后，您可以在"连接与授权"页面查看更新后的授权状态，并继续配置数据同步规则。
常见问题
| 问题 | 原因与解决方案 |
|---|---|
| 页面显示“未获取到授权码” | 一般是 ERP 没有正确跳回本系统，或回跳地址没有配对。请回到 ERP 对接中心重新发起授权，并检查 ERP 配置是否完整。 |
| 页面显示“未识别 ERP 类型” | 系统没能判断本次授权属于哪个 ERP。请在页面上手动选择 ERP 类型后再重试。 |
| Token 换取失败，提示授权码过期 | 您在 ERP 页面授权后停留时间过长，导致本次授权失效。请返回 ERP 对接中心重新发起授权，并尽快完成确认。 |
| Token 换取失败，显示其他错误信息 | 多数是 ERP 账号权限不足，或 ERP 侧配置还不完整。请按页面提示检查 ERP 账号、账套和授权设置。 |
| 自动换取Token没有触发 | 页面缺少必要的授权信息。可以手动选择 ERP 类型后点击“立即换取 Token”；如果仍失败，请重新发起授权。 |