金蝶云星空 ERP 操作技能

通过 MCP 工具与金蝶云星空 API 交互的核心指南。查询前务必先查阅本文件确认表单ID和字段命名规则，避免 500 错误。

前提条件：本 Skill 需配合金蝶云星空 MCP Server 使用，推荐 kingdee-k3cloud-mcp。确保 Claude Code 已配置好 MCP Server 并可访问 query_bill_json、view_bill 等工具。

核心原则

1. 分步查询：先用 query_bill_json 查列表（关键字段），再用 view_bill 看单条详情
2. 日期过滤：半开区间 FDate >= 'YYYY-MM-DD' AND FDate < 'YYYY-MM-DD+1'
3. FDate vs FCreateDate：FDate 是业务日期（手填），FCreateDate 是系统创建时间。按"今天开的单"统计用 FCreateDate
4. 单据状态码：Z = 暂存草稿，A = 创建，B = 审核中，C = 已审核，D = 重新审核
5. 控制数据量：top_count 限制行数，只查必要字段，超过20行数据考虑创建 Excel
6. 字段不确定时：先调用 query_metadata(form_id) 验证字段是否存在，避免试错浪费 token