Cjt Tc Meta MCP Guide

畅捷通 T+Cloud MCP 工具完整汇总

一、核心工具（6 个）

1. chanjet_search — 搜索服务和操作（起点工具）

用途： 通过关键词搜索 T+Cloud 中可用的服务和操作，返回服务名、操作列表、调用示例。

参数：

• keyword（必填）：搜索关键词，如 "销售订单"、"inventory"、"报表"
• category（可选）：过滤类别 — all（默认）/ voucher（单据）/ archive（档案）/ report（报表）/ special（特殊）

返回内容：

• 服务名称（service）
• 中文名称
• 可用操作列表（operation）
• 调用示例（chanjet_execute 语法）

使用场景： 每次查询前先用它确认正确的 service 和 operation，避免路径错误。

2. chanjet_execute — 万能执行器

用途： 执行 T+Cloud 任意 API 操作，是所有业务操作的最终执行通道。

参数：

• service（必填）：服务名称，如 SaleOrderOpenApi、inventory、reportQuery
• operation（必填）：操作名称，如 Create、FindVoucherList、GetReportData
• body（可选）：请求体 JSON，格式因操作类型而异

支持的操作类型：

• 查询类： FindVoucherList、Query、QueryPage、GetReportData
• 创建类： Create、CreateAsync、CreateBatch
• 修改类： Update、UpdateBatch
• 审核类： Audit、UnAudit
• 删除类： Delete、DeleteBatch、BatchDelete
• 状态类： Close、Open、Change、ManualFinish
• 报表类： GetReportData、GetBalanceSumRpt、FindTaxTable

3. chanjet_column_info — 获取单据字段定义

用途： 获取单据业务编码对应的真实字段名，新建、修改或筛选前必须先调用，不可猜测字段名。

参数：

• bizCode（必填）：单据业务编码，如 SA04（销货单）、SO（销售订单）、POO（采购订单）
• kind（可选）：获取内容 — search（查询筛选项，默认）/ custom（自定义字段）/ all（全部）

返回内容： 字段名列表（FieldName）、字段类型、是否必填、是否可筛选等

⚠️ 重要性： 字段名错误是调用失败的最常见原因之一。即使 chanjet_execute 内置了自动字段映射（best-effort），关键流程仍应优先使用此工具返回的真实 FieldName。

4. chanjet_reportinfo — 查询报表名称和字段

用途： 查询 T+Cloud 业务报表名称和字段定义，为 GetReportData 做准备。

调用方式：

• 第一步：chanjet_reportinfo(keyword="销售") → 列出所有含"销售"的报表（Title + Name + MenuCode）
• 第二步：chanjet_reportinfo(reportTitle="销售毛利分析表") → 返回该报表的筛选项、栏目、分组项

注意： 资产负债表/利润表/现金流量表不在此系统中（属于 FormReport 套表），改用 chanjet_execute 调用 TaxOpenAPI/FindTaxTable。

5. chanjet_bizcodelist — 单据业务编码对照表

用途： 获取 T+Cloud 单据业务编码对照表（如 SA04=销货单、SO=销售订单、POO=采购订单）。

参数：

• keyword（可选）：关键词筛选，支持中文名称或编码模糊匹配，如 "销售"、"采购"、"SA"

使用场景： 不知道 bizCode 时先调用此工具，再用 bizCode 调用 chanjet_column_info。

6. chanjet_help — 帮助信息

用途： 获取 T+Cloud MCP 工具帮助，包括工作流示例和常见错误。

参数：

• topic（可选）：帮助主题
  • overview：工具概览（默认）
  • workflow：工作流示例
  • errors：常见错误
  • schema：字段查询

二、标准工作流

工作流 1：查单据列表 + 详情

步骤 1: chanjet_search("销售")
        → 找到 SaleOrderOpenApi 服务，操作：FindVoucherList、GetVoucherDTO

步骤 2: chanjet_execute(
          service="SaleOrderOpenApi",
          operation="FindVoucherList",
          body={"pageIndex":0, "pageSize":10, "paramDic":{}}
        )
        → 返回单据列表（仅包含 id, code, externalcode, ts）

