账套迁移建账需求文档（金蝶等软件数据导入）

场景：客户第一次使用本系统，此前使用金蝶（KIS/专业版/精斗云/在线会计）或用友等财务软件。客户从原软件导出固定文件，导入本系统后自动生成科目体系 + 期初余额 + 历史数据，不需要手工重录科目和余额。 参考：金蝶在线会计自身提供「财务初始余额 Excel 导入」与「查凭证 → 导入凭证/导出列表」（实测确认），凭证级互换是行业标配能力，本方案对等设计。 日期：2026-10-01

---

一、目标与原则

1. 一键迁移：从原软件导出的文件直接上传，系统自动完成科目生成、期初建账、（可选）历史凭证入库；全程不手工录入科目。
2. 分级迁移：科目+期初（P0）保证"马上能用"；历史凭证（P1）保证"账史完整"；档案卡片（P2）锦上添花。任一层级可独立导入。
3. 宽容输入：不强制客户用我们的模板重填——直接上传金蝶原生导出文件，系统做列智能识别 + 人工确认。
4. 可校验：每一步有勾稽校验，迁移完成后资产负债表期初数必须与原系统一致。

二、迁移对象与优先级

级别	对象	来源文件	落地效果
P0	科目体系 + 期初余额 + 损益累计	科目余额表（Excel）	立即可记账；出资产负债表/利润表
P1	历史凭证	凭证导出文件（Excel/标准接口格式）	历史明细账、总账、凭证可查（只读）
P2	往来单位（客户/供应商）、部门、职员	核算项目/往来档案导出	辅助核算维度可查
P2	固定资产卡片	固定资产卡片导出	资产模块延续计提折旧
P2	存货档案	存货/核算项目导出	库存模块延续

为什么以「科目余额表」而不是三表为 P0：余额表直接按科目给出期初/发生/期末，不需要"报表项目→科目"反推映射；所有金蝶/用友产品都能导出科目余额表，是兼容面最广的建账输入。三表方案仅作为"只有报表没有账"的兜底（见第九章）。

三、客户从原软件导出什么

3.1 金蝶系

产品	导出内容	导出路径	格式
KIS / 专业版 / 旗舰版	科目余额表	账表处理 → 科目余额表 → 引出（选 Excel；勾选"期初余额+本年累计+期末余额"列）	.xls/.xlsx
同上	凭证	凭证查询 → 过滤期间 → 引出（"金蝶标准格式"或 Excel 明细）	.txt/.xml/.xlsx
同上	核算项目（往来单位/部门/职员）	基础资料 → 核算项目 → 引出	Excel
同上	固定资产卡片	固定资产 → 卡片管理 → 引出	Excel
精斗云 / 在线会计	科目余额表	账簿 → 科目余额表 → 导出（可按科目级次/类别过滤）	Excel
精斗云 / 在线会计	凭证列表	查凭证 → 更多 → 导出列表（实测存在）	Excel
精斗云 / 在线会计	凭证导入	查凭证 → 更多 → 导入凭证（本系统对等设计）	Excel/模板

3.2 用友系

产品	导出内容	说明
T3/T6/U8	科目余额表（UFO 报表或账表→科目余额表→输出 Excel）	列结构与金蝶基本一致
T3/T6/U8	凭证（凭证打印/序时账输出 Excel）	兜底走"序时账"格式解析
畅捷通 T+ / 好会计	科目余额表、凭证明细导出	同上

3.3 通用兜底

任意软件只要能导出"科目编码 + 名称 + 期初借/贷 + 期末借/贷"的表格（哪怕手工整理），即可完成 P0 建账。

四、本系统导入模板定义

模板仅用于"客户原文件无法识别"时的兜底；主路径是直接解析金蝶/用友原生导出文件。

4.1 模板 A：科目余额表（P0 核心）

列名	必填	说明
科目编码	✅	支持任意级次（如 1002 / 100201 / 10020101），级次由编码规则自动推断
科目名称	✅	末级科目名称
科目类别	✅	资产/负债/共同/权益/成本/损益
余额方向	—	借/贷，缺省按类别推断
期初余额-借 / 期初余额-贷	✅	数值，允许留 0
本年累计-借 / 本年累计-贷	损益类必填	用于利润表"本年累计"衔接
期末余额-借 / 期末余额-贷	✅	用于勾稽校验
数量/单位	—	数量核算科目
辅助核算类型 + 辅助核算项	—	如"客户：长沙XX公司"，或按明细行展开（一行一个辅助项）

4.2 模板 B：凭证明细（P1）

列名	必填	说明
凭证号	✅	如 记-0012（支持自动重排）
凭证日期	✅	需早于启用期间
摘要	✅
科目编码	✅	必须存在于已建科目
借方金额 / 贷方金额	✅	单行单方向
辅助核算项	—	客户/供应商/部门/职员，逗号分隔多值
附单据数、制单人、审核人	—

4.3 模板 C/D：往来单位、固定资产卡片

往来单位：编码、名称、类型（客户/供应商/both）、联系方式。 资产卡片：编码、名称、类别、部门、开始使用日期、原值、累计折旧、月折旧、折旧方法、预计使用年限、净残值率。

