Skip to main content
Glama
WaHaiLong

Kingdee MCP Server

by WaHaiLong

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
KINGDEE_APP_IDYes应用ID (AppID)
KINGDEE_ACCT_IDYes账套ID
KINGDEE_APP_SECYes应用密钥 (AppSecret)
KINGDEE_USERNAMEYes集成用户名
KINGDEE_SERVER_URLYes金蝶服务器地址,需包含 /k3cloud/,例如 http://your-server/k3cloud/
MCP_SQLSERVER_HOSTNoSQL Server 主机地址(可选,用于数据库探查)
MCP_SQLSERVER_PORTNoSQL Server 端口(默认 1433)1433
MCP_SQLSERVER_USERNoSQL Server 用户名(建议只读账号,可选)
MCP_SQLSERVER_DATABASENo数据库名(可选)
MCP_SQLSERVER_PASSWORDNoSQL Server 密码(可选)

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
kingdee_usage_reportB

查看 MCP 使用统计报告,包括工具调用频率、成功率、耗时分布等。

此工具分析已记录的使用日志,帮助了解:

  • 哪些工具被高频使用

  • 哪些工具失败率较高

  • API 调用耗时分布

  • 使用时段分布

Returns: str: 使用报告(支持 text/markdown/json 格式)

kingdee_usage_statsA

获取当前会话的使用统计摘要。

返回当前进程内聚合的统计数据:

  • 工具使用次数

  • 成功/失败次数

  • 累计耗时

  • 错误类型统计

Returns: str: 统计数据的 JSON 格式

kingdee_discover_tablesA

搜索 SQL Server 中包含关键字的表名(仅查系统目录,不读业务数据)。

适用场景:

  • 想知道"采购"相关的表有哪些

  • 快速定位业务表名,不记得确切名称时

  • 配合 kingdee_discover_columns 一起使用,先找表再看字段

搜索范围:SQL Server 系统目录(information_schema.TABLES / sys.tables)

Returns: str: 表名列表,含表名、类型、创建时间

kingdee_discover_columnsA

按关键字搜索 SQL Server 中的列名(仅查系统目录,不读业务数据)。

适用场景:

  • 想找一个"供应商编码"字段在哪些表里

  • 接口映射时,确认某个字段在数据库里的实际名称

  • 快速验证 Kingdee API 字段和数据库字段的对应关系

Returns: str: 列名搜索结果,含表名、列名、数据类型、是否可空

kingdee_describe_tableA

查看指定表的完整结构(列名、类型、可空、默认值)。

适用场景:

  • 知道表名,想了解完整字段列表

  • 写 SQL 或做数据建模前,查看表结构

  • 确认 Kingdee API 返回的字段在数据库里的实际类型

已知金蝶常用表名前缀:

  • t_PUR_:采购相关(t_PUR_PurchaseOrder 采购订单)

  • t_SAL_:销售相关(t_SAL_SaleOrder 销售订单)

  • t_STK_:库存相关(t_STK_InStock 入库单)

  • t_BD_:基础资料(t_BD_Material 物料、t_BD_Supplier 供应商)

Returns: str: 表结构详情

kingdee_discover_metadata_candidatesA

发现金蝶数据库中与指定 form_id 或 form_id 前缀对应的表。

这是面向金蝶/K3 场景的辅助工具:根据 form_id 推测对应的数据库表名。

form_id → 表名对应规律:

  • PUR_PurchaseOrder → t_PUR_PurchaseOrder(采购订单)

  • SAL_SaleOrder → t_SAL_SaleOrder(销售订单)

  • STK_InStock → t_STK_InStock(入库单)

  • BD_Material → t_BD_Material(物料)

  • BD_Supplier → t_BD_Supplier(供应商)

  • BD_Customer → t_BD_Customer(客户)

适用场景:

  • 想知道某个 form_id 对应数据库里哪张表

  • 想探索某类单据的所有关联表(如采购全流程:订单→收料→入库)

  • 理解金蝶 form_id 和数据库表名的映射关系

Returns: str: form_id 与表名的候选映射列表

kingdee_query_billsB

查询金蝶云星空任意单据列表,支持过滤、排序和分页。

适用 form_id 示例:PUR_PurchaseOrder(采购订单)、SAL_SaleOrder(销售订单)、 STK_InStock(采购入库)、SAL_OUTSTOCK(销售出库)、STK_MisDelivery(其他出库)。

Returns: str: JSON,含 form_id / count / has_more / data 字段

kingdee_view_billA

根据单据内码 FID 获取单据完整详情(含所有分录字段)。

mode=summary(默认):关联字段只保留 Id / Number / Name,大幅缩减体积, 适合参照旧单建新单。完整数据动辄 10 万字符,summary 通常在 1 万以内。 mode=full:返回原始 JSON。

Returns: str: JSON 格式的单据数据

kingdee_query_purchase_ordersA

查询采购订单(PUR_PurchaseOrder)列表。

常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定供应商: "FSupplierId.FNumber='S001'"

  • 指定日期: "FDate>='2024-01-01' and FDate<='2024-12-31'"

  • 未关闭: "FCloseStatus='A'"

  • 业务正常: "FBusinessClose='A'"

