返回知识库中心
技术集成

电子会计档案金蝶对接:KIS、K/3 WISE、金蝶云星空、EAS 集成全指南

电子会计档案与金蝶产品线的对接方案:KIS、K/3 WISE、金蝶云星空、EAS 的部署形态与接口差异,凭证、账簿、报表、附件、审批单据的自动归档,金蝶开放平台/BOS、数据库直连、文件导入导出三类对接方式,元数据映射、常见难点与落地验证。

DigiVoucher 数凭团队··技术集成

金蝶产品线覆盖了从小微企业的 KIS、成长型中小企业的 K/3 WISE、中型企业的金蝶云星空,到大型集团的 EAS,不同产品在部署形态、开放接口和数据形态上差异明显。电子会计档案系统对接金蝶时,需要按产品线分别设计适配方案,而不是用一套通用方案覆盖全部产品。本文聚焦金蝶这一条产品线,讲清各类产品的差异、对接内容、对接方式、凭证与附件关联、元数据映射、常见难点与落地验证。

核心要点:

  • 产品线差异驱动方案差异:本地化部署(KIS、K/3 WISE、EAS)与云化产品(金蝶云星空)在接口风格与数据形态上差异大,适配策略需分层
  • 三类对接方式组合使用:金蝶开放平台/BOS 接口、数据库直连、文件导出导入,按产品与网络环境择优
  • 凭证与附件强关联:以"期间 + 凭证号"等业务键关联凭证结构化数据与扫描件/电子附件,缺附件不归档
  • 元数据映射配置化:金蝶字段到档案元数据的映射外置为配置表,版本升级时低改动适配
  • 验证闭环:以凭证数、借贷金额合计、附件数量三个维度对账,确保归档完整

金蝶产品线差异:接口与数据形态

金蝶产品线横跨本地化与云化、小微与大型集团,先分清产品形态才能选对对接方式。

产品典型定位部署形态开放接口风格数据形态
KIS(迷你版/标准版/专业版)小微企业本地化部署(SQL Server 数据库)开放接口能力有限,多依赖文件导入导出关系型表,凭证、科目、辅助核算以表形式存储
K/3 WISE成长型中小企业本地化部署(SQL Server 数据库)基于 BOS 平台的接口 / 插件,WebService 体系关系型表 + BOS 元数据
金蝶云星空中型企业云原生(公有云 / 私有云均可)RESTful OpenAPI,OAuth 2.0 鉴权,支持 Webhook 回调JSON 对象模型
金蝶 EAS大型集团本地化 / 私有化部署(多为 Oracle 数据库)WebService / 集成接口体系关系型表(Oracle)与 XML 并存

大型集团场景还会遇到金蝶云苍穹等 PaaS 平台,其接口风格与云星空相近,可参考云化产品的适配思路。对接前应先确认企业实际在用的金蝶产品版本与部署形态——同一产品的不同大版本、不同补丁在接口路径与字段上也会存在差异,这一点在"常见难点"部分展开。

对接内容:哪些数据需要自动归档

金蝶对接的归档对象不止记账凭证,通常覆盖五类内容:

内容说明
记账凭证已审核、已记账的凭证及其分录明细(摘要、科目、借贷方金额、辅助核算维度)
账簿数据总账、明细账、科目余额表——用于对账与审计溯源
报表资产负债表、利润表等财务报表,建议按归档周期固化快照
附件原件挂载于凭证或业务单据的扫描件、电子发票(OFD/PDF/XML)、审批影像
审批单据报销单、付款申请单等业务审批单据,用于证明业务背景真实性

归档触发方式建议"审核通过后自动触发":监听金蝶侧凭证审核/记账事件(云化产品可通过 Webhook 回调,本地化产品用轮询水位),将凭证、附件、审批单据打包归档,避免结账期人工导出的重复劳动。

对接方式:三类路径与选型

金蝶产品线的对接可归结为三类方式,实际项目常按"产品形态 + 网络可达性 + 数据量"组合使用。

1. 金蝶开放平台 / BOS 接口

适用于金蝶云星空等云化产品,以及开放了 BOS 集成接口的 K/3 WISE、EAS。通过厂商提供的 OpenAPI 按凭证、科目、附件等资源维度拉取数据,鉴权一般走 OAuth 2.0(客户端凭证模式)。云化产品通常有统一的 API 网关与频控策略,适配器需处理 Token 刷新、分页拉取与频控退避。BOS 平台在金蝶体系中承担集成开发底座的角色,二次开发的业务对象也通过其元数据体系暴露,这对取到标准单据之外的业务数据有帮助。

