宜搭表单自动生成金蝶云星空凭证有什么办法？安捷云「X表单→凭证」解决方案

一、先说结论

业务在宜搭按熟悉的表单填报，AgileFlow 负责把这堆业务语言翻译成金蝶能接受的结构化凭证数据——账簿、凭证字、期间、摘要、末级科目、借贷金额、按科目要求装配的核算维度——推送进金蝶云星空，生成待审核凭证，并把凭证号回写到表单。

一句话：业务侧照常填表，金蝶侧拿到的是一张已经长成"金蝶样子"的凭证。

二、痛点：金蝶的凭证，不是"填几个字段"就能进

很多做过金蝶对接的 IT 都有同一个体会：接口文档不难，难的是对齐。金蝶云星空的凭证校验规则相当细，随便推一条数据进去，大概率被拒。常见的坑有六个：

1. 核算维度按科目"各要各的"（最容易卡死的一环）

金蝶的科目可以挂多个核算维度，而且不同科目要求的维度完全不一样：管理费用通常只要部门，研发支出还要项目，其他应付款必须带员工，应收应付要客户或供应商。业务侧如果不知道每个科目要哪些维度，就只剩两个选择——全传（可能传了科目不接受的维度，被拒）或者全不传（可能缺维度，也被拒）。

2. 只认末级科目

指向上级科目会直接报"非末级科目不允许记账"。业务表单里如果让人自选科目，很容易选到非末级。

3. 账簿、凭证字、期间要对应上

多组织、多账簿的企业，每家主体对应哪个账簿、用哪个凭证字、落在哪个会计期间，都得事先约定好，不能靠默认值碰运气。

4. 账期关了就是关了

目标期间已结账，推什么都进不去。等金蝶返回错误码再排查，财务看到的是一串技术信息，既不知道哪张单出问题，也不知道怎么改。

5. 重复推送会产生重复凭证

接口超时、网络抖动、人工重试，同一张表单可能被推两次，账上就多一张凭证，红冲起来很麻烦。

6. 非标业务在金蝶里没有单据入口

押金、预提、摊销、内部结算、质保金扣款这些事，金蝶里没有现成业务单据可用，最后仍然回到财务手工敲分录。

前五条是"推不进去"的问题，第六条是"根本没得推"的问题。AgileFlow 这个模板要解决的是全部六条。

三、方案概述：把金蝶的复杂度，挡在业务侧之外

这个模板的设计思路是分层：

· 业务层（宜搭表单）：员工只填业务信息——发生了什么、多少钱、归哪个部门/项目/客户。不需要懂科目、不需要懂维度。

· 翻译层（AgileFlow）：按照预配置的规则，把业务信息翻译成金蝶凭证的完整结构，并在推送前把金蝶会拒的东西先查一遍——科目是不是末级、该带的核算维度齐不齐、账期开没开、这张单是不是推过了。

· 财务层（金蝶云星空）：接收后生成待审核凭证，由财务复核、过账。

> 「X表单」的 X 代表任意。企业有几张非标表单，就能接几个场景，不必为每类业务单独开发接口。

有哪五类校验在推送前就拦下来（对应上面的坑）：

> 为什么这套校验值得单独做：等金蝶返回错误码再排查，问题会落到财务头上；在推送前拦住，问题就回到了填表人手上——谁能改，就让谁看到。这是效率差别的关键。

四、数据流：六步把表单变成金蝶凭证

宜搭填写自定义表单

│

▼

① 触发（表单提交 / 审批通过，可配置）

│

▼

② 取数（读取表单字段、附件、填报人组织信息）

│

▼

③ 翻译（账簿 / 凭证字 / 期间 / 摘要 / 末级科目 / 金额 / 核算维度）

│

▼

④ 前置校验（科目有效性、维度完整性、账期、借贷平衡、幂等）

│

▼

⑤ 推送金蝶云星空（生成待审核凭证）

│

▼

⑥ 回写（凭证号、金蝶内码回写表单，双向可追溯）

几个关键节点展开说：

② 取数：除表单填写内容外，还要带出填报人的组织信息——因为核算维度里的"部门""员工"往往不靠人填，而靠组织架构自动带出。这一步做好了，维度缺失的问题能少一大半。