推荐 field_keys(默认已包含关键执行字段): FID,FBillNo,FDate,FDocumentStatus,FSupplierId.FName,FPurchaseDeptId.FName, FTaxAmount,FAllAmount,FReceiveQty,FStockInQty

注:FTotalAmount/FLinkQty/FBusinessClose 等字段在 demo 环境可能不存在, 如需关联数量,请用 FReceiveQty + FStockInQty 代替,或用 kingdee_get_fields 确认可用字段

关联数量业务规则:

  • 关联数量 = 累计收料数量 + 累计入库数量

  • 关联数量 >= 订单数量时,采购订单无法下推收料单/入库单

  • 勾选控制交货数量时,关联数量 >= 交货下限时无法下推

Returns: str: JSON 格式的采购订单列表

kingdee_query_purchase_order_progressA

查询采购订单行明细及执行进度(含累计收料/入库数量)。

与 kingdee_query_purchase_orders 的区别:

  • 本工具查询【表体分录级】字段,返回每行物料的详细执行情况

  • 默认返回已审核单据,可通过 filter_string 过滤

返回的关键字段(demo 账套实测):

  • FBillNo: 单据编号

  • FMaterialId.FNumber / FMaterialId.FName: 物料编码/名称

  • FQty: 订单数量

  • FReceiveQty: 累计收料数量

  • FStockInQty: 累计入库数量

  • FPrice: 单价(不含税)

  • FTaxPrice: 含税单价

  • FAllAmount: 价税合计

以下字段需启用供应链模块后才存在(demo 环境可能不存在):

  • FLinkQty: 关联数量(=累计收料数量+累计入库数量)

  • FBusinessClose: 业务关闭状态(A=正常,B=业务关闭)

  • FFreezeStatus: 冻结状态(A=正常,B=冻结)

  • FTerminateStatus: 终止状态(A=正常,B=终止)

  • FDlyCntl_Low / FDlyCntl_High: 交货下限/上限

业务关闭规则(需启用供应链):

  • 累计入库数量 >= 交货下限时,该行自动【业务关闭】

  • 累计入库数量 < 交货下限时,自动【业务反关闭】

Returns: str: JSON 格式的采购订单执行进度列表

kingdee_query_sale_ordersA

查询销售订单(SAL_SaleOrder)列表。

常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定客户: "FCustId.FNumber='C001'"

推荐 field_keys: FID,FBillNo,FDate,FDocumentStatus,FCustId.FName,FSalesOrgId.FName,FTotalAmount

Returns: str: JSON 格式的销售订单列表

kingdee_query_stock_billsA

查询出入库相关单据。

form_id 常用取值:

  • STK_InStock: 采购入库单

  • SAL_OUTSTOCK: 销售出库单

  • STK_MisDelivery: 其他出库单

  • STK_Miscellaneous: 其他入库单

  • STK_TransferDirect: 直接调拨单

Returns: str: JSON 格式的出入库单列表

kingdee_query_inventoryA

查询即时库存数量(STK_Inventory)。

常用 filter_string:

  • 指定物料: "FMaterialId.FNumber='MAT001'"

  • 指定仓库: "FStockId.FNumber='WH01'"

  • 有库存: "FBaseQty>0"(默认已设置)

Returns: str: JSON 格式的库存列表,含物料编码、名称、仓库、数量、单位

kingdee_query_materialsA

查询物料基础资料(BD_Material)。

常用 filter_string:

  • 按编码前缀: "FNumber like 'HG%'"

  • 按名称模糊: "FName like '%钢板%'"

  • 已审核启用: "FDocumentStatus='C'"

Returns: str: JSON 格式的物料列表,含编码、名称、规格、单位、物料分组

kingdee_query_partnersA

查询客户(BD_Customer)或供应商(BD_Supplier)基础资料。

partner_type 取值:BD_Customer 或 BD_Supplier

Returns: str: JSON 格式的客户/供应商列表,含编码、名称、简称、联系人、电话

kingdee_save_billA

新建或修改金蝶单据(采购订单、销售订单等)。

  • 新建:model 中不传 FID

  • 修改:model 中必须传 FID,并设置 is_delete_entry=false 防止分录被删

  • 自动纠错:如字段名拼写错误(如 FSalesOrgId→FSaleOrgId),会自动修正

新建采购订单 model 示例: { "FDate": "2024-01-15", "FSupplierId": {"FNumber": "S001"}, "FPurchaseDeptId": {"FNumber": "D001"}, "FPOOrderEntry": [ {"FMaterialId": {"FNumber": "MAT001"}, "FQty": 100, "FPrice": 10.5, "FUnitID": {"FNumber": "PCS"}} ] }

Returns: str: JSON,含新建单据的 FID 和单据编号 FBillNo

kingdee_submit_billsA

提交单据(草稿 → 待审核)。

返回结构化结果:success=true 时包含 next_action 字段,建议调用 kingdee_audit_bills 完成审核。

Returns: str: JSON,含 success / next_action / bill_ids 字段

kingdee_audit_billsA

审核单据(待审核 → 已审核)。

返回结构化结果:success=true 时表示单据已生效,next_action=null。

Returns: str: JSON,含 success / bill_ids 字段

kingdee_unaudit_billsA

反审核单据(已审核 → 待审核)。反审核后可重新修改和提交。

返回结构化结果:success=true 时表示单据已回到待审核状态。