步骤 3: chanjet_execute(
          service="SaleOrderOpenApi",
          operation="GetVoucherDTO",
          body={"param":{"voucherID":"<id>", "voucherTypeCode":"SO"}}
        )
        → 返回完整单据详情（含表头、明细行、业务字段）

⚠️ 注意： FindVoucherList 只返回基础字段，业务字段（如客户、金额、数量等）必须通过 GetVoucherDTO 获取。

工作流 2：创建单据（以销货单为例）

步骤 1: chanjet_column_info(bizCode="SA04")
        → 获取销货单的真实字段名

步骤 2: 查关联档案获取真实 Code:
        - chanjet_execute(service="partner", operation="Query", body='{"param":{"Name":"XX公司"}}')
          → 取得客户 Code（填入 Vendor.Code 或 Partner.Code）
        - chanjet_execute(service="inventory", operation="Query", body='{"param":{"Name":"产品A"}}')
          → 取得存货 Code（填入明细行 Inventory.Code）
        - chanjet_execute(service="warehouse", operation="Query", body='{"param":{}}')
          → 取得仓库 Code（填入 Warehouse.Code）

步骤 3: chanjet_execute(
          service="SaleDeliveryOpenApi",
          operation="Create",
          body={"dto":{
            "Vendor":{"Code":"C001"},
            "Date":"2026-05-15",
            "Details":[{
              "Inventory":{"Code":"M001"},
              "Quantity":100,
              "Price":25.50
            }]
          }}
        )
        → 返回创建结果（含 voucherID）

步骤 4: chanjet_execute(
          service="SaleDeliveryOpenApi",
          operation="Audit",
          body={"param":{"voucherID":"<id>"}}
        )
        → 审核单据

⚠️ 规则： body 中涉及存货/仓库/往来单位/部门等关联字段，必须先查档案取得真实 Code，禁止猜测编码。

工作流 3：查询报表数据

步骤 1: chanjet_reportinfo(keyword="销售")
        → 找到报表列表，如 "销售毛利分析表" (SA_GrossProfitAnalysisRpt)

步骤 2: chanjet_reportinfo(reportTitle="销售毛利分析表")
        → 获取该报表的筛选项、栏目、分组项定义

步骤 3: chanjet_execute(
          service="reportQuery",
          operation="GetReportData",
          body={
            "reportName": "SA_GrossProfitAnalysisRpt",
            "pageIndex": 1,
            "pageSize": 100,
            "param":{
              "BeginDate": "2026-01-01",
              "EndDate": "2026-05-15"
            }
          }
        )
        → 返回报表数据

⚠️ 注意： GetReportData 的 pageIndex 从 1 开始（不是 0！传 0 会报"非第一页查询"错误）。第 2 页及以后必须携带第 1 页响应中的 TaskSessionID 和 SolutionID。

工作流 4：创建存货（档案）

步骤 1: chanjet_execute(service="inventoryClass", operation="Query", body='{"param":{}}')
        → 取得存货分类 Code（填入 InventoryClass.Code）

步骤 2: chanjet_execute(service="Unit", operation="Query", body='{"param":{}}')
        → 取得计量单位 Code（填入 MainUnit.Code）

步骤 3: chanjet_execute(
          service="McpMetaService",
          operation="GetArchiveSelectFields",
          body='{"service":"inventory","operation":"Query"}'
        )
        → 查看存货档案允许的 SelectFields 范围

步骤 4: chanjet_execute(
          service="inventory",
          operation="Create",
          body={"dto":{
            "Code":"M001",
            "Name":"产品A",
            "InventoryClass":{"Code":"01"},
            "MainUnit":{"Code":"PCS"}
          }}
        )
        → 创建存货

工作流 5：查询现存量

chanjet_execute(
  service="currentStock",
  operation="Query",
  body={"param":{}}
)
→ 返回当前库存状况（存货、仓库、现存量、可用量、结存金额等）

