用友 ERP U9C OpenApi 调试工具 V1.1.0 说明文档一、工具概述本工具是一款专为用友 U9C ERP 系统打造的 OpenAPI 接口调试客户端用于快速验证、调用 U9C 的各类业务 API支持身份认证、通用 SQL 查询、业务接口调试等核心功能帮助开发 / 运维人员快速完成接口对接、数据验证与问题排查。二、界面与核心功能说明基础配置区请求前置参数表格配置项 说明 示例值BaseURL U9C 服务的根地址格式为http://[服务器IP]/u9c http://192.168.70.131/u9cAPI 身份认证接口地址用于获取 Token /webapi/OAuth2/AuthLoginSelectEnt 企业 / 账套选择下拉框对应 U9C 的多组织架构 虚拟机测试 虚拟机测试ClientId 第三方应用的客户端 ID由 U9C 系统配置分配 MESClientSecret 第三方应用的客户端密钥与 ClientId 配对使用 7c9c76f1f1b943EntCode 企业编码账套编码对应 U9C 的企业档案编码 101OrgCode 组织编码对应 U9C 的组织架构编码 10ApiUrl 目标业务 API 的请求路径调试时自动填充或手动输入 /webapi/CustQueryDataAccessSQL/Qu…Token 身份认证成功后返回的访问令牌用于后续接口鉴权 eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…BizAPI 业务接口分类 / 快捷选择当前示例为通用查询SQL 通用查询SQL搜索框 快速筛选 API 列表当前共支持 87 个 U9C 标准接口 空用于输入关键词筛选请求按钮 点击后根据配置参数发送 API 请求触发接口调用 -请求体输入区左侧用于输入接口的请求参数支持 JSON 格式。示例中调用通用查询SQL接口请求体为json{“SQL”: “select * from base_user”}该请求的作用是执行 SQL 语句查询 U9C 系统的base_user用户档案表数据。响应结果展示区右侧接口调用成功后返回标准化 JSON 格式的响应数据核心字段说明如下表格字段 说明 示例值ResCode 响应状态码0表示接口调用成功 0Success 调用结果布尔值true表示请求成功 trueResMsg 响应消息无错误时为null nullData 业务数据主体为嵌套结构 -IsSuccessed 内部业务执行结果true表示 SQL 执行成功 trueData[] SQL 查询返回的结果集单条用户数据包含以下字段ID用户 IDCreatedOn创建时间CreatedBy创建人ModifiedOn修改时间ModifiedBy修改人Password加密后的用户密码Code用户编码Name用户名称如Enterprise AdministratorIsAlive用户状态true为启用Effective_IsEffective生效状态true为有效 示例中为管理员用户数据三、核心功能流程配置基础参数填写BaseURL、ClientId、ClientSecret、EntCode、OrgCode选择目标企业 / 组织。获取 Token点击请求按钮调用AuthLogin接口完成身份认证Token 自动填充到对应字段。选择业务接口通过BizAPI下拉框或搜索框选择目标业务接口如通用 SQL 查询、单据操作接口等。输入请求参数在左侧输入区按接口规范填写 JSON 格式请求体。执行接口调用再次点击请求按钮发送请求并查看右侧响应结果验证接口返回数据是否符合预期。四、关键注意事项权限控制ClientId/ClientSecret需在 U9C 系统中提前配置第三方应用授权未授权的应用无法获取 Token。EntCode/OrgCode需与实际账套、组织编码一致否则会返回组织不存在错误。通用查询SQL接口需配置数据查询权限仅支持对授权表的查询操作禁止执行增删改 SQL 语句。Token 有效期U9C 的 Token 默认有有效期通常为 2 小时过期后需重新调用AuthLogin接口获取新 Token。安全规范ClientSecret、Token 属于敏感信息禁止在生产环境中明文传输或泄露。通用 SQL 查询接口仅用于调试与数据验证禁止在生产环境中直接通过该接口执行高危 SQL 操作。错误排查若 Token 获取失败优先检查BaseURL连通性、账号密码 / 密钥正确性、企业组织编码是否匹配。若接口返回业务错误可通过ResMsg字段查看具体错误信息核对请求参数格式与权限配置。五、适用场景第三方系统如 MES、WMS与 U9C ERP 的接口对接调试。快速验证 U9C 系统的业务数据如用户档案、物料档案、订单数据。排查 API 接口调用异常定位参数、权限或系统层面的问题。开发阶段的接口原型验证减少直接编码对接的调试成本。六、功能扩展EntInfo.json支持扩展多账套配置通过预设企业编码、组织编码、账套名称实现一键切换不同账套环境无需手动修改参数适配多组织架构场景。u9copenapi.json内置 87 个标准业务接口并支持自定义扩展接口配置可新增 / 修改接口路径、参数模板适配不同版本 U9C 的 API 更新需求。