易仓对接指南

1. 适用范围

本文适用于已使用易仓 ERP、需要将易仓业务数据接入观远连接器的客户。当前连接器已配置订单、商品与 SKU、仓库、出库、费用、财务交易和汇率等数据接口；实际可同步范围以易仓账号已开通的 API 权限为准。

接入前请确认您拥有易仓开放平台账号，并具备创建应用、申请接口权限或完成应用授权的权限。第三方平台页面及权限名称可能因账号类型、组织权限或产品版本不同而变化。

2. 申请易仓开放平台资质

2.1 登录易仓并确认账号权限

1. 使用企业自己的易仓正式环境账号登录 易仓科技开放平台。
2. 确认当前企业已完成开放平台资质认证，且账号具备应用管理权限。
3. 若看不到“工作台”或“应用管理”，请联系企业管理员、易仓客户经理或项目支持人员开通权限。

易仓开放平台的公开接入流程包括：注册并登录、完成资质认证、创建应用、应用授权、接口调试和上线。请按平台实际页面完成申请。

2.2 进入“工作台 > 应用管理”

1. 进入易仓开放平台后，点击顶部“工作台”。
2. 点击左侧“应用管理”。
3. 点击“新增”，开始创建应用。

图中为易仓官网“自研接入流程（ECCANG 客户）”提供的应用管理与新增入口示例。

2.3 创建应用或打开已有应用

1. 先检查是否已有专门用于观远数据对接的应用。
2. 已有应用：打开该应用，确认应用属于本次需要同步数据的易仓正式环境账号。
3. 没有应用：点击“新增”。已购买 ECCANG ERP、用于企业自研对接的客户，应用类型选择“我的应用”。
4. 填写应用名称和应用简介；如页面要求 IP 白名单，填写实际发起接口请求的出口 IP。
5. 在“接口申请”中选择 ERP，并按业务需要勾选订单、商品/SKU、仓库、出库、费用、财务交易、汇率等接口权限。
6. 提交应用，等待审核通过并完成授权。

请勿将密钥发送到聊天、邮件正文或截图中；仅在观远连接器的数据账户表单中填写。若页面要求白名单、回调地址或额外授权，请按易仓开放平台对当前应用的要求配置。

创建应用时，“应用类型”选择“我的应用”，填写基础信息，并在“接口申请”中选择 ERP 及所需接口。

2.4 获取 app_key 和 secret_key

1. 返回“工作台 > 应用管理”。
2. 确认目标应用的状态为“审核通过”并已启用。
3. 在目标应用所在行找到“APP Key”，复制并保存为 app_key。
4. 在同一行找到“Secret Key”，复制并保存为 secret_key。
5. 确认 app_key 与 secret_key 来自同一个应用，不要混用测试环境、历史应用或其他账号下的字段。

官网示例已对真实应用名称和密钥做模糊处理。客户操作时请复制自己应用对应行中的 APP Key 和 Secret Key。

2.5 获取 service_id

1. 仍停留在“工作台 > 应用管理”。
2. 找到同一应用的“授权状态”，点击“查看”。
3. 在“查看接口授权情况”弹窗中选择对应环境，并查看“已授权”页签。
4. 找到“服务ID”，复制并保存为 service_id。
5. 确认该 service_id 与前面获取的 app_key、secret_key 属于同一个应用或同一套接口授权。

在授权状态中点击“查看”，即可在接口授权情况弹窗中看到服务 ID 和已授权接口。

2.6 填写前核对

• 三个字段均来自同一个易仓正式环境应用。
• 应用已启用，并已获得本次项目所需的接口权限。
• 字段复制时没有多余空格、换行、全角字符或遗漏字符。
• secret_key 未出现在公开文档、聊天记录或未脱敏截图中。

2.7 字段汇总

以上字段均为必填。如找不到 app_key 或 secret_key，请先确认当前账号有权查看应用凭据；如找不到 service_id，请确认应用已经完成授权，并在“授权状态 > 查看”中检查接口服务信息。

3. 创建观远连接器数据账户

3.1 选择易仓

在观远连接器进入“数据账户管理”，新增数据账户并选择“易仓”。在表单中填写从易仓开放平台获取的凭据。

选择易仓后，表单会显示账户名称、app_key、secret_key 和 service_id。截图仅展示字段标签和空白输入框，不含真实凭据。

3.2 字段映射关系

3.3 测试连接并保存

1. 核对三个字段来自同一个已授权应用或服务，且没有前后空格。
2. 点击“测试连接”。
3. 测试成功后保存数据账户，并按数据需求选择需要同步的接口。

测试成功仅表示凭据校验通过。若某个业务表无数据或同步失败，请继续确认该接口是否已在易仓侧授权，以及账号是否有对应业务数据访问权限。

4. 常见问题