dingMCP/docs/submission-templates.md

提单模板能力

以下结论来自 2026-08-12 通过本项目 MCP 实时读取的 10 个模板 Schema，以及对应正式接口文档。模板每次发起前仍会重新读取，本文不是可复用的静态 Schema。

来源	模板	API 能力	关键字段或限制
薪福通	差旅报销单	支持，有约束	报销总额、币种、费用明细、差旅行程；费用和行程逐项递归校验，企业模板还要求承担部门
薪福通	费用报销单	支持，有约束	报销总额、币种、费用明细；当前模板要求承担部门和费用说明
薪福通	招待费用申请单	支持，有约束	企业模板类型为 EXPENSE_APPLY，使用费用申请创建接口的 applyExpenses（费用类型编码、金额等），而不是按模板名称误用招待申请专用 DTO；写后实时核验状态
薪福通	出差费用申请单	支持，有约束	行程、城市和预计费用递归校验；实测仅有发起节点时流程即时完成并返回 completed
钉钉 OA	业务招待申请_北极大	仅客户端	普通字段和明细表可读取，但真实测试中新版企业创建接口返回系统异常、旧版企业接口拒绝组件格式
钉钉 OA	出差申请单_北极大	仅客户端	DDBizSuite 出差套件包含日程、天数、同行人及考勤联动，企业 OpenAPI 没有可靠构造协议
钉钉 OA	外出_北极大	仅客户端	DDBizSuite 外出套件包含类型、起止时间、时长和考勤联动
钉钉 OA	业务招待申请_捷康	仅客户端	钉钉费控申请套件与普通 OA 明细并存，含企业主体、归属、成本中心等套件字段
钉钉 OA	差旅费用报销_捷康	仅客户端	钉钉费控报销套件含行程、报销明细、发票、收款账户和企业主体；另有关联出差申请和项目字段
钉钉 OA	业务招待费用报销_捷康	仅客户端	钉钉费控报销套件含报销明细、发票、收款账户和付款主体

薪福通自定义字段统一使用 customFieldValues[].fieldNumber/fieldValue。日期字段使用 yyyy-MM-dd HH:mm，人员字段值是花名册编号 JSON 数组，部门字段值是组织编码 JSON 数组，表格字段值是包含 sequence、columnValues、titleCode 的 JSON 数组字符串，附件字段值是先通过薪福通附件能力取得的附件编号。approval_get_submission_schema 会返回实时 valueFormat；Agent 不应按字段名称猜编码或结构。

薪福通模板要求承担部门或城市编码时，使用同一 templateId 调用 approval_get_submission_options。kind=department 只会返回当前登录用户本人档案中的可选组织；kind=city 可用 query 按城市名称搜索。城市全量接口较慢，网关给予独立的 45 秒超时并在进程内缓存字典 24 小时，不写入磁盘。响应仅包含可填写的 code 和 label，不会暴露员工号或原始成员档案。

薪福通的自定义字段接口可能同时列出 billCompanyCode、billDepartmentCode 等标准单据抬头字段，也可能用动态字段号返回名为“承担部门/单据部门”的 ADV_DEPARTMENT 控件，但创建接口禁止把它们放进 customFieldValues。MCP 会剔除这些服务器管理控件；公司和部门都省略时，薪福通根据当前登录申请人的档案默认填写。若通过标准抬头字段显式指定，则公司与部门必须成对填写。

任一来源模板的 submissionCapability.status=client_only 时，approval_prepare_submission 会再次拒绝，不能通过修改本地 Skill 或桥绕过。薪福通白名单模板使用正式创建接口，并在写后实时核验：billSts=1 为待审批，billSts=2 为企业流程规则导致的即时完成。当前列出的 6 个钉钉模板均为 client_only；对于以后可由 API 构造的钉钉模板，网关会先调用企业接口 POST /v1.0/workflow/processes/forecast，预测成功并补齐自选处理人后才生成提交确认。