chanjet_execute(
  service="currentStock",
  operation="QueryByTime",
  body={"param":{"Date":"2026-05-15"}}
)
→ 返回指定日期的库存快照

三、Body 格式规则（重要！）

档案查询

示例：

// 查询所有存货（分页 100 条）
{"param":{"PageSize":100}}

// 模糊查询名称含"绿萝"的存货
{"param":{"Name":"%绿萝%"}}

// 模糊查询编码含"A01"的存货
{"param":{"Code":"%A01%"}}

// 查询指定名称的往来单位
{"param":{"Name":"XX公司"}}

单据操作

档案删除

四、全模块分类详解

1. 销售管理（9 个服务 / 47 个接口）

模块定位： 覆盖销售业务全链路 — 从订单到出库到开票。

单据服务

档案服务

简易服务

报表服务

业务场景：

• 销售订单 → 销货单 → 销售出库单 → 销售发票（标准销售流程）
• 销售订单可关联生产加工单（按单生产）或采购订单（以销定购）
• 支持订单关闭/打开/变更等状态管理

2. 采购管理（6 个服务 / 32 个接口）

模块定位： 覆盖采购业务全链路 — 从订单到入库到开票。

单据服务

简易服务

业务场景：

• 采购订单 → 进货单 → 采购入库单 → 采购发票（标准采购流程）
• 支持以销定购（销售订单关联采购订单）
• 采购订单支持关闭/打开状态管理

3. 库存管理（21 个服务 / 77 个接口）

模块定位： 覆盖库存全业务 — 出入库、调拨、盘点、成本核算。

出入库单据

简易出入库服务

存货档案

价格档案

库存查询

成本核算

业务场景：

• 采购入库 → 库存持有 → 销售出库（标准库存流转）
• 调拨单：仓库 A → 仓库 B
• 盘点单：定期盘点，生成盘盈/盘亏调整
• 成本核算：支持移动平均、个别计价等成本算法

4. 生产管理（5 个服务 / 28 个接口）

模块定位： 覆盖生产计划到执行全过程。

生产单据

生产档案

⚠️ 重要约束： 生产加工单 Create/Update 时，PreStartDate（预开工日）和 PreFinishDate（预完工日）必须 >= VoucherDate（单据日期），否则后端返回 999 错误 "预开工日不能早于单据日期！"

业务场景：

• 销售订单 → 生产加工单 → 领料申请 → 生产检验 → 产成品入库
• 支持按单生产（MTO）和按库生产（MTS）
• 支持手动完工（ManualFinish）

5. 委外管理（3 个服务 / 21 个接口）

模块定位： 覆盖委外加工业务全链路。

业务场景：

• 委外加工单 → 委外发料单 → 委外商加工 → 委外入库单
• 委外发料会扣减原材料库存
• 委外入库会增加产成品库存

6. 财务管理（10 个服务 / 38 个接口）

模块定位： 覆盖收付款、费用、零售结算等财务业务。

收付款单据

应收应付单据

其他财务单据

简易服务

业务场景：

• 销货单 → 其他应收单 → 收/付款单（收款流程）
• 采购入库单 → 其他应付单 → 收/付款单（付款流程）
• 费用单独立于采购/销售，用于日常费用管理

7. 会计凭证（2 个服务 / 7 个接口）

业务场景：

• 业务单据自动生成凭证（系统对接）
• 手工录入调整凭证
• 凭证类别管理

8. 基础档案（29 个服务 / 84 个接口）

模块定位： 企业基础数据管理，是所有业务单据的数据支撑。

往来单位

存货相关

组织档案

财务档案

计量档案

生产档案

项目档案

会员档案

费用档案

自定义档案

系统辅助

9. 价格管理（2 个服务 / 12 个接口）

业务场景：

• 客户价格本：不同客户不同价格体系
• 供应商价格本：不同供应商不同采购价
• 调价单审核后生效

10. 报表分析（4 个服务 / 10 个接口）