③ 翻译：这是整个方案的核心。宜搭说"费用类型=房租预提"，AgileFlow 按规则翻成"借：管理费用—房租（部门维度），贷：其他应付款—预提费用"。业务语言和会计语言的鸿沟就在这一步填平。

⑤ 推送：支持单张实时推送，也支持批量补推（历史遗留的表单集中处理）。大批量场景下建议分批执行并查看执行日志，避免一次性压太多。

⑥ 回写：凭证号写回宜搭表单，形成"表单 → 凭证"的单向可查、"凭证 → 表单"的反向可溯，审计取证时不用满世界翻文件。

五、字段映射示例

下表为典型映射示意，具体字段以贵司宜搭表单结构与金蝶云星空科目、核算维度实际配置为准：

关于编码对不上：宜搭侧用的部门编码、员工编码，未必和金蝶基础资料里的一致（尤其宜搭组织架构来自钉钉或 HR 系统时）。这时需要一张编码转换对照表——宜搭侧编码 → 金蝶侧编码。这张表要在实施阶段就建立并长期维护，别指望两边编码天然一致。

六、三个注意事项，怎么绕

这一节是本文和"通用凭证自动化方案"的区别所在。金蝶云星空的三个硬约束，AgileFlow 都有对应处理：

坑一：核算维度按科目差异化要求

处理方式：在科目主数据里维护"该科目要求哪些维度"（如：管理费用=部门；研发支出=部门+项目；其他应付款=员工+供应商），凭证生成时按科目要求填充并校验，缺什么在推送前就报出来。

> 这个设计的好处：业务侧不需要知道"这个科目要什么维度"，只填表单里有的业务字段，剩下交给规则。

坑二：科目必须是末级

处理方式：科目主数据标记"是否末级"，配置映射规则时只允许选末级科目；若历史规则指向的科目后来被停用或降级，通过定期同步科目主数据发现并标记失效，避免一直报错。

坑三：账期关闭 + 重复推送

处理方式：推送前校验账期状态，已结账则阻止并提示"建议改入下期"；以表单单号作为来源单据号做幂等判重，同一张表单只允许生成一张凭证，接口超时重试也不会重复入账。

> 这三条归纳起来就是一句话：把金蝶的校验规则，前移到表单填报那一刻。财务事后不用擦屁股，业务当场就知道该改什么。

七、三笔典型分录示例

以下用三个能体现"核算维度差异"的场景说明落地效果。科目与维度仅为示例，实际以贵司科目体系、核算维度设置及会计政策为准：

场景 1：收取客户保证金（往来类，需客户维度）

 场景 2：研发项目费用归集（费用类，需部门+项目双维度）

 场景 3：供应商质保金扣款（往来调整，需供应商维度）

 这三个场景的共同点：表单里填的字段是"客户/项目/供应商"这类业务语言，落到金蝶里必须变成"该科目能接受的核算维度组合"。这层转换就是 AgileFlow 在做的事，也是纯手工对接最容易翻车的地方。

八、上线收益

1. 非标业务有了凭证入口。 押金、预提、摊销、内部结算这类"金蝶里没有单据"的业务，终于能自动进账。

2. 错误在填报时就被拦住。 维度缺失、科目选错、账期已关，业务现场就知道，不用等财务月底发现。

3. 财务从"录分录"变"审凭证"。 原来大部分时间花在敲科目和查编码，现在只做复核。

4. 多账簿多组织不再靠记忆。 主体对应账簿、业务类型对应凭证字，全部规则化配置。

5. 不会重复入账。 幂等判重从机制上杜绝"同单多凭证"，省掉红冲和对账的麻烦。

6. 审计链路完整。 凭证可追溯到原始表单与附件，"凭什么入账"随时可查。

7. 新场景改配置即可。 新业务类型出现，配表单加规则就行，不需要排开发。

九、适用场景

判断标准很简单：这笔业务在金蝶云星空里有没有现成单据能开？有就用原生能力；没有，就用这个模板。

· 资金往来类：保证金/押金收取与退还、代垫费用、备用金借支与核销、往来款划转

· 预提摊销类：房租预提、水电费预提、装修费摊销、软件服务费摊销、长期待摊费用分摊

· 内部结算类：部门费用分摊、分公司内部往来、关联方结算、集团内部调拨