Returns: str: JSON,含 success / bill_ids 字段

kingdee_delete_billsA

删除单据(仅草稿状态可删除,已提交/已审核的单据需先反审核)。

返回结构化结果:success=true 时表示删除成功。

Returns: str: JSON,含 success / bill_ids 字段

kingdee_push_billA

将源单据下推生成目标单据(如销售订单下推销售出库单、采购订单下推采购入库单)。

常用下推场景:

  • 销售订单 → 销售出库单: form_id=SAL_SaleOrder, target_form_id=SAL_OUTSTOCK

  • 采购订单 → 采购入库单: form_id=PUR_PurchaseOrder, target_form_id=STK_InStock

  • 采购订单 → 收料通知单: form_id=PUR_PurchaseOrder, target_form_id=PUR_ReceiveBill

  • 销售订单 → 销售退货单: form_id=SAL_SaleOrder, target_form_id=SAL_RETURNSTOCK

转换规则说明:

  • 默认(rule_id=空,enable_default_rule=false):Kingdee 使用系统配置的默认转换规则

  • enable_default_rule=true:强制启用该单据的默认下推规则,忽略 rule_id

  • rule_id 显式指定:绕过默认规则,直接使用指定规则(下推失败时常用此方式)

采购订单下推限制(关联数量规则):

  • 采购订单【关联数量】>=【订单数量】时,无法下推收料单/入库单 (关联数量 = 累计收料数量 + 累计入库数量)

  • 勾选【控制交货数量】时:

    • 关联数量 >= 交货下限时,无法下推

    • 关联数量 + 本次下推数量 > 交货上限时,目标单据无法保存

  • 单据状态必须为"已审核",且未关闭、业务状态为"正常"

响应包含:

  • Result.ResponseStatus:保存结果(IsSuccess 判断整体是否成功)

  • Result.ConvertResponseStatus:每行下推转换结果(可查看具体分录成功/失败)

Returns: str: JSON,含 success / bill_nos / next_action 字段(成功时包含目标单据编号)

kingdee_create_and_auditA

一次性走完 Save → Submit → Audit 三步,避免 AI 漏掉中间步骤。

任意一步失败即停止(不自动重试),返回 halted_at 和 recovery_hint 告诉 AI 从哪里手动接手。失败日志按整体 op="create_and_audit" 记录一次(不会三倍膨胀)。

适用场景:明确要"一条龙"创建并使单据生效,没有中间审批/校验需求。 需要中间步骤校验时,请改用手工链路 kingdee_save_bill → kingdee_submit_bills → kingdee_audit_bills。

Returns: str: JSON。成功:success=true、halted_at=null、steps 三条均 success。 失败:success=false、halted_at 指出卡点、recovery_hint 给出下一步建议。

kingdee_push_and_auditA

一次性走完 Push → (可选 Submit + Audit) 全流程。

Push 生成的目标单默认是草稿;本工具自动批量提交+审核所有生成的目标单 FID。 任何一步失败即停止;失败日志按整体 op="push_and_audit" 记录一次。

auto_submit_audit=False 时退化为纯 push(与 kingdee_push_bill 等价,但返回 steps 结构)。

Returns: str: JSON。含 steps、target_bill_nos、target_fids、halted_at / recovery_hint。

kingdee_query_userA

查询金蝶系统中的用户列表。

常用 filter_string:

  • 指定用户名: "FUserID.FNumber='user001'"

  • 在岗状态: "FIsActive=1"

  • 指定部门: "FDepartment.FNumber='D001'"

推荐 field_keys: FUserID,FName,FNumber,FDepartment.FName,FIsActive,FCreateDate

Returns: str: JSON 格式的用户列表

kingdee_query_roleA

查询金蝶系统中的角色列表。

常用 filter_string:

  • 指定角色名: "FRoleID.FNumber='admin'"

  • 启用状态: "FIsActive=1"

推荐 field_keys: FRoleID,FName,FNumber,FIsActive,FCreateDate,FDescription

Returns: str: JSON 格式的角色列表

kingdee_query_permissionA

查询金蝶系统中的权限列表。

常用 filter_string:

  • 指定角色: "FRoleId.FNumber='ROLE001'"

  • 指定对象类型: "FObjectType='BD_Material'"

推荐 field_keys: FPermissionId,FName,FNumber,FObjectType,FObjectName,FIsAllow

Returns: str: JSON 格式的权限列表

kingdee_query_sequenceA

查询金蝶系统中的编码规则(SequenceRule)列表。

常用 filter_string:

  • 指定单据类型: "FObjectType='PUR_PurchaseOrder'"

  • 指定编码规则: "FSequenceRuleId.FNumber='SEQ001'"

推荐 field_keys: FSequenceRuleId,FName,FNumber,FObjectType,FDescription,FIsActive

Returns: str: JSON 格式的编码规则列表

kingdee_query_number_ruleA

查询金蝶系统中的单据编号规则列表。

常用 filter_string:

  • 指定单据类型: "FObjectType='SAL_SaleOrder'"

  • 指定规则名: "FNumberRuleId.FNumber='NR001'"

推荐 field_keys: FNumberRuleId,FName,FNumber,FObjectType,FPrefix,FSequenceLength,FDateFormat

Returns: str: JSON 格式的单据编号规则列表

