YonSuite 数据查询

要解决的问题

YonSuite 业务单据常跨销售、采购、生产、库存、CRM 和供应商等模块，字段分散、主子表嵌套、含税金额与税额口径不一致。直接写一次性脚本查数容易留下冗余代码，也难以稳定产出可复核的报表。

技能如何工作

• 统一查询入口：通过 query_tool CLI 调用 YonSuite OpenAPI，输出销售、采购、生产订单等 JSON 到 output/ 目录。
• 字段参考：查询时查阅 references/api/*.md，处理 oriSum、oriTaxUnitPrice、orderPrices.originalName 等字段口径。
• 输出流程：先生成中间 JSON，再做字段检查，随后输出聊天卡片和 HTML 报告，文件命名遵循 本月销售分析报表_YYYY_MM.html 等规范。
• 分析约束：分析类任务调用 data-analysis skill，做 IQR 预检、HHI 集中度、漏斗转化和 Decision Brief，而不是让 LLM 直接推断。

适用边界与注意点

适合已配置 YONSUITE_GATEWAY_URL、YONSUITE_TOKEN_URL 等凭据的 YonSuite 数据查询与报表生成。分析依赖对应模块返回字段，遇到 name 嵌套对象、税额为 null、合计行过滤规则时需按参考文档处理。该技能强调复用 query_tool 和 modules/，避免新增临时 Python 脚本；待办中心功能已迁出，不用于该场景。