· 项目核算类：研发项目费用归集、工程项目成本分摊（需项目维度的典型场景）

· 往来调整类：供应商质保金扣款、客户折让、尾差调整、坏账准备计提

· 非经常性损益类：罚款收入、违约金、捐赠、政府补贴、资产处置

· 其他自定义业务：企业自己用宜搭搭出来、且需要入账的任何表单

十、为什么选安捷云 AgileFlow

· 一个模板适配所有表单。「X表单」不绑定业务类型，接一次能力，能复用无数场景。

· 把金蝶的复杂度前置消化。 核算维度、末级科目、账期、幂等这些硬约束都在配置层解决，业务侧只看到一张普通表单。

· 可视化配置，财务自己能维护。 科目映射、维度规则、校验项全图形化，不必每次找开发。

· 编码对照可维护。 支持建立"宜搭编码 ↔ 金蝶编码"的转换表，组织架构变动时只改这张表。

· 执行可观测。 每笔推送有执行日志与失败告警，哪张单卡住了、卡在哪个校验，一眼可见。

· 生态可扩展。 宜搭（钉钉低代码）与金蝶云星空是中型以上企业常见组合；AgileFlow 在这条链路上另有「宜搭→好业财凭证」「宜搭→好业财出库单」等成熟模板，可组合成覆盖不同 ERP 体系的业财一体方案。AgileFlow 与安捷AI（天智鲲鹏）同体系，后续还能继续打通 T+、飞书、企业微信等系统。

十一、接入路径

8. 授权连接。 在 AgileFlow 中授权宜搭（钉钉）与金蝶云星空，建立系统间通道。

9. 同步基础资料。 拉取金蝶的账簿、科目（含末级标记与核算维度要求）、核算维度档案、币别等主数据，这是后续映射的地基。

10. 建立编码对照。 把宜搭侧的部门、员工、项目编码与金蝶侧编码对齐，形成转换表。

11. 配置映射与校验。 设置字段对应关系、凭证字、期间规则，并开启前置校验（科目有效性、维度完整性、账期、幂等）。

12. 试运行。 用一张真实表单跑一遍，在金蝶核对生成的凭证——重点看借贷是否平衡、维度是否齐全、期间是否落对。

13. 扩大范围。 首张验证通过后，按同样的思路批量接入其他非标表单。

> 实施阶段最该花时间的是第 2、3 步（基础资料同步与编码对照）。这两步做扎实，后面每张表单的接入都会很快；这两步糊弄过去，后面会反复在"维度缺失""编码找不到"上打转。

十二、常见问题（FAQ）

Q1：这跟金蝶云星空自带的凭证模板有什么区别？

金蝶自带的凭证模板解决的是"金蝶内部单据→凭证"的转换。本模板解决的是"金蝶之外（宜搭自定义表单）→凭证"这一段，尤其适合金蝶里没有对应单据类型的非标业务。两者互补，不冲突。

Q2：核算维度传不对怎么办？

方案是在科目主数据里维护每个科目要求的维度，生成前按科目要求校验并填充。业务表单不需要让人填维度，只需填部门/项目/客户这些业务字段，由规则自动映射到对应维度。

Q3：生成的凭证要人工审核吗？

默认生成"待审核"状态，由财务复核后过账。凭证入账属会计行为，保留复核环节是内控底线。自动化的价值在于把"录入"这段做掉，把"审核"留给财务判断。

Q4：科目选错了会不会把账做乱？

映射规则统一配置，且只允许选末级科目。同时推送前会校验科目是否存在、是否停用、是否末级。规则一旦确定，比人工选科目更稳定。

Q5：一张表单有多行明细怎么办？

支持多行明细映射为多行分录，借贷平衡按整张凭证判断；金额自动汇总，不平则拦截。

Q6：多组织、多账簿怎么处理？

按表单里的"公司主体"字段映射到对应账簿，凭证字也可按主体或业务类型分别配置。复杂集团场景建议在实施阶段先把"主体—账簿—凭证字"的对应关系列清楚。

Q7：历史表单能补推吗？

可以。支持批量补推，建议分批执行并检查执行日志。补推时注意幂等判重，已生成凭证的表单会被跳过。

Q8：涉及外币业务怎么办？

支持币别、汇率类型、汇率、原币金额的映射，凭证按金蝶的折算逻辑处理。