⚠️ 注意： 资产负债表/利润表/现金流量表不在此系统（FormReport 套表），改用 chanjet_execute 调用 TaxOpenAPI/FindTaxTable。

11. 系统服务（5 个服务 / 20 个接口）

五、总览

六、核心报表清单（100+ 张）

销售类报表（31 张）

采购类报表（14 张）

库存类报表（14 张）

应收应付报表（17 张）

生产类报表（15 张）

客户分析报表（12 张）

资金类报表（5 张）

其他报表

七、关键规则与注意事项

1. 字段名不可猜测

示例：

❌ 错误: {"dto":{"InventoryName":"产品A"}}  // 字段名错误
✅ 正确: 先查 inventory Query 取得 Code "M001"，再填 {"dto":{"Inventory":{"Code":"M001"}}}

2. FindVoucherList 限制

• 只返回基础字段： [id, code, externalcode, ts]
• 业务字段需用 GetVoucherDTO 获取： 客户、金额、数量、明细行等
• 内置自动字段映射（best-effort）： 会尝试把常见别名/中文标题/扁平键映射为真实 FieldName
• 关键流程优先用 chanjet_column_info： 自动映射可能在元数据获取失败时按原样发送

3. GetReportData 注意事项

• PageIndex 从 1 开始（不是 0！传 0 会报"非第一页查询"错误，服务器虽会自动修正为 1，但应直接传 1）
• 第 2 页及以后必须携带： TaskSessionID 和 SolutionID（从第 1 页响应中获取）
• 不要传 reportTitle： 这是 MCP 内部字段，会自动剥离
• 数据量过大时分页： 将多页数据存储在本地拼接

4. 常见错误

5. 生产加工单创建约束

• PreStartDate（预开工日）和 PreFinishDate（预完工日）必须 >= VoucherDate（单据日期）
• 否则后端返回 999 错误："预开工日不能早于单据日期！"

6. Body 格式特殊规则

• 大部分档案 Query： {"param":{}} — 字段名 PascalCase（Code/Name/Disabled）
• department/person/Account/SettleStyle Query： {"dto":{}} — 特殊格式，注意区分
• 档案分页： PageSize 放在 param 内（最大 1000），无 pageIndex
• 单据分页： pageIndex 从 0 开始（FindVoucherList），pageSize 默认 10

八、查询策略速查

九、常用搜索关键词

十、业务单据流转关系

销售业务流

销售订单 → 销货单 → 销售出库单 → 销售发票
  ↓           ↓          ↓
其他应收单 → 收/付款单

采购业务流

采购订单 → 进货单 → 采购入库单 → 采购发票
  ↓           ↓          ↓
其他应付单 → 收/付款单

生产业务流

销售订单 → 生产加工单 → 领料申请单 → 材料出库单
                    ↓
              生产过程检验单
                    ↓
              产成品入库单 → 销货单

委外业务流

委外加工单 → 委外发料单 → 委外商加工 → 委外入库单

库存业务流

采购入库 → 库存持有 → 销售出库
    ↕              ↕
  调拨单         盘点单（盘盈/盘亏）

十一、快速参考卡片

创建单据 checklist

• 调用 chanjet_column_info 获取字段名
• 查询往来单位档案取得 Code
• 查询存货档案取得 Code
• 查询仓库档案取得 Code
• 查询部门档案取得 Code（如需要）
• 调用 Create 创建单据
• 调用 Audit 审核单据

查询报表 checklist

• 调用 chanjet_reportinfo(keyword) 找到报表
• 调用 chanjet_reportinfo(reportTitle) 获取字段定义
• 调用 GetReportData（pageIndex 从 1 开始）
• 数据量大时分页查询（携带 TaskSessionID 和 SolutionID）

常见错误 checklist

• param 不为 null（用 {"param":{}}）
• 字段名来自 chanjet_column_info（不猜测）
• 关联字段使用真实 Code（不猜编码）
• GetReportData 的 pageIndex 从 1 开始
• 生产加工单的日期 >= 单据日期