kingdee_query_system_configA

查询金蝶系统中的系统配置参数。

常用 filter_string:

  • 指定配置项: "FConfigKey='MaxUploadSize'"

  • 指定分类: "FCategory='System'"

推荐 field_keys: FConfigId,FConfigKey,FConfigValue,FDescription,FCategory,FIsActive

Returns: str: JSON 格式的系统配置列表

kingdee_list_formsA

搜索金蝶系统中可用的表单类型(form_id)。

不知道 form_id 时,先调用此工具搜索。例如:

  • 输入"员工"返回 BD_Empinfo

  • 输入"采购"返回采购相关的表单列表

  • 留空返回所有常用表单

Returns: str: JSON 格式的表单列表,含 form_id、名称、描述、推荐字段、数据库表名

kingdee_get_fieldsA

获取指定表单的完整字段信息和业务规则。

不知道查询哪些字段时,或需要了解表单的业务限制时,先调用此工具。 本工具会调用金蝶 QueryBusinessInfo 接口拉取真实字段定义(带缓存)。

返回内容:

  • name/desc/db_tables/business_rules: 来自本地表单目录

  • recommended_fields: 推荐查询字段(精简版,给 LLM 看的)

  • metadata.fields: 所有主表字段(含 caption/type/must)

  • metadata.entries: 所有分录子表及其字段

  • metadata.required_fields: 主表必填字段列表

  • save_template: 自动生成的最小可保存 model 骨架(仅含必填字段)

字段格式说明:

  • FXxx 是普通字段

  • FXxx.FName 是关联字段取名称(例:FSupplierId.FName)

  • FXxx.FNumber 是关联字段取编码(例:FSupplierId.FNumber)

Returns: str: JSON 格式的字段信息

kingdee_query_pending_approvalsA

查询待审批的单据列表。

查询当前处于审批中状态(已提交、待审核)的单据。

Returns: str: JSON 格式的待审批单据列表

kingdee_query_workflow_statusC

查询单据的审批流状态。

返回单据当前的审批状态和单据详情。

Returns: str: JSON 格式的审批状态信息

kingdee_workflow_approveA

审批通过或驳回单据。

  • approve: 审核通过(待审核 → 已审核)

  • reject: 驳回(已审核 → 反审核回到待审核状态)

  • 返回结构化结果,包含 success / next_action 字段

Returns: str: JSON,含 success / action / bill_id 字段

kingdee_query_expense_reimburseA

查询费用报销单。

专门用于查询费用报销单据,支持按状态、金额、日期筛选。

Returns: str: JSON 格式的费用报销单列表

kingdee_query_fixed_assetA

查询固定资产卡片主数据(FA_FAGet / BD_MainData,formId: FA)。 固定资产是企业长期使用的有形资产,如房屋、机器设备、运输工具等。 支持按资产编号、名称、状态、使用部门等条件筛选。 常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定资产编号: "FNumber='FA001'"

  • 指定使用部门: "FUseDeptId.FNumber='D001'"

  • 在用资产: "FStatus='USING'" 推荐 field_keys: FID,FNumber,FName,FAssetSource,FSpecification,FUsedPeriod,FOriginalAmount,FDepreciateRate,FUseDeptId.FName,FDocumentStatus,FStatus

kingdee_query_asset_cardA

查询资产卡片(FA_FAGet 或子单据)。 资产卡片是固定资产的详细记录,包含原值、累计折旧、净值、卡片状态等信息。 常用 filter_string:

  • 指定资产编号: "FNumber='FA001'"

  • 指定保管人: "FCustodian.FNumber='EMP001'"

  • 已计提折旧: "FTotalDepreciate>0" 推荐 field_keys: FID,FNumber,FName,FAssetSource,FOriginalAmount,FTotalDepreciate,FNetAmount,FDepreciateMonth,FUsefulLife,FSalvageValue,FCustodian.FName

kingdee_query_asset_depreciationA

查询资产折旧记录(FA_DepreciationBill)。 折旧记录是固定资产计提折旧的明细,反映每月折旧费用、累计折旧、净值变化。 常用 filter_string:

  • 指定期间: "FYear=2024 and FPeriod=3"

  • 指定资产: "FAssetId.FNumber='FA001'" 推荐 field_keys: FID,FYear,FPeriod,FAssetId.FNumber,FAssetId.FName,FDepreciateDeptId.FName,FDepreciateAmount,FOriginalAmount,FTotalDepreciate,FNetAmount

kingdee_save_assetA

新增或修改固定资产(FA_FAGet)。 固定资产新建后状态为"草稿",需提交+审核后才生效。 修改已审核资产需要反审核后才能操作。

kingdee_query_asset_transferA

查询资产调拨单(FA_Transfer)。 资产调拨记录固定资产在部门或使用人之间的转移。 常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定资产: "FAssetId.FNumber='FA001'"

  • 原使用部门: "FOldDeptId.FNumber='D001'" 推荐 field_keys: FID,FBillNo,FTransferDate,FDocumentStatus,FAssetId.FNumber,FAssetId.FName,FOldDeptId.FName,FNewDeptId.FName,FTransferReason

kingdee_query_asset_scrapeA

查询资产报废单(FA_Scrape)。 资产报废记录固定资产的处置,包括正常报废、提前报废、毁损等。 常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定资产: "FAssetId.FNumber='FA001'"

  • 报废类型: "FScrapeType='NORMAL'" 推荐 field_keys: FID,FBillNo,FScrapeDate,FDocumentStatus,FAssetId.FNumber,FAssetId.FName,FOriginalAmount,FTotalDepreciate,FNetAmount,FScrapeType,FHandleMethod

kingdee_query_purchase_requisitionsA

查询采购申请单(PUR_Requisition)列表。

采购申请单是采购流程的起点,用于向采购部门提出物料或服务采购需求。 申请单可下推生成采购订单、采购询价单等。

常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定申请人: "FApplicantId.FNumber='EMP001'"

  • 指定申请部门: "FRequestDeptId.FNumber='D001'"

推荐 field_keys: FID,FBillNo,FDate,FDocumentStatus,FApplicantId.FName,FRequestDeptId.FName,FTotalAmount

Returns: str: JSON 格式的采购申请单列表

kingdee_query_sale_quotationsA

查询销售报价单(SAL_Quotation)列表。

销售报价单是向客户提供的商品或服务价格方案,可作为销售订单的参考或直接下推为销售订单。

常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定客户: "FCustId.FNumber='C001'"

推荐 field_keys: FID,FBillNo,FDate,FDocumentStatus,FCustId.FName,FSalesmanId.FName,FTotalAmount

Returns: str: JSON 格式的销售报价单列表

kingdee_query_quality_inspectionsA

查洵来料检验单(QIS_InspectBill/IQC)列表。

来料检验单用于对采购物料进行质量检验,判断是否允许入库。

常用 filter_string:

  • 已检验: "FDocumentStatus='C'"

  • 检验结果-合格: "FResult='1'" 或 "FPassQty>0"

  • 检验结果-不合格: "FFailQty>0"

推荐 field_keys: FID,FBillNo,FDate,FDocumentStatus,FSupplierId.FName,FMaterialId.FName,FPassQty,FFailQty,FInspectTypeId.FName

Returns: str: JSON 格式的来料检验单列表

kingdee_query_stock_transfer_applyA

查询调拨申请单(STK_TransferApply)列表。

调拨申请单用于申请仓库之间物料的转移,经审核后可下推生成调拨单。

常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定调出仓库: "FSendStockId.FNumber='WH01'"

  • 指定调入仓库: "FReceiveStockId.FNumber='WH02'"

推荐 field_keys: FID,FBillNo,FDate,FDocumentStatus,FSendStockId.FName,FReceiveStockId.FName

Returns: str: JSON 格式的调拨申请单列表

kingdee_query_audit_logA

查询金蝶云星空的审计日志(BOS_AuditLog)。

记录单据的审核操作:谁在什么时候审核了哪张单据、审核结果是什么。 用于合规审计、审批追溯、反舞弊检查。

推荐场景:

  • 合规要求:保留所有审核操作的审计轨迹

  • 问题排查:某张单据的审核历史

  • 责任追溯:谁在什么时间通过了/驳回了审批

返回字段说明:

  • FCREATEDATE: 审核时间

  • FCREATORID: 审核人

  • FOBJECTID: 单据内码

  • FFORMID: 单据类型

  • FAUDITRESULT: 审核结果(通过/驳回/取消)

  • FMEMO: 审核意见

Returns: str: JSON 格式的审计日志列表

kingdee_query_operation_logsA

查询金蝶云星空的上机操作日志(BOS_OperateLog)。

记录用户在系统中的所有操作:登录、登出、进入业务对象、业务操作等。 用于安全审计、故障排查、操作追溯。

推荐场景:

  • 排查某张单据是谁在什么时候操作的

  • 安全审计:检查异常登录或批量操作

  • 合规要求:追溯敏感操作记录

返回字段说明:

  • FDATETIME: 操作时间

  • FUSERID: 操作用户

  • FCOMPUTERNAME: 机器名称

  • FCLIENTIP: 客户端IP

  • FENVIRONMENT: 操作场景(0=登入系统, 1=进入业务对象, 3=业务操作, 4=登出系统)

  • FOPERATENAME: 操作名称(登录/单据查询/批量保存等)

  • FDESCRIPTION: 操作描述

  • FInterId: 对象内码(关联单据号)

  • FTimeConsuming: 耗时(毫秒)

  • FClientType: 客户端类型

Returns: str: JSON 格式的操作日志列表

kingdee_query_change_logA

查询金蝶云星空的单据变更记录(BOS_ModifyLog)。

记录单据字段的修改历史:谁在什么时候修改了什么字段、从什么值改成了什么值。 用于数据变更追溯、合规审计、问题排查。

推荐场景:

  • 数据治理:追踪关键字段的变更历史

  • 问题排查:某张单据的修改记录

  • 合规要求:保留重要数据的修改轨迹

返回字段说明:

  • FCREATEDATE: 修改时间

  • FCREATORID: 修改人

  • FOBJECTID: 单据内码

  • FFIELDNAME: 字段名称

  • FOLDVALUE: 修改前的值

  • FNEWVALUE: 修改后的值

Returns: str: JSON 格式的变更记录列表

kingdee_query_approval_flowA

查询金蝶云星空的审批流程记录。

记录单据从提交到最终审核的完整审批轨迹,包括每个节点的审批人、时间、结果和意见。 用于审批追溯、流程优化、合规检查。

推荐场景:

  • 审批追溯:某张单据走过了哪些审批节点

  • 流程优化:分析审批时长和瓶颈

  • 合规检查:确认关键单据是否按流程审批

注意:金蝶审批流程数据可能存储在多个表单中, 如 V_SFA_ApprovalRecord(审批记录)、Workflow_Instance(流程实例)等。 如查询无结果,请用 kingdee_get_fields 查看实际可用字段。

Returns: str: JSON 格式的审批流程列表

kingdee_query_data_backupA

查询金蝶云星空的数据备份记录。

记录系统的数据备份和恢复操作。 用于灾备验证、合规检查、恢复演练。

推荐场景:

  • 灾备验证:确认备份是否按计划执行

  • 合规要求:保留备份操作的审计轨迹

  • 恢复演练:查找可用的备份点

注意:金蝶备份数据可能存储在系统配置表或其他后台表单中, 如需访问请确认当前用户有系统管理权限。 如查询无结果,请用 kingdee_get_fields 查看实际可用字段。

Returns: str: JSON 格式的数据备份记录列表

kingdee_query_purchase_inquiryA

查洵采购询价单(SVM_InquiryBill/RFQ)列表。

采购询价单(Request for Quotation)用于向供应商询价,收集报价信息。

常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定供应商: "FSupplierId.FNumber='S001'"

推荐 field_keys: FID,FBillNo,FDate,FDocumentStatus,FSupplierId.FName,FMaterialId.FName,FPrice

Returns: str: JSON 格式的询价单列表

kingdee_query_supplier_quotesA

查洵供应商报价单(SVM_QuoteBill)列表。

供应商报价单是供应商对询价单的响应,包含物料价格信息。 可用于比价分析,选择最优供应商。

常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定供应商: "FSupplierId.FNumber='S001'"

  • 指定物料: "FMaterialId.FNumber='MAT001'"

推荐 field_keys: FID,FBillNo,FDate,FDocumentStatus,FSupplierId.FName,FMaterialId.FName,FPrice,FQuantity

Returns: str: JSON 格式的报价单列表

kingdee_query_misc_movement_detailA

查询杂项出入库明细表(STK_MiscMovementDetail)。

用于查看杂项出入库的明细数据,包括其他入库、其他出库等。

常用 filter_string:

  • 指定日期范围: "FBillDate>='2024-01-01' and FBillDate<='2024-12-31'"

  • 指定物料: "FMaterialId.FNumber='MAT001'"

  • 指定仓库: "FStockId.FNumber='WH01'"

推荐 field_keys(默认已包含关键字段): FID,FBillNo,FBillDate,FDocumentStatus,FStockOrgId.FName, FMaterialId.FNumber,FMaterialId.FName,FUnitId.FName,FQty,FPrice,FAmount

Returns: str: JSON 格式的杂项出入库明细列表

kingdee_query_transfer_pending_detailA

查询分步式调出未调入明细表(STK_TransferPendingDetail)。

用于查看分步式调拨流程中,已调出但未调入的单据明细。

常用 filter_string:

  • 指定调出日期范围: "FOutDate>='2024-01-01' and FOutDate<='2024-12-31'"

  • 指定物料: "FMaterialId.FNumber='MAT001'"

  • 指定调出仓库: "FOutStockId.FNumber='WH01'"

推荐 field_keys(默认已包含关键字段): FID,FBillNo,FOutDate,FInDate,FDocumentStatus,FStockOrgId.FName, FOutStockId.FName,FInStockId.FName,FMaterialId.FNumber,FMaterialId.FName, FUnitId.FName,FOutQty,FInQty,FPendingQty

Returns: str: JSON 格式的分步式调出未调入明细列表

kingdee_query_transfer_applyA

查询调拨申请单(STK_TransferApply)列表。

调拨申请单是调拨业务的起点,可下推生成直接调拨单或分步式调拨单。

常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定日期范围: "FBillDate>='2024-01-01' and FBillDate<='2024-12-31'"

  • 指定调出仓库: "FOutStockId.FNumber='WH01'"

  • 指定调入仓库: "FInStockId.FNumber='WH02'"

  • 未关闭: "FCloseStatus='A' and FBusinessClose='A'"

推荐 field_keys(默认已包含关键字段): FID,FBillNo,FBillDate,FDocumentStatus,FStockOrgId.FName, FOutStockId.FName,FInStockId.FName,FTransferType, FMaterialId.FNumber,FMaterialId.FName,FUnitId.FName,FQty,FPrice,FAmount

Returns: str: JSON 格式的调拨申请单列表

kingdee_query_transfer_directA

查询直接调拨单(STK_TransferDirect)列表。

直接调拨单用于一步完成调拨业务,同时更新调出仓和调入仓库存。

常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定日期范围: "FBillDate>='2024-01-01' and FBillDate<='2024-12-31'"

  • 指定调出仓库: "FOutStockId.FNumber='WH01'"

  • 指定调入仓库: "FInStockId.FNumber='WH02'"

  • 未关闭: "FCloseStatus='A' and FBusinessClose='A'"