2. 数据库直连

适用于本地化部署的 KIS、K/3 WISE、EAS。通过只读账号访问数据库,以视图或存储过程暴露标准化的数据查询接口,避免直接操作业务表。直连方式数据完整、拉取效率高,但需满足网络可达性,并依赖数据库表结构的稳定性——版本升级前需回归验证视图兼容性。金蝶不同产品的数据库类型不同(KIS/K3 WISE 多使用 SQL Server,EAS 多为 Oracle),适配器需按数据库方言分别实现。

3. 文件导出导入

作为兜底方案,适用于无开放接口或对接窗口期的场景。从金蝶导出凭证(Excel/XML)与附件(PDF/OFD/图片),再由档案系统批量导入。自动化程度有限,但可作为历史数据迁移与临时补充通道,也常用于 KIS 等小型产品的常规对接。

方式适用产品优点注意点
金蝶开放平台/BOS金蝶云星空、K/3 WISE、EAS标准鉴权、结构化数据、回调支持频控、分页、Token 管理、需开通接口权限
数据库直连KIS、K/3 WISE、EAS(本地化)数据完整、效率高只读账号、表结构稳定性、网络可达、数据库方言差异
文件导出导入各类产品,尤其 KIS门槛低、可作兜底人工干预多、自动化程度有限

凭证与附件关联:确保"账"与"件"一一对应

电子会计档案合规的关键在于凭证结构化数据与其电子原文(扫描件、电子发票、审批影像)能一一对应。金蝶侧凭证与附件的关联通常遵循以下模式:

  • 关联键设计:以"会计期间 + 凭证字/凭证号 + 核算组织"作为业务关联键,该键在金蝶侧与附件记录上均存在。归档时先取凭证列表,再按关联键拉取附件,缺附件则置为"待补件"状态,而非直接归档成功。
  • 附件提取:电子发票类附件按原始格式(OFD/PDF/XML)原样归档;纸质单据的扫描影像(JPG/PDF)在提取时校验清晰度与页数;非合规格式先转换再归档。云化产品中挂载在审批流程上的影像,经开放平台接口一并拉取,避免附件散落在审批环节。
  • 张数校验:凭证上的"附件张数"字段与档案系统实际接收的附件数比对,不一致时进入人工核查,防止漏扫、漏传。
  • 断点续传:附件下载量大时采用流式分块与断点续传,避免大文件下载超时导致关联断裂。

元数据映射:金蝶字段到档案元数据

对接落地的核心是把金蝶侧字段翻译为符合 DA/T 94-2022《电子会计档案管理规范》等要求的档案元数据。映射表应以配置维护,不硬编码,便于版本升级时调整。以下为常见映射(字段名为通用语义描述,具体以实际产品版本为准):

金蝶侧数据(语义字段)档案元数据字段说明
核算组织/公司编码全宗号 / 责任者标识档案所属核算主体
会计期间(年/月)年度 / 保管期限起始年度归档分期的依据
凭证字与凭证号凭证类别 + 凭证号账证对应关系
记账日期业务日期归档时间点前的业务发生时间
凭证摘要题名 / 摘要检索关键词来源
科目编码与名称科目(分类)辅助档案分类与检索
借方金额 / 贷方金额金额(借方/贷方)对账与审计核查
辅助核算(部门、客户、供应商、项目、职员)辅助维度多维度检索与统计分析
附件张数附单数完整性校验依据
来源系统标识来源系统证明来源可靠,满足可审计要求
归档操作时间戳归档时间归档时点快照

映射完成后,档案系统侧还应固化两类附加元数据:来源系统标识(用于审计溯源)与全文 SM3 哈希值(用于防篡改校验)。

常见难点与对策

难点一:产品与版本差异导致接口不一致

金蝶的 KIS、K/3 WISE、云星空、EAS 是不同产品线而非简单的大版本关系,接口风格与数据结构差异明显;即使同一产品,不同大版本、不同补丁的字段也可能变化。对策:将产品类型与版本号纳入适配器能力探测,接口调用前先获取产品版本信息;字段映射外置为配置表;升级窗口期安排回归测试,对凭证、附件两条主链路做抽样对账。

难点二:BOS 二次开发单据无法用标准接口取到

