管易云对接指南
本文用于指导管易云 C-ERP 客户获取云 ERP 授权信息，并在观远数据连接器中创建管易云数据账户。整个过程只需要填写授权页面展示的三项资质，不需要向观远提供管易云登录密码。
1. 适用范围
本指南适用于使用管易云标准 API、需要将管易云业务数据同步到观远的数据账户。客户需要拥有可登录管易云 C-ERP、并可访问“云 ERP 授权”页面的账号。
本文不适用于“管易云奇门”授权。奇门模式除管易云资质外还涉及淘宝奇门应用及 targetAppKey，应按单独的奇门对接流程处理。
2. 获取管易云对接资质
2.1 登录管易云后台并打开授权页面
使用具备相应权限的账号登录管易云官方后台，依次进入“控制面板 → 应用授权 → 云 ERP 授权”。
上图为公开资料中的管易云后台脱敏示例，仅用于辅助识别菜单位置；实际页面可能因产品版本或账号权限不同而略有差异。
2.2 开通云 ERP 授权并保存资质
进入“云 ERP 授权”页面后，如果页面尚未开通，请先按页面提示开通。开通后保存页面展示的 appKey、secret 和 sessionKey。不要把真实密钥粘贴到工单、聊天记录或文档中。
上图已对资质值做脱敏处理。客户只需识别左侧字段名称并复制自己账号页面中的实际值。可从管易云官方后台进入该授权页面。
2.3 需要保存的资质字段
3. 创建观远数据账户
3.1 打开数据账户创建页并选择管易云
在观远数据连接器中进入“数据账户管理”，点击新增数据账户，在所属平台中选择“管易云”。为数据账户填写便于业务人员识别的账户名称。
当前文档包暂未包含观远连接器选择“管易云”后的真实数据账户表单截图；字段映射如下，页面截图待从连接器后台补充。
3.2 字段映射关系
| 管易云字段 | 观远连接器字段 | 是否必填 | 说明 |
|---|
appKey | appKey | 是 | 复制“云 ERP 授权”页面中的同名字段。 |
secret | appSecret | 是 | 字段名称不同；将管易云的 secret 填入连接器的 appSecret。 |
sessionKey | sessionKey | 是 | 复制“云 ERP 授权”页面中的同名字段。 |
3.3 测试连接并保存
- 按上表填写三项资质，注意不要多复制空格或换行。
- 点击“测试连接”。测试成功后，再保存数据账户。
- 如果同一公司有多个管易云环境或租户，请使用清晰的账户名称区分，并逐个测试后保存。
4. 常见问题
| 问题 | 处理建议 |
|---|
| 找不到“云 ERP 授权”菜单 | 确认当前账号拥有控制面板和应用授权权限；若仍不可见，请联系管易云管理员、实施顾问或官方服务人员确认产品版本与功能开通状态。 |
| 页面提示尚未开通 | 先在“控制面板 → 应用授权 → 云 ERP 授权”中完成开通，再复制三项资质。 |
| 测试连接提示认证或签名失败 | 重点核对 secret 是否填入了连接器的 appSecret，以及三项资质是否属于同一个管易云环境；重新复制时避免带入空格或换行。 |
sessionKey 失效或被重置 | 回到管易云“云 ERP 授权”页面获取当前有效值，更新观远数据账户后重新测试连接。 |
| 使用的是管易云奇门接口 | 不要直接套用本指南。奇门模式还需要额外资质和授权步骤，请改用“管易云奇门”对接流程。 |
5. 安全提示
secret 和 sessionKey 属于敏感资质，只应填写在观远连接器数据账户表单中。- 截图、工单和群聊中如需排查问题，请先遮挡真实资质值。
- 资质被重置后，应及时更新观远数据账户并重新测试连接。
| 
