接口工程能力
金蝶云星空接口全生命周期管理
从接口开发、联调测试到上线运行、监控告警，每一步都在集成网关里完成，不需要在金蝶里装插件。
- 接口地址统一为
/k3cloud/Kingdee.BOS.WebApi.ServicesStub.服务.方法.common.kdsvc - 查询接口的 FormId 放在 data 里；查看、保存类接口的 formid 放在顶层，而且要小写
- FormId 不能凭命名规律猜，接入前逐个在客户账套里核对
01接口开发
- 按单据类型封装保存、提交、审核
- 字段映射、编码对照配置化
02联调测试
- 先在测试账套跑通，再切正式账套
- 请求与响应全量留痕，问题逐笔定位
03发布上线
- 测试、正式账套独立配置，切换不改代码
- 服务重启后排队中的任务继续执行
04运行监控
- 推送状态一屏可见，失败单据一键重推
- 可恢复错误自动退避重试，不可恢复的挂起并列出原因
登录方式
登录方式：用官方推荐的签名登录
签名登录 官方推荐
金蝶管理员在「第三方系统登录授权」里新增一个应用，指定集成用户，把应用 ID、密钥、账套 ID 交给对接方。接口方法 AuthService.LoginBySign：账套 ID、用户名、应用 ID、密钥、时间戳排序后做 SHA256 签名。
- 金蝶云星空公有云的新账套只能走第三方授权
- 密钥本身不在网络上传，只传签名
老方式要整改
应用密钥直接登录 LoginByAppSecret、账号密码登录 ValidateUser，金蝶官方已标为「不推荐，需要整改」。
- 老账套还在用的，接入时一并改成签名登录
- PT-146911 之前的版本签名用 SHA1，其余用 SHA256
密钥怎么保管
密钥只存在对接程序的配置里；报文留痕时密钥字段自动脱敏，日志里看不到明文。
- 买断版：密钥在你们自己的服务器上
- 项目结束可以随时在金蝶里停用这个应用
接口资产
金蝶云星空常用接口
集成网关里已经封装好的接口，上线前都会在客户的测试账套里先联调一遍。
POST单据查询
按条件查多张单据的指定字段。FormId 放在 data 里，返回二维数组。
DynamicFormService.ExecuteBillQueryPOST查看单据
取一张单据的完整对象。formid 在顶层且必须小写，写进 data 会报错。
DynamicFormService.ViewPOST保存
新建或修改单据、基础资料，返回金蝶单号，回写到推送记录。
DynamicFormService.SavePOST提交
保存后提交，进入审核流程。
DynamicFormService.SubmitPOST审核
按客户的规则决定推送后是否自动审核。
DynamicFormService.AuditPOST登录授权
签名登录，同一账套的会话在单据之间复用，过期自动重新登录。
AuthService.LoginBySign表单标识
常用表单 FormId
FormId 必须逐个验证，不能凭命名猜——比如销售价目表是 BD_SAL_PriceList，写成 SAL_PriceList 会直接报「业务对象不存在」。
| 单据 / 资料 | FormId |
|---|---|
| 销售订单 | SAL_SaleOrder |
| 销售出库单 | SAL_OUTSTOCK |
| 应收单 | AR_receivable |
| 客户 | BD_Customer |
| 物料 | BD_MATERIAL |
| 销售价目表 | BD_SAL_PriceList |
| 销售退货单 | SAL_RETURNSTOCK |
| 采购入库单 | STK_InStock |
| 收款单 | AR_RECEIVEBILL |
| 仓库 | BD_STOCK |
不同版本、不同账套可能有差异，接入前逐个在客户账套里核对。
相关集成方案
金蝶云星空与其他系统对接
聚水潭对接金蝶云星空
网店的销售出库、售后退货、采购入库逐单进金蝶，不用等聚水潭月结，每一单都能追到。
查看方案旺店通对接金蝶云星空
出库、退货、收款按类同步；旺店通接口本身收费，报价前先讲清楚，不重推就不多付调用费。
查看方案开单系统对接金蝶云星空
开好的单、出了库的货自动生成金蝶单据；客户、物料以金蝶为准拉回来，两边不用重复维护。
查看方案更多系统组合
吉客云、用友 U8 / T+、金蝶 KIS、淘宝奇门、钉钉……先看对方开放了什么接口，再告诉你能不能接。
查看可对接系统金蝶、金蝶云星空为其权利人的商标，本页仅用于说明对接对象，鹰翔科技与金蝶不存在隶属、代理或授权关系。接口说明以金蝶官方文档为准。