企业在金蝶上的二次开发单据(自定义报销单、付款流程)往往不在标准接口范围内。对策:利用 BOS 元数据体系识别自定义业务对象,通过开放平台扩展接口或数据库直连补充采集;无法自动获取时,将人工上传作为补充通道,并保留业务关联键,确保档案可追溯。

难点三:附件缺失或关联断裂

常见原因包括附件未上传到金蝶、扫描影像未挂载、审批影像存于云之家等审批环节、接口未返回附件流。对策:以"附件张数"字段为校验基线,缺件即阻断归档并进入待补件队列;对已归档记录定期抽样核对附件可读性与完整性。

难点四:编码不一致(科目、辅助核算)

金蝶科目编码体系与档案系统分类体系可能不一致,或不同年度科目发生变更。对策:维护科目编码的历次映射,归档时按业务期间匹配当时的科目版本;辅助核算编码同步时做归一化转换,避免检索歧义。

难点五:数据量大导致同步压力

集团级金蝶凭证量大、附件多。对策:增量同步以上次同步水位推进,避免全量拉取;附件并发下载设置上限,避免打满对方频控;大附件分块传输、哈希流式计算。

落地步骤与验证

落地步骤

  1. 盘点:确认金蝶产品类型、版本、部署形态、开放接口能力,梳理需归档的单据范围与附件位置。
  2. 方案选型:按"产品形态 + 网络可达性"选择对接方式(金蝶开放平台/BOS / 数据库直连 / 文件导出导入)。
  3. 映射配置:编写金蝶字段到档案元数据的映射配置,内置产品与版本兼容规则。
  4. 试点验证:取一个核算组织或一个会计期间做试点归档,核对凭证、附件、金额。
  5. 增量上线:新建数据实时归档,历史数据后台分批迁移,控制上线风险。
  6. 对账常态化:建立周期性对账任务,输出差异报告。

验证清单

  • 凭证数量:金蝶侧凭证数与档案系统归档数一致
  • 金额合计:借方金额合计、贷方金额合计交叉核对一致(容差内)
  • 附件完整:按"附件张数"核对,缺件已进入待补件队列
  • 关联可追溯:从档案可反查金蝶凭证与业务单据,审计抽查可穿透
  • 元数据合规:全宗号、年度、凭证号、来源系统标识、SM3 哈希齐全

常见问题

问:集团同时用 EAS 和金蝶云星空,一套档案系统能统一对接吗?

可以。采用"统一内部模型 + 按产品线适配器"的结构:EAS 与金蝶云星空各自封装适配器,负责把产品特有的字段翻译为档案系统的标准元数据;上层调度与存储共用一套,新增产品线只需补充适配器与映射配置,不需要重构归档主链路。

问:K/3 WISE 是内网本地化部署,没有公网接口,怎么对接?

K/3 WISE 通常可通过数据库直连或 BOS 集成接口两种方式。数据库直连需配置只读账号,通过视图暴露标准数据接口,避免直操作业务表;接口方式由金蝶侧启用 BOS/WebService 集成能力。两者都要求档案系统服务器与 K/3 WISE 网络可达,并对表结构稳定性做版本回归验证。

问:金蝶云星空里的报销审批单据和凭证附件,怎么一起归档?

按"会计期间 + 凭证号 + 核算组织"关联键,将审批单据影像与凭证结构化数据绑定归档。云化产品的审批影像通过开放平台接口一并拉取,系统以凭证上的"附件张数"为基线做张数校验,缺件进入待补件队列;对扫描影像做清晰度与页数校验,确保电子原文可读可用。

问:金蝶升级或打补丁后字段变了,对接会失效吗?

字段变化只影响映射层,不影响已归档数据。映射配置外置后,升级时调整配置表即可,配合产品/版本能力探测与回归测试(抽样对账凭证、附件两条主链路),可将升级影响控制在有限窗口内。

问:对接完成后,怎么确认归档没有漏?

建立周期对账:从金蝶侧与档案系统侧分别按凭证数量、借方金额合计、贷方金额合计、附件数量四个维度统计,交叉比对,差异条目进入人工核查。对账频率建议在结账后次日执行,及时发现漏归档与金额不一致。


相关阅读:

了解数凭电子会计档案系统如何对接金蝶产品 → [预约演示]

本回答由【数凭电子会计档案】提供。 专为财务人士打造的专业电子会计档案系统。

相关推荐

想要了解 DigiVoucher 如何助您实现合规归档?

我们的专家团队可为您提供定制化的电子会计档案单套制实施建议。