全部 Skill/金蝶云星空 WebAPI

金蝶云星空 WebAPI Skill

金蝶云星空的 WebAPI 跑在客户自己的服务器上，用一个 URL 模式加表单 FormId 操作所有单据和基础资料。本 skill 只覆盖云星空，不覆盖星瀚、苍穹、旗舰版和精斗云。

文档版 · 未实测kingdeeopen.kingdee.comHMAC-SHA256 签名请求头财务 · ERP更新 2026-09-11
6份 reference
6个易错点
4条无凭证探测
2026-09-11文档抓取
INSTALL · 安装

安装

选你用的 Agent，复制命令。

npx -y skills add fxp/skillify --skill kingdee --agent claude-code --yes

装到项目的 .claude/skills/；加 -g 装到全局。装完需要你手动执行 /reload-plugins，这一步 Agent 代劳不了。

或者让 Agent 自己装

读 https://github.com/fxp/skillify/blob/main/skills/kingdee/prompt.md 并照它执行
下载 kingdee.skill 45 KB 源文件 ↗

装对了的标志：references/ 下有 6 份文档。

TRY ASKING · 装好后可以这样问

装好后，可以这样问你的 Agent

这份 Skill 覆盖的典型任务。点一下复制。

CAPABILITIES · 能力清单

6 类能力

每类能力对应一份 reference，Agent 按任务只打开需要的那份。

鉴权与连接

第三方授权签名逐步拆解、SDK 初始化、会话登录、无凭证探测结果

references/auth-and-connection.mdPOST AuthService.ValidateUser · POST AccountService.GetDataCenterList

单据查询

ExecuteBillQuery 参数与分页、View 取整单、QueryBusinessInfo 查字段 key

references/bill-query.mdPOST ExecuteBillQuery · POST View · POST QueryBusinessInfo

单据保存与审核

Save / Submit / Audit / Delete、局部修改、批量保存、下推、状态操作、工作流审批

references/bill-operations.mdPOST Save · POST Submit · POST Audit · POST Push · POST ExcuteOperation

基础资料

物料、客户、供应商的必填字段、多组织分配、禁用与分组

references/master-data.mdPOST Save (BD_MATERIAL) · POST Allocate · POST GroupSave

凭证与应收应付

GL_VOUCHER 结构与借贷写法、核算维度、应收单 / 应付单 / 收款单必填项

references/finance-vouchers.mdPOST Save (GL_VOUCHER) · POST Save (AR_receivable) · POST Save (AP_Payable)

返回与报错

Result.ResponseStatus、批量部分失败、网关 519、SDK 异常与排错清单

references/errors-and-responses.mdResult.ResponseStatus · gateway errcode
FACTS · 当前事实

当前事实

整理自官方文档（抓取于 2026-09-11），还没有用真实凭证验证。

项值
Base URL客户的星空站点 http(s)://<host>/k3cloud/，接口 POST {ServerUrl}/{ServiceName}.common.kdsvc
凭证账套 ID（数据中心 ID）+ 集成用户 + AppID + AppSecret，lcid 默认 2052
官方 SDKpip install kingdee.cdp.webapi.sdk（import k3cloud_webapi_sdk，8.2.0 起 ServerUrl 必填）
请求体外层查询 {"data":{FormId,…}}，写操作 {"formid":…,"data":{…}}
文档版本API 7.5.1800.6（2020-10-15）；补丁要求 ≥ PT136657【7.3.1310.2】
GOTCHAS · 易错点

照通用经验写容易错的 6 件事

来自官方文档，还没有用真实凭证验证。

  1. 没有公共 API 域名。ServerUrl 是客户的星空站点，SDK 8.2.0 已取消默认的 api.kingdee.com/galaxyapi。
  2. 签名是 base64(hex(HMAC))。密钥是 AppID 第二段解码后的值，待签路径里 / 要编码成 %2F，路径后是两个换行。
  3. ExecuteBillQuery 返回裸二维数组。没有字段名和总数，FieldKeys 是逗号串，分页靠 StartRow + Limit（≤2000）。
  4. 改单默认删掉没传的分录。IsDeleteEntry 默认 true，只改一行要传 false 并在 NeedUpDateFields 里带上单据体 key。
  5. 保存 ≠ 生效。Save、Submit、Audit 是三个接口；Numbers 是数组、Ids 是逗号串；状态操作走 ExcuteOperation（拼写没有 e）。
  6. 基础资料引用写对象、跨组织要分配。单据里写 {"FNumber":"编码"}，其他组织要用时调 Allocate，不是再 Save。
STATUS · 验证状态

验证状态

文档版：整理自官方文档（抓取于 2026-09-11），还没有用真实凭证调用验证。页面和 Skill 里标「文档原文，未实测」的报错与行为都来自文档本身。

无凭证探测

  • 旧公网网关 api.kingdee.com/galaxyapi 仍在线：无鉴权调 .common.kdsvc 返回 HTTP 519 与 errcode 4002「应用ID为空」
  • 网关先校验秒级时间戳：13 分钟前的 x-api-timestamp 被判过期（errcode 4006）
  • 网关错误用非标准 HTTP 519，body 为 {errcode, description, description_cn}，与业务层 Result.ResponseStatus 完全不同
  • 网关不接受裸账号密码：对 ValidateUser 同样返回 4002
有这个平台的沙箱或 API Key？联系我们——补测并做完装与不装的对照测试后，它会升级为「已实测」。