五、导入向导流程（七步）

① 新建账套 → ② 选择来源软件 → ③ 上传科目余额表 → ④ 列映射确认
     → ⑤ 科目对照确认 → ⑥ 期初确认+试算平衡 → ⑦ （可选）凭证/档案导入 → 完成

1. 新建账套：公司名称、会计制度（小企业准则/一般企业准则）、启用期间（默认=迁移资料的期末期间下一期，可改）。
2. 选择来源软件：金蝶KIS/专业版、精斗云/在线会计、用友T3/T+、通用 Excel → 加载对应列映射预设与科目编码规则预设。
3. 上传科目余额表：解析后展示识别结果（工作表、表头行位置、列识别置信度）。
4. 列映射确认：源表头 ↔ 标准字段拖拽/下拉确认；同一来源软件的映射结果保存为预设，下次自动带出。
5. 科目对照确认：系统按"编码+名称"自动匹配标准科目字典（预期 ≥90% 自动命中）；差异类型人工处理： - 一级科目不同名 → 人工指定对照（如原"1002 银行存款"多明细 → 合并或保留明细） - 原科目带辅助核算 → 转为本系统"往来单位"辅助核算（同时生成 P2 档案） - 原自定义科目 → 保留为自定义科目（按原编码） - 损益类 → 校验期末余额应为 0，取"本年累计"
6. 期初确认 + 试算平衡：Σ借 ≠ Σ贷 时阻断并给出差额与差异科目定位报告（可下载）；通过后落库。
7. 可选扩展导入：凭证文件（校验后入历史期间）、往来单位、固定资产卡片 → 完成，进入记账工作台。

六、科目编码规则引擎（关键设计）

1. 级次自适应推断：金蝶一级 4 位（4-4-4-4-2 常见）、用友 4-2-2-2-2；系统按全表编码长度分布自动推断级次结构，推断失败时让用户指定各级位数。
2. 父子关系重建：编码前缀即父科目（100201 的父是 1002）；若余额表中只有末级科目，自动生成上级科目壳。
3. 标准科目字典：按会计制度内置标准科目表（编码、名称、类别、方向、辅助核算要求）；映射字典版本化，同一来源软件的映射结果可保存为映射模板复用。
4. 辅助核算转换：金蝶"应收账款-客户辅助"明细行 → 本系统科目 + 往来单位辅助核算；若明细行数过多（>500），提示改为"按汇总科目导入 + 档案后续补"。

七、校验规则清单

#	规则	处理
1	试算平衡：Σ期初借 = Σ期初贷	阻断，输出差额报告
2	勾稽：期初 + 本期发生 = 期末（逐科目）	警告并列出差异科目（可忽略清单）
3	损益类科目期末余额 = 0	警告
4	科目编码唯一、级次连续（父科目存在）	阻断
5	凭证每张借贷平衡	阻断该张，跳过或修复后重传
6	凭证日期 < 启用期间	阻断
7	凭证科目必须已存在	阻断并列出缺失科目清单
8	余额方向与科目类别匹配	警告

八、历史数据落地策略（P1 凭证怎么存）

1. 默认（方案一，推荐）：P0 建账后即可记账，历史数据仅以"迁移前余额"体现；P1 凭证导入为历史期间只读凭证——可查明细账/总账/凭证联查，不可修改、不可删除、不可反结账越过迁移点。
2. 历史凭证不参与重算：结转损益、报表重分类只作用于启用期间之后；报表从启用期间起保证准确。
3. 完整迁移的边界：凭证导入的历史期间只保证"账可查、账实一致"，不保证与原系统逐笔分录完全同构（辅助核算缺失、合并凭证等以警告清单披露）。

九、边界与异常

场景	处理
余额表只有一级科目	只建一级科目并提示"可补导明细级"；不影响建账
编码不符合任何已知规则	向导让用户手动指定级次位数
表头五花八门（各版本/手工表）	列映射 UI 兜底（第四章）
外币/数量核算科目	P0 先只转本位币金额，标记"待补外币/数量账"
试算不平（原账套本身不平）	阻断；提供差额报告；支持挂"待处理差额"过渡科目（强提示，计入操作日志）
只有三表没有账（极端兜底）	走"报表项目→科目"映射建账（合并项按规则拆分：货币资金→现金+银行等），不生成历史凭证
凭证号重复/断号	自动重排（启用"凭证号整理"逻辑），保留原号备查字段

十、原型落点

1. 新增原型页 accounting-import.html（建账向导，步骤条 UI），入口放两处：记账服务列表工具栏「更多 → 导入建账」、finance-config 财务配置页。
2. 映射确认/试算平衡界面可复用 ledger-center 的台账表格风格。

十一、验收标准

1. 用金蝶 KIS 真实账套导出的科目余额表导入：科目+期初自动生成，试算平衡通过，本系统资产负债表期初数与原系统逐项一致。
2. 凭证文件导入后：历史明细账/总账与原系统抽样一致；凭证只读、不可反结账越过迁移点。
3. 全程零手工录科目；同一来源软件第二次迁移复用映射模板，人工干预 ≤10%。
4. 原生文件无法解析时，改用标准模板仍可完成（兜底路径可达）。