推荐 field_keys(默认已包含关键字段): FID,FBillNo,FBillDate,FDocumentStatus,FStockOrgId.FName, FOutStockId.FName,FInStockId.FName,FMaterialId.FNumber, FMaterialId.FName,FUnitId.FName,FQty,FPrice,FAmount

Returns: str: JSON 格式的直接调拨单列表

kingdee_push_stock_transferA

从调拨申请单下推到直接调拨单(STK_TransferApply -> STK_TransferDirect)。

用于将调拨申请单下推生成直接调拨单,一步完成调拨。

参数说明:

  • form_id: 固定为 STK_TransferApply(调拨申请单)

  • target_form_id: 固定为 STK_TransferDirect(直接调拨单)

  • source_bill_nos: 调拨申请单的单据编号列表

转换规则说明:

  • 默认(rule_id=空):使用系统配置的默认转换规则

  • enable_default_rule=true:强制启用默认下推规则

  • rule_id 显式指定:绕过默认规则,使用指定规则

响应包含:

  • Result.ResponseStatus:保存结果(IsSuccess 判断整体是否成功)

  • Result.ConvertResponseStatus:每行下推转换结果

Returns: str: JSON,含 success / bill_nos / next_action 字段

kingdee_query_material_costA

查询物料成本库(BD_MaterialCost)。

返回物料的标准成本、最新成本、平均成本等信息。

常用 filter_string:

  • 指定物料: "FMaterialId.FNumber='MAT001'"

  • 指定成本组织: "FCostOrgId.FNumber='100'"

推荐 field_keys: FMaterialId.FNumber,FMaterialId.FName,FUnitId.FName,FStdCost,FLatestCost,FAvgCost

Returns: str: JSON 格式的物料成本列表

kingdee_query_material_target_costA

查询物料目标成本单(BD_MatTargetCost)。

常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定物料: "FMaterialId.FNumber='MAT001'"

推荐 field_keys: FBillNo,FDate,FDocumentStatus,FMaterialId.FNumber,FMaterialId.FName,FTargetCost

Returns: str: JSON 格式的目标成本单列表

kingdee_query_cost_calculationA

查询成本计算单(CB_CostCalBill)列表。

常用 filter_string:

  • 指定年度: "FYear=2024"

  • 指定期间: "FPeriod='01'"

  • 指定物料: "FMaterialId.FNumber='MAT001'"

推荐 field_keys: FYear,FPeriod,FMaterialId.FNumber,FMaterialId.FName,FCostAmt,FMaterialCost,FLabourCost

Returns: str: JSON 格式的成本计算单列表

kingdee_query_cost_centersA

查询成本中心基础资料(CB_CostCenter)。

常用 filter_string:

  • 指定编码: "FNumber like 'CC%'"

  • 启用状态: "FIsActive='1'"

推荐 field_keys: FNumber,FName,FDeptId.FName,FIsActive

Returns: str: JSON 格式的成本中心列表

kingdee_query_cost_itemsA

查询成本项目基础资料(CB_CostItem)。

常用 filter_string:

  • 指定编码: "FNumber like 'CI%'"

  • 成本项目类型: "FCostItemType='1'"

推荐 field_keys: FNumber,FName,FCostItemType,FIsActive

Returns: str: JSON 格式的成本项目列表

kingdee_query_product_standard_costB

查询产品标准成本(STD_ProductCostQuery)。

常用 filter_string:

  • 指定物料: "FMaterialId.FNumber='MAT001'"

  • 指定成本版本: "FCostVersionId.FNumber='STD01'"

推荐 field_keys: FMaterialId.FNumber,FMaterialId.FName,FUnitId.FName,FStdCost,FMaterialCost,FLabourCost,FFeeCost

Returns: str: JSON 格式的产品标准成本列表

kingdee_query_cost_adjustmentsA

查询成本调整单(STK_CostAdjust)。

常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定调整类型: "FAdjustType='1'"

推荐 field_keys: FBillNo,FDate,FDocumentStatus,FCostOrgId.FNumber,FCostOrgId.FName,FAdjustType,FAdjustAmount

Returns: str: JSON 格式的成本调整单列表

kingdee_save_cost_adjustmentA

新建或修改成本调整单(STK_CostAdjust)。

model 示例: { "FDate": "2024-01-15", "FCostOrgId": {"FNumber": "100"}, "FAdjustType": "1", "FCostAdjustEntry": [ {"FMaterialId": {"FNumber": "MAT001"}, "FAdjustQty": 100, "FAdjustPrice": 10.5} ] }

Returns: str: JSON,含 FID 和 FBillNo

kingdee_query_instant_cost_compareA

查询即时成本对比分析表(STK_InstantCostCompare)。

对比即时成本与核算成本的差异。

常用 filter_string:

  • 指定物料: "FMaterialId.FNumber='MAT001'"

  • 指定仓库: "FStockId.FNumber='WH01'"

推荐 field_keys: FMaterialId.FNumber,FMaterialId.FName,FStockId.FName,FInstantCost,F核算成本,FDiffAmt

Returns: str: JSON 格式的即时成本对比列表

kingdee_query_cost_trendA

查询成本价趋势分析表(STK_CostTrend)。

分析物料成本价格的变化趋势。

常用 filter_string:

  • 指定物料: "FMaterialId.FNumber='MAT001'"

  • 指定日期范围: "FDate>='2024-01-01' and FDate<='2024-12-31'"

