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 密码(可选)

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

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