# 金蝶云星空 WebAPI 集成：让 AI 安全地读写业务数据

> Source: https://netray.co/zh/kingdee-webapi-integration-ai
> Language: zh
> Publisher: Netray (netray.co)

金蝶云星空提供基于 HTTP 的 WebAPI，可以登录、按单据查询、查看、保存、提交、审核。让 AI 接入的稳妥做法是：默认只读，通过专用接口账号和最小权限查询，所有写入走保存加提交的草稿流程并由人工确认。模型和中间层都可以部署在企业内网。

越来越多金蝶用户想把 AI 助手接到云星空：问库存、问订单交期、让系统起草采购申请。技术上最常见的入口就是 WebAPI。云星空的开放接口按业务对象（表单标识）组织，例如物料 BD_Material、销售订单 SAL_SaleOrder、采购订单 PUR_PurchaseOrder、生产订单 PRD_MO、即时库存 STK_Inventory，调用方通过登录接口取得会话后，再调用查询、保存等方法。

但「能调通」和「能放心用」是两回事。接口账号权限给多大，AI 生成的查询条件错了怎么办，写入后怎么追溯，这些都需要在架构层面提前设计。

## 云星空 WebAPI 的常用能力

常用方法包括：登录验证（可使用应用 ID 与应用密钥方式的第三方登录授权，具体以所用版本的开放平台文档为准）、单据查询 ExecuteBillQuery、单据查看 View、保存 Save、批量保存 BatchSave、提交 Submit、审核 Audit、反审核 UnAudit、删除 Delete 等。查询接口可按字段列表、过滤条件、排序和分页取数。

不同版本的接口细节、字段名和权限要求有差异，开发前应以你所用云星空版本的官方文档和实际 BOS 表单字段为准，不要照搬网上示例。

- ExecuteBillQuery：按表单标识、字段列表、过滤条件取数，适合做 AI 查数
- View：按内码或编码查看单据完整内容
- Save 与 Submit：创建或修改单据并提交，适合做草稿生成
- Audit：审核动作，建议只保留给人工，不交给 AI 触发

## AI 智能体的典型架构

推荐三层：最上层是对话或工作台入口，中间是工具层，把云星空 WebAPI 封装成少数几个明确的工具，例如查库存、查订单状态、查 BOM、起草采购申请；最下层是部署在内网的开源模型，负责理解问题、选择工具、整理结果。模型本身不直接拿到数据库连接或接口密钥。

工具层负责参数校验、字段白名单、分页上限和日志。用户问「某物料现在还有多少库存」，模型只能产生受限的查询参数，工具层再拼装并执行 ExecuteBillQuery，把返回结果连同使用的过滤条件一起展示出来，用户能看到系统到底查了什么。

- 专用接口账号，权限按岗位拆分，不使用管理员账号
- 字段与表单白名单，禁止任意表单、任意字段读取
- 查询条件、返回行数和耗时全部记录日志
- 写入只创建草稿或暂存单据，提交与审核由人完成

## 典型场景

查询类最容易见效：采购员问某供应商的在途采购订单，计划员问某物料的现存量与可用量，销售问某客户订单的交付状态。这些问题以前要打开多个报表、导出再核对，现在一句话得到带来源的答案。

写入类要谨慎：例如根据缺料情况起草采购申请单，通过 Save 写成暂存状态，采购主管在云星空里审阅修改后再提交。这样既节省录入时间，又不破坏原有的审批流和权限控制。

## 安全、合规与数据位置

接口调用建议只在内网或专线上发生，模型服务器与云星空之间通过受控网关访问。如果你使用的是金蝶云星空的公有云或专属云版本，还需要确认接口的网络开放策略和调用频率限制，并让企业自己的信息安全部门审批。

涉及员工、客户个人信息的字段，应在工具层脱敏或不开放；日志与对话记录按企业数据分类分级要求保存。是否需要等级保护或其他备案，由企业合规部门依据法规判断，我们提供的是数据不出内网的技术条件。

## 什么时候用金蝶自带能力就够了

如果你的需求只是常规报表、固定看板或审批流提醒，云星空自带的报表、BI 与消息功能通常已经够用，不必引入大模型。金蝶自身的 AI 助手也在持续更新，先试用官方能力是合理的第一步。

当你需要跨系统（ERP、MES、质量、文档）提问，或要求私有化部署、自定义工具和审批规则时，再考虑独立的 AI 智能体层会更合适。

## FAQ

### 金蝶云星空 WebAPI 需要额外购买授权吗？

授权和开放策略因版本与合同而异，请向金蝶或你的实施伙伴确认。我们建议在立项前先确认接口调用的授权范围和并发限制。

### AI 可以直接审核单据吗？

不建议。我们的默认设计是 AI 只读、写入只到草稿或暂存，审核和提交由有权限的人在云星空内完成，保持审批留痕。

### 接口账号应该怎么设置权限？

为 AI 工具建立专用用户，按只读场景授予对应业务对象的查看权限，不使用管理员账号，并限制可访问的组织与数据范围。

### 模型能不能自己写 SQL 直接查云星空数据库？

不推荐。直接查库绕过了云星空的权限和业务口径，也不利于升级。优先使用 WebAPI 或受控的只读视图。

### 二次开发的插件和 WebAPI 怎么选？

需要在云星空内部改变界面或业务规则时用 BOS 插件，需要从外部系统读写数据时用 WebAPI。AI 智能体通常属于后者。