推荐 field_keys: FMaterialId.FNumber,FMaterialId.FName,FDate,FCostPrice,FPriceChange

Returns: str: JSON 格式的成本价趋势列表

kingdee_query_finished_product_costA

查询完工入库产品成本(CB_FinishInCostQuery)。

常用 filter_string:

  • 指定生产订单: "FMoBillNo='MO000001'"

  • 指定期间: "FYear=2024 and FPeriod='01'"

推荐 field_keys: FMoBillNo,FMaterialId.FNumber,FMaterialId.FName,FFinishQty,FCostPrice,FCostAmt

Returns: str: JSON 格式的完工成本列表

kingdee_query_material_cost_usageB

查询生产材料耗用成本(CB_MaterialCostQuery)。

常用 filter_string:

  • 指定生产订单: "FMoBillNo='MO000001'"

  • 指定物料: "FMaterialId.FNumber='MAT001'"

推荐 field_keys: FMoBillNo,FMaterialId.FNumber,FMaterialId.FName,FConsumeQty,FCostPrice,FCostAmt

Returns: str: JSON 格式的材料耗用成本列表

kingdee_query_production_ordersB

查询生产订单(PRD_MO)列表。

常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定日期: "FDate>='2024-01-01'"

  • 进行中: "FStatus='2'" (1=计划,2=确认,3=投料,4=汇报,5=入库)

  • 指定物料: "FMaterialId.FNumber='MAT001'"

推荐 field_keys: FID,FBillNo,FDate,FDocumentStatus,FMaterialId.FName,FQty,FPlanStartDate,FPlanFinishDate,FStatus

Returns: str: JSON 格式的生产订单列表

kingdee_query_production_pick_materialsA

查询生产领料单(PRD_PickMtrl)列表。

常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定生产订单: "FMoBillNo='MO000001'"

  • 指定仓库: "FStockId.FNumber='CK001'"

推荐 field_keys: FID,FBillNo,FDate,FDocumentStatus,FMoBillNo,FMaterialId.FName,FPickQty,FStockId.FName

Returns: str: JSON 格式的生产领料单列表

kingdee_query_production_stock_inA

查询生产入库单(PRD_Instock)列表。

常用 filter_string:

  • 已审核: "FDocumentStatus='C'"

  • 指定生产订单: "FMoBillNo='MO000001'"

  • 指定仓库: "FStockId.FNumber='CK001'"

推荐 field_keys: FID,FBillNo,FDate,FDocumentStatus,FMoBillNo,FMaterialId.FName,FInQty,FStockId.FName

Returns: str: JSON 格式的生产入库单列表

kingdee_view_production_orderA

查看生产订单(PRD_MO)完整详情。

必填参数:

  • form_id: "PRD_MO"

  • bill_id: 单据 FID 或 bill_no: 单据编号

Returns: str: JSON 格式的生产订单完整数据

kingdee_save_production_orderA

新建或修改生产订单(PRD_MO)。

新建示例: { "FDate": "2024-01-15", "FMaterialId": {"FNumber": "MAT001"}, "FQty": 100, "FPlanStartDate": "2024-01-20", "FPlanFinishDate": "2024-01-25" }

Returns: str: JSON,含 FID 和 FBillNo

kingdee_submit_production_ordersC

提交生产订单(PRD_MO)至审核队列。

Returns: str: JSON,含 success / next_action / bill_ids

kingdee_audit_production_ordersB

审核生产订单(PRD_MO)。

Returns: str: JSON,含 success / bill_ids

kingdee_push_production_pickB

从生产订单下推生成生产领料单(PRD_PickMtrl)。

Returns: str: JSON,含 success / target_bill_nos / next_action

kingdee_push_production_stock_inB

从生产领料单下推生成生产入库单(PRD_Instock)。

Returns: str: JSON,含 success / target_bill_nos / next_action

kingdee_query_mrp_resultB

查询 MRP 运算结果(PLAN_MRPResult)。

来自销售订单/销售预测/库存不足等需求,经 MRP 运算生成的计划订单建议。 可下推生成采购申请/生产订单。

Returns: str: JSON 数组,每条含 FBillNo/FMaterialId/FSrcBillNo/FPurchaseQty 等字段。

kingdee_query_production_planC

查询生产计划单(PLAN_ProductionPlan)。

生产计划单是 MRP 运算后手工调整的计划单据,可直接下推生成生产订单。

Returns: str: JSON 数组。

kingdee_query_production_reportB

查询生产汇报单(PRD_MOReport)。

生产汇报记录工序完成数量/工时/良品率等信息,是生产入库的提前工序。

Returns: str: JSON 数组,含 FBillNo/FMOId/FMaterialId/FReportQty/FHourQty 等。

Prompts

Interactive templates invoked by user choice

NameDescription
查询采购订单查询已审核采购订单的提示词模板
查询即时库存查询当前库存的提示词模板
新建采购订单新建采购订单的提示词模板

Resources

Contextual data attached and managed by the client

NameDescription
resource_form_catalog金蝶常用表单目录,包含 form_id、中文名称、描述和推荐查询字段
resource_help金蝶 MCP Server 使用指南

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/WaHaiLong/KingdeeMCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server