n8n-nodes-kingdee
金蝶云星空 n8n 社区节点，提供金蝶云星空 WebAPI 的集成支持。
安装
参考：https://docs.n8n.io/integrations/community-nodes/installation/
节点名称：@luka-cat-mimi/n8n-nodes-kingdee
功能特性
- ✅ 支持金蝶云星空 WebAPI 调用
- ✅ 两种凭证认证方式：
- 应用授权（推荐）：使用 AppID + AppSecret 进行认证
- 账户密码（已废弃）：使用用户名密码进行认证
- ✅ 自动 Cookie 会话管理
- ✅ 响应数据自动处理（日期格式、多语言字段）
- ✅ 支持批量并发请求
支持的资源与操作
共计 46 个资源，覆盖基础资料、财务会计、供应链、生产制造、质量管理、税务管理等模块。
基础资料
| 资源 |
FormId |
支持的操作 |
| 员工 |
BD_Empinfo |
查看、查询、启用、禁用 |
| 系统用户 |
SEC_User |
查询、更新、启用、禁用 |
| 物料 |
BD_MATERIAL |
查看、查询、保存、删除、暂存、提交、审核、反审核、启用、禁用、分配、取消分配、撤销、分组保存、分组删除、查询分组信息、批量保存 |
| 计量单位 |
BD_UNIT |
查看、查询 |
| 存货类别 |
BD_MATERIALCATEGORY |
查看、查询 |
基础管理 - 组织管理
| 资源 |
FormId |
支持的操作 |
| 组织机构 |
ORG_Organizations |
查看、查询 |
财务会计 - 出纳管理
| 资源 |
FormId |
支持的操作 |
| 付款单 |
AP_PAYBILL |
保存、提交、审核 |
| 收款单 |
AR_RECEIVEBILL |
查看、查询、删除、暂存、保存、提交、审核、反审核、撤销、下推、作废、批量保存 |
| 付款申请单 |
CN_PAYAPPLY |
查看、查询 |
财务会计 - 应付款管理
| 资源 |
FormId |
支持的操作 |
| 应付单 |
AP_Payable |
查看、查询 |
财务会计 - 应收款管理
| 资源 |
FormId |
支持的操作 |
| 应收单 |
AR_receivable |
查看、查询 |
财务会计 - 总账
| 资源 |
FormId |
支持的操作 |
| 凭证 |
GL_VOUCHER |
查看、查询 |
| 科目余额表 |
GL_RPT_AccountBalance |
查询报表数据 |
供应链 - 采购管理
| 资源 |
FormId |
支持的操作 |
| 采购订单 |
PUR_PurchaseOrder |
查看、查询、保存 |
| 采购申请单 |
PUR_Requisition |
查看、查询 |
| 收料通知单 |
PUR_ReceiveBill |
查看、查询 |
| 采购入库单 |
STK_InStock |
查看、查询 |
供应链 - 销售管理
| 资源 |
FormId |
支持的操作 |
| 销售订单 |
SAL_SaleOrder |
查看、查询 |
| 发货通知单 |
SAL_DELIVERYNOTICE |
查看、查询 |
| 销售出库单 |
SAL_OUTSTOCK |
查看、查询 |
供应链 - 库存管理
| 资源 |
FormId |
支持的操作 |
| 即时库存 |
STK_Inventory |
查询 |
| 库存同步 |
STK_InvUpdateToGY |
查询 |
| 出库申请单 |
STK_OutStockApply |
查看、查询 |
| 直接调拨单 |
STK_TransferDirect |
查看、查询 |
| 其他出库单 |
STK_MisDelivery |
查看、查询 |
| 其他入库单 |
STK_MISCELLANEOUS |
查看、查询 |
生产制造 - 委外管理
| 资源 |
FormId |
支持的操作 |
| 委外订单 |
SUB_SUBREQORDER |
查看、查询 |
| 委外领料单 |
SUB_PICKMTRL |
查看、查询 |
| 委外超耗单 |
SUB_EXCONSUME |
查看、查询 |
生产制造 - 工程管理
| 资源 |
FormId |
支持的操作 |
| 物料清单 |
ENG_BOM |
查看、查询、保存、删除、提交、审核、反审核、禁用、反禁用、撤销、分配、取消分配、分组保存、分组删除 |
生产制造 - 计划管理
| 资源 |
FormId |
支持的操作 |
| 计划订单 |
PLN_PLANORDER |
查看、查询 |
生产制造 - 生产管理
| 资源 |
FormId |
支持的操作 |
| 生产订单 |
PRD_MO |
查看、查询 |
| 生产领料单 |
PRD_PickMtrl |
查看、查询 |
| 生产补料单 |
PRD_FeedMtrl |
查看、查询 |
| 生产退料单 |
PRD_ReturnMtrl |
查看、查询 |
| 生产汇报单 |
PRD_MORPT |
查看、查询 |
| 生产入库单 |
PRD_INSTOCK |
查看、查询 |
质量管理
| 资源 |
FormId |
支持的操作 |
| 检验单 |
QM_InspectBill |
查看、查询 |
| 生产退料请检单 |
QM_ReturnMtrAppQc |
查看、查询 |
税务管理 - 发票管理
| 资源 |
FormId |
支持的操作 |
| 采购普通发票 |
IV_PURCHASEOC |
查看、查询 |
| 采购增值税专用发票 |
IV_PURCHASEIC |
查看、查询 |
| 进项费用普通发票 |
IV_PUREXPINV |
查看、查询 |
| 进项费用增值税发票 |
IV_PUREXVATIN |
查看、查询 |
| 销售增值税专用发票 |
IV_SALESIC |
查看、查询 |
| 销售普通发票 |
IV_SALESOC |
查看、查询 |
| 金税开票单 |
IV_GTINVOICE |
查看、查询 |
成本管理 - 存货核算
| 资源 |
操作 |
FormId |
说明 |
| 成本管理 |
存货收发存汇总表（按日期） |
HS_INOUTSTOCKSUMMARYBYDATERPT |
查询报表数据 (GetSysReportData) |
操作说明
| 操作 |
API 方法 |
说明 |
| 查看 |
View |
按编码或内码查看单据详情 |
| 查询 |
ExecuteBillQuery |
批量查询列表，支持分页、过滤、排序、字段选择 |
| 保存 |
Save |
新增或更新单据 |
| 暂存 |
Draft |
暂存单据草稿 |
| 提交 |
Submit |
提交单据 |
| 审核 |
Audit |
审核单据 |
| 反审核 |
UnAudit |
撤销审核 |
| 删除 |
Delete |
删除单据 |
| 撤销 |
CancelAssign |
撤销单据 |
| 下推 |
Push |
下推生成下游单据 |
| 作废 |
Cancel |
作废单据 |
| 批量保存 |
BatchSave |
批量新增或更新单据 |
| 查询报表数据 |
GetSysReportData |
查询系统报表数据 |
过滤条件语法
查询操作支持 SQL 风格的过滤条件：
-- 单条件查询
FForbidStatus = 'A'
-- 模糊查询
FName LIKE '%张%'
-- 多条件 AND
FForbidStatus = 'A' AND FIsLocked = 0
-- 多条件 OR（并集查询）
FUserAccount = '111' OR FEmail = '222'
-- IN 查询
FUserAccount IN ('user1', 'user2', 'user3')
-- 复合条件
(FUserAccount = '111' OR FEmail LIKE '%@company.com') AND FForbidStatus = 'A'
凭证类型
应用授权凭证（推荐）
| 字段 |
说明 |
| API 请求域名 |
企业访问金蝶云星空的域名，支持 /K3Cloud 或 /galaxyapi 后缀 |
| 账套 ID |
在金蝶后台「在线测试 WebAPI」->「WebAPI 在线验证」页面获取 |
| 用户名 |
登录用户名 |
| 应用 ID |
后台授权的应用 ID |
| 应用密钥 |
后台授权的应用密钥 |
| 组织编码 |
多组织时填写，非必填 |
| 语言种类 |
简体中文(2052) / 英文(1033) / 繁体中文(3076) |
账户密码凭证（已废弃）
⚠️ 此认证方式已被金蝶官方废弃，推荐使用应用授权凭证。
| 字段 |
说明 |
| API 请求域名 |
同上 |
| 账套 ID |
同上 |
| 用户名 |
登录用户名 |
| 密码 |
登录密码 |
| 语言种类 |
同上 |
注意事项
- 使用应用授权凭证时，需要在金蝶后台配置应用并获取 AppID 和 AppSecret
- 账套 ID 可在金蝶后台「在线测试 WebAPI」->「WebAPI 在线验证」页面获取
- 账户密码认证方式已被金蝶官方废弃，建议尽快迁移到应用授权方式
支持
许